SaturationSlider

SaturationSliderは、ユーザーが色の彩度を選択するために使用されるコンポーネントです。

使い方

import { SaturationSlider } from "@yamada-ui/react"
<SaturationSlider.Root />

サイズを変更する

デフォルトの値を設定する

デフォルトの値を設定する場合は、defaultValueに値を設定します。

形を変更する

ステップ値を設定する

ステップ値を設定する場合は、stepに値を設定します。

無効にする

無効にする場合は、disabledtrueに設定します。

読み取り専用にする

読み取り専用にする場合は、readOnlytrueに設定します。

ツールチップを表示する

開始と終了のイベントをハンドルする

開始と終了のイベントをハンドルする場合は、onChangeStartonChangeEndを使用します。

Value: [120,0.33,0.33], Start Value: [120,0.33,0.33], End Value: [120,0.33,0.33]

制御する

Props

アクセシビリティ

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

キーボード操作

キー説明状態
ArrowRightstepの値に基づいて彩度を増加します。-
ArrowLeftstepの値に基づいて彩度を減少します。-
ArrowUpstepの値に基づいて明度を増加します。-
ArrowDownstepの値に基づいて明度を減少します。-

ARIAロールと属性

コンポーネントロールと属性使い方
SaturationSlider.Thumbrole="slider"スライダーであることを示します。
aria-label"彩度と明度のつまみ"を設定します。
aria-labelledby関連するSaturationSlider.Rootidを設定します。
aria-roledescription"2D slider"を設定します。
aria-valuemin0を設定します。
aria-valuemax100を設定します。
aria-valuenow現在の値を設定します。
aria-valuetext"彩度 18%, 明度 18%"のように、現在の値を設定します。
aria-readonlyreadOnlyが設定されている場合は"true"を設定します。
aria-disableddisabledが設定されている場合は"true"を設定します。
aria-invalidinvalidが設定されている場合は"true"を設定します。
aria-requiredrequiredが設定されている場合は"true"を設定します。
aria-describedbySaturationSlider.RootField.Root内にあり、Field.RooterrorMessageまたはhelperMessage、もしくはField.ErrorMessageまたはField.HelperMessageが設定されている場合は、そのidを設定します。
inputaria-hidden要素をアクセシビリティツリーから除外します。
aria-readonlyreadOnlyが設定されている場合は"true"を設定します。
aria-disableddisabledが設定されている場合は"true"を設定します。
aria-invalidinvalidが設定されている場合は"true"を設定します。
aria-requiredrequiredが設定されている場合は"true"を設定します。
aria-describedbySaturationSlider.RootField.Root内にあり、Field.RooterrorMessageまたはhelperMessage、もしくはField.ErrorMessageまたはField.HelperMessageが設定されている場合は、そのidを設定します。

類似のコンポーネント

HueSlider

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

AlphaSlider

AlphaSliderは、ユーザーが色の透明度を選択するために使用されるコンポーネントです。

Slider

Sliderは、ユーザーが値の範囲から選択するために使用されるコンポーネントです。

ColorSelector

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

ColorPicker

ColorPickerは、ユーザーが色を選択したり任意の色の値を入力するために使用されるコンポーネントです。

使用しているコンポーネント・フック

使用されているコンポーネント・フック