`afs-list` primitive

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

合同

何时使用

在交互 target 上对 AFS 路径或打包 fixture 做声明式列表时。

何时不要使用

不要在公开 docs 绑定任意 AFS 路径。在没有只读 fixture origin 时不要声称已验证的 live list sample。

Sample 合同

Document sample（空 — No items）

源码：

:::afs-list{id="docs-prim-afs-list-empty" layout="list" itemStyle="row"}
:::

渲染：

Document sample（有 src 无子节点 — loading chrome）

展示静态 renderer 的 loading 空态。它不会在本站文档上抓取 AFS 路径。

源码：

:::afs-list{id="docs-prim-afs-list-loading" layout="list" itemStyle="row" src="data/items"}
:::

渲染：

Document sample（静态子节点）

预填子节点渲染为列表项。这不是 AFS list() 解析的证据。

源码：

:::afs-list{id="docs-prim-afs-list-static" layout="list" itemStyle="row"}
Static row one — authored as document children, not fetched.

Static row two — still not an AFS path proof.
:::

渲染：

• Static row one — authored as document children, not fetched.

• Static row two — still not an AFS path proof.

Showcase list-basic 将 afs-list 绑定到打包的 data/items 且列表本身无写入动作——对未来带专用只读 fixture origin 的嵌入 sample 有用。见 Live 示例：范围与合同（「列表还缺什么」）。

失败与限制

验证证据

证据锚点

相关页面