# 搜索/Search
輕松創建一個好看的搜索框。
## 用法
搜索組件由搜索表單和搜索文本域組成。注意 使用此組件需要額外添加 `search.css` 文件,在`css/components`文件夾中。此組件需要額外添加 `search.js` 文件,在`js/components`文件夾中。
| Class類 | 描述 |
| --- | --- |
| `.uk-search` | 添加這個類到 `<form>`元素中,定義搜索組件。 |
| `.uk-search-field` | 添加這個類到 `<input>`元素中創建一個搜索文本域。 |
為了使搜索框所必須的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)的事件一樣。
- UIkit 中文文檔
- 開始使用
- 初學者
- 開始使用
- 如何自定義
- 布局示例
- 開發者
- 項目結構
- Less & Sass 文件
- 創建主題
- 創建樣式
- Customizer.json
- JavaScript
- 自定義前綴
- 核心組件
- 默認
- 基礎
- 打印
- 布局類組件
- 網格
- 面板/Panel
- 塊/Block
- 文章
- 評論/Comment
- 效果/Utility
- Flex 布局
- 覆蓋/Cover
- 導航類組件
- 導航菜單
- 導航欄
- 二級導航
- 面包屑/Breadcrumb
- 分頁
- 選項卡
- 縮略圖導航/Thumbnav
- 頁面元素
- 列表
- 描述列表
- 表格
- 表單
- 常用組件
- 按鈕
- 圖標
- 關閉/Close
- 徽章/Badge
- 提示框
- 縮略圖/Thumbnail
- 遮罩/Overlay
- 文本
- 列
- 動畫
- 對比度/Contrast
- JAVASCRIPT組件
- 下拉菜單
- 模態對話框
- 抽屜/Off-canvas
- 切換器/Switcher
- 撥動/toggle
- 滾動監聽/Scrollspy
- 平滑滾動
- 附加組件
- 布局類組件
- 動態網格
- 視差網格
- 導航類組件
- 圓點導航
- 滑動導航/Slidenav
- 動態分頁
- 常用組件
- 高級表單
- 文件表單/Form file
- 密碼表單
- 選擇表單
- 占位符
- 進度條/Progress
- JAVASCRIPT組件
- 燈箱/Lightbox
- 自動完成/Autocomplete
- 日期選擇器/Datepicker
- HTML 編輯器
- 滾動條/Slider
- 滑塊集/Slideset
- 幻燈片/Slideshow
- 視差/Parallax
- 手風琴/Accordion
- 通知/Notify
- 搜索/Search
- 可嵌套/Nestable
- 可排序/Sortable
- 附著/Sticky
- 時間選擇器
- 工具提示/Tooltip
- 上傳