YearPicker

YearPickerは、ユーザーが年を選択するために使用されるコンポーネントです。

YearPickerは、アクセシビリティに関してWAI-ARIA - Combobox Patternに従います。

FormControlを使用しない場合は、YearPickerにaria-labelまたはaria-labelledbyを設定します。

<YearPicker placeholder="YYYY" aria-label="Birthday" />

Copied!

<VStack gap="sm">
  <Heading as="h3" id="label">
    Birthday
  </Heading>

  <YearPicker placeholder="YYYY" aria-labelledby="label" />
</VStack>

Copied!

キーボード操作

キー	説明	状態
`ArrowUp`	フォーカスを上のセルに1つ移動します。	-
`ArrowDown`	フォーカスを下のセルに1つ移動します。	-
`ArrowLeft`	フォーカスを左のセルに1つ移動します。最初のセルの場合は、次の期間の最後のセルをフォーカスします。	-
`ArrowRight`	フォーカスを右のセルに1つ移動します。最後のセルの場合は、次の期間の最初のセルをフォーカスします。	-
`Home`	最初のセルをフォーカスします。	-
`End`	最後のセルをフォーカスします。	-
`Space`, `Enter`	フォーカスしているセルをアクティブにします。	-
`Escape`	ダイアログを閉じます。	`closeOnEsc={true}`

ARIAロールと属性

コンポーネント	ロールと属性	使い方
`YearPickerField` 内部	`role="combobox"`	コンボボックスであることを示します。
	`aria-haspopup="dialog"`	ダイアログが存在することを示します。
	`aria-expanded`	ダイアログが開いている場合は`"true"`を設定し、閉じている場合は`"false"`を設定します。
	`aria-controls`	ダイアログが開いている場合は関連した`ColorSelector`の`id`を設定し、閉じている場合は`undefined`を設定します。
	`aria-readonly`	`isReadOnly`が設定されている場合は`"true"`を設定します。
	`aria-disabled`	`isDisabled`が設定されている場合は`"true"`を設定します。
	`aria-invalid`	`isInvalid`が設定されている場合は`"true"`を設定します。
	`aria-required`	`isRequired`が設定されている場合は`"true"`を設定します。
`DatePickerClearIcon` 内部	`role="button"`	ボタンであることを示します。
	`aria-label`	`"Clear value"`を設定します。
`Calendar` 内部	`role="dialog"`	ダイアログであることを示します。
	`id`	`YearPickerField`と関連付けるために使用する`id`。
	`aria-hidden`	ダイアログが開いている場合は`"true"`を設定し、閉じている場合は`"false"`を設定します。
`CalendarControlPrev` 内部	`aria-label`	`"Go to previous year"`を設定します。
`CalendarControlNext` 内部	`aria-label`	`"Go to next year"`を設定します。
`YearList` 内部	`role="grid"`	グリッドであることを示します。
	`aria-label`	`"From 2021 to 2032"`のように、年の範囲を設定します。
`Button` 内部	`aria-selected`	項目が選択されている場合は`"true"`を設定し、未選択の場合は`"false"`を設定します。
	`aria-disabled`	項目が無効の場合は`"true"`を設定します。

GitHubでこのページを編集する

前MonthPicker 次ColorPicker