跳到主要内容

Sample 合同 · MD 指令 · ARC 2.0.0-beta.28

`::::card-group`

在 document 网格中分组导航卡片，并验证 fence 深度与真实渲染。

Web Device Markdown 指令——不是 AUP primitive；不是 theme/site layout 组件。

Sample 合同

字段值
目的在 document 网格中排布嵌套卡片
边界外层 fence 必须深于内层容器；不是 layout-component API
作者入口::::card-group 包裹卡片指令
表面Web Device document（静态）
公共状态released
Fallback / 失败无 group 时卡片单独渲染；fence 深度错误会坍塌结构
验证下方路由 · arc --version = 2.0.0-beta.28

Sample

外层 fence 需要比嵌套容器多一个冒号。子节点为叶 ::link-card 时，四个冒号足够：

源码：

markdown
::::card-group
::link-card{title="Content objects" description="Review content and metadata" href="/en/docs/web-device/content-and-objects/" icon="book"}
::link-card{title="AUP boundary" description="See the difference between page layout and an AUP tree" href="/en/docs/web-device/aup-reference/" icon="layout"}
::::

渲染：

Content objects

Review content and metadata

AUP boundary

See the difference between page layout and an AUP tree

失败与限制

情形预期结果
外层 fence 过浅子节点解析错误；group/cards 可能坍塌
空 group空网格 chrome / 无卡片
期望 layout .web 组件 props错误表面

验证证据

项值
基线2026-08-09 · arc --version → 2.0.0-beta.28
能力行docs/aup/capability-matrix.md §6 · ::::card-group
实现content-reader.ts · arc#2454 · docs-page CSS
公开路由/en/docs/web-device/markdown/card-group/ · /zh/docs/web-device/markdown/card-group/
本地运行arc service start --blocklet blocklets/arcblock --port 4900 · 打开路由
接受标准group 排布嵌套卡片；点击仅导航

相关