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

Picker контроль

  • Статья

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

Заметка

Полная документация и исходный код находятся в разделе Репозиторий компонентов кода на GitHub.

Элемент управления Picker.

Описание:

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

Компонент кода Picker позволяет использовать компоненты меню выбора Fluent UI из приложений на основе холста и пользовательских страниц.

Компонент кода Tag Picker («Средство выбора тегов») предоставляет следующие возможности:

  1. Привязывается к входной коллекции для выбранных тегов.
  2. Привязывается к входной коллекции для предложенных тегов.
  3. Позволяет пользователям выбрать из пропозиций или ввести произвольный текстовый тег.
  4. Создает событие При изменении, когда пользователь добавляет или удаляет тег.
  5. Позволяет Установить фокус программными методами.

Наборы данных

Элемент Tag Picker имеет следующие входные наборы данных, которые подробно описаны в разделе Основные свойства далее в этой статье.

  • Tags
    • TagsDisplayName
  • Suggestions
    • SuggestionsDisplayName
    • SuggestionSubDisplayName

Набор данных Suggestions должен фильтроваться с помощью свойства выдачи SearchTerm, например:

Search(colSuggestions,TagPicker.SearchTerm,"name")

Свойства

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

Свойство Description
Items Коллекция (таблица) тегов. Приложение отвечает за добавление или удаление тегов в ответ на события добавления или удаления компонента (описанные ниже в разделе о событиях OnChange).
Suggestions_Items Коллекция (таблица) пропозиций.
TagMaxWidth Максимальная ширина тегов при отрисовке. Текст переполнения будет обрезан с многоточием, а всплывающая подсказка покажет полный текст.
AllowFreeText При вводе значения не выбирайте автоматически первое предложение, чтобы можно было ввести произвольный текст, а не выбирать из заранее определенного списка.
SearchTermToShortMessage Сообщение, отображаемое, когда условие поиска меньше, чем MinimumSearchTermLength.
HintText Сообщение, отображаемое внутри средства выбора, когда условие поиска не указано.
NoSuggestionsFoundMessage Сообщение, отображаемое, когда коллекция предложений не содержит результатов.
MinimumSearchTermLength Минимальное количество символов для запуска всплывающего окна с предложениями.
MaxTags Максимальное число тегов, которые можно добавить. После этого номера средство выбора тегов будет доступно только для чтения, пока тег не будет удален.
Error True, если должна отображаться красная граница ошибки.

Items характеристики

Свойство Description
TagsDisplayName Установите как имя столбца, содержащего отображаемое имя тега.

Suggestions характеристики

Свойство Description
SuggestionsDisplayName Установите как имя столбца, содержащего отображаемое имя пропозиции.
SuggestionsSubDisplayName (Необязательно) установите как имя столбца, содержащего дополнительную строку текста.

Свойства стиля

Свойство Description
Theme Принимает строку JSON, сгенерированную с помощью Конструктора тем Fluent UI (windows.net). Если оставить это поле пустым, будет использоваться тема по умолчанию, определенная Power Apps. Сведения о порядке настройки см. в разделе темы.
FontSize размер шрифта тегов, отображаемых в средстве выбора.
BorderRadius радиус границы тегов, отображаемых в средстве выбора.
ItemHeight высота тегов (в пикселях), отображаемых внутри средства выбора.
AccessibilityLabel Подпись Aria для программы чтения с экрана

Свойства событий

Свойство Description
Input Event Задайте на событие, которое должно отправляться в TagPicker

Выходные свойства

Свойство Description
SearchTerm Текст, введенный в средство выбора тегов, который можно использовать для фильтрации набор данных предложений.
TagsDisplayName текст, который используется для создания нового Тега, когда возникает событие При изменении
AutoHeight Когда средство выбора тегов переносится на несколько строк, свойство Автоматическая высота можно использовать для управления высотой отзывчивого контейнера.

Поведение

Поддерживает SetFocus как InputEvent.

Событие OnChange

Компонент TagPicker вызывает событие OnChange при добавлении или удалении тегов. Используемые свойства:

Свойство Description
TagEvent Имя вызванного события
TagKey Ключ элемента, вызвавшего событие (если событие связано с тегом)

Событие должно содержать выражение, похожее на:

If( TagPicker.TagEvent = "Add" && CountRows(Filter(colTags,name=TagPicker.TagsDisplayName)) = 0,
    Collect( colTags, { name:TagPicker.TagsDisplayName })
);

If( TagPicker.TagEvent="Remove",
 RemoveIf( colTags,name=Text(TagPicker.TagsDisplayName) )
);

Ограничения

Этот компонент кода можно использовать только в приложениях на основе холста и настраиваемых страницах.