Version: 6000.3
语言: 中文
类型选择器
类选择器

名称选择器

USS 名称选择器根据元素的名称匹配元素。USS 名称选择器类似于 CSS ID 选择器,用于匹配具有特定id属性。

要设置元素的名称:

  • 在 C# 脚本中,使用VisualElement.name.
  • 在 UXML 中,使用name属性。例如:<VisualElement name="my-nameName">.

为避免意外匹配,请在面板中使元素名称唯一。

语法

名称选择器由元素的指定名称组成,前缀为数字符号 ()。#

#ElementName { ... }

注意:仅在将选择器写入 USS 文件时才使用数字符号 ()。将名称分配给 UXML 或 C# 文件中的元素时,请勿使用它。包含数字符号的元素名称无效。例如#<Button name="#OK" />无效。

为了演示简单选择器如何匹配元素,下面是一个示例 UI 文档。

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

未应用任何样式的情况下,UI 如下所示:

带有边距和蓝色细边框的按钮示例。
带有边距和蓝色细边框的按钮示例。

以下名称选择器样式规则与第二个Button元素。

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

应用样式时,UI 如下所示:

取消按钮具有深红色边框和粉红色背景。
取消按钮具有深红色边框和粉红色背景。

其他资源

类型选择器
类选择器