슬라이더

슬라이더를 사용하면 사용자가 다양한 값 중에서 부동 소수점 값을 선택할 수 있습니다. 슬라이더를 사용하여 사운드의 음량이나 광원의 밝기 같은 값을 조정할 수 있습니다. 값을 설정하려면 트랙을 따라 조절 버튼을 드래그하거나 트랙 자체를 클릭합니다. 슬라이더에는 값을 직접 수정할 수 있는 텍스트 입력 필드도 포함될 수 있습니다.

참고: 요소를 인스펙터 창의 다른 필드와 정렬하려면 .unity-base-field__aligned USS 클래스를 적용하기만 하면 됩니다. 자세한 내용은 BaseField를 참조하십시오.

슬라이더 생성

UI 빌더, UXML, C#을 사용하여 슬라이더를 생성할 수 있습니다. 다음 C# 예시에서는 기본값, 하한값, 상한값이 있는 슬라이더를 생성하고 슬라이더의 방향을 설정합니다.

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

페이지 크기 설정

슬라이더 컨트롤에는 트랙을 조절 버튼의 양쪽으로 클릭할 때 조절 버튼이 얼마나 움직이고 값이 얼마나 변하는지 제어하는 page-size 프로퍼티가 있습니다.

페이지 크기 값이 0인 경우 트랙을 클릭하면 조절 버튼이 커서 또는 포인터 위치로 이동하고 그에 따라 값이 업데이트됩니다.

페이지 크기 값이 0보다 큰 경우 트랙을 클릭하면 조절 버튼이 커서 또는 포인터 위치를 향해 특정 양만큼 이동합니다. 슬라이더 컨트롤은 전체 범위의 백분율로 페이지 크기를 처리합니다.

예를 들어 전체 범위가 200이고 페이지 크기가 20이면 페이지 크기는 200의 20%인 40입니다. 트랙을 클릭할 때마다 조절 버튼이 이동하고 값이 40만큼 증가하거나 감소합니다.

예제

다음 UXML 예시에서는 슬라이더를 생성합니다.

<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# 예시는 슬라이더의 커스터마이즈 가능한 기능 중 일부를 나타냅니다.

/// <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 선택자의 리스트입니다.

또한 인스펙터 또는 UI 툴킷 디버거의 매칭 선택자 섹션을 사용하여 해당 계층 구조의 모든 레벨에서 VisualElement 컴포넌트에 영향을 주는 USS 선택자를 확인할 수도 있습니다.

추가 리소스

• SliderInt
• MinMaxSlider