“type 被 parser 接受”与“type 在某台设备可用”是不同声明。这个参考先给出当前类型分类,再把最终支持判断交回实际 DeviceCaps、target renderer 和本地验收。
18 个跨设备 primitive
| 组 | 当前 type |
|---|---|
| 基本界面 | view、text、media、input、action、overlay |
| 结构与时间 | table、time、chart、map、calendar |
| 交互 surface | chat、rtc、explorer、editor、canvas、surface、afs-list |
这 18 个名字构成跨设备 primitive 表,也是 capability map 的对象。每个名称的合同见 AUP primitives。对每一个 type,设备会报告 native、webview、partial 或 unsupported;不要用上表替代真实目标的报告。
42 个 Web-only widget
当前类型表另有 42 个 Web widget。它们包含呈现/站点用途的类型,例如 frame、terminal、breadcrumb、pagination、tooltip、comments-surface、blocklet-embed、webgl-hero 与 wm-surface。它们在 Web runtime 中可以有 renderer,但不是跨设备 primitive,也不进入 DeviceCaps.primitives 的保证范围。
为了避免把“有 60 个 type”写成“有 60 个跨设备能力”,请按下列规则写文档和例子:
| 想声称什么 | 需要什么证据 |
|---|---|
| 某 primitive 在一个 target 可用 | 该 target 的 capability + 真实呈现验收 |
| 某 primitive 有 fallback | 当前 degradation chain 明确列出并已在目标验证 |
| 某 Web widget 可用 | Web runtime/浏览器验收 |
| custom type 可用 | 该 target 的注册/renderer 与真实验收 |
未知/custom type 没有共享 chain 时,当前 degradation 实现会原样通过,而不是自动转成安全文字。把自定义类型推广到第二个 renderer 前,先为它设计显示与失败边界。
参考相邻页面
- 看 device 报告、9 条显式降级链及其失败形态:设备能力与降级。
- 看 node、props、data binding 与 children 的语义:语义 tree。
- 看 Web Device 中静态 HTML 的边界:AUP 在 Web Device 中。
- 看 document 表面上的 18 个 primitive、Markdown 宿主与 deck 媒体演示漫步:AUP capability tour。
本页是 2.0.0-beta.25 的类型分类,不是一张跨版本、跨设备的兼容性承诺表。