# 拨动/toggle
使用一个拨动器来隐藏,切换,或者改变各种内容的外观。
## 用法
要使用这个组件,只需要添加 `data-uk-toggle="{target: #ID}"` 属性到一个 `<button>` 或 `<a>` 元素中。你可以在任意选择器中使用这个拨动属性。
拨动器会在页面的某元素中添加或者删除一个class类。默认情况下,它会添加 `.uk-hidden` 类来隐藏这个元素。
### 示例
![](https://box.kancloud.cn/2016-05-12_57346f39e3e37.jpg)
干嘛?
### Code
```
<button class="uk-button" data-uk-toggle="{target:'#my-id'}">...</button>
<div id="my-id">...</div>
```
* * *
## 拨动多个元素
你也可以同时拨动多个元素。使用适当的选择器就行。
### 示例
![](https://box.kancloud.cn/2016-05-12_57346f3a01eba.jpg)
注意 在这个例子中,我们为其中一个元素添加了 `.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` 类,你也可以添加你的自定义类。
### 示例
![](https://box.kancloud.cn/2016-05-12_57346f3a132e6.jpg)
注意 在这个例子中我们使用了 `.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` 参数中。 元素出现和消失都使用这个类。如果你喜欢不同的动画,只需添加另一个动画类就行了。
### 示例
![](https://box.kancloud.cn/2016-05-12_57346f3a24e9e.jpg)
### 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
- 上传