跳到主要内容

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

frame

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

用途

用于页面片段的沙箱 iframe / embed 隔离。交互 session 可启同源 capability bridge；document embed 保持链接/iframe 约束。

边界

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

作者入口

AUP type: "frame"；Markdown ::embed 在 document 目标可编译为 frame 形节点。

表面

交互 Web + document partial renderer。适用信任边界。

Fallback

document 路径上被拒绝/未知 embed URL 退化为纯链接。

证据

SourcePath
Registrationpackages/aup/src/aup-types.ts
Interactive rendererproviders/runtime/ui/src/web-page/renderers/frame.ts
Document rendererproviders/runtime/web-device/src/renderer/primitives/frame.ts; RENDERERS; content-embed.ts
Matrixcapability-matrix.md §2 frame — verified #290
Related docsframes-bridges-embedded-surfaces; web-device/markdown-embeds

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

Sample

公开 document 目标行为由既有已验证文档覆盖（见 Related）。本页是 AUP widget 分类条目；不要把 Showcase 当成 www.arcblock.io 上的 live embed。

相关