Введение во встроенные переменные USS
USS встроенный переменные указать значения по умолчанию для Редактора и времени выполнения UI. Вы можете использовать эти переменные в своих собственных USS чтобы соответствовать ваши пользовательские интерфейсы с Unity стиль.
Имя каждой встроенной переменной указывает, как и где переменная используется. Имя переменной состоит из одной или нескольких частей, разделенных дефисами. Каждая часть состоит из одного или нескольких слов, разделенных подчеркиванием.
--unity-{group}-{role_and_control}-{sub_element}-{pseudo_state_sequence}
Каждая часть имени показывает типы правил USS, которые используют данную переменную.
- Группа: Тип данных, которые представляет переменная.
- Роль/Управление: Концептуальная группа элементов, на которые влияет переменная.
- Подэлемент: Элемент или элемент управления, на который влияет переменная.
- Псевдо-состояния: Перечисляет состояния, для которых Unity использует переменные.
Например, следующее имя переменной:
--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 |
Роль и контроль
Роли и элементы управления являются двумя способами концептуальной группировки элементов.
- Роль относится к группе элементов, которые имеют одну и ту же цель, независимо от типа каждого элемента. Например,
errorроль включает все элементы, отображающие сообщения об ошибках для пользователей. - Управление относится к группе элементов одного типа, независимо от того, что они делают. Например,
buttonsвключает все кнопки в Редакторе.
Каждая переменная имеет либо роль, либо контроль.
Имена переменных имеют следующие роли и элементы управления:
Роли
| Роль | Описание |
|---|---|
default |
Настройки стиля по умолчанию, такие как цвет текста, фон и поля. |
alternated_rows |
Элементы, отображающие табличные данные с чередованием цветов строк. Например, элементы списка в представлении списка. |
error |
Элементы, сообщающие пользователям о состояниях ошибок. |
highlight |
Выделенные части UI. Например, выбор текста или выбранные элементы в дереве представлений. |
link |
Части интерфейса (обычно текст), которые являются ссылками и на которые можно нажать. Это не состояние нажатия. |
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 |
Поля, используемые для значений объектов. Например, значения свойств для GameObject или Asset. |
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 использует эту переменный в стилях, которые влияют на цвет текста.
Имена переменных имеют следующие подэлементы:
Группа цветов
| Подэлемент | Описание |
|---|---|
background |
Цвет фона элемента |
border |
Цвет внешней границы элемента |
border_accent |
Цвет внутренней границы элемента. Например, окна Inspector имеют двухцветную границу |
text |
Цвет текста для элементов, отображающих текст |
Метрическая группа
| Подэлемент | Описание |
|---|---|
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 |
Значения ширины и высоты элемента |
Псевдогосударства
Псевдо-state последовательность представляет собой список UI состояний, для которых Unity использует переменную.
Например, если вы видите имя переменной с псевдонимом hover состояние, это означает, что Unity использует эту переменную в стилях, которые влияют на элементы, когда пользователь наводит на них указатель мыши.
Например: --unity-colors-toolbar_button-text-hover.
Имя переменной может иметь более одного псевдо-state. Несколько псевдо-состояний появляются в алфавитном порядке, разделенные подчеркиванием _.
Например: --unity-colors-toolbar_button-text-focus_selected.
Имена переменных Unity могут иметь любую комбинацию из следующих псевдо-состояний:
| Псевдоним состояния | Описание |
|---|---|
| (нет) | Обычное состояние |
checked |
Управляющий элемент типа флажок установлен |
disabled |
Управление отключено |
focus |
Контроль имеет фокус |
hover |
Пользователь перемещает курсор мыши над элементом управления |
inactive |
Управление не имеет фокуса |
pressed |
Нажатие кнопки управления |
selected |
Выбранный элемент управления |