阅读(1280) (0)

Tab 选项卡

2017-05-25 19:05:04 更新

调用方式

  • 通过自定义属性调用
  • 通过 JavaScript 调用

相关资料

Material Design Tab 选项卡设计规范


样式

基础样式

下面是一个标准选项卡。在手机上时会占据 100% 的宽度,每一个选项宽度都相等;在平板/PC 上会左对齐。

www.mdui.org - Tab 选项卡 - 基础样式

在线运行


可滚动

在 <div class="mdui-tab"> 上添加类 .mdui-tab-scrollable 使选项卡可以横向滚动,用于选项较多的场景。

www.mdui.org - Tab 选项卡 - 可滚动

在线运行


居中对齐

在 <div class="mdui-tab"></div> 元素上添加类 .mdui-tab-centered 可使选项卡在平板/PC 上居中对齐。

www.mdui.org - Tab 选项卡 - 居中对齐

在线运行


100% 宽度

在 <div class="mdui-tab"></div> 元素上添加类 .mdui-tab-full-width 可以使选项卡始终占据 100% 的宽度,且每个选项卡宽度相等。

www.mdui.org - Tab 选项卡 - 100%宽度

在线运行


含图标

www.mdui.org - Tab 选项卡 - 含图标

在线运行


含图标和文本

www.mdui.org - Tab 选项卡 - 含图标和文本

在线运行


含背景色

在 <div class="mdui-tab"></div> 的元素上添加类 .mdui-color-[color] 即可为选项卡赋予背景色。

www.mdui.org - Tab 选项卡 - 含背景色

在线运行


默认激活的选项

在 <a> 元素上添加类 .mdui-tab-active 可以使该选项处于默认激活状态。

www.mdui.org - Tab 选项卡 - 默认激活的选项

在线运行


禁用状态的选项

在 <a> 元素上添加 disabled 属性可以禁用该选项。

www.mdui.org - Tab 选项卡 - 禁用状态的选项

在线运行


调用方式

通过自定义属性调用

使用该方式无需编写 JavaScript 代码,只需在元素 <div class="mdui-tab"></div> 上添加 mdui-tab="options" 属性即可激活该组件。

<div class="mdui-tab" mdui-tab>
...
</div>


通过 JavaScript 调用

实例化组件:

// selector 为 .mdui-tab 元素的 CSS 选择器或 DOM 元素
// options 为插件的参数,见下面的参数列表
var inst = new mdui.Tab(selector, options);

在线运行


参数

 参数名 类型 默认值 描述
 trigger string click 切换选项卡的触发方式。默认为 click
  • click: 点击切换
  • hover: 鼠标悬浮切换
 loop boolean false
 是否启用循环切换,若为 true,则最后一个选项激活时调用 next 方法将回到第一个选项,第一个选项激活时调用 prev 方法将回到最后一个选项。


方法

 方法名 描述
 prev() 切换到上一个选项
 next() 切换到下一个选项
 show(index) 显示指定的选项。
  • index:选项的索引号或 id
 handleUpdate() 当父元素的宽度发生变化时,需要调用该方法重新设置指示器位置。


事件

 事件名 描述 目标 参数
 change.mdui.tab 切换选项时,事件将被触发。 <div class="mdui-tab">
  • event.detail.inst:实例

  • event.detail.index:激活的选项的索引号

  • event.detail.id:激活的选项的选项卡内容的id

 show.mdui.tab 切换到指定选项时,事件将被触发。 <a> event.detail.inst:实例


CSS 类名列表

 类名 效果
 .mdui-tab 定义一个选项卡组件。
 .mdui-tab-scrollable 可滚动选项卡组件。
 .mdui-tab-centered 居中对齐的选项卡组件。
 .mdui-tab-full-width 100% 宽度的选项卡组件。
 .mdui-tab-active 激活状态的选项。