SearchBox 控制 (預覽版)
[本文章是發行前版本文件，且隨時可能變更。]
用來建立搜尋體驗的控制項。
描述
搜尋方塊 (SearchBox) 會提供輸入欄位，用來搜尋網站或應用程式中的內容，以尋找特定項目。
此程式碼元件為 Fluent UI SearchBox 控制項提供了一個包裝函式，以便在畫布和自訂頁面中使用。
重要
- 這是預覽功能。
- 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
索引鍵屬性
| 屬性 | 描述 |
|---|---|
SearchText |
由使用者輸入的文字。 參考這個做為搜尋功能的輸入內容。 |
IconName |
Fluent UI 圖示的名稱 (請參閱 Fluent UI 圖示)。 |
Underlined |
是否為加底線強調 SearchBox。 |
DisableAnimation |
是否要在焦點上對 SearchBox 圖示進行動畫處理。 |
PlaceholderText |
搜尋方塊的預留位置。 |
其他屬性
| 屬性 | 描述 |
|---|---|
Theme |
主題物件 (不是 Json 格式)。 有關如何設定的指南，請參閱佈景主題。 |
AccessibilityLabel |
螢幕報讀軟體 aria-label。 |
InputEvent |
要傳送到控制項的事件。 例如 SetFocus。 |
範例
設定搜尋行為
將此控制項新增至需要搜尋介面的應用程式，通常與資源庫、DetailsList 或任何可以顯示資料集的控制項結合使用。
使用 Search() or Filter() 運算式建立搜尋體驗，該運算式使用 SearchBox 中 SearchText 屬性的值。
Search( Accounts, SearchBox.SearchText, "name" )
限制
此程式碼元件只能在畫布應用程式和自訂頁面中使用。