USS 内置变量简介

USS 内置变量为编辑器和运行时 UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。更多信息
参见术语表指定默认值。您可以在自己的 USS 中使用这些变量，以使您的自定义界面与 Unity 样式相匹配。

每个内置变量的名称都指示变量如何以及在何处使用。变量名由一个或多个部分组成，部分之间用连字符分隔。每个部分由一个或多个单词组成，单词之间用下划线分隔。

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

名称的每个部分都显示使用该变量的 USS 规则的类型。

例如，以下变量名

--unity-colors-button-text-hover

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

	值	含义
组	`colors`	表示颜色数据。
角色/控件	`button`	影响按钮。
子元素	`text`	影响文本。它的 `group` 为 `colors`，因此它影响文本颜色。
伪状态	`hover`	应用于鼠标指针悬停在其上的元素。

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

组

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

变量名具有以下组

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

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

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

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

角色

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

控件

控件	描述
`app_toolbar`	主要的 Unity 工具栏Unity 编辑器顶部的按钮和基本控件行，允许您以各种方式与编辑器交互（例如缩放、平移）。更多信息参见术语表
`app_toolbar_button`	主 Unity 工具栏中的按钮
`box`	用于在编辑器 UI 中对元素进行分组的框
`button`	UI 中的按钮，工具栏除外
`dropdown`	下拉列表或菜单
`helpbox`	用于显示帮助信息的框
`input_field`	用于输入文本或数值的字段
`label`	编辑器 UI 中的文本标签
`object_field`	用于对象值的字段。例如，游戏对象Unity 场景中的基本对象，可以表示角色、道具、场景、摄像机、路径点等等。游戏对象的功用由附加在其上的组件定义。更多信息参见术语表或资源的属性值。
`popup`	弹出菜单和其他弹出控件
`preview`	用于显示预览的视图。例如，网格和纹理等资源的预览。
`scrollbar_groove`	滚动条的背景元素，用户可以在其中拖动滚动条滑块
`scrollbar_thumb`	滚动条中可拖动的句柄元素
`slider_groove`	滑块的背景元素，用户可以在其中拖动滑块滑块
`slider_thumb`	滑块中可拖动的句柄元素
`slider_thumb_halo`	用户拖动滑块滑块时在其周围显示的叠加层
`tab`	选项卡控件中的选项卡项
`toolbar`	除主 Unity 工具栏 (`app_toolbar`) 之外的任何编辑器工具栏
`toolbar_button`	编辑器工具栏中的按钮
`window`	编辑器窗口

子元素是变量影响的元素的一部分。与变量的 group 结合使用，子元素显示变量表示的数据类型。

例如，当您看到具有 colors 组和 text 子元素的变量名时，这意味着 Unity 在影响文本颜色的样式中使用该变量。

变量名具有以下子元素

组	子元素	描述
`colors`
	`background`	元素的背景颜色
	`border`	元素的外边框颜色
	`border_accent`	元素的内边框颜色。例如，检查器一个 Unity 窗口，显示有关当前选定的游戏对象、资源或项目设置的信息，允许您检查和编辑值。更多信息参见术语表窗口具有双色边框
	`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 变量名可以具有以下伪状态的任意组合

创建 USS 变量

USS 内置变量参考