Встроенные переменные Unity

Встроенные таблицы стилей Unity определяют USS переменные, которые задают значения по умолчанию для редактора и среды выполнения UI(пользовательский интерфейс) Позволяет пользователю взаимодействовать с вашим приложением. Подробнее
См. в Словарь. Вы можете использовать эти переменные в своих собственных таблицах стилей, чтобы убедиться, что ваши пользовательские интерфейсы соответствуют стилю Unity.

Информацию о конкретных переменных см. в списке встроенных переменных Unity.

Имена переменных Unity

Unity использует специальное соглашение об именах для встроенных переменных, чтобы указать, как и где они используются. Имя переменной состоит из одной или нескольких частей, разделенных дефисами. Каждая часть состоит из одного или нескольких слов, разделенных символом подчеркивания.

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

Каждая часть имени говорит вам что-то о типах правил USS, в которых используется переменная.

• Группа: тип данных, которые представляет переменная.
• Роль/Контроль: концептуальная группировка элементов, на которые влияет переменная.
• Подэлемент: часть элемента или элемента управления, на который влияет переменная.
• Псевдосостояния: перечисляет состояния, для которых Unity использует переменную.

Например, следующее имя переменной:

--unity-colors-button-text-hover

Предоставляет следующую информацию о том, как Unity использует переменную:

	Значение:	Значение:
Group	colors	Переменная представляет данные о цвете.
Role/Control	button	Переменная влияет на кнопки.
Sub-Element	text	Переменная влияет на текст. Поскольку его group имеет colors, вы знаете, что это влияет на цвет текста.
Pseudo-States	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	Выделенные части пользовательского интерфейса. Например, выделение текста или выбранные элементы в представлениях в виде дерева.
link	Части пользовательского интерфейса (обычно текстовые), которые являются интерактивными ссылками. Это ненажатое состояние.
play_mode	Элементы, отображаемые, когда редактор находится в режиме воспроизведения.
visited_link	Части пользовательского интерфейса, обычно текстовые, представляющие собой интерактивные ссылки, по которым пользователь уже нажимал..
warning	Элементы, передающие предупреждающее сообщение пользователям.

Элементы управления:

Управление:	Описание:
app_toolbar	Основная панель инструментовряд кнопок и основных элементов управления в верхней части редактора Unity, который позволяет вам взаимодействовать с редактором в различными способами (например, масштабирование, перевод). More info See in Словарь
app_toolbar_button	Кнопки на главной панели инструментов Unity
box	Блоки, используемые для группировки элементов в пользовательском интерфейсе редактора.
button	Кнопки в пользовательском интерфейсе, кроме панелей инструментов
dropdown	Выпадающие списки или меню
helpbox	Поля, используемые для отображения справочной информации
input_field	Поля, используемые для ввода текста или числовых значений
label	Текстовые метки в пользовательском интерфейсе редактора
object_field	Поля, используемые для значений объектов. Например, значения свойств для GameObjectосновного объекта в сценах Unity, который может представлять персонажей, реквизит, декорации, камеры, путевые точки. , и более. Функциональность GameObject определяется прикрепленными к нему компонентами. Подробнее См. в Словаре или Активе.
popup	Всплывающее меню и другие всплывающие элементы управления
preview	Представления, используемые для отображения превью. Например, такие активы, как сетки и текстуры..
scrollbar_groove	Фоновый элемент полосы прокрутки, в котором пользователи перетаскивают ползунок полосы прокрутки.
scrollbar_thumb	Перетаскиваемый элемент ручки в полосе прокрутки
slider_groove	Фоновый элемент ползунка, в котором пользователи перетаскивают бегунок ползунка.
slider_thumb	Перетаскиваемый элемент ручки в ползунке
slider_thumb_halo	Наложение, отображаемое вокруг бегунка ползунка, когда пользователь перетаскивает его
tab	Элементы вкладок в элементах управления вкладками
toolbar	Любая панель инструментов редактора, кроме основной панели инструментов Unity. (app_toolbar)
toolbar_button	Кнопки на панели инструментов редактора
window	Окна редактора

Подэлемент

Подэлемент — это часть элемента, на которую влияет переменная. Вместе с группой переменной подэлемент сообщает вам, какие именно данные представляет переменная.

Например, когда вы видите имя переменной с группой colors и подэлементом text, это означает Unity использует переменную в стилях, влияющих на цвет текста.

Имена переменных Unity могут иметь следующие подэлементы:

Группа:	Подэлемент:	Описание:
colors
	background	Цвет фона элемента
	border	Цвет внешней границы элемента
	border_accent	Цвет внутренней границы элемента. Например, Inspectorокно 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 использует переменную.

Например, если вы видите имя переменной с псевдосостоянием hover, это означает, что Unity использует эту переменную в стилях, влияющих на элементы, когда пользователь наводит на них указатель.

Например: --unity-colors-toolbar_button-text-hover.

Имя переменной может иметь более одного псевдосостояния. Несколько псевдосостояний отображаются в алфавитном порядке, разделенные символом подчеркивания _.

Например: --unity-colors-toolbar_button-text-focus_selected.

Имена переменных Unity могут иметь любую комбинацию следующих псевдосостояний:

Псевдосостояние:	Описание:
(none)	Нормальное состояние
checked	Проверяется элемент управления флажком
disabled	Элемент управления отключен
focus	Элемент управления имеет фокус
hover	Пользователь наводит курсор на элемент управления
inactive	Элемент управления не имеет фокуса
pressed	Элемент управления нажат
selected	Элемент управления выбран

Список встроенных переменных Unity