SearchBox kontrol (pratinjau)
[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]
Kontrol digunakan untuk membuat pengalaman pencarian.
Description
Kotak pencarian (SearchBox) menyediakan bidang input untuk pencarian di situs atau aplikasi guna menemukan item tertentu.
Komponen kode ini menyediakan pembungkus di sekitar kontrol Fluent UI SearchBox untuk digunakan di kanvas & halaman kustom.
Penting
- Ini adalah fitur pratinjau.
- Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.
Properti kunci
| Properti | Description |
|---|---|
SearchText |
Teks yang diinput oleh pengguna. Lihat fungsi ini sebagai input untuk fungsi pencarian. |
IconName |
Nama ikon Fluent UI (lihat Ikon Fluent UI). |
Underlined |
Apakah SearchBox digarisbawahi atau tidak. |
DisableAnimation |
Apakah akan memberi ikon SearchBox animasi saat fokus atau tidak. |
PlaceholderText |
Tempat penampung untuk kotak pencarian. |
Properti tambahan
| Properti | Description |
|---|---|
Theme |
Objek Tema (tidak diformat Json). Untuk panduan tentang cara mengkonfigurasi, lihat tema. |
AccessibilityLabel |
Aria-label pembaca layar. |
InputEvent |
Aktivitas untuk dikirim ke kontrol. Misalnya SetFocus. |
Contoh
Mengonfigurasikan perilaku pencarian
Tambahkan kontrol ini ke aplikasi dengan antarmuka pencarian yang diperlukan, biasanya digabungkan dengan galeri, DetailsList, atau kontrol apa pun yang dapat menampilkan dataset.
Buat pengalaman pencarian dengan menggunakan ekspresi Search() atau Filter() yang menggunakan nilai properti SearchText di SearchBox.
Search( Accounts, SearchBox.SearchText, "name" )
Pembatasan
Komponen kode ini hanya dapat digunakan pada aplikasi kanvas dan halaman kustom.