Version: Unity 6.0 (6000.0)
语言 : 中文
创建 USS 变量
USS 内置变量引用

USS 内置变量简介

USS 内置变量指定 Editor 和运行时__ UI__(即用户界面,User Interface)让用户能够与您的应用程序进行交互。Unity 目前支持三种 UI 系统。更多信息
See in Glossary
的默认值。可以在自己的 USS 中使用这些变量,以使自定义界面与 Unity 样式相匹配。

每个内置变量的名称指示变量的使用方式和位置。变量名称由一个或多个部分组成(以连字符分隔)。每个部分由一个或多个的单词组成(以下划线分隔)。

--unity-{group}-{role_and_control}-{sub_element}-{pseudo_state_sequence}

名称的每个部分都告知有关使用变量的 USS 规则的类型。

  • :变量表示的数据类型。
  • 角色/控件:变量影响的元素的概念分组。
  • 子元素:变量影响的元素或控件。
  • 伪状态:列出 Unity 使用该变量的状态。

例如,以下变量名称:

--unity-colors-button-text-hover

提供有关 Unity 如何使用变量的以下信息:

含义
colors 表示颜色数据。
角色/控制 button 影响按钮。
子元素 text 影响文本。其 groupcolors,因此会影响文本颜色。
伪状态 hover 应用于鼠标指针悬停在元素上时的元素。

当用户将鼠标悬停在按钮上时,此 USS 内置变量会更改按钮文本的颜色。

组指定变量表示的数据类型。每个组都有几个可能的子元素

Unity 变量名称包含以下组:

用于
colors 颜色属性,例如 background-colorborder-color
metrics 控制尺寸和形状的属性。例如 border-radius, border-width, margin, 和 padding
icons 标准 Unity 图标图像

角色和控件

角色和控件是在概念上对元素进行分组的两种方式。

  • 角色指一组具有相同用途的元素,与每个元素所属的类型无关。例如,error 角色包括向用户显示错误消息的所有元素。
  • 控件指一组类型相同的元素,与其用途无关。例如,buttons 包括 Editor 中的所有按钮。

每个变量都具有一个角色或控件。

变量名称可以具有以下角色和控件:

角色

角色 描述
default 默认样式设置,例如文本颜色、背景和边距。
alternated_rows 显示具有交替行颜色的表格数据的元素。例如,列表视图中的列表项。
error 向用户传达错误状态的元素。
highlight 突出显示的 UI 部分。例如,文本选择或树视图中的选定项。
link 作为可单击链接的 UI 部分(通常是文本)。这是未单击状态。
play_mode Editor 处于播放模式时显示的元素。
visited_link 作为用户已单击的可单击链接的 UI 部分(通常是文本)。
warning 向用户传达警告消息的元素。

控件

控件 描述
app_toolbar Unity 主工具栏
app_toolbar_button Unity 主工具栏中的按钮
box 用于在 Editor UI 中给元素分组的框
button UI 中的按钮(工具栏除外)
dropdown 下拉列表或菜单 helpbox 用于显示帮助信息的框
input_field 用于输入文本或数值的字段
label 编辑器 UI 中的文本标签
object_field 用于对象值的字段。例如,游戏对象或资源的属性值。
popup 弹出菜单和其他弹出控件
preview 用于显示预览的视图。例如,网格和纹理等资源的预览。
scrollbar_groove 用户在其中拖动滚动条滑块的滚动条的背景元素
scrollbar_thumb 滚动条中的可拖动手柄元素
slider_groove 用户在其中拖动滑动条滑块的滑动条的背景元素
slider_thumb 滑动条中的可拖动手柄元素
slider_thumb_halo 用户拖动滑动条时显示在滑动条滑块周围的覆盖层
tab 选项卡控件中的选项卡项
toolbar 除 Unity 主工具栏 (app_toolbar) 之外的任何 Editor 工具栏
toolbar_button 编辑器工具栏中的按钮
window 编辑器窗口

子元素

子元素是变量影响的元素的一部分。子元素与变量的 group 相结合,可确切告知变量表示的数据类型。

例如,在看到具有 colors 组和 text 子元素的变量名称时,这表示 Unity 使用变量时所采用的样式会影响文本颜色。

变量名称包含以下子元素:

子元素 描述
colors
background 元素的背景颜色
border 元素的外边框颜色
border_accent 元素的内边框颜色。例如,Inspector 窗口具有双色调边框
text 显示文本的元素的文本颜色
metrics
margin_{left, top, right, bottom} 元素的边距值
padding_{left, top, right, bottom} 元素的填充值
border_{left, top, right, bottom}_width 元素的边框宽度值
border_{left_top, left_bottom, right_top, right_bottom}_radius 元素的边框半径值
width, height 元素的宽度和高度值

伪状态

伪状态序列是 Unity 对其使用变量的 UI 状态列表。

例如,看到具有 hover 伪状态的变量名称时,这表示 Unity 使用变量时所采用的样式会在用户将指针悬停在元素上方时影响元素。

例如:--unity-colors-toolbar_button-text-hover

变量名可以具有多个伪状态。多个伪状态按字母顺序出现(以下划线 _ 分隔)。

例如:--unity-colors-toolbar_button-text-focus_selected

Unity 变量名称可以具有以下伪状态的任意组合:

伪状态 描述
(无) 正常状态
checked 复选框类型控件处于选中状态
disabled 控件处于禁用状态
focus 控件具有焦点
hover 用户将鼠标悬停在控件上方
inactive 控件没有焦点
pressed 控件被按下
selected 控件处于选定状态

其他资源

创建 USS 变量
USS 内置变量引用