展示
Steps 步骤条
一串带编号的步骤,画成一条轨——一件接一件,中间有条线穿过去。
什么时候用它
流水线、迁移、配方:有先后、没有分叉。一旦出现分叉或者要指向别处,那就是 Diagram;把分叉画成列表等于把它藏起来。
示例
default
- Corpus
- Chunking
- Embedding
- Storage
- Retrieval
- Answer
说明
一串带编号的步骤,画成一条轨。
这就是一条流水线真实的形状:一件接一件,每件有个名字和一行细节,再有一条线穿过去,让眼睛把它们读成一个过程,而不是五行互不相干的内容。技术文章里,它是仅次于示意图最常被需要的图形——而它不是示意图:这里没有分叉,也没有任何东西指向别处,用方框加箭头画它等于在说反话。
连接线画在每一项上,而不是在编号圆点后面拉一条通高的线,所以它是从一个圆点下方开始、到下一个圆点上方结束,而不是从两个圆点中间穿过去——最后一项也就不会拖着一截多余的尾巴。正是这个细节把"轨"和"加了条边框的列表"区分开。
用 <ol>,因为顺序本身就是内容。aria-current="step" 标出被填充的那一个,这是这里唯一一件读屏用户没法从阅读顺序推出来的事。
属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| steps必填 | Step[] | — | |
| label | string | 当没有标题为它命名时,用它给这串步骤起个名字,供辅助技术使用。 | |
| marker | 'number' | 'rule' | 'number' | 编号圆点怎么画。 `number` 从 1 开始数,适合流水线、配方、迁移。`rule` 去掉数字,只留一个细线节点,适合一串状态——"排队中、执行中、已完成"是顺序,不是编号列表。 |
同时接受 Omit<HTMLAttributes<HTMLOListElement>, 'children'> 里的全部属性,它们会直接透传给底层元素,不再逐条列出。
无障碍
- 用 <ol>,因为顺序本身就是内容——一堆 div 说明不了先后。
- aria-current="step" 标出被填充的那一个,这是这里唯一一件读者没法从阅读顺序推出来的事。
- 编号圆点和连接线都是 aria-hidden:那个数字就是列表序号,读屏软件本来就会念。