SearchBox контроль (предварительная версия)
[Данная статья посвящена предварительному выпуску и может быть изменена.]
Элемент управления, используемый для создания поиска.
Описание
Поле поиска (SearchBox) предоставляет поле ввода для поиска содержимого на сайте или в приложении для поиска определенных элементов.
Этот компонент кода обеспечивает оболочку вокруг элемента управления Fluent UI SearchBox для использования в приложениях на основе холста и на пользовательских страницах.
Внимание
- Это предварительная версия функции.
- Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.
Ключевые свойства
| Свойство | Description |
|---|---|
SearchText |
Текст, который вводит пользователь. Относитесь к этому как к вводу для функций поиска. |
IconName |
Имя значка Fluent UI (см. Значки Fluent UI). |
Underlined |
Будет ли SearchBox подчеркнутым. |
DisableAnimation |
Следует ли анимировать значок SearchBox, когда он находится в фокусе. |
PlaceholderText |
Заполнитель для окна поиска. |
Дополнительные свойства
| Свойство | Description |
|---|---|
Theme |
Объект Theme (не в формате Json). Сведения о порядке настройки см. в разделе темы. |
AccessibilityLabel |
Подпись Aria для программы чтения с экрана. |
InputEvent |
Событие, которое требуется отправить элементу управления. Например, SetFocus. |
Пример
Настройка поведения поиска
Добавьте этот элемент управления в приложение, где требуется интерфейс поиска, обычно в связи с галереей, DetailsList или любой элемент управления, который может отображать набор данных.
Создайте возможности поиска с помощью выражений Search() или Filter(), которые используют значение свойства SearchText в SearchBox.
Search( Accounts, SearchBox.SearchText, "name" )
Ограничения
Этот компонент кода можно использовать только в приложениях на основе холста и настраиваемых страницах.