USS 内置变量指定 Editor 和运行时__ UI__(即用户界面,User Interface)让用户能够与您的应用程序进行交互。Unity 目前支持三种 UI 系统。更多信息
See in Glossary 的默认值。可以在自己的 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 内置变量会更改按钮文本的颜色。
组指定变量表示的数据类型。每个组都有几个可能的子元素。
Unity 变量名称包含以下组:
| 组 | 用于 |
|---|---|
colors |
颜色属性,例如 background-color 和 border-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 |
控件处于选定状态 |