# 撥動/toggle
使用一個撥動器來隱藏,切換,或者改變各種內容的外觀。
## 用法
要使用這個組件,只需要添加 `data-uk-toggle="{target: #ID}"` 屬性到一個 `<button>` 或 `<a>` 元素中。你可以在任意選擇器中使用這個撥動屬性。
撥動器會在頁面的某元素中添加或者刪除一個class類。默認情況下,它會添加 `.uk-hidden` 類來隱藏這個元素。
### 示例

干嘛?
### Code
```
<button class="uk-button" data-uk-toggle="{target:'#my-id'}">...</button>
<div id="my-id">...</div>
```
* * *
## 撥動多個元素
你也可以同時撥動多個元素。使用適當的選擇器就行。
### 示例

注意 在這個例子中,我們為其中一個元素添加了 `.uk-hidden` 類,所以只有另一個元素會顯示出來。撥動器會在兩個元素之間切換可見狀態。
### Code
```
<button class="uk-button" data-uk-toggle="{target:'.my-class'}">...</button>
<div class="my-class">...</div>
<div class="my-class uk-hidden">...</div>
```
* * *
## 自定義class類
如果你不想切換 `.uk-hidden` 類,你也可以添加你的自定義類。
### 示例

注意 在這個例子中我們使用了 `.uk-panel-box-primary` 類來切換不同的面板樣式。
### Code
```
<button class="uk-button" data-uk-toggle="{target:'#my-id', cls:'uk-panel-box-primary'}">...</button>
<div id="my-id" class="uk-panel uk-panel-box">...</div>
```
## 動畫
撥動器組件允許你為元素添加撥動的動畫效果。只需要添加一個 [動畫組件](animation.html "Animation component") 中的 `.uk-animation-*` 類到 `animation` 參數中。 元素出現和消失都使用這個類。如果你喜歡不同的動畫,只需添加另一個動畫類就行了。
### 示例

### Code
```
<button class="uk-button" data-uk-toggle="{target:'#my-id', animation:'uk-animation-slide-left, uk-animation-slide-bottom'}">...</button>
<div id="my-id">...</div>
```
* * *
## JavaScript 選項
這是一個例子,關于如何通過屬性來設置選項:
```
data-uk-toggle="{target:'#my-id'}"
```
| 選項 | 可能的值 | 默認值 | 描述 |
| --- | --- | --- | --- |
| `target` | CSS selector | false | 被撥動的是哪個元素 |
| `cls` | string | 'uk-hidden' | 撥動的class類 |
| `animation` | mixed | false | 任意 uikit 的動畫類名 |
- 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
- 上傳