跳到主要内容

ARC 2.0.0-beta.25

Primitive 类型分类与证据

区分 18 个跨设备 primitive、42 个 Web-only widget,以及目标实际报告的能力。

“type 被 parser 接受”与“type 在某台设备可用”是不同声明。这个参考先给出当前类型分类,再把最终支持判断交回实际 DeviceCaps、target renderer 和本地验收。

18 个跨设备 primitive

当前 type
基本界面viewtextmediainputactionoverlay
结构与时间tabletimechartmapcalendar
交互 surfacechatrtcexplorereditorcanvassurfaceafs-list

这 18 个名字构成跨设备 primitive 表,也是 capability map 的对象。每个名称的合同见 AUP primitives。对每一个 type,设备会报告 nativewebviewpartialunsupported;不要用上表替代真实目标的报告。

42 个 Web-only widget

当前类型表另有 42 个 Web widget。它们包含呈现/站点用途的类型,例如 frameterminalbreadcrumbpaginationtooltipcomments-surfaceblocklet-embedwebgl-herowm-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 前,先为它设计显示与失败边界。

参考相邻页面

本页是 2.0.0-beta.25 的类型分类,不是一张跨版本、跨设备的兼容性承诺表。