内置 Unity 变量

Unity 内置样式表定义了为编辑器和运行时 UI 指定默认值的 USS 变量。可以在自己的样式表中使用这些变量确保自定义界面与 Unity 样式相匹配。

有关特定变量的信息，请参阅内置 Unity 变量列表。

Unity 变量名称

Unity 对内置变量使用特定命名约定来指示如何以及在何处使用这些变量。变量名称由一个或多个部分组成（以连字符分隔）。每个部分由一个或多个的单词组成（以下划线分隔）。

--unity-{组}-{角色和控件}-{子元素}-{伪状态序列}

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

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

例如，以下变量名称：

--unity-colors-button-text-hover

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

	值：	含义：
Group	colors	变量表示颜色数据。
角色/控件	button	变量影响按钮。
子元素	text	变量影响文本。因为其组是 colors，所以您知道它会影响文本颜色。
伪状态	hover	Unity 使用变量时所采用的样式会在鼠标指针悬停在元素上方时应用于元素。

换句话说，Unity 使用变量时所采用的样式会在用户将鼠标悬停在按钮上方时更改按钮文本颜色。

本部分的其余内容提供有关变量名称格式每个部分的详细信息。

组

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

Unity 变量名称可以包含以下组：

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

角色和控件

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

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

每个 Unity 变量都具有一个角色或控件。它不能同时具备两者。

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

角色：

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

控件：

控制：	描述：
app_toolbar	Unity 主工具栏
app_toolbar_button	Unity 主工具栏中的按钮
box	在编辑器 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) 除外
toolbar_button	编辑器工具栏中的按钮
window	Editor 窗口

子元素

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

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

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	控件处于选定状态

内置 Unity 变量的列表

---