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

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

Description

Элемент управления "Поле со списком " позволяет искать элементы, которые вы выберете. Поиск выполняется на стороне сервера в свойстве SearchField, поэтому производительность не влияет на большие источники данных.

Режим одного или нескольких выборов настраивается с помощью свойства SelectMultiple.

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

При просмотре элемента управления на небольших экранах всплывающий элемент списка элементов становится полноэкранным элементом управления для повышения удобства использования.

Ограничения

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

• При использовании элемента управления "Поле со списком" в коллекции его выбор не сохраняется, когда пользователь прокручивает коллекцию. Это не проблема, если вы используете элемент управления со списком в коллекции, которая не прокручивается. Решение в настоящее время недоступно.

Средство выбора людей

Чтобы использовать поле со списком в качестве средства выбора людей, выберите шаблон Person из параметров макета в области данных и настройте соответствующие свойства данных, которые будут отображаться для пользователя ниже.

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

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

DefaultSelectedItems — начальные выбранные элементы перед взаимодействием пользователя с элементом управления.

SelectedItems — список выбранных элементов, результатом взаимодействия с пользователем.

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

SelectMultiple — может ли пользователь выбрать один элемент или несколько элементов.

IsSearchable — может ли пользователь искать элементы перед выбором.

SearchFields — поля данных источника данных, искомые при вводе текста пользователем.

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

AccessibleLabel — метка для средств чтения с экрана.

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

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

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

DisplayFields — список полей, отображаемых для каждого элемента, возвращаемого поиском. Проще всего настроить с помощью области данных на вкладке "Свойства".

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

FocusedBorderColor — цвет границы элемента управления при фокусе элемента управления.

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

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

InputTextPlaceholder — обучающий текст, отображаемый конечным пользователям, если элементы не выбраны.

OnChange — действия, выполняемые при изменении выбора пользователем.

OnNavigate — действия, выполняемые при выборе элемента пользователем.

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

TabIndex — порядок навигации клавиатуры относительно других элементов управления.

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

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

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

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

Примеры

Поле со списком "Базовый"

Действия, описанные в этом примере, применяются к любому источнику данных, предоставляющим таблицы, но для точного выполнения этих действий используйте среду с базой данных Microsoft Dataverse с примерами данных.

1. Выберитеполе"Вставить>входные данные>" и назовите его "Combobox1".

2. На панели "Свойства " в правой части экрана откройте список источников данных (рядом с элементами), а затем добавьте или выберите источник данных, например таблицу "Учетные записи".

3. На той же панели нажмите кнопку "Изменить " (рядом с полями).

4. В области данных откройте основной текстовый список, а затем выберите столбец "Основное имя ", который будет отображаться в элементе управления "Поле со списком ".

5. Удерживая клавишу ALT , щелкните стрелку вниз, чтобы открыть элемент управления со списком .

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

(Необязательно) Отображение первой записи по умолчанию

1. Задайте для свойства DefaultSelectedItems это выражение, заменив DataSource именем источника данных:

   First(DataSource)
   

(Необязательно) Отображение выбранного значения имени учетной записи в метке

1. Выберите "Вставитьтекстовую метку" и выберите "Метка>".

2. Задайте свойству Text значение этого выражения, заменив Text следующей формулой:

   If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
   

   Замечание

   Оператор If проверяет, как могут существовать выбранные элементы и отображать их в метке с разделителями-запятыми или сообщение "NO SELECTED ITEM" при пустом значении.

Имитация простого поведения раскрывающегося списка

Задав значение IsSearchable false и SelectMultiple значение false, вы можете достичь той же функциональности раскрывающегося списка.

1. Выберите "Вставить>входные данные" и выберите поле со списком.

2. В области "Свойства " в правой части экрана откройте список источников данных (рядом с элементами), а затем добавьте или выберите источник данных.

3. На той же панели нажмите кнопку "Изменить " (рядом с полями).

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

5. Задайте для свойства IsSearchable значение false.

6. Задайте для свойства SelectMultiple значение false.

7. Удерживая клавишу ALT , щелкните стрелку вниз, чтобы открыть элемент управления со списком .

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

   Замечание

   Текст "Найти элементы" исчез, и вы сможете выбрать только один элемент.

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

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

Между ними должна быть достаточная контрастность цвета:

• ChevronFill и ChevronBackground
• ChevronHoverFill и ChevronHoverBackground
• SelectionColor и SelectionFill
• Выделение и заполнение
• SelectionTagColor и SelectionTagFill

Это в дополнение к стандартным требованиям к контрастности цветов.

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

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

  Замечание

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

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

• TabIndex должен быть равен нулю или больше, чтобы пользователи клавиатуры могли перейти к нему.

• Индикаторы фокуса должны быть четко видимыми. Для этого используйте FocusedBorderColor и FocusedBorderThickness .

  Замечание

  Клавиша tab переходит к поле со списком или от него. Клавиши со стрелками перемещаются по содержимому поля со списком. Экранный ключ закрывает раскрывающийся список при открытии.