Элемент управления "Коллекция" в Power Apps

Элемент управления, содержащий другие элементы управления и показывающий набор данных.

Description

Элемент управления "Коллекция" может отображать несколько записей из источника данных, и каждая запись может содержать несколько типов данных. Например, используйте элемент управления "Коллекция " для отображения нескольких контактов с каждым элементом с контактными данными, включающими имя, адрес и номер телефона для каждого контакта.

Каждое поле данных отображается в отдельном элементе управления в элементе управления "Коллекция ". И вы можете настроить эти элементы управления в своем шаблоне. Шаблон отображается как первый элемент в коллекции:

• В левой части элемента управления "Коллекция " в горизонтальной или альбомной ориентации.
• А в верхней части элемента управления "Коллекция " в вертикальной или книжной ориентации.

Все изменения, внесенные в шаблон, отражаются во всем элементе управления "Коллекция ".

Доступны стандартные шаблоны для отображения изображений и текста в коллекции, а также коллекция элементов переменной высоты.

Ограничения

Элемент управления коллекции имеет следующие ограничения:

1. Если пользователь прокрутит элемент управления гибкой высоты до загрузки всех элементов, элемент, который в настоящее время находится в представлении, может быть отправлен вниз и вне представления после завершения загрузки данных. Чтобы избежать этой проблемы, используйте стандартный элемент управления коллекции вместо варианта гибкой высоты .
2. Следующие элементы управления не поддерживаются в коллекции:
   • Форма отображения
   • Форма редактирования
   • Средство просмотра PDF
   • Плитка Power BI
   • Редактор форматированного текста
   • Прокручиваемый экран (Динамная сетка)
   • Сканер веб-штрихкодов
3. Невозможно добавить коллекцию в другую коллекцию, если она уже находится внутри другой коллекции. Максимальный уровень вложения составляет 2.
4. Минимальный размер TemplateSize — один. Это может привести к смещения элементов управления в коллекции от ожидаемых значений X или Y , если размер шаблона не учитывается.
5. Если приложение создается автоматически из данных, сохраните приложение, а затем снова откройте его, коллекция обзоров может не сразу отобразить данные. Чтобы устранить эту проблему, введите хотя бы один символ в поле поиска и удалите введенный текст. Затем коллекция отобразит данные, как ожидалось.
6. Если коллекция включает элемент управления ComboBox, DatePicker, Slider или Toggle с OnChange правилом, которое исправляет тот же источник данных или коллекцию, что и коллекция, это может привести к неожиданной или сниженной производительности. Это связано с тем, что OnChange правило, которое исправляет источник данных коллекции, может создать бесконечный цикл исправления и перезагрузки. Чтобы избежать этой проблемы, рекомендуется не использовать OnChange правила, когда эти элементы управления помещаются в коллекцию.

Ключевые свойства

По умолчанию — элемент или запись из источника данных, выбранного в коллекции при запуске приложения.

Элементы — источник данных, отображаемых в элементе управления, например в коллекции, списке или диаграмме.

Выбрано — выбранный элемент.

Дополнительные свойства

AccessibleLabel — метка коллекции (а не элементы, которые она содержит) для средств чтения с экрана. Следует описать список элементов.

AllItems — элементы, загруженные в коллекцию. Это может быть меньше фактического числа элементов источника данных. При прокрутке коллекции могут быть загружены дополнительные элементы. AllItems также содержит элементы управления, используемые в каждом элементе коллекции.

AllItemsCount — количество элементов, загруженных в коллекцию. Это может быть меньше фактического числа элементов источника данных. При прокрутке коллекции могут быть загружены дополнительные элементы.

BorderColor — цвет границы элемента управления.

BorderStyle — является ли граница элемента управления твердым, дефишированным, dotted или None.

BorderThickness — толщина границы элемента управления.

DelayItemLoading — задержка загрузки элементов (строк) до тех пор, пока экран не загрузит его.

DisplayMode — разрешает ли элемент управления входные данные (изменить), отображается только данные (вид) или отключен (отключено).

Заливка — цвет фона элемента управления.

Высота — расстояние между верхними и нижними краями элемента управления.

ItemAccessibleLabel — метка каждого элемента коллекции для средств чтения с экрана. Следует описать, что такое каждый элемент.

LoadingSpinner (None, Controls илиor Data) — если задано значение None, вертушка не отображается. Когда элементы управления | Данные, спиннер будет отображаться при выполнении передачи отрисовки, что приводит к видимым пустым строкам.

LoadingSpinnerColor — цвет заливки загрузочной вертушки. По умолчанию задано значение BorderColor.

NavigationStep — как далеко прокручивается коллекция, если для свойства ShowNavigation задано значение true , и пользователь выбирает стрелку навигации в любом конце этой коллекции.

Доступный вариант — можно ли выбрать элементы коллекции. Если задано значение true, средства чтения с экрана определяют коллекцию как список, доступный для выбора. И вы выбираете элемент, выбрав его. Если задано значение false, средства чтения с экрана определяют коллекцию как обычный список, а выбор элемента не выбирает его.

ShowNavigation — отображается ли стрелка в каждой части коллекции, чтобы пользователь смог прокручивать элементы в коллекции, выбрав стрелку.

ShowScrollbar — отображается ли полоса прокрутки при наведении указателя мыши на коллекцию.

TemplateFill — цвет фона коллекции.

TemplatePadding — расстояние между элементами в коллекции.

TemplateSize — высота шаблона для коллекции в вертикальной или книжной ориентации. Или ширина шаблона для коллекции в горизонтальной или альбомной ориентации. Минимальный размер — один.

Переход — визуальный эффект (Pop, Push или None) при наведении указателя мыши на элемент в коллекции.

Видимый — отображается ли элемент управления или скрыт.

Ширина — расстояние между левыми и правыми краями элемента управления.

WrapCount — количество элементов, отображаемых для каждой строки или столбца на основе горизонтального или вертикального макета.

X — расстояние между левым краем элемента управления и левым краем родительского контейнера или экрана.

Y — расстояние между верхним краем элемента управления и верхним краем родительского контейнера или экрана.

Связанные функции

Filter( DataSource, Formula )

Reset( Control ) — сбрасывает коллекцию обратно в исходное состояние. Начальное состояние включает прокрутку до первого элемента и выбор первого элемента или по умолчанию при наличии.

Примеры

Отображение и фильтрация данных

• Отображение текста
• Отображение изображений
• Фильтрация данных путем выбора параметра списка
• Фильтрация данных путем настройки ползунка

Получение данных от пользователя

• Получение текста
• Получение изображений
• Получение фотографий
• Получение звуков
• Получение рисунков

Руководство по настройке специальных возможностей

Контрастность цветов

Если щелкнуть элемент коллекции в любом месте коллекции, он должен быть достаточной контрастностью между:

• BorderColor и цвет за пределами коллекции (если есть граница).
• Заливка и цвет за пределами коллекции (если границы нет).

Поддержка средства чтения с экрана

• Значение AccessibleLabel должно присутствовать.

  Замечание

  Средства чтения с экрана объявляют, когда элементы в коллекции изменяются. Также упоминается ДоступныйLabel . Это дает контекст объявлению и еще более важен, если на одном экране есть несколько коллекций.

• Если элемент коллекции содержит несколько элементов управления, используйте ItemAccessibleLabel для отображения содержимого элементов коллекции.

• Задайте для параметра Selectableзначение true , если вы хотите, чтобы пользователи выбрали элемент коллекции. В противном случае задайте для этого значения значение false.

• Если элемент коллекции содержит несколько элементов управления, используйте ItemAccessibleLabel для предоставления сводки содержимого элемента коллекции.

• Выбор должен быть задан соответствующим образом в зависимости от того, предназначены ли пользователи для выбора элемента коллекции.

Поддержка клавиатуры

• Попробуйте задать значение ShowScrollbarзначение true. На большинстве сенсорных устройств полоса прокрутки не будет отображаться до начала прокрутки.

• Если щелкнуть элемент коллекции в любом месте коллекции, он также должен быть способом выбора элемента коллекции. Например, добавление кнопки с его свойством OnSelect имеет значение Select(Parent).

  Замечание

  Элементы управления за пределами коллекции не рассматриваются в порядке навигации по клавиатуре в коллекции. Элементы управления TabIndex в коллекции ограничены. Дополнительные сведения см. в свойствах специальных возможностей .

См. также

Использование средства DelayItemLoading и загрузки спиннера для повышения производительности в коллекции