Елемент керування «Галерея» в Power Apps

Елемент керування, який містить інші елементи керування і відображає набір даних.

Опис

Елемент керування Колекція може відображати кілька записів з одного джерела даних, і кожен запис може містити кілька типів даних. Наприклад, за допомогою елемента керування Галерея можна показувати декілька контактів, кожен елемент яких відображає контактні відомості, що містять ім’я, адресу та номер телефону для кожної контактної особи.

Кожне поле даних відображається в окремому елементі керування в елементі керування Галерея. Ці елементи керування можна настроювати у шаблоні. Шаблон відображається як перший елемент у галереї:

• Зліва в елементі керування Галерея в горизонтальній/альбомній орієнтації.
• У верхній частині елемента керування Галерея у вертикальній/портретній орієнтації.

Будь-які зміни, внесені до шаблону, відображаються в елементі керування Галерея.

Готові шаблони для відображення зображень і тексту доступні в галереї, а також галерея для елементів зі змінною висотою.

Обмеження

Елемент керування галереєю має такі обмеження:

1. Якщо користувач прокручує елемент керування галереї для елементів зі змінною висотою перш ніж завантажаться всі елементи, то елемент у поданні може зміститися і не відображатися після завершення завантаження даних. Щоб уникнути цієї проблеми, скористайтеся стандартним елементом керування Галерея замість опції Змінна висота.
2. У галереї не підтримуються наведені нижче елементи керування.
   • Display form
   • Форма редагування
   • Засіб перегляду PDF
   • Плитка Power BI
   • Rich text editor
   • Екран із прокручуванням (гнучка сітка)
   • Вебсканер штрихкодів
3. Лише одну галерею можна додати до іншої галереї.
4. Мінімальний розмір шаблону дорівнює одиниці. Це може призвести до відхилення елементів керування в Галереї від очікуваних значень X або Y, якщо ви не враховуєте розмір шаблону.
5. Якщо ви автоматично створюєте програму з даних, зберігаєте програму, а потім повторно відкриваєте її, в оглядовій колекції дані можуть одразу не відображатися. Щоб усунути цю проблему, введіть у полі пошуку принаймні один символ, а потім видаліть введений текст. Після цього галерея покаже дані, як і очікувалося.
6. Якщо галерея містить елемент керування ComboBox, DatePicker, Slider або Toggle з OnChange правилом, яке виправляє те саме джерело даних або колекцію, що й галерея, це може призвести до неочікуваного або зниження продуктивності. Це пов’язано з тим, що OnChange правило, яке виправляє джерело даних галереї, може створити нескінченний цикл виправлень і перезавантаження. Щоб уникнути цієї проблеми, рекомендується не використовувати OnChange правила, коли ці елементи керування розміщені в галереї.

Ключові властивості

Default – елемент або запис із джерела даних, який потрібно вибрати в галереї під час запуску програми.

Items – джерело даних, що відображаються в елементах керування, таких як галерея, список або діаграма.

Selected – вибраний елемент.

Додаткові властивості

AccessibleLabel – підпис галереї (а не елементів, які він містить) для невізуальних екранів. Описує список елементів.

AllItems – Предмети, які завантажуються в галерею. Це може бути менше, ніж фактична кількість елементів джерело даних. Під час прокручування галереї можуть завантажуватися додаткові елементи. AllItems також містить елементи керування, які використовуються в кожному елементі галереї.

AllItemsCount - Кількість предметів, які завантажені в галерею. Це може бути менше, ніж фактична кількість елементів джерело даних. Під час прокручування галереї можуть завантажуватися додаткові елементи.

BorderColor – колір межі елемента керування.

BorderStyle – визначає стиль межі елемента керування: Solid (суцільна), Dashed (штрихова), Dotted (пунктирна), або None (немає).

BorderThickness – товщина межі елемента керування.

DelayItemLoading – дає змогу відкласти завантаження елементів (рядків) до завантаження екрану.

DisplayMode – визначає, чи елемент керування дозволяє користувачу вводити дані (Редагувати), лише відображає дані (Подання), або є вимкнутим (Вимкнуто).

Fill – колір фону елемента керування.

Height – відстань між верхнім і нижнім краями елемента керування.

ItemAccessibleLabel – підпис кожного елемента галереї для невізуальних екранів. Описує кожен елемент.

LoadingSpinner (значення None (Немає), Controls (Елементи керування) або Data (Дані)) – якщо встановлено значення "None", центрифуга не відображатиметься. Якщо встановлено значення "Елементи керування | Дані", центрифуга відображається, коли відбувається прохід рендерінгу, в результаті чого відображаються пусті рядки.

LoadingSpinnerColor – колір заливки центрифуги завантаження. За замовчуванням установлено BorderColor (колір межі елемента керування).

NavigationStep – як далеко прокручується галерея, якщо властивість ShowNavigation має значення True, а користувач вибере стрілку навігації з будь-якого кінця цієї галереї.

Selectable – визначає, чи можна вибрати елементи галереї. Якщо встановлено значення True, невізуальні екрани визначають галерею як список, який можна вибрати. Елемент можна вибрати, вибравши список. Якщо встановлено значення False, невізуальні екрани визначають галерею як звичайний список, а вибір елемента не призводить до вибору списку.

ShowNavigation – визначає, чи відображається стрілка на кожному кінці галереї, щоб користувач міг прокручувати елементи в галереї, натискаючи на стрілку.

ShowScrollbar – визначає, чи відображається смуга прокручування, якщо навести курсор на галерею.

TemplateFill – фоновий колір галереї.

TemplatePadding – відстань між елементами в галереї.

TemplateSize – висота шаблону для галереї у вертикальній/портретній орієнтації. Або ширина шаблону для галереї в горизонтальній/альбомній орієнтації. Мінімальний розмір - один.

Transition – візуальний ефект (Pop, Pushабо None) під час наведення курсора на елемент галереї.

Visible – відображення або приховання елемента керування.

Width – відстань між лівим і правим краями елемента керування.

WrapCount – кількість елементів, які відображаються у кожному рядку або стовпці на основі горизонтальної або вертикальної орієнтації.

X – відстань між лівим краєм елемента керування та лівим краєм його батьківського контейнера або екрана.

Y – відстань між верхнім краєм елемента керування та верхнім краєм його батьківського контейнера або екрана.

Пов’язані функції

Filter( DataSource, Formula )

Reset( Control ) – скидання галереї до початкового стану. Початковий стан передбачає прокручування до першого елемента та вибору першого елемента або елемента за замовчуванням за умови його наявності.

Примітка

Елемент керування Reset не призводить до рекурсивного скидання всіх дочірніх галерей.

Приклади

Відображати та фільтрувати дані

• Показати текст
• Показати зображення
• Фільтрувати дані, вибравши елемент списку
• Фільтрувати дані через настроювання повзунка

Отримати дані від користувача

• Отримати текст
• Отримати зображення
• Отримати фотографії
• Отримати звуки
• Отримати малюнки

Рекомендації щодо спеціальних можливостей

Контрастність кольору

Якщо клацнувши будь-де в елементі галереї цей елемент вибирається, слід мати належний контраст кольору між:

• BorderColor та кольором за межами галереї (якщо наявна межа).
• Fill та кольором за межами галереї (якщо межа відсутня).

Підтримка зчитування екрана

• Властивість AccessibleLabel є обов’язковою.

  Примітка

  Невізуальні екрани оголосять, коли елементи в галереї змінено. Властивість AccessibleLabel також згадується. Це дає контекст оголошенню, і є ще важливішим, якщо на тому самому екрані є кілька галерей.

• Якщо елемент галереї містить кілька елементів керування, скористайтеся властивістю ItemAccessibleLabel для відображення вмісту елементів галереї.

• Установіть значення Selectable True, якщо потрібно, щоб користувачі мали змогу вибрати елемент галереї. В іншому разі встановіть значення False.

• Якщо елемент галереї містить кілька елементів керування, скористайтеся властивістю ItemAccessibleLabel для надання зведення вмісту елементів галереї.

• Selectable потрібно вказати відповідно до того, чи користувачі повинні мати змогу вибрати елемент галереї.

Підтримка клавіатури

• Розгляньте можливість установлення для властивості ShowScrollbar значення True. На більшості пристроїв із сенсорним екраном смуга прокручування не відображатиметься, доки не почнеться прокрутка.

• Якщо елемент галереї можна вибрати, клацнувши будь-де в елементі, користувачі клавіатури теж мають мати змогу вибрати елемент галереї. Наприклад, можна додати Button, і встановити для властивості OnSelect значення Select(Parent).

  Примітка

  Елементи керування за межами галереї не розглядаються у порядку переходів за допомогою клавіатури в межах галереї. Елементи керування TabIndex в галереї встановлено. Див. Властивості спеціальних можливостей, щоб дізнатися більше.

Статті за темою

Використання DelayItemLoading та лічильника «Завантажується» для підвищення швидкодії колекції

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).