フィールドセットは、コンテンツの切り替え機能を備えたグループ化コンポーネントです。
import Fieldset from 'primevue/fieldset';
シンプルなフィールドセットは、legendプロパティと、子要素としてのコンテンツを使用して作成されます。
<Fieldset legend="Header">
<p class="m-0">
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
</p>
</Fieldset>
toggleableオプションが有効になっている場合、フィールドセットのコンテンツを展開および折りたたむことができます。
<Fieldset legend="Header" :toggleable="true">
<p class="m-0">
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo
consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
</p>
</Fieldset>
テンプレートを使用すると、カスタムコンテンツでレジェンドセクションをカスタマイズできます。
<Fieldset>
<template #legend>
<div class="flex items-center pl-2">
<Avatar image="/images/avatar/amyelsner.png" shape="circle" />
<span class="font-bold p-2">Amy Elsner</span>
</div>
</template>
<p class="m-0">
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
</p>
</Fieldset>
フィールドセットコンポーネントは、セマンティックなfieldset要素を使用します。切り替え可能なオプションが有効になっている場合、ボタン要素がlegend要素内に含まれます。このボタンには、aria-controlsがコンテンツセクションのIDを定義するために、aria-expandedが可視状態のために付与されます。ボタンを読み取る値は、デフォルトではlegendプロパティの値になりますが、toggleButtonPropsプロパティを介してaria-labelまたはaria-labelledbyを定義することでカスタマイズできます。
コンテンツはregionを使用し、コンテンツ切り替えボタンのaria-controlsに一致するID、およびヘッダーのIDを参照するaria-labelledbyを定義します。
| キー | 機能 |
|---|---|
| tab | ページのタブシーケンスで、フォーカス可能な次の要素にフォーカスを移動します。 |
| shift + tab | ページのタブシーケンスで、フォーカス可能な前の要素にフォーカスを移動します。 |
| enter | コンテンツの表示/非表示を切り替えます。 |
| space | コンテンツの表示/非表示を切り替えます。 |