请求卡 <VerbCards />
3–4 张卡片，各有一个方法徽章（PUT/GET…）、请求行和一句说明；每按一次 → 一张卡底部像小票一样打出响应行。
版型與風格的說明目前僅提供簡體中文。
- 分組
- 接口 · 3–4 个操作
- 元件
VerbCards·#verb-cards- 互動
- build: reveal 时每步打出一张卡的响应
適合
- 介绍一个 API 的几个核心操作
- 每个操作都有“请求 → 响应”
不適合
- 要展示完整代码：用 Terminal 或 CodeDiff
- 操作超过 4 个：拆页
內容上限
| 1 | cards 3–4 张 |
| 2 | verb ≤ 6 个拉丁字符；path ≤ 28 个拉丁字符 |
| 3 | body ≤ 30 字；reply ≤ 28 个拉丁字符 |
欄位
| 欄位 | 型別 | |
|---|---|---|
kicker · 必填 | string | 标题上方的小节名，2–8 字 |
title · 必填 | string | string[] | 页面标题；传数组可手动断行，每项一行 |
lead | string | 一到两句导语，≤ 60 字 |
source | string | 事实出处；页面上有任何数据或事实时必填 |
hint | ReactNode | 页眉中间的操作提示，可用 <kbd> |
cards · 必填 | { verb, path, body, reply }[] | 每个操作一张 |
範例程式碼
<VerbCards kicker="S3 API" title="…" cards={[{ verb: 'PUT', path: 'PUT /photos/a.jpg', body: '…', reply: '200 OK' }, …]} source="…" />