Контрола за галерия в Power Apps
Контрола, която съдържа други контроли и показва набор от данни.
Описание
Контролата Gallery може да показва няколко записа от един източник на данни, а всеки запис може да съдържа няколко типа данни. Например, използвайте контрола Gallery, за да се показват множество контакти с всеки елемент, показващи информация за контакт, която включва име, адрес и телефонен номер за всеки контакт.
Всяко поле за данни се показва в отделен елемент за контрол в рамките на контролата Gallery. И можете да конфигурирате тези контроли в неговия шаблон. Шаблонът се появява като първият елемент в галерията:
- От левия ръб на контролата Gallery в хоризонтална / пейзажна ориентация.
- И на върха на контролата Gallery във вертикална / портретна ориентация.
Всички промени, които правите в шаблона, се отразяват в контролата Gallery.
Предлагат се предварително зададени шаблони за показване на изображения и текст в галерия и галерия за елементи с променлива височина.
Ограничения
Контролата на галерията има следните ограничения:
- Ако потребител превърта контролата Гъвкава височина на галерията преди зареждането на всички елементи, елементът, който в момента е в изглед, може да бъде изтласкан и изваден, когато приключи зареждането на данни. За да избегнете този проблем, използвайте стандартна контрола Gallery вместо Гъвкава височина вариант.
- Следните контроли не се поддържат в галерия:
- Можете да добавите само една галерия в друга галерия.
- Минималният размер на шаблона е един. Това може да доведе до отклонение на контролите в галерията от очакваните стойности на X или Y, когато не отчитате размера на шаблона.
- Ако генерирате приложение автоматично от данни, запишете го и след това го отворите отново, галерията за сърфиране може да не показва веднага никакви данни. За да разрешите този проблем, въведете поне един знак в полето за търсене и след това изтрийте текста, който сте въвели. След това галерията ще покаже данните, както се очаква.
Свойства на ключове
Default - Елементът или записа от източник на данни да бъде избран в галерията, когато приложението се стартира.
Items - Източникът на данни, който се появява в контрола като галерия, списък или диаграма.
Selected - Премахване на избрания елемент.
Допълнителни свойства
AccessibleLabel - Етикет на галерията (не артикулите, които съдържа) за читатели на екрана. Трябва да опише какъв е списъкът с елементи.
AllItems – Елементи, които са заредени в галерията. Това може да е по-малко от действителния брой артикули на източник на данни. Повече елементи могат да бъдат заредени, когато галерията се превърта. AllItems съдържа и контроли, които се използват във всеки елемент на галерия.
AllItemsCount - Брой на елементите, които са заредени в галерията. Това може да е по-малко от действителния брой артикули на източник на данни. Повече елементи могат да бъдат заредени, когато галерията се превърта.
BorderColor – Цветът на границата на контролата.
BorderStyle – Дали границата на контрола е солидна, с тирета, с точки или няма.
BorderThickness – Дебелината на границата на контролата.
DelayItemLoading - Забавяне на зареждането на елементи (редове), докато екранът не се зареди първо.
DisplayMode – Дали контрола позволява въвеждане от потребителя (редактиране), показва само данни (изглед) или е деактивирана (Забранено).
Fill – Цветът на запълване в контрола.
Height - Разстоянието между горния и долния ръб на контрола.
ItemAccessibleLabel - Етикет на всеки елемент от галерията за екранни четци. Трябва да опише какво е всеки елемент.
LoadingSpinner (Няма, Контроли или Данни) - Когато няма, инструментът за завъртане няма да бъде показан. Когато контроли | данни, завъртането ще бъдат показани, когато се появи пропуск на рендиране, който води до видими празни редове.
LoadingSpinnerColor - Цветът на запълване на зареждащия спинер. BorderColor е зададено на по подразбиране.
NavigationStep - Докъде се превърта галерия, ако нейното свойство ShowNavigation е настроено на вярно и потребителят избира стрелка за навигация в двата края на тази галерия.
Избираеми - дали могат да бъдат избрани елементи от галерията Когато е настроен на вярно, читателите на екрана идентифицират галерията като избираем списък. И вие избирате елемент, като го изберете. Когато е настроен на невярно, екранните четци идентифицират галерията като обикновен списък, а избирането на елемент не го избира.
ShowNavigation - Дали стрелката се появява в двата края на галерията, така че потребителят да може да превърта елементите в галерията, като избира стрелка.
ShowScrollbar - Дали се появява лента за превъртане, когато потребителят задържи курсора върху галерия.
TemplateFill – Цветът на запълване на галерия.
TemplatePadding - Разстоянието между артикулите в галерия.
TemplateSize - Височината на шаблона за галерия във вертикална / портретна ориентация. Или ширината на шаблона за галерия в хоризонтална / пейзажна ориентация. Минималният размер е един.
Transition - Визуалният ефект (Изскачане, Натиск или Няма), когато потребителят задържи курсора върху елемент в галерия.
Visible - Дали се появява контрола, или е скрита.
Width - Разстоянието между левия и десния ръб на контрола.
WrapCount - Брой показани елементи на ред или колона въз основа на хоризонтално или вертикално оформление.
X - Разстоянието между левия ръб на контрола и левия ръб на неговия родителски контейнер или екрана.
Y - Разстоянието между горния ръб на контрола и горния ръб на неговия родителски контейнер или екрана.
Свързани функции
Reset( Control ) - Възстановява вашата галерия до първоначалното й състояние. Първоначалното състояние включва превъртане до първия елемент и избор на първия елемент или по подразбиране, ако има такъв.
Бележка
Контролата Reset не рекусивно рестартира всички деца на галерията.
Примери
Показване и филтриране на данни
Вземете данни от потребителя
Насоки за достъпност
Контраст на цвят
Ако щракването върху което и да е място в галерията има за цел да го изберете, трябва да има подходящ цветен контраст между:
- BorderColor и цветът извън галерията (ако има граница).
- Fill и цветът извън галерията (ако няма граница).
Поддръжка на екранен четец
AccessibleLabel трябва да е налице.
Бележка
Читателите на екрана ще обявят кога елементи в галерията се променят. AccessibleLabel също се споменава. Това дава контекст на съобщението и е още по-важно, когато на един и същ екран има множество галерии.
Когато елементът от галерията съдържа множество контроли, използвайте ItemAccessibleLabel, за да се покаже съдържанието на елементи от галерията.
Задайте стойността на Избираеми на вярно, ако искате потребителите да изберат елемент от галерията. В противен случай задайте тази стойност на невярно.
Когато елементът от галерията съдържа множество контроли, използвайте ItemAccessibleLabel, за да предоставите обобщение на съдържанието на елемента на галерия.
Избираеми трябва да бъдат зададени по подходящ начин, в зависимост от това дали потребителите имат за цел да изберат елемент от галерията.
Поддръжка на клавиатурата
Помислете за настройка ShowScrollbar да е вярно. На повечето устройства със сензорен екран лентата за превъртане няма да се покаже, докато започне превъртането.
Ако щракването върху където и да било елемент от галерията има за цел да го изберете, трябва да има начин и потребителите на клавиатурата да изберат елемента на галерията. Например, добавяне на Button, което има своето свойство OnSelect, зададено на Select(Parent).
Бележка
Контролите извън галерията не се вземат предвид в реда за навигация на клавиатурата в галерията. TabIndex контролите в галерията са обхванати. Вижте свойства за достъпност да научите повече.
Вижте също
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).
Обратна връзка
https://aka.ms/ContentUserFeedback.
Очаквайте скоро: През цялата 2024 г. постепенно ще отстраняваме проблемите в GitHub като механизъм за обратна връзка за съдържание и ще го заменим с нова система за обратна връзка. За повече информация вижте:Подаване и преглед на обратна връзка за