跳到主要内容

AUP 跨设备 primitive · ARC 2.0.0-beta.28

`chart` primitive

chart 是 full-web 上的跨设备 primitive;静态文档不得声称 live chart。

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

合同

字段值
Primitive 名称chart
层级AUP 跨设备 primitive(AUP_PRIMITIVES)
公共状态experimental
Document 能力unsupported
共享 degradation chainchart → table → text(document 得到表,不是 Chart.js)
作者入口交互 Web 上的 AUP/DSL · 没有 ::chart Markdown 指令
Document renderer / 备注Full-web Chart.js path; document: degrade + optional static reshape to table (arc#3458)
Showcase 证据blocklets/showcase-dsl/.aup/pages/chart.aup

何时使用

具备 chart 能力并用 Chart.js 呈现的完整交互 Web 表面。

何时不要使用

不要把 live chart 写成 document 能力。不要在站点内容发明 ::chart。

Document sample

不提供 live chart sample。 静态 document target 上的事实:

事实当前边界
Document 能力DEVICE_CAPS_DOCUMENT 未列出 chart → unsupported
共享 chainchart → table → text
你得到的一张表,不是 Chart.js 图形;本路径不加载 CDN chart
数据 reshaperuntime 含静态 reshape(arc#3458)时,内联 labels/datasets 变为表 columns/rows,而不是空 “No data” 表
Markdown没有已定义的 ::chart 指令
文档策略页面需要数据时优先作者手写 Markdown 或 AUP table

Showcase chart 仅作为交互表面证据。上游 issue 关闭 ≠ docs-safe live chart(见 设备能力与降级 与内部 capability-matrix §0.5–0.6)。

证据锚点

项值
注册表packages/aup/src/aup-types.ts · AUP_PRIMITIVES
Document capsproviders/runtime/web-device/src/device-caps.ts · DEVICE_CAPS_DOCUMENT
Degradationpackages/aup/src/degradation.ts · DEGRADATION_CHAINS
内部矩阵docs/aup/capability-matrix.md(内部,不对外路由)
Taxonomy hubPrimitive 类型分类与证据
Sample 合同规则Live 示例:范围与合同

相关页面

Slides / deck 路径(web)

普通 document 页使用 DEVICE_CAPS_DOCUMENT。含 deck 的树(Markdown slides: true)可走 DEVICE_CAPS_DECK,使 chart/map 等保留 progressive-enhance shell,而不是文章降级链(arc#4005 / #4011)。这不是「任意文档页都能 live Chart.js」的通用产品声明。

Markdown directive 属性仍是字符串;tour 里 JSON 数组属性还需运行时 coercion(arc#4013)。