跳到主要内容

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

comments-surface

AUP Web-only widget `comments-surface`：用途、边界、表面、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）。

用途

平台评论线程表面（撰写、列表、反应、分页）。AUP 包装层接线 props/事件；宿主无关 bundle 实现浏览器 DOM。

边界

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

作者入口

AUP type: "comments-surface"，或当 .web/comments 启用时由 Web Device 站点级挂载（site-server 路径）。front matter 可按条目关闭。

表面

交互站点 / AUP session。设置 requireAuth 时需要身份配置。

Fallback

站点 comments 关闭 → 不挂载。无共享 degradation chain。

证据

SourcePath
Registrationpackages/aup/src/aup-types.ts
AUP renderer wrapperproviders/runtime/ui/src/web-page/renderers/comments-surface.ts
Bundleproviders/runtime/ui/src/web-page/surfaces/comments-surface-bundle.ts
Web Device runtimeproviders/runtime/web-device/src/comments-surface-runtime.ts; site-server.ts comments mount
Showcaseblocklets/showcase/.aup/pages/comments.json

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

Sample

公开 sample 层面 internal / experimental。 交互 Web runtime（有时含 Web Device widget 包）存在注册与 renderer，但本站不提供 docs-safe live sample。不要仅凭类型名推断产品就绪。

相关