这是 AUP Web-only widget,不是 cross-device primitive,也不是 Web Device layout component。
该名称登记在 AUP_WIDGETS(packages/aup/src/aup-types.ts)。结构校验可以接受它,Web runtime(或注明的原生目标)可以实现它。它不是 18 个跨设备 AUP_PRIMITIVES 之一,不会经 fillPrimitives 进入 DeviceCaps.primitives,也不是 Web Device 主题/站点 layout component(例如 content-card 或 page-breadcrumb)。
用途
服务端提供的面包屑路径(items 含 label/href)。工厂在 packages/aup/src/components/breadcrumb.ts。与站点 layout-component page-breadcrumb 不同。
边界
- 不要把该类型写成可移植 primitive。
- 不要与 Web Device layout-component 参考页混装在
widgets/下。 - parser 接受名称 ≠ 可移植性或产品就绪声明。
作者入口
通过 createBreadcrumb 或原始节点使用 AUP type: "breadcrumb"。路径解析须在服务端(Renderer Purity)。
表面
交互 Web AUP 组件。不是 Web Device layout 的 page-breadcrumb。
Fallback
无 degradation chain。空 items → 空路径。
证据
| Source | Path |
|---|---|
| Registration | packages/aup/src/aup-types.ts (UI components section) |
| Factory | packages/aup/src/components/breadcrumb.ts |
| Renderer | providers/runtime/ui/src/web-page/renderers/breadcrumb.ts |
| Tests | packages/aup/test/components/breadcrumb.test.ts; providers/runtime/ui/test/widget-renderers-993.test.ts |
路径相对于本文档基线所用的 Arc 仓库 checkout。
Sample
本站尚无 docs-safe 的 live sample。请以所列 Showcase 源码 / factory API 作为 source-only 参考。需要交互验收时在本地运行 Showcase。
相关
- Widgets hub — 仅导航
- Primitive 类型分类 — 18 vs 42 边界
- 自定义 primitive 与 Web widget
- 内部矩阵:
docs/aup/capability-matrix.md