Version: 2021.3
언어: 한국어
USS 선택자
복잡 선택자

단순 선택자

USS는 다음의 단순 선택자를 지원합니다.

  • C# 타입 선택자는 특정 C# 타입의 요소와 매칭됩니다.
  • USS 클래스 선택자는 할당된 USS 클래스가 있는 요소와 매칭됩니다.
  • 이름 선택자는 할당된 name 속성이 있는 요소와 매칭됩니다.
  • 범용 선택자는 모든 요소와 매칭됩니다.

단순 선택자를 복잡 선택자로 조합하거나, 유사 클래스를 추가하여 특정 상태의 요소를 타게팅할 수 있습니다.

이 페이지에서는 단순 선택자의 각 타입을 설명하고 구문과 예제를 제공합니다. 다음 UXML 문서를 사용하여 단순 선택자와 요소를 매칭하는 방법을 확인할 수 있습니다.

<UXML xmlns="UnityEngine.UIElements">
  <VisualElement name="container1">
    <VisualElement name="container2" class="yellow">
      <Button name="OK" class="yellow" text="OK" />
      <Button name="Cancel"class="" text="Cancel" />
    </VisualElement>
  </VisualElement>
</UXML>

적용된 스타일이 없으면 UXML 문서는 아래 표시된 UI를 생성합니다.

참고:
예제 이미지에는 데모 목적으로 개별 요소를 식별하는 데 도움이 되는 여백과 가느다란 파란색 테두리가 표시되어 있습니다.

C# 타입 선택자

C# 타입 선택자는 해당 C# 타입을 기반으로 요소와 매칭됩니다.

참고:
USS 타입 선택자는 HTML 태그와 매칭되는 CSS 타입 선택자와 유사합니다. 예를 들어 USS의 Button {...}은 CSS의 p {...}가 단락(<p>) 태그와 매칭되는 것과 동일한 방식으로 C# 타입의 Button 버튼 요소와 매칭됩니다.

구문:

C# 타입 선택자는 C# 타입 이름으로, 있는 그대로 작성됩니다

TypeName { ... }

C# 타입 선택자를 작성할 때는 구체적인 오브젝트 타입을 지정해야 합니다. 타입 이름에는 네임스페이스를 포함하지 마십시오.

예를 들어 다음 선택자는 유효합니다.

Button { ... }

다음 선택자는 유효하지 않습니다.

UnityEngine.UIElements.Button { ... }

예제:

위의 예제 UXML 문서에서는 다음의 스타일 규칙이 두 개의 Button 요소와 매칭됩니다.

Button {
  border-radius: 8px;
  width: 100px;
  }

이름 선택자

이름 선택자는 할당된 name 속성의 값을 기반으로 요소와 매칭됩니다.

  • C#에서 VisualElement.name을 사용하여 요소의 이름을 설정합니다.
  • UXML에서 <VisualElement name="my-nameName"> 이름 속성을 요소에 부여할 수 있습니다.

Unity는 이름에 대한 규칙을 적용하지 않지만, 패널 내에서 요소 이름을 고유하게 만들어야 합니다. 고유하지 않은 이름을 사용하면 예기치 않은 매칭이 발생할 수 있습니다.

참고:
USS 이름 선택자는 특정 id 속성이 있는 요소와 매칭되는 CSS ID 선택자와 유사합니다.

구문:

이름 선택자는 앞에 숫자 기호(#)가 붙은 요소의 할당된 이름으로 구성됩니다.

# name { ... }
참고:
USS 파일에 선택자를 작성할 때는 숫자 기호(#)만 사용하고, UXML 또는 C# 파일에서 요소에 이름을 할당할 때에는 숫자 기호를 사용하지 마십시오. 숫자 기호가 포함된 요소 이름은 유효하지 않습니다.

예를 들어 <Button name="OK" />는 유효하지만, <Button name="#OK" />는 유효하지 않습니다.

예제:

위의 예제 UXML 문서에서는 다음의 스타일 규칙이 두 번째 Button 요소와 매칭됩니다.

# Cancel {
    border-width: 2px;
    border-color: DarkRed;
    background-color: pink;
}

USS 클래스 선택자

클래스 선택자는 특정 USS 클래스가 할당한 요소와 매칭됩니다.

참고:
클래스 선택자는 CSS에서와 동일한 방식으로 USS에서 작동합니다.

구문:

클래스 선택자는 마침표(.)로 시작하는 클래스명으로 구성됩니다. 클래스명은 숫자로 시작할 수 없습니다.

.class { ... }
참고:
마침표(.)는 USS 파일에 선택자를 작성할 때에만 사용됩니다. UXML 또는 C# 파일에서 요소에 클래스를 할당할 때에는 포함하지 마십시오.
예를 들어 <Button class="yellow" />는 사용하고 <Button class=".yellow" />는 사용하지 마십시오.

마침표는 클래스명에 사용하지 마십시오. Unity의 USS 파서는 마침표를 새로운 클래스의 시작으로 해석합니다.

예를 들어 yellow.button이라는 클래스를 생성하고 다음 USS 규칙을 사용하는 경우가 있을 수 있습니다.

.yellow.button{...}

이 경우 파서는 선택자를 다중 선택자로 해석하고, .yellow 클래스와 .button 클래스 둘 다와 매칭되는 요소를 찾습니다.

요소에 두 개 이상의 클래스가 할당된 경우 선택자는 요소와 매칭되기 위해 이 중 하나와만 매칭되어야 합니다.

선택자에서 여러 클래스를 지정할 수도 있습니다. 이 경우 요소는 매칭을 위해 해당 클래스를 모두 할당해야 합니다. 자세한 내용은 다중 선택자를 참조하십시오.

예제:

위의 예제 UXML 문서에서는 다음의 스타일 규칙이 container2라는 요소와 OK라는 버튼 요소와 매칭되고, 해당 배경 컬러를 노란색으로 변경합니다.

.yellow {
    background-color: yellow;
}

범용 선택자

때때로 와일드카드 선택자라고도 불리는 범용 선택자는 모든 요소와 매칭됩니다.

구문:

* { ... }

예제:

위의 예제 UXML 문서에서는 다음의 스타일 규칙이 모든 요소와 매칭되고, 해당 배경 컬러를 노란색으로 변경합니다. 여기에는 창의 메인 영역이 포함되는데, 이는 스타일시트가 창의 루트 요소에 적용되었기 때문입니다.

* {
    background-color: yellow;
}
참고:
범용 선택자는 모든 요소를 테스트하므로 성능에 영향을 미칠 수 있습니다. 따라서 범용 선택자는 되도록 적게 사용하고, 자손 선택자와 함께 사용하지 마십시오. 해당 조합을 사용하면 시스템이 많은 요소를 반복적으로 테스트해야 하므로 성능에 영향을 미칠 수 있습니다.

복잡 선택자에서 범용 선택자 사용

복잡 선택자에 범용 선택자를 포함할 수 있습니다. 예를 들어 다음 USS 규칙은 자식 선택자에서 범용 선택자를 사용하여 USS 클래스 yellow가 할당된 요소의 자식인 모든 버튼과 매칭됩니다.

.yellow > * > Button{..}

USS 선택자
복잡 선택자