Контролата Комбинирано поле в Power Apps
Контрола, която позволява на потребителите да правят избор от предоставения избор. Поддържа търсене и множествен избор.
Описание
Контролата Combo box ви позволява да търсите елементи, които ще изберете. Търсенето се извършва от страна на сървъра в свойството SearchField, така че производителността не се влияе от големи източници на данни.
Режимът с единичен или многократен избор е конфигуриран чрез свойството SelectMultiple.
Когато търсите елементи за избор, за всеки елемент можете да изберете да покажете една стойност на данни, две стойности или картина и две стойности (Лице), като промените настройките на Оформление в панела Данни.
Когато гледате на малки екрани, списъкът с елементи ще се превърне в пълен екран за по-добра използваемост.
Бележка
Ако искате да търсите предмети с числа, конвертирайте числа в текст с функция Текст(). Например Text(12345).
Ограничения
Контролата на разгъващия се списък има следните ограничения:
- Когато използвате контрола Разгъващ се списък в галерия, нейните избори не се поддържат, когато потребителят превърта галерията. Това не е проблем, ако използвате контрола Разгъващ се списък в галерия, която не превърта. В момента не е налично заобиколно решение.
Избор на хора
За да използвате Combo box като избирач на хора, изберете шаблона Човек от настройките на оформлението в панела Данни и конфигурирайте свързаните свойства на данните, които ще се показват на човека по-долу.
Ключови свойства
Items - Източникът на данни, от който може да се направи избор.
DefaultSelectedItems - Първоначалните избрани елементи, преди потребителят да взаимодейства с контрола.
Бележка
Свойството Default е остаряло, използвайте DefaultSelectedItems вместо това.
SelectedItems - Списък на избраните елементи в резултат на взаимодействие с потребителя.
SelectMultiple - Дали потребителят може да избере един артикул или няколко елемента.
IsSearchable - Дали потребителят може да търси елементи, преди да избере.
Бележка
IsSearchable може да се активира само на източник на данни, който съдържа поне едно текстово поле. Изразът Items трябва да може да се делегира, за да могат да се делегират заявки с търсене. Тоест декларациите If в рамките на израз Items не се поддържа.
SearchFields - Полетата за данни на източник на данни, търсени, когато потребителят въвежда текст.
Бележка
За да търсите в множество полета, задайте свойството SearchFields в този формат: ["MyFirstColumn", "MySecondColumn"]. Поддържат се само текстови полета.
Допълнителни свойства
AccessibleLabel - Етикет за четци на екрани.
BorderColor – Цветът на границата на контролата.
BorderStyle – Дали границата на контрола е солидна, с тирета, с точки или няма.
BorderThickness – Дебелината на границата на контролата.
DisplayFields - Списък на полетата, показани за всеки елемент, върнат от търсенето. Най-лесно да се конфигурира чрез панела за данни в раздела Свойства.
Бележка
За да актуализирате множество полета за показване в даден шаблон, задайте свойството DisplayFields в този формат: ["MyFirstColumn", "MySecondColumn"].
DisplayMode – Дали контрола позволява въвеждане от потребителя (редактиране), показва само данни (изглед) или е деактивирана (Забранено).
FocusedBorderColor - Цветът на границата на контрола, когато контролата е на фокус.
FocusedBorderThickness - Дебелината на границата на контрола, когато контролата е на фокус.
Height - Разстоянието между горния и долния ръб на контрола.
InputTextPlaceholder - Текст с инструкции, показан на крайните потребители, когато няма избрани елементи.
OnChange – Действия, които да се извършат, когато потребителят промени даден избор.
OnNavigate – Действия, които се извършват, когато потребителят избере елемент.
OnSelect – Действия, които се извършват, когато потребителят докосне или избере контрола.
TabIndex - Ред за навигация на клавиатурата в сравнение с други контроли.
Visible - Дали се появява контрола, или е скрита.
Width - Разстоянието между левия и десния ръб на контрола.
X - Разстоянието между левия ръб на контрола и левия ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер).
Y - Разстоянието между горния ръб на контрола и горния ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер).
Бележка
Свойствата на границата на падащия прозорец се контролират от свойството Граница.
Примери
Основно комбинирано поле
Стъпките в този пример се отнасят за всеки източник на данни, който предоставя таблици, но за да следвате точно тези стъпки, използвайте среда с база данни на Microsoft Dataverse с примерни данни.
Изберете Вмъкване > Въвеждане > Combo box и му дайте име "Combobox1".
В прозореца Свойства в дясната част на екрана отворете списъка Избор на източник на данни (до Items) и след това добавете или изберете източник на данни, като таблица с акаунти.
В същия прозорец изберете Редактиране (до Полета).
В прозореца Данни отворете списъка Основен текст и след това изберете колоната Основно име, която ще се покаже в контролата Combo box.
Докато държите клавиша Alt, изберете стрелката на полето за да отворите контролата Combo box.
Контролата показва данните от основното име, което сте посочили в източника на данни, който сте указали.
(По избор) Показване на първия запис по подразбиране
Задайте свойството DefaultSelectedItems на този израз, като заместите DataSource с името на вашия източник на данни:
First(DataSource)
(По избор) Показване на избраната стойност на името на акаунта в етикет
Изберете Вмъкване > Етикет на текст, след което изберете Label.
Задайте свойството Text на този израз, като заместите Text със следната формула:
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")Бележка
Операторът If ще провери как може да съществуват избрани елементи и ще ги покаже в етикет, разделен със запетаи, или съобщение „НЯМА ИЗБРАН ЕЛЕМЕНТ“, когато е празно.
Симулиране на опростено поведение на падащото меню
Като зададете IsSearchable на false и SelectMultiple на false, можете да постигнете същата функционалност на падащо меню.
Изберете Вмъкване > Въвеждане, след което изберете Combo box.
В прозореца Свойства в дясната част на екрана отворете списъка Избор на източник на данни (до Items) и след това добавете или изберете източник на данни.
В същия прозорец изберете Редактиране (до Полета).
В екрана Данни отворете списъка Основен текст и след това изберете колоната, която искате да покажете в контролата Combo box.
Задайте свойството IsSearchable на false.
Задайте свойството SelectMultiple на false.
Докато държите клавиша Alt, изберете стрелката на полето за да отворите контролата Combo box.
Контролата показва данните от колоната, която сте посочили в източник на данни, който сте посочили.
Бележка
Текстът „Търсене на елементи“ изчезва и ще можете да изберете само един елемент.
Насоки за достъпност
Контраст на цвят
Трябва да има достатъчен цветен контраст между:
- ChevronFill и ChevronBackground
- ChevronHoverFill и ChevronHoverBackground
- SelectionColor и SelectionFill
- SelectionFill и Fill
- SelectionTagColor и SelectionTagFill
Това е в допълнение към стандартни изисквания за цветен контраст.
Поддръжка на екранен четец
AccessibleLabel трябва да е налице.
Бележка
На сензорни екрани потребителите на екранен четец могат да навигират съдържанието на комбинираното поле последователно. Комбинираното поле действа като бутон, който показва или скрива съдържанието му, когато е избран.
Поддръжка на клавиатурата
TabIndex трябва да е нула или повече, така че потребителите с клавиатура да могат да навигират.
Индикаторите за фокус трябва да са ясно видими. Използвайте FocusedBorderColor и FocusedBorderThickness за постигане на това.
Бележка
Клавишът за раздела се придвижва към или извън комбинираното поле. Клавишите със стрелки навигират съдържанието на комбинираното поле. Ключът за бягство затваря падащото меню при отваряне.
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).