拨动/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>
动画
拨动器组件允许你为元素添加拨动的动画效果。只需要添加一个 动画组件 中的 .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 的动画类名 |