ListView
ListView — это вертикально прокручиваемая область, которая связывает и отображает список элементов.
Примечание: Горизонтальные и вертикальные элементы Scroller являются стандартными UI Toolkit Scrollers.
Создать ListView
Вы можете создать ListView с UI Builder, UXML и C#. Следующий пример C# создает ListView:
var listView = new ListView();
ListView против ScrollView
Вы можете использовать ScrollView управления, чтобы создать те же функции, что и при использовании ListView. Однако ListView более эффективным, чем ScrollView когда вы выполняете следующие действия:
- Заполнение элементов списка
- Управление высотой элемента
- Привязка и развязка к объектам
- Создание экземпляров количества визуальных элементов, необходимых для заполнения страницы
- Переработка визуальных элементов для оптимизации обработки памяти
Обновить представление коллекции
Чтобы обновить представление коллекции, вы можете вызвать либо RefreshItems/RefreshItem или Rebuild.
Как правило, вызов метода RefreshItems или RefreshItem — эти методы обновляют только представление коллекции и менее дорогостоящи. Если вызов метода Rebuild, представление коллекции полностью перестроено, что может быть дорогостоящим.
Однако вы должны вызвать Rebuild в следующих случаях:
- Вы меняете тип источник данных, например при переходе от
List<float>к аList<Vector3>. - Вы изменяете
makeItemилиdestroyItem.
Установить высоту элемента
Чтобы изменить, как высота элемента используется для управления содержанием, используйте VirtualizationMethod:
VirtualizationMethod.FixedHeightустанавливает для всех элементов одинаковую высоту.VirtualizationMethod.DynamicHeightпозволяет элементам иметь различные высоты.
Контроль скорости прокрутки
ListView имеет встроенный дочерний элемент ScrollView, который позволяет пользователям прокручивать список. Вы можете управлять скоростью прокрутки с помощью , переопределяя свойства mouseWheelScrollSize, horizontalPageSizeи verticalPageSize ScrollView с помощью C#.
Сделать список изменяемым
По умолчанию контроль ListView не может быть переупорядочен. Чтобы сделать его переупорядоченным, установите свойство reorderable на true в UI Builder, UXML или C#.
listView.reorderable = true;
Реализация операций перетаскивания для ListView
Перетаскивание — распространённый приём в проектировании интерфейсов. Чтобы реализовать операции перетаскивания, переопределите следующие методы:
- Чтобы включить перетаскивание элементов, переопределите
canStartDrag. - Чтобы задать, какие элементы перетаскиваются, переопределите
setupDragAndDrop. - Чтобы получать изменения статуса элементов, переопределите
dragAndDropUpdate. Вы можете выполнять определенные действия на основе положения перетаскивания или других условий. - Чтобы управлять поведением перетаскивания, переопределите
handleDrop.
Во время операции перетаскивания вы можете включить перестановку элементов путем перетаскивания. Чтобы включить эту функцию, установите атрибут reorderable на true в UI Builder, UXML и C#.
См. Создание списка перетаскивания и дерева представлений между окнами для примера.
Используйте контроллер и навигацию клавиатуры с ListView
Чтобы включить навигацию контроллера и клавиатуры с помощью ListView, выполните следующие действия:
- Включить режим выбора: Установите Тип выбора на Одиночный или Несколько в Inspector (или
selectionTypeв C#). События навигации с клавиатуры и контроллера привязаны к состоянию выделения. Если отключить выделение, список эти события ввода игнорирует. - Установить первоначальный фокус: UI Toolkit не всегда даёт ListView фокус при запуске, поэтому список может не получать клавиши, пока что-то не фокусируется. Чтобы получать события клавиатуры или контроллера без предварительного щелчка мыши, вызовите
listView.Focus()через скрипт (например, в обратном вызовеAttachToPanelEvent). - Настройка ввода для времени выполнения UI: Время выполнения см. в Runtime UI система событий и обработка ввода для подключения системы ввода к UI Toolkit, и далее Настройка обработки ввода с помощью Input System пакет настроить проект UI действия (D-pad, стрелки и другие навигационные). Input System пакет UI поддержка тема описывает каждое UI действия. Настройки панели, см. Настройка среды выполнения UI. В панелях Редактора клавиши со стрелками автоматически преобразуются в события навигации без дополнительной настройки.
ListView FAQs
Ниже приведены некоторые часто задаваемые вопросы об управлении ListView.
Могу ли я получить список строк, которые видны в представлении?
Для этого нет выделенных APIs. Вы можете использовать UQuery для получения интересующих элементов.
Обязательно ли для любой из переопределенных функций контроллера вида вызывать base.Method?
Вызывайте этот метод только в том случае, если требуется расширить его поведение по умолчанию.
Я добавил Toggle в мою строку. Почему выбор не переходит в эту строку, когда пользователь выбирает его?
По умолчанию, строка выбирается только в том случае, если событие нажатия мыши не потребляется содержимым строки. В этом случае ваш Toggle останавливает распространение события. Чтобы исправить это, зарегистрируйте обратный вызов PointerDownEvent с TrickleDown на Toggle, чтобы вызвать SetSelection.
Как получить обратный вызов, когда пользователь изменяет свой выбор в представлении?
Рекомендуется использовать обратный вызов selectedIndicesChanged для получения данных по индексу, когда это необходимо. Хотя вы также можете использовать selectionChanged, помните, что он возвращает список объектов, что может привести к выделению блоков при использовании с типами значений.
Могу ли я получить индексы строк, которые видны на экране?
Для этого нет выделенного APIs. Вы можете использовать обратные вызова bindItem и unbindItem для отслеживания этих индексов в userData.
Могу ли я иметь горизонтальный ListView?
Контроллер ListView не поддерживает горизонтальное расположение и виртуализацию. Рекомендуется использовать ScrollView с flex-direction: row для горизонтального расположения элементов. Однако применение этого к ListView нарушает виртуализацию.
Примеры
Следующий пример UXML создает ListView:
<UXML xmlns="UnityEngine.UIElements">
<ListView class="the-uxml-listview" fixed-item-height="20" />
</UXML>
Следующий пример USS стилизует ListView:
.the-uxml-listview {
height: 200px;
}
.unity-list-view__item-content > .unity-label {
flex-grow: 1;
margin-top: 2px;
}
Следующий пример C# иллюстрирует некоторые из настраиваемых функций ListView:
// Create some list of data, here simply numbers in interval [1, 1000]
const int itemCount = 1000;
var items = new List<string>(itemCount);
for (var i = 0; i < itemCount; i++)
items.Add(i.ToString());
// The "makeItem" function will be called as needed
// when the ListView needs more items to render
Func<VisualElement> makeItem = () => new Label();
// As the user scrolls through the list, the ListView object
// will recycle elements created by the "makeItem"
// and invoke the "bindItem" callback to associate
// the element with the matching data item (specified as an index in the list)
Action<VisualElement, int> bindItem = (e, i) => ((Label)e).text = items[i];
var listView = container.Q<ListView>();
listView.makeItem = makeItem;
listView.bindItem = bindItem;
listView.itemsSource = items;
listView.selectionType = SelectionType.Multiple;
// Callback invoked when the user double clicks an item
listView.itemsChosen += (selectedItems) =>
{
Debug.Log("Items chosen: " + string.Join(", ", selectedItems));
};
// Callback invoked when the user changes the selection inside the ListView
listView.selectedIndicesChanged += (selectedIndices) =>
{
Debug.Log("Index selected: " + string.Join(", ", selectedIndices));
// Note: selectedIndices can also be used to get the selected items from the itemsSource directly or
// by using listView.viewController.GetItemForIndex(index).
};
Чтобы попробовать этот пример в реальном времени в Unity, перейдите в Окно > UI Toolkit > Образцы. Для дополнительных примеров, см. следующее:
- Создание представлений списка и дерева: Используйте ListView, TreeView, MultiColumnListView и MultiColumnTreeView для создания представлений списка и дерева.
- Создание представления сложного списка: Используйте ListView для создания настраиваемого окна Редактора со списком символов.
- Привязать к списку с помощью ListView: Создать список переключателей и привязать этот список к лежащему в основе списку объектов
GameSwitch. - Создание перетаскиваемого списка и дерева представлений между окнами: Используйте ListView, TreeView и MultiColumnListView для создания перетаскиваемого UI между окнами.
Базовый класс C# и пространство имён
C# класс: ListView
Пространство имен: UnityEngine.UIElements
Базовый класс: BaseListView
Атрибуты члена UXML
Этот элемент имеет следующие атрибуты члена:
| Имя | Тип | Описание |
|---|---|---|
item-template |
UIElements.VisualTreeAsset |
A UXML шаблон, который конструирует каждый переработанный и отброшенный элемент в списке. Этот шаблон предназначен для замены makeItem определение.Вы можете использовать его вместе с BaseListView.bindingSourceSelectionMode и привязки, чтобы иметь полностью бескодовый рабочий процесс. |
Унаследованные атрибуты UXML
Этот элемент наследует от своего базового класса следующие атрибуты:
| Имя | Тип | Описание |
|---|---|---|
allow-add |
boolean |
Это свойство позволяет пользователю разрешить или запретить добавление элемента при нажатии кнопки Добавить. Оно должно возвращать true или false.Если обратный вызов не установлен на false, то любая операция Добавить будет разрешена. |
allow-remove |
boolean |
Это свойство позволяет пользователю разрешать или блокировать удаление элемента при нажатии кнопки Удалить. Оно должно возвращать true или false.Если свойство не установлено на false, то любая операция Удалить будет разрешена. |
binding-path |
string |
Путь к целевому свойству для привязки. |
binding-source-selection-mode |
UIElements.BindingSourceSelectionMode |
Это свойство управляет тем, будет ли каждый элемент в списке автоматически получать настройку источника данных для правильного элемента в источнике коллекции. При установке в AutoAssignобратные вызова bind не нужно указывать, так как связи могут использоваться для заполнения элементов. |
fixed-item-height |
float |
Высота отдельного элемента в списке, в пикселях. Это свойство должно быть установлено при использовании virtualizationMethod, значением которого является FixedHeight, для того, чтобы функционировало представление коллекции. Если это свойство установлено, когда virtualizationMethod является DynamicHeight, оно служит высотой по умолчанию для вычисления необходимого количества элементов и области прокрутки, прежде чем элементы будут расположены. Его следует установить на минимальную ожидаемую высоту элемента. |
focusable |
boolean |
Если false, то элемент не может быть фокусирован. Элемент может быть фокусирован только в том случае, если его свойство canGrabFocus имеет значение true. |
header-title |
string |
Это свойство управляет текстом развернутого заголовка при использовании showFoldoutHeader.Если установлен обратный вызов makeHeader, это свойство переопределяется и заголовок не отображается. |
horizontal-scrolling |
boolean |
Это свойство определяет, показывает ли представление коллекции горизонтальную панель прокрутки, когда ее содержимое не вписывается в видимую область. |
reorder-mode |
UIElements.ListViewReorderMode |
Это свойство управляет режимом перетаскивания для представления списка. Значение по умолчанию — Simple. Когда это свойство установлено на Animated, Unity добавляет ручки перетаскивания перед каждым элементом, и при перетаскивании элементы выводятся с анимацией при изменении порядка. Перетаскивание нескольких элементов поддерживается только в режиме перетаскивания Simple. |
reorderable |
boolean |
Получает или устанавливает значение, указывающее, может ли пользователь перетаскивать элементы списка для изменения их порядка. Значение по умолчанию — false, которое позволяет пользователю перетаскивать элементы в другие представления и из них при реализации canStartDrag, setupDragAndDrop, dragAndDropUpdateи handleDrop. Установите это значение на true, чтобы разрешить пользователю изменять порядок элементов в списке. |
selection-type |
UIElements.SelectionType |
Управляет типом выбора. Значение по умолчанию — SelectionType.Single. При отключении выбора в представлении коллекции любой текущий выбор удаляется. |
show-add-remove-footer |
boolean |
Это свойство определяет, будет ли в представление списка добавлен нижний колонтитул. Значение по умолчанию false. Когда это свойство установлено на true, Unity добавляет сноску под видом прокрутки. Эта сноска содержит две кнопки: кнопку “+”, которая при нажатии добавляет один элемент в конец вида списка. Кнопка “-”, которая при нажатии удаляет все выбранные элементы или последний элемент, если ни один не выбран. makeFooter обратный вызов задан, он переопределит это свойство. |
show-alternating-row-backgrounds |
UIElements.AlternatingRowBackground |
Это свойство определяет, будут ли цвета фона строк представления коллекции чередоваться. AlternatingRowBackground enum. |
show-border |
boolean |
Включите это свойство для отображения границы вокруг представления коллекции. Если установлено значение true, то вокруг ScrollView, используемого внутри представления коллекции, отображается граница. |
show-bound-collection-size |
boolean |
Это свойство определяет, отображается ли в списке размер коллекции (количество элементов). Значение по умолчанию — true. Когда это свойство установлено на true, ListView включает TextField для управления размером массива. |
show-foldout-header |
boolean |
Это свойство управляет тем, отображается ли в представлении списка заголовок в форме раскрывающегося массива, который может быть развернут или свернут. Значение по умолчанию — false. Когда это свойство установлено на true, Unity добавляет раскрывающийся массив в иерархию представления списка и перемещает прокручиваемый вид внутрь этого вновь созданного раскрывающегося массива. Вы можете изменить текст этого раскрывающегося массива с помощью свойства headerTitle на ListView. Если showBoundCollectionSize установлено на true, ListView включает TextField для управления размером массива. Если установлен обратный вызов makeHeader, Foldout не отображается. |
tabindex |
int |
Целое число, используемое для сортировки фокусируемых элементов в кольце фокуса. Должно быть больше или равно нулю. Установка значения tabIndex меньше 0 (например, −1) удаляет элемент из кольца фокуса и навигации по вкладкам. |
virtualization-method |
UIElements.CollectionVirtualizationMethod |
Метод виртуализации, который будет использоваться для этой коллекции, когда видна полоса прокрутки. Принимает значение из CollectionVirtualizationMethod enum.Значение по умолчанию FixedHeight. При использовании фиксированной высоты указать fixedItemHeight Фиксированная высота более эффективна, но предлагает меньше гибкости в отношении содержания. DynamicHeight, коллекция будет ждать вычисления фактической высоты. Динамическая высота более гибкая, но менее эффективная. |
Этот элемент также наследует следующие атрибуты от VisualElement:
| Имя | Тип | Описание |
|---|---|---|
content-container |
string |
Логический контейнер, в который добавляются дочерние элементы. Если к этому элементу добавляется дочерний элемент, то он добавляется в контейнер содержимого этого элемента. При итерации над VisualElement.Children При использовании элемента вместо самого элемента используется иерархия контейнера содержимого элемента. Это может привести к неожиданным результатам, например, к игнорированию элементов событиями навигации, если они не находятся непосредственно в иерархической структуре контейнера. См. IFocusRing для больше информации.Если контейнер содержимого совпадает с самим элементом, то дочерние элементы добавляются непосредственно к элементу. Это верно для большинства элементов, но может быть переопределено более сложными типами. ScrollView, например, имеет контейнер содержимого, отличающийся от самого себя. В этом случае дочерние элементы, добавленные к представлению прокрутки, добавляются вместо этого к его элементу контейнера содержа-VisualElement.Hierarchy.parent) дочерних элементов является элементом контейнера содержимого прокрутки, их логическим родителем (VisualElement.parentПоскольку некоторые фокусируемые дочерние объекты представления прокрутки не являются частью его логической иерархии, такие как его Scroller элементов, эти фокусируемые дочерние элементы не рассматриваются по умолчанию при использовании последовательной навигации. Как я могу изменить, какой элемент будет фокусироваться дальше для примера решения, если правила навигации по умолчанию не соответствуют вашим потребностям. |
data-source |
Object |
Назначает источник данных этому VisualElement, который переопределяет любой унаследованный источник данных. Этот источник данных наследуется всеми дочерними объектами. |
data-source-path |
string |
Путь от источника данных к значению. |
data-source-type |
System.Type |
Возможный тип источника данных, присваиваемый этому VisualElement. Эта информация используется UI Builder только как подсказка для определенного заполнения поля пути источника данных, когда эффективный источник данных не может быть указан во время проектирования. |
enabled |
boolean |
Возвращает true, если VisualElement разрешен локально.Этот флаг не изменяется, если VisualElement имплицитно отключен одним из родителей. Чтобы проверить это, используйте enabledInHierarchy. |
language-direction |
UIElements.LanguageDirection |
Указывает направленность текста элемента. Значение будет распространяться на дочерей элемента. Установка languageDirection на RTL может получить только базовую поддержку RTL, такую как инверсия текста. Чтобы получить более полную поддержку RTL, такую как перерыв строки, перенос слов или формирование текста, вы должны включить Усовершенствованный текстовый генератор. |
name |
string |
Имя этого VisualElement. Используйте это свойство для написания селекторов USS, которые нацелены на определенный элемент. Стандартная практика заключается в том, чтобы дать элементу уникальное имя. |
picking-mode |
UIElements.PickingMode |
Определяет, может ли этот элемент быть целью событий указателя или выбран IPanel.Pick запросов.Элементы не могут быть выбраны, если: - Они невидимы. style.display установлен на DisplayStyle.NoneЭлементы с режимом подбора PickingMode.Ignore никогда не получать псевдо-state. |
style |
string |
Задает значения стиля на VisualElement.Возвращаемые данные стиля, рассчитанные из USS файлы или встроенные стили, записанные в этот объект в C#, не представляет полностью разрешенные стили, такие как окончательная высота и ширина VisualElement. Чтобы получить доступ к этим полностью разрешенным стилям, используйте resolvedStyle.Дополнительные сведения об использовании этого свойства и всех поддерживаемых USS свойства, см. Применить стили в C# сценарии и USS ссылка на свойства страницы руководства. |
tooltip |
string |
Текст, который будет отображаться внутри информационного поля после того, как пользователь задержится над элементом небольшое время. Это поддерживается только в Редакторе UI. |
usage-hints |
UIElements.UsageHints |
Комбинация значений подсказки, которые указывают высокоуровневые предполагаемые схемы использования для VisualElement. Это свойство может быть установлено только тогда, когда VisualElement еще не является частью Panel. Как только оно становится частью Panel, это свойство становится эффективно только для чтения, и попытки изменить его будут вызывать исключение. Указание правильного UsageHints заставляет систему принимать более правильные решения о том, как обрабатывать или ускорять определенные операции на основе предполагаемой схемы использования. Обратите внимание, что эти подсказки не влияют на поведение или визуальные результаты, а только влияют на общую производительность панели и элементов внутри нее. Рекомендуется всегда рассматривать возможность указания правильного UsageHints, но помните, что некоторые UsageHints могут быть внутренне проигнорированы при определенных условиях (e.g. из-за аппаратных ограничений на целевой платформе). |
view-data-key |
string |
Используется для устойчивости данных представления, таких как развернутые состояния дерева, положение прокрутки или уровень масштаба. Этот ключ используется для сохранения и загрузки данных представления из хранилища данных представления. Если этот ключ не установлен, устойчивость отключена для связанного VisualElement. Дополнительные сведения см. в разделе Устойчивость данных представления в руководстве Unity. |
Классы USS
В таблице ниже перечислены все открытые имена свойств C# и связанные с ними селекторы USS.
| C# собственность | USS выбор | Описание |
|---|---|---|
ussClassName |
.unity-list-view |
Имя USS-класса для элементов ListView. Unity добавляет этот USS-класс к каждому экземпляру элемента ListView. Любые стили, применённые к этому классу, влияют на все ListView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
itemUssClassName |
.unity-list-view__item |
Имя USS-класса для элементов списка в элементах ListView. Unity добавляет этот USS-класс к каждому элементу списка, содержащемуся в ListView. Любые стили, применённые к этому классу, влияют на все элементы списка, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
emptyLabelUssClassName |
.unity-list-view__empty-label |
Имя USS-класса для метки, отображаемой, когда ListView пуст. Unity добавляет этот USS-класс к метке, которая отображается, если ListView пуст. Любые стили, применённые к этому классу, влияют на все пустые метки, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
reorderableUssClassName |
.unity-list-view__reorderable |
Имя USS-класса для элементов ListView с анимированным переупорядочиванием. Unity добавляет этот USS-класс к каждому экземпляру элемента ListView, когда reorderMode установлен на Animated. Любые стили, применённые к этому классу, влияют на все ListView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
reorderableItemUssClassName |
.unity-list-view__reorderable-item |
Имя USS-класса для элементов списка в ListView с анимированным переупорядочиванием. Unity добавляет этот USS-класс к каждому элементу в ListView, когда reorderMode установлен на Animated. Любые стили, применённые к этому классу, влияют на все элементы, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
reorderableItemContainerUssClassName |
.unity-list-view__reorderable-item__container |
Имя USS-класса для контейнера элементов в ListView с анимированным переупорядочиванием. Unity добавляет этот USS-класс к каждому контейнеру элементов в ListView, когда reorderMode установлен на Animated. Любые стили, применённые к этому классу, влияют на все контейнеры элементов, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
reorderableItemHandleUssClassName |
.unity-list-view__reorderable-handle |
Имя USS-класса для маркера перетаскивания в ListView с анимированным переупорядочиванием. Unity добавляет этот USS-класс к маркерам перетаскивания в ListView, когда reorderMode установлен на Animated. Любые стили, применённые к этому классу, влияют на все маркеры перетаскивания, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
reorderableItemHandleBarUssClassName |
.unity-list-view__reorderable-handle-bar |
Имя USS-класса для полосы маркера перетаскивания в ListView с анимированным переупорядочиванием. Unity добавляет этот USS-класс к каждой полосе маркера перетаскивания в ListView, когда reorderMode установлен на Animated. Любые стили, применённые к этому классу, влияют на все полосы маркера перетаскивания, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
footerUssClassName |
.unity-list-view__footer |
Имя USS-класса для нижнего колонтитула ListView. Unity добавляет этот USS-класс к элементу нижнего колонтитула в ListView. Любые стили, применённые к этому классу, влияют на все ListView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
foldoutHeaderUssClassName |
.unity-list-view__foldout-header |
Имя USS-класса для сворачиваемого заголовка ListView. Unity добавляет этот USS-класс к сворачиваемому элементу в ListView. Любые стили, применённые к этому классу, влияют на все сворачиваемые элементы, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
arraySizeFieldUssClassName |
.unity-list-view__size-field |
Имя USS-класса для поля размера ListView, когда включён показ размера привязанной коллекции Unity добавляет этот USS-класс к элементу поля размера в ListView, когда showBoundCollectionSize установлен на true. Любые стили, применённые к этому классу, влияют на все поля размера, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
arraySizeFieldWithHeaderUssClassName |
.unity-list-view__size-field--with-header |
Имя USS-класса для поля размера ListView, когда включён сворачиваемый заголовок. Unity добавляет этот USS-класс к элементу поля размера в ListView, когда showBoundCollectionSize установлен на true. Любые стили, применённые к этому классу, влияют на все поля размера, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
arraySizeFieldWithFooterUssClassName |
.unity-list-view__size-field--with-footer |
Имя USS-класса для поля размера ListView, когда включён нижний колонтитул. Unity добавляет этот USS-класс к элементу поля размера в ListView, когда showBoundCollectionSize установлен на true. Любые стили, применённые к этому классу, влияют на все поля размера, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
listViewWithHeaderUssClassName |
.unity-list-view--with-header |
Имя USS-класса для ListView, когда включён сворачиваемый заголовок. Unity добавляет этот USS-класс к ListView, когда showFoldoutHeader установлен на true. Любые стили, применённые к этому классу, влияют на все списки, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
listViewWithFooterUssClassName |
.unity-list-view--with-footer |
Имя USS-класса для ListView, когда включён нижний колонтитул добавления/удаления. Unity добавляет этот USS-класс к ListView, когда showAddRemoveFooter установлен на true. Любые стили, применённые к этому классу, влияют на все списки, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
scrollViewWithFooterUssClassName |
.unity-list-view__scroll-view--with-footer |
Имя USS-класса для области прокрутки, когда включён нижний колонтитул добавления/удаления. Unity добавляет этот USS-класс к области прокрутки BaseListViewкогда showAddRemoveFooter установлен на true. Любые стили, применённые к этому классу, влияют на все списки, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
ussClassName |
.unity-collection-view |
Имя USS-класса для элементов BaseVerticalCollectionView. Unity добавляет этот USS-класс к каждому экземпляру элемента BaseVerticalCollectionView. Любые стили, применённые к этому классу, влияют на все BaseVerticalCollectionView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
borderUssClassName |
.unity-collection-view--with-border |
Имя USS-класса для элементов BaseVerticalCollectionView с рамкой. Unity добавляет этот USS-класс к экземпляру элемента BaseVerticalCollectionView, если у этого экземпляра свойство BaseVerticalCollectionView.showBorder имеет значение true. Любые стили, применённые к этому классу, влияют на все такие BaseVerticalCollectionView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
itemUssClassName |
.unity-collection-view__item |
Имя USS-класса для элементов списка в элементах BaseVerticalCollectionView. Unity добавляет этот USS-класс к каждому элементу списка, содержащемуся в BaseVerticalCollectionView. Любые стили, применённые к этому классу, влияют на все элементы списка, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
dragHoverBarUssClassName |
.unity-collection-view__drag-hover-bar |
Имя USS-класса для полосы наведения при перетаскивании. Unity добавляет этот USS-класс к полосе, которая появляется, когда пользователь перетаскивает элемент списка. Любые стили, применённые к этому классу, влияют на все элементы BaseVerticalCollectionView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
dragHoverMarkerUssClassName |
.unity-collection-view__drag-hover-marker |
Имя USS-класса для круглого маркера наведения при перетаскивании, обозначающего глубину. Unity добавляет этот USS-класс к полосе, которая появляется, когда пользователь перетаскивает элемент списка. Любые стили, применённые к этому классу, влияют на все элементы BaseVerticalCollectionView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
itemDragHoverUssClassName |
.unity-collection-view__item--drag-hover |
Имя USS-класса, применяемое к элементу списка при наведении перетаскиваемого объекта. Unity добавляет этот USS-класс к элементу списка, когда его перетаскивают. Любые стили, применённые к этому классу, влияют на все элементы BaseVerticalCollectionView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
itemSelectedVariantUssClassName |
.unity-collection-view__item--selected |
Имя USS-класса для выбранных элементов списка в BaseVerticalCollectionView. Unity добавляет этот USS-класс к каждому выбранному элементу в BaseVerticalCollectionView. Свойство BaseVerticalCollectionView.selectionType определяет, можно ли выбрать ноль, один или несколько элементов. Любые стили, применённые к этому классу, влияют на все элементы BaseVerticalCollectionView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
itemAlternativeBackgroundUssClassName |
.unity-collection-view__item--alternative-background |
Имя USS-класса для нечётных строк в BaseVerticalCollectionView. Unity добавляет этот USS-класс к каждому нечётному элементу в BaseVerticalCollectionView, когда свойство BaseVerticalCollectionView.showAlternatingRowBackgrounds свойство установлено на ContentOnly или All. Когда showAlternatingRowBackgrounds имеет одно из этих значений, нечётные элементы отображаются с иным цветом фона, чем чётные. Этот USS-класс служит для того, чтобы отличать нечётные элементы от чётных. Когда свойство showAlternatingRowBackgrounds свойство установлено на None, USS-класс не добавляется, и любые стили или поведение, которые на него опираются, становятся недействительными. |
listScrollViewUssClassName |
.unity-collection-view__scroll-view |
Имя USS-класса для области прокрутки в BaseVerticalCollectionView. Unity добавляет этот USS-класс к области прокрутки BaseVerticalCollectionView. Любые стили, применённые к этому классу, влияют на все области прокрутки BaseVerticalCollectionView, расположенные рядом с таблицей стилей или ниже неё в визуальном дереве. |
disabledUssClassName |
.unity-disabled |
Имя USS-класса для локально отключённых элементов. |
Вы также можете использовать раздел Соответствующие селекторы в отладчике Inspector или UI Toolkit, чтобы увидеть, какие селекторы USS влияют на компоненты VisualElement на каждом уровне его иерархии.