`view` primitive

view 是 AUP 跨设备 primitive，不是 Web Device 的 layout 组件，也不是 Web-only widget。它属于 AUP_PRIMITIVES 中的 18 个名称之一，并出现在每个 target 的 DeviceCaps.primitives map 中（取值为 native、webview、partial 或 unsupported）。

合同

何时使用

需要语义容器、面板分组、mode=tabs 或 mode=steps，并希望其他设备也能解释时。

何时不要使用

不要把 view 当成 Web Device layout.aup 里 portal-header、content-card 等站点组件的替代。

Sample 合同

Document sample（tabs）

这是 document target 上未绑定的 view，mode="tabs"。切换 tab 只改变浏览器中可见面板，不会打开 AUP session，也不会写入内容。

源码：

::::view{id="docs-prim-view-tabs" mode="tabs" label="Package manager"}
:::view{label="pnpm"}
Install with `pnpm install`.
:::

:::view{label="npm"}
Install with `npm install`.
:::
::::

渲染：

外层 fence 的冒号数必须多于内层。合同同 Live 示例：范围与合同。

失败与限制

Document sample（view 的 steps 模式）

通用 view 容器也支持 mode="steps"。Markdown 原生教程路径是 ::::steps / :::step（见 steps）；二者最终都落到 document 的 view 渲染。

源码：

::::view{id="docs-prim-view-steps" mode="steps" label="Two checks"}
:::view{title="Check the surface"}
Confirm you are on the document target, not a layout section.
:::

:::view{title="Check the fence depth"}
Outer containers need more colons than nested ones.
:::
::::

渲染：

1. Check the surface

   Confirm you are on the document target, not a layout section.

2. Check the fence depth

   Outer containers need more colons than nested ones.

验证证据

证据锚点

相关页面