SearchBox Kontrolle (Vorschauversion)
[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-Benutzeroberfläche -Steuerelement zur Verwendung in Canvas-Apps und benutzerdefinierten Seiten bereit.
Wichtig
- Dies ist eine Vorschauversion.
- Funktionen in der Vorschauversion sind nicht für den Produktionseinsatz 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 des Dataflows |
|---|---|
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 des Dataflows |
|---|---|
Theme |
Das Design-Objekt (nicht JSON-formatiert). Siehe Designs für eine Konfigurationsanleitung. |
AccessibilityLabel |
Aria-Beschriftung für Sprachausgabe. |
InputEvent |
Ein Ereignis, das an das Steuerelement gesendet werden soll. z. B. SetFocus. |
Beispiel
Suchverhalten konfigurieren
Fügen Sie Ihrer App, dort wo Sie eine Suchoberfläche benötigen, dieses Steuerelement hinzu. Es ist normalerweise an einen Katalog DetailsList oder ein Steuerelement gekoppelt, 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.