Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]
Ein Steuerelement, das verwendet wird, um eine Sucherfahrung zu erstellen.
Beschreibung
Ein Suchfeld (SearchBox) bietet ein Eingabefeld zum Suchen innerhalb einer Website oder App, um bestimmte Elemente zu finden.
Diese Codekomponente stellt einen Wrapper um das Fluent UI SearchBox-Steuerelement für die Anwendung in Canvas und benutzerdefinierten Seiten bereit.
Wichtig
- Dies ist eine Vorschauversion.
- Funktionen in der Vorschauversion sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.
Schlüsseleigenschaften
| Eigenschaften | Beschreibung |
|---|---|
SearchText |
Text, der vom Benutzer eingegeben wird. Verwenden Sie dies als Eingabe für Suchfunktionen. |
IconName |
Name des zu verwendenden Fluent-Benutzeroberflächen-Symbols (siehe Fluent-Benutzeroberflächen-Symbole). |
Underlined |
Bestimmt, ob das Suchfeld unterstrichen ist oder nicht |
DisableAnimation |
Ob das Suchfeld-Symbol im Fokus animiert werden soll oder nicht. |
PlaceholderText |
Platzhalter für das Suchfeld. |
Zusätzliche Eigenschaften
| Eigenschaften | Beschreibung |
|---|---|
Theme |
Das Theme-Objekt (nicht im JSON-Format). Siehe Theming für eine Anleitung zur Konfiguration. |
AccessibilityLabel |
Aria-Beschriftung für den Screenreader. |
InputEvent |
Ein Ereignis, das an das Steuerelement gesendet werden soll. z. B. SetFocus. |
Beispiel
Suchverhalten konfigurieren
Fügen Sie dieses Steuerelement dort zu Ihrer App hinzu, wo eine Suchoberfläche benötigt wird, normalerweise in Verbindung mit einem Katalog, DetailsList, oder einem Steuerelement, das ein DataSet anzeigen kann.
Erstellen Sie eine Sucherfahrung, indem Sie die Ausdrücke Search() oder Filter() verwenden, die den Wert der SearchText-Eigenschaft in der SearchBox verwenden.
Search( Accounts, SearchBox.SearchText, "name" )
Einschränkungen
Diese Codekomponente kann nur in Canvas-Apps und benutzerdefinierten Seiten verwendet werden.