ステップは、ステッパーとも呼ばれ、ワークフローにおけるステップのインジケーターです。ステップコンポーネントのレイアウトは、レスポンシブデザインに最適化されています。
import { Steps } from 'primereact/steps';
ステップには、modelとしてメニュー項目のコレクションが必要です。
<Steps model={items} />
ステップは、activeIndexプロパティを使用してプログラムで制御できます。
<Steps model={items} />
ステップはデフォルトで線形であり、前のステップの完了を強制して進むことができます。非線形モードの場合は、readOnlyをfalseに設定します。
<Steps readOnly model={items} />
コンポーネントにインタラクティビティを追加するには、readOnlyを無効にし、ステップを制御するためにonSelectとともにactiveIndexへのバインディングを使用します。
<Toast ref={toast}></Toast>
<Steps model={items} activeIndex={activeIndex} onSelect={(e) => setActiveIndex(e.index)} readOnly={false} />
ステップは、アイテムのインスタンスを受け取り要素を返すアイテムのtemplateプロパティでアイテムのカスタマイズを提供します。
<Steps model={items} activeIndex={activeIndex} readOnly={false} className="m-2 pt-4" />
ステップコンポーネントはnav要素を使用し、暗黙的にすべての属性がルートに渡されるため、コンポーネントを説明するためにaria-labelledbyまたはaria-labelを使用できます。順序付きリスト内では、現在のステップ項目がaria-currentを「step」として定義する場所で使用されます。
キー | 機能 |
---|---|
tab | フォーカスがコンポーネントに移動すると、アクティブなステップにフォーカスを追加します。すでにフォーカスのあるタブヘッダーがある場合は、ページのタブシーケンスに基づいてフォーカスをコンポーネントから移動します。 |
enter | readonlyが有効になっていない場合、フォーカスされたステップをアクティブにします。 |
space | readonlyが有効になっていない場合、フォーカスされたステップをアクティブにします。 |
右矢印 | readonlyが有効になっていない場合、フォーカスを次のステップに移動します。 |
左矢印 | readonlyが有効になっていない場合、フォーカスを前のステップに移動します。 |
home | readonlyが有効になっていない場合、フォーカスを最初のステップに移動します。 |
end | readonlyが有効になっていない場合、フォーカスを最後のステップに移動します。 |