Поделиться через

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

  • Статья

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

Описание

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

Режим одиночного или множественного выбора настраивается с использованием свойства SelectMultiple.

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

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

Примечание

Если вы хотите искать элементы с числами, преобразуйте числа в текст с помощью функции Text(). Например, Text(12345).

Ограничения

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

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

Выбор людей

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

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

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

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

Примечание

Свойство Default устарело, используйте вместо него DefaultSelectedItems.

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

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

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

Примечание

IsSearchable можно включить только для источника данных, который содержит хотя бы одно текстовое поле. Выражение Items должно быть делегируемым, чтобы запросы были делегированы с поиском. То есть, операторы If в выражении Items не поддерживаются.

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

Примечание

Для поиска по нескольким полям установите свойство SearchFields свойство в следующем формате: ["MyFirstColumn", "MySecondColumn"]. Поддерживаются только текстовые поля.

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

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

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

BorderStyle  — стиль границы элемента управления: Solid, Dashed, Dotted или None.

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

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

Примечание

Чтобы обновить несколько полей отображения в данном шаблоне, установите свойство DisplayFields свойство в этом формате: ["MyFirstColumn", "MySecondColumn"].

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

Свойства границы всплывающего меню управляются свойствами Border.

Примеры

Базовое поле со списком

Действия в этом примере применимы к любому источнику данных, предоставляющему таблицы, но чтобы точно выполнить эти шаги, используйте среду с базой данных 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" проверит, как могут существовать выбранные элементы, и отобразит их в метке, разделенной запятыми, или сообщении «НЕТ ВЫБРАННОГО ЭЛЕМЕНТА», когда оно пусто.

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

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

  1. Выберите Вставить > Ввод, а затем выберите Поле со списком.

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

  3. На той же панели выберите Редактировать (рядом с Поля).

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

  5. Установите свойство IsSearchable как false.

  6. Установите свойство SelectMultiple как false.

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

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

    Примечание

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

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

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

Необходимо настроить достаточный контраст для следующих элементов:

  • ChevronFill и ChevronBackground
  • ChevronHoverFill и ChevronHoverBackground
  • SelectionColor и SelectionFill
  • SelectionFill и Fill
  • SelectionTagColor и SelectionTagFill

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

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

  • Должен присутствовать элемент AccessibleLabel.

    Примечание

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

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

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

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

    Примечание

    Клавиша TAB позволяет переходить к полю со списком. Клавиши со стрелками позволяют переходить по содержимому поля со списком. Клавиша ESC закрывает открытый раскрывающийся список.

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).