版本对照表 <SpecSheet />
2–3 列分组表格,每行一个组件的旧版本 → 新版本;主版本号变化的行用强调色和圆点标出。
Template and style descriptions are currently available in Chinese only.
- Group
- 变化 · 一批组件的新旧版本
- Component
SpecSheet·#spec-sheet- Interaction
- 各组依次淡入;悬停一组时图标点亮。
Good for
- 发行版、依赖、平台升级时的一批版本号
- 想让听众快速找出“哪些是大版本跳跃”
Avoid when
- 只有 3 个以下组件:用 KeyValue 或 CompareTable
- 值不是版本号而是行为描述:用 CompareTable
Content limits
| 1 | groups 2–3 组,每组 3–6 行,各组行数相差不超过 1 |
| 2 | name ≤ 12 个字符;from / to ≤ 10 个字符 |
| 3 | major 只标主版本号变化,不要全标 |
Fields
| Field | Type | |
|---|---|---|
kicker · required | string | 标题上方的小节名,2–8 字 |
title · required | string | string[] | 页面标题;传数组可手动断行,每项一行 |
lead | string | 一到两句导语,≤ 60 字 |
source | string | 事实出处;页面上有任何数据或事实时必填 |
hint | ReactNode | 页眉中间的操作提示,可用 <kbd> |
columns · required | [string, string] | 两个版本的列名 |
groups · required | { label, icon?, rows: { name, from?, to, major? }[] }[] | 分组 |
Example
<SpecSheet
kicker="软件栈"
title="工具链、系统和服务一起换代"
columns={['Lumen 12', 'Lumen 13']}
groups={[
{ label: '工具链', icon: 'code', rows: [{ name: 'GCC', from: '12.2', to: '14.2', major: true }, { name: 'Python 3', from: '3.11', to: '3.13' }] },
{ label: '服务', icon: 'server', rows: [{ name: 'PostgreSQL', from: '15', to: '17', major: true }, { name: 'Nginx', from: '1.22', to: '1.26' }] },
]}
source="aurora 发行说明 §2.2.10"
/>