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


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

Елемент керування, який дає змогу робити вибір із наданих значень. Підтримує пошук і вибір кількох елементів.

Опис

Елемент керування Поле зі списком дає змогу виконувати пошук елементів, які будуть вибрані. Пошук виконується на сервері у властивості SearchField, внаслідок чого великі джерела даних не впливають на швидкодію.

Режим вибору одного або кількох елементів настроюється за допомогою властивості SelectMultiple.

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

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

Примітка

Якщо потрібно знайти елементи з цифрами, слід перетворити числа на текст за допомогою функції Текст(). Наприклад, Текст(12345).

Обмеження

Елемент керування спадним списком має такі обмеження:

  • Коли ви використовуєте елемент керування зі списком у галереї, його вибір не зберігається, коли користувач прокручує галерею. Це не проблема, якщо ви використовуєте елемент керування зі списком у галереї, яка не прокручується. Обхідний шлях наразі недоступний.

Вибір користувачів

Щоб використовувати Поле зі списком для вибору користувачів, виберіть у параметрах макета, в області даних, шаблон Користувач і настройте відповідні властивості даних, які будуть відображатися для користувача нижче.

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

Елементи – джерело даних, з-поміж яких можна зробити вибір.

DefaultSelectedItems – початкові вибрані елементи до взаємодії користувача з елементом керування.

Примітка

Властивість Default вилучено, натомість використовуйте DefaultSelectedItems.

SelectedItems – список вибраних елементів після взаємодії з користувачем.

SelectMultiple – визначає, чи користувач може вибрати один елемент, чи кілька елементів.

IsSearchable – визначає, чи може користувач шукати елементи, перш ніж їх вибрати.

Примітка

Властивість IsSearchable можна увімкнути лише для джерела даних, яке містить принаймні одне текстове поле. Вираз Елементи має піддаватися передаванню для запитів, які підлягають передаванню при пошуку. Це означає, що оператор Якщо у виразі Елементи не підтримується.

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, що містить зразки даних.

  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 та Заливка
  • SelectionTagColor та SelectionTagFill

Це додаток до стандартних вимог до контрастності кольору.

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

  • Має бути присутня властивість AccessibleLabel.

    Примітка

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

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

  • Для властивості TabIndex має бути встановлено значення "нуль" або більше, щоб користувачі клавіатури могли перейти до неї.

  • Індикатори фокусу мають бути чітко видимі. Для цього використовуйте FocusedBorderColor і FocusedBorderThickness.

    Примітка

    Клавіша Tab переміщує до або від елемента керування "Поле зі списком". Клавіші зі стрілками переміщують між вмістом елемента керування "Поле зі списком". Клавіша Escape закриває розкривний список, якщо він був відкритий.

Примітка

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

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