`view` primitive

view is an AUP cross-device primitive, not a Web Device layout component and not a Web-only widget. It is one of the 18 names in AUP_PRIMITIVES and appears in every target's DeviceCaps.primitives map as native, webview, partial, or unsupported.

Contract

When to use

Need a semantic container, panel grouping, mode=tabs, or mode=steps that other devices can interpret.

When not to use

Do not use view as a Web Device layout.aup section stand-in for portal-header, content-card, or other site components.

Sample contract

Document sample (tabs)

This is an unbound document-target view with mode="tabs". Switching tabs only changes which panel is visible in the browser. It does not open an AUP session or write content.

Source:

::::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`.
:::
::::

Rendered:

The outer fence needs more colons than nested containers. Same contract as Live examples: scope and contract.

Failure and limits

Document sample (steps mode via view)

mode="steps" is also available on a generic view container. The Markdown-native tutorial path is ::::steps / :::step (see steps); both land on document view rendering.

Source:

::::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.
:::
::::

Rendered:

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.

Verification evidence

Evidence anchors

Nearby pages