步骤

步骤,也称为步进器,是工作流程中步骤的指示器。步骤组件的布局针对响应式设计进行了优化。


import { Steps } from 'primereact/steps';
         

步骤需要一个菜单项集合作为其模型


<Steps model={items} />
 

可以使用activeIndex属性以编程方式控制步骤。


<Steps model={items} />
 

步骤默认是线性的,以强制完成上一个步骤才能继续。对于非线性模式,请将readOnly设置为 false。


<Steps readOnly model={items} />
 

为了向组件添加交互性,请禁用readOnly并使用绑定到activeIndex以及onSelect来控制步骤。


<Toast ref={toast}></Toast>
<Steps model={items} activeIndex={activeIndex} onSelect={(e) => setActiveIndex(e.index)} readOnly={false} />
 

步骤通过items template 属性提供项目自定义,该属性接收项目实例并返回一个元素。


<Steps model={items} activeIndex={activeIndex} readOnly={false} className="m-2 pt-4" />
 

屏幕阅读器

步骤组件使用 nav 元素,并且由于任何属性都隐式传递给根元素,因此可以使用 aria-labelledbyaria-label 来描述该组件。其中使用了一个有序列表,其中当前步骤项将 aria-current 定义为“step”。

键盘支持

按键功能
tab当焦点移动到组件时,将焦点添加到活动步骤;如果已经有一个聚焦的选项卡标题,则根据页面选项卡顺序将焦点移出组件。
enter如果未启用 readonly,则激活聚焦步骤。
空格如果未启用 readonly,则激活聚焦步骤。
右箭头如果未启用 readonly,则将焦点移动到下一步。
左箭头如果未启用 readonly,则将焦点移动到上一步。
home如果未启用 readonly,则将焦点移动到第一步。
end如果未启用 readonly,则将焦点移动到最后一步。