Web Device Markdown 指令——不是 AUP primitive;不是 theme/site layout 组件。
Sample 合同
| 字段 | 值 |
|---|---|
| 目的 | 内容 Markdown 中的导航卡片 |
| 边界 | 仅导航;无 exec、AFS 写入或 session;不是 .web 组件 API |
| 作者入口 | ::link-card{title=… description=… href=… icon=…} |
| 表面 | Web Device document(静态) |
| 公共状态 | released |
| Fallback / 失败 | 无安全 href → 非链接卡片 chrome |
| 验证 | 下方路由 · arc --version = 2.0.0-beta.28 |
Sample
源码:
::link-card{title="Web Device overview" description="Review the site structure and its boundary" href="/en/docs/web-device/overview/" icon="book"}渲染:
Web Device overview
Review the site structure and its boundary
无 href 的源码(不是导航目标):
::link-card{title="Not a link" description="Missing href stays non-interactive chrome"}渲染:
Not a link
Missing href stays non-interactive chrome
失败与限制
| 情形 | 预期结果 |
|---|---|
缺 href | 非链接呈现 |
不安全 href scheme | 不提升为安全导航目标 |
期望 exec 或表单提交 | 超出合同 |
验证证据
| 项 | 值 |
|---|---|
| 基线 | 2026-08-09 · arc --version → 2.0.0-beta.28 |
| 能力行 | docs/aup/capability-matrix.md §6 · ::link-card |
| 实现 | content-reader.ts · contentCardToAup |
| 公开路由 | /en/docs/web-device/markdown/link-card/ · /zh/docs/web-device/markdown/link-card/ |
| 本地运行 | arc service start --blocklet blocklets/arcblock --port 4900 · 点击 link-card → 仅普通导航 |
| 接受标准 | 源码与卡片一致;缺 href 不是链接;无写入/exec |
相关
- Markdown hub — 仅导航
- 同级卡片:info-card · action-card · card-group
- 历史多单元 hub:markdown-cards