# 搜索/Search 輕松創建一個好看的搜索框。 ## 用法 搜索組件由搜索表單和搜索文本域組成。注意 使用此組件需要額外添加 `search.css` 文件，在`css/components`文件夾中。此組件需要額外添加 `search.js` 文件，在`js/components`文件夾中。 | Class類 | 描述 | | --- | --- | | `.uk-search` | 添加這個類到 `&lt;form&gt;`元素中，定義搜索組件。 | | `.uk-search-field` | 添加這個類到 `&lt;input&gt;`元素中創建一個搜索文本域。 | 為了使搜索框所必須的JavaScript能夠生效，需要添加 `data-uk-search`屬性。 ### Example  ### Markup ``` <form class="uk-search" data-uk-search> <input class="uk-search-field" type="search" placeholder=""> </form> ``` * * * ## JSON 搜索結果 在需要用JSON格式化搜索結果的表單中添加 `{source:'PATH/TO/RESULTS'}` 到data屬性中，并設置JSON文件的路徑 ([示例](../tests/components/_searchautocomplete.json)).你可以用 [下拉菜單組件](dropdown.html) 中的下拉菜單來顯示搜索結果。搜索的結果會注入并顯示在下拉菜單中。你甚至可以用鍵盤上的上下鍵來操作這個下拉菜單。 重要 這樣的搜索框需要用到 [自動完成組件](addons_autocomplete.html)。請確定你已經將他們引入了。 ### Example  ### Markup ``` <form class="uk-search" data-uk-search="{source:'my-results.json'}"> <input class="uk-search-field" type="search" placeholder=""> <!-- 這是通過JavaScript注入了搜索結果的下拉菜單 --> <div class="uk-dropdown uk-dropdown-search"> <ul class="uk-nav uk-nav-search">...</ul> </div> </form> ``` * * * ## 導航條中的搜索 搜索框也可以用在[導航條](navbar.html)中. ### Example  ### Markup ``` <nav class="uk-navbar"> <div class="uk-navbar-flip"> <div class="uk-navbar-content"> <form class="uk-search" data-uk-search="{source:'my-results.json'}"> ... </form> </div> </div> </nav> ``` * * * ## 抽屜中的搜索 搜索框也可以放在抽屜中。 ### Example  ### Markup ``` <!-- 這是開關抽屜邊欄的按鈕 --> <button class="uk-button" data-uk-offcanvas="{target:'#my-id'}">...</button> <!-- 這是抽屜邊欄 --> <div id="my-id" class="uk-offcanvas"> <div class="uk-offcanvas-bar"> <form class="uk-search"> ... </form> </div> </div> ``` ## JavaScript 選項 | 選項 | 可用值 | 默認值 | 描述 | | --- | --- | --- | --- | | `source` | string | '' | 數據源的URL | | `minLength` | integer | 3 | 觸發自動完成的最小輸入長度 | | `param` | string | search | 發送Ajax請求的查詢名稱 | | `delay` | integer | 300 | 停止輸入后的延時 | ### 手動初始化 ``` var search = UIkit.search(element, { /* options */ }); ``` ### 事件 跟[自動完成組件](autocomplete.html)的事件一樣。