Skip to main content

Sample contract · MD directive · ARC 2.0.0-beta.28

`:::action-card`

Place navigation choices in an action-card without promising exec or data writes.

Web Device Markdown directive — not an AUP primitive; not a theme/site layout component.

Sample contract

FieldValue
PurposeCard that nests navigation-only ::action nodes
BoundariesNested ::action is not general exec permission; document stays read-only for site content
Author entry:::action-card{…} with nested ::action
SurfaceWeb Device document (static)
Public statusreleased
Fallback / failureUnsafe action href rejected; fence depth errors drop nested actions
VerificationRoutes below · arc --version = 2.0.0-beta.28

Sample

Source:

markdown
:::action-card{title="Continue reading" description="Place several navigation choices in one card" icon="book"}
::action{label="Read the AUP layout boundary" href="/en/docs/web-device/aup-reference/" variant="primary"}
::action{label="Browse components hub" href="/en/docs/web-device/components/" variant="secondary"}
:::

Rendered:

Continue reading

Place several navigation choices in one card

Read the AUP layout boundaryBrowse components hub

Failure and limits

SituationExpected result
Expecting exec or form submitOut of contract
Nested ::action without hrefNon-link action chrome
Outer fence too shallowNested actions may drop

Verification evidence

ItemValue
Baseline2026-08-09 · arc --version → 2.0.0-beta.28
Capability rowdocs/aup/capability-matrix.md §6 · :::action-card
Implementationcontent-reader.ts · nested generic ::action
Public routes/en/docs/web-device/markdown/action-card/ · /zh/docs/web-device/markdown/action-card/
Local runarc service start --blocklet blocklets/arcblock --port 4900 · clicks navigate only
AcceptActions navigate; no write/exec; source matches card

Related