Slider

Slider を使用すると、ユーザーは値の範囲から浮動小数点の値を選択できます。サウンドの音量やライトの明度などの値の調整にも Slider を使用できます。値を設定するには、トラックに沿ってつまみをドラッグするか、トラック自体をクリックします。スライダーにはテキスト入力フィールドを含めることもでき、このフィールドで値を直接変更できます。

ノート: 要素を Inspector ウィンドウの他のフィールドと揃えるには、.unity-base-field__aligned USS クラスを適用します。詳細については、BaseField を参照してください。

Slider の作成

UI Builder、UXML、または C# で Slider を作成できます。以下の C# の例では、デフォルト値、低値、高値のスライダーを作成し、スライダーの向きを設定します。

var slider = new Slider();
slider.value = 0.5f;
slider.lowValue = 0;
slider.highValue = 100;
slider.direction = SliderDirection.Horizontal;

ページサイズの設定

Slider コントロールには page-size プロパティがあり、つまみの両側にあるトラックをクリックしたときにつまみが移動する量と値が変化する量を制御します。

ページサイズの値が 0 の場合、トラックをクリックすると、つまみがカーソルまたはポインタの位置に移動し、それに応じて値が更新されます。

Page Size の値が 0 より大きい場合、トラックをクリックすると、つまみがカーソルまたはポインタの位置に向かって特定の量だけ移動します。Slider コントロールは、ページサイズを範囲の合計に対するパーセンテージとして扱います。

例えば、範囲の合計が 200 で、ページサイズが 20 の場合、ページサイズの量は 200 の 20%、つまり 40 になります。トラックをクリックするたびにつまみが動き、値が 40 増減します。

例

以下の UXML 例では Slider を作成します。

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <Slider
        label="UXML Slider"
        name="the-uxml-slider"
        low-value="0"
        high-value="100"
        page-size="1"
        value="42.2" />
</UXML>

以下の C# の例は、Slider のカスタマイズ可能な機能の一部を示しています。

/// <sample>
// Get a reference to the slider from UXML and assign it its value.
var uxmlSlider = container.Q<Slider>("the-uxml-slider");
uxmlSlider.value = 42.2f;

// Create a new slider, disable it, and give it a style class.
var csharpSlider = new Slider("C# Slider", 0, 100);
csharpSlider.SetEnabled(false);
csharpSlider.AddToClassList("some-styled-slider");
csharpSlider.value = uxmlSlider.value;
container.Add(csharpSlider);

// Mirror value of uxml slider into the C# field.
uxmlSlider.RegisterCallback<ChangeEvent<float>>((evt) =>
{
    csharpSlider.value = evt.newValue;
});
/// </sample>

この例を Unity でライブ体験するには、Window > UI Toolkit > Samples の順に移動します。

C# 基本クラスと名前空間

C# クラス: Slider
名前空間: UnityEngine.UIElements
基本クラス: BaseSlider_1

継承された UXML 属性

この要素は基本クラスから以下の属性を継承します。

この要素は VisualElement から以下の属性も継承します。

USS クラス

以下の表は、すべての C# パブリックプロパティ名と、それに関連する USS セレクターのリストです。

Inspector または UI Toolkit Debugger の Matching Selectors セクション を使用して、階層のすべてのレベルで VisualElement のコンポーネントに影響する USS セレクターを確認することもできます。

追加リソース

• SliderInt
• MinMaxSlider