SearchBox control (підготовча версія)
[Ця стаття стосується попередньої версії, і її буде змінено.]
Елемент керування використовується для реалізації процедури пошуку.
Опис
У полі пошуку (SearchBox) передбачено поле введення для пошуку певних елементів на сайті або в програмі.
Цей компонент коду надає обгортку навколо елемента керування Fluent UI SearchBox для використання на полотні та користувацьких сторінках.
Важливо
- Це функція попереднього перегляду.
- Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.
Ключові властивості
| Властивість | Опис |
|---|---|
SearchText |
Текст, який вводить користувач. Розглядайте це, як вхідні дані для функцій пошуку. |
IconName |
Назва піктограми інтерфейсу користувача з можливістю налаштування (див. піктограми Fluent UI). |
Underlined |
Чи буде елемент SearchBox підкресленим, чи ні. |
DisableAnimation |
Чи слід анімувати піктограму SearchBox при отриманні фокусу. |
PlaceholderText |
Заповнювач для поля пошуку. |
Додаткові властивості
| Властивість | Опис |
|---|---|
Theme |
Об’єкт «Тема» (не відформатований у форматі Json). Див. використання тем, щоб отримати вказівки щодо налаштування. |
AccessibilityLabel |
Підпис aria-label для невізуальних екранів. |
InputEvent |
Подія, яку потрібно надіслати елементу керування. Наприклад, SetFocus. |
Приклад
Налаштування поведінки пошуку
Додайте цей елемент керування до програми, де потрібен інтерфейс пошуку, зазвичай у поєднанні із галереєю, DetailsList або будь-яким елементом керування, який може відображати набір даних.
Створіть функції пошуку, використовуючи вирази Search() або Filter(), які використовують значення властивості SearchText з SearchBox.
Search( Accounts, SearchBox.SearchText, "name" )
Обмеження
Цей компонент коду можна використовувати лише в компонованих програмах і настроюваних сторінках.