跳到正文
misoto22 design

展示

Steps 步骤条

一串带编号的步骤,画成一条轨——一件接一件,中间有条线穿过去。

什么时候用它

流水线、迁移、配方:有先后、没有分叉。一旦出现分叉或者要指向别处,那就是 Diagram;把分叉画成列表等于把它藏起来。

示例

default

  1. CorpusBlog MDX · project database · profile
  2. ChunkingBy heading · 300–800 tokens
  3. EmbeddingVoyage 3.5-lite · 1024 dimensions
  4. Storagepgvector — the site’s own database
  5. RetrievalTop 5 by cosine · 0.2 floor
  6. AnswerReasoning filtered · live citations

说明

一串带编号的步骤,画成一条轨。

这就是一条流水线真实的形状:一件接一件,每件有个名字和一行细节,再有一条线穿过去,让眼睛把它们读成一个过程,而不是五行互不相干的内容。技术文章里,它是仅次于示意图最常被需要的图形——而它不是示意图:这里没有分叉,也没有任何东西指向别处,用方框加箭头画它等于在说反话。

连接线画在每一项上,而不是在编号圆点后面拉一条通高的线,所以它是从一个圆点下方开始、到下一个圆点上方结束,而不是从两个圆点中间穿过去——最后一项也就不会拖着一截多余的尾巴。正是这个细节把"轨"和"加了条边框的列表"区分开。

用 <ol>,因为顺序本身就是内容。aria-current="step" 标出被填充的那一个,这是这里唯一一件读屏用户没法从阅读顺序推出来的事。

属性

Steps props
属性类型默认值说明
steps必填Step[]
labelstring当没有标题为它命名时,用它给这串步骤起个名字,供辅助技术使用。
marker'number' | 'rule''number'编号圆点怎么画。 `number` 从 1 开始数,适合流水线、配方、迁移。`rule` 去掉数字,只留一个细线节点,适合一串状态——"排队中、执行中、已完成"是顺序,不是编号列表。

同时接受 Omit<HTMLAttributes<HTMLOListElement>, 'children'> 里的全部属性,它们会直接透传给底层元素,不再逐条列出。

无障碍

  • 用 <ol>,因为顺序本身就是内容——一堆 div 说明不了先后。
  • aria-current="step" 标出被填充的那一个,这是这里唯一一件读者没法从阅读顺序推出来的事。
  • 编号圆点和连接线都是 aria-hidden:那个数字就是列表序号,读屏软件本来就会念。