跳到主要内容

ARC 2.0.0-beta.28 · AUP Web-only widget

app-header

AUP Web-only widget `app-header`：用途、边界、表面、fallback 与证据。

这是 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）。

用途

品牌 shell 页眉——服务端驱动的导航 chrome。Renderer 发出 AUP 事件，而不是自行制定客户端路由策略。

边界

  • 不要把该类型写成可移植 primitive。
  • 不要与 Web Device layout-component 参考页混装在 widgets/ 下。
  • parser 接受名称 ≠ 可移植性或产品就绪声明。

作者入口

AUP app shell type: "app-header"。Showcase：prim-app-header、session、session-chrome。

表面

交互 Web + document RENDERERS。站点 layout 的 portal-header 是不同的 layout-component。

Fallback

无共享 degradation chain。

证据

SourcePath
Registrationpackages/aup/src/aup-types.ts
Registryproviders/runtime/ui/src/aup-registry.ts (app-header)
Interactive rendererproviders/runtime/ui/src/web-page/renderers/app-header.ts
Document rendererproviders/runtime/web-device/src/renderer/primitives/app-header.ts; RENDERERS in render-to-html.ts
Showcaseblocklets/showcase/.aup/pages/prim-app-header.json

路径相对于本文档基线所用的 Arc 仓库 checkout。

Sample

本站尚无 docs-safe 的 live sample。请以所列 Showcase 源码 / factory API 作为 source-only 参考。需要交互验收时在本地运行 Showcase。

相关