SearchBox έλεγχος (έκδοση προεπισκόπησης)
[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]
Ένα στοιχείο ελέγχου που χρησιμοποιείται για τη δημιουργία μιας εμπειρίας αναζήτησης.
Περιγραφή
Ένα πλαίσιο αναζήτησης (SearchBox) παρέχει ένα πεδίο εισόδου για αναζήτηση εντός μιας τοποθεσίας ή μιας εφαρμογής για την εύρεση συγκεκριμένων στοιχείων.
Αυτό το στοιχείο κώδικα παρέχει ένα πρόγραμμα συσκευασίας γύρω από το στοιχείο ελέγχου Πλαίσιο αναζήτησης περιβάλλοντος εργασίας χρήστη Fluent για χρήση σε καμβά και προσαρμοσμένες σελίδες.
Σημαντικό
- Αυτή είναι μια δυνατότητα προεπισκόπησης.
- Οι λειτουργίες προεπισκόπησης δεν προορίζονται για παραγωγική χρήση και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια.
Ιδιότητες κλειδιού
| Ιδιότητα | Description |
|---|---|
SearchText |
Κείμενο που εισάγεται από το χρήστη. Ανατρέξτε σε αυτό ως δεδομένα εισόδου για λειτουργίες αναζήτησης. |
IconName |
Όνομα του εικονιδίου του περιβάλλοντος εργασίας χρήστη Fluent (βλ. Εικονίδια περιβάλλοντος εργασίας χρήστη Fluent). |
Underlined |
Ε'ιτε το πλαίσιο αναζήτησης είναι υπογραμμισμένο είτε όχι. |
DisableAnimation |
Μπορείτε να επιλέξετε εάν το εικονίδιο πλαίσιο αναζήτησης θα εμφανίζεται στην εστίαση ή όχι. |
PlaceholderText |
Χαρακτήρας κράτησης θέσης για το πλαίσιο αναζήτησης. |
Πρόσθετες ιδιότητες
| Ιδιότητα | Description |
|---|---|
Theme |
Το αντικείμενο θέματος (όχι σε μορφή Json). Δείτε θέματα για οδηγία για τον τρόπο ρύθμισης παραμέτρων. |
AccessibilityLabel |
Ετικέτα aria προγράμματος ανάγνωσης οθόνης. |
InputEvent |
Ένα συμβάν για αποστολή στο στοιχείο ελέγχου. Π.χ. SetFocus. |
Παράδειγμα
Ρύθμιση παραμέτρων συμπεριφοράς αναζήτησης
Προσθέστε αυτό το στοιχείο ελέγχου στην εφαρμογή σας όπου χρειάζεται ένα περιβάλλον εργασίας αναζήτησης, συνήθως σε συνδυασμό με μια συλλογή, DetailsList ή οποιοδήποτε στοιχείο ελέγχου που μπορεί να εμφανίζει ένα σύνολο δεδομένων.
Δημιουργήστε μια εμπειρία αναζήτησης χρησιμοποιώντας τις παραστάσεις Search() ή Filter() που χρησιμοποιούν την τιμή της ιδιότητας SearchText στο SearchBox.
Search( Accounts, SearchBox.SearchText, "name" )
Περιορισμοί
Αυτό το στοιχείο κώδικα μπορεί να χρησιμοποιηθεί μόνο σε εφαρμογές καμβά, προσαρμοσμένες σελίδες.