SearchBox Kontrolka (wersja zapoznawcza)

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Kontrolka używana do tworzenia środowiska wyszukiwania.

opis

Pole wyszukiwania (SearchBox) udostępnia pole wejściowe do przeszukiwania witryny lub aplikacji w celu znalezienia konkretnych elementów.

Ten składnik kodu udostępnia otokę kontrolki Fluent UI SearchBox do użycia na kanwie i na stronach niestandardowych.

Ważne

• Jest to funkcja w wersji zapoznawczej.
• Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Właściwości klucza

Właściwości	opis
SearchText	Tekst, który jest wprowadzany przez użytkownika. Można odwoływać się do tej funkcji jako do danych wejściowych funkcji wyszukiwania.
IconName	Nazwa ikony Fluent UI (zobacz Ikony Fluent UI).
Underlined	Czy kontrolka SearchBox jest podkreślona.
DisableAnimation	Czy należy animować ikonę SearchBox w centrum fokusu.
PlaceholderText	Symbol zastępczy pola wyszukiwania.

Dodatkowe właściwości

Właściwości	opis
Theme	Obiekt Motyw (nie sformatowany w Json). Zobacz motywy, aby uzyskać wskazówki dotyczące konfiguracji.
AccessibilityLabel	Czytnik ekranu aria-label.
InputEvent	Zdarzenie do wysłania do kontroli Np. SetFocus.

Przykład

Skonfiguruj zachowanie wyszukiwania

Dodaj tę kontrolkę do aplikacji, w której potrzebny jest interfejs wyszukiwania, zwykle w połączeniu z galerią DetailsList lub dowolną kontrolką, która może wyświetlać zestaw danych.

Utwórz wyszukiwanie przy użyciu funkcji Search() lub Filter(), które korzystają z wartości właściwości SearchText w funkcji SearchBox.

Search( Accounts, SearchBox.SearchText, "name" )

Ograniczenia

Tego składnika kodu można używać tylko w aplikacjach kanwy i na stronach niestandardowych.