토글

토글에는 이미지와 레이블이 포함되어 있습니다. 다른 표준__ UI__(사용자 인터페이스) 사용자가 애플리케이션과 상호 작용하도록 해 줍니다. Unity는 현재 3개의 UI 시스템을 지원합니다. 자세한 정보
See in Glossary 툴킷 컨트롤(예: 버튼)과 마찬가지로 토글에는 MouseUpEvent 및 PointerUpEvent에 등록하는 클릭 가능한 매니퓰레이터가 연결되어 있습니다. 이러한 이벤트 중 하나가 매니퓰레이터를 트리거하면 토글의 값은 true에서 false로 변경되거나 false에서 true로 변경됩니다. 토글의 현재 값을 읽거나 설정할 수 있습니다. 토글을 Boolean 변수에 바인드할 수도 있습니다.

드롭다운에서 선택한 항목이나 활성화된 옵션과 같은 다른 조건에 따라 요소를 표시하거나 숨길 수 있습니다. 조건부 UI의 예시는 Unity 카메라 인스펙터입니다. Physical Camera 모드를 활성화할 때 추가 옵션이 표시됩니다.

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

토글 생성

UI 빌더나 UXML, C#을 사용하여 토글을 생성할 수 있습니다.

다음 C# 예시에서는 특정 레이블이 있는 토글을 생성합니다.

Toggle myToggle = new Toggle("Click me");

토글 스타일 지정

기본적으로 토글 컨트롤은 체크박스로 표시됩니다. 스타일을 적용하여 일반적인 토글 스위치처럼 표시되도록 할 수 있습니다.

토글 체크박스의 스타일을 지정하려면 .unity-toggle__input 및 .unity-toggle__checkmark 스타일 프로퍼티를 사용합니다. 예를 들어 토글에 className이라는 클래스를 적용한 경우를 들 수 있습니다. 다음 USS는 토글을 선택하거나 해제하면 체크박스의 배경 이미지를 변경합니다.

/* Set the background image when the checkbox is selected. */
.className:checked > .unity-toggle__input > .unity-toggle__checkmark {
    background-image: url("path/to/image-file");
}

/* Set the background image When the checkbox is not selected. */
.className > .unity-toggle__input > .unity-toggle__checkmark {
    background-image: url("path/to/image-file"); 
}

예제

다음 UXML 예시에서는 토글을 생성합니다.

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <Toggle label="UXML Field" name="the-uxml-field" />
</UXML>

다음 C# 예시는 토글의 커스터마이즈 가능한 기능 중 일부를 나타냅니다.

/// <sample>
// Get a reference to the field from UXML and assign a value to it.
var uxmlField = container.Q<Toggle>("the-uxml-field");
uxmlField.value = true;

// Create a new field, disable it, and give it a style class.
var csharpField = new Toggle("C# Field");
csharpField.value = false;
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
csharpField.value = uxmlField.value;
container.Add(csharpField);

// Mirror the value of the UXML field into the C# field.
uxmlField.RegisterCallback<ChangeEvent<bool>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

Unity에서 이 예시를 실시간으로 실행하려면 Window > UI Toolkit > Samples로 이동하십시오.

더 많은 예시를 확인하려면 다음을 참조하십시오.

• 조건부 UI 만들기

C# 기본 클래스 및 네임스페이스

C# 클래스: Toggle
네임스페이스: UnityEngine.UIElements
기본 클래스: BaseBoolField

상속 UXML 속성

이 요소는 다음 속성을 해당 기본 클래스에서 상속합니다.

이 요소는 또한 다음 속성을 VisualElement에서 상속합니다.

USS 클래스

다음 표는 모든 C# 공용 프로퍼티 이름과 관련 USS 선택자의 리스트입니다.

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

추가 리소스

• 폴드아웃
• 유사 클래스