Tabs 标签页
分隔内容上有关联但属于不同类别的数据集合。
基础用法
基础的、简洁的标签页。
▼显示代码
注意
$(el)的innerHtml将被替换。
选项卡样式
选项卡样式的标签页。
用户管理内容
配置管理内容
角色管理内容
定时任务补偿内容
▼显示代码
卡片化
卡片化的标签页。
用户管理内容
配置管理内容
角色管理内容
定时任务补偿内容
▼显示代码
位置
可以通过 tabPosition 设置标签的位置
▼显示代码
自定义标签页
通过label设置标签显示文本。
▼显示代码
动态增减标签页
增减标签页按钮只能在选项卡样式的标签页下使用
▼显示代码
参数
你可以通过修改$.fn.tabs.defaults来修改全局默认配置,也可以在初始化时传入指定配置$(el).tabs({xx: xx})。
参数默认为 Json ,若为数组,则会被当做tabs赋值。
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| tabs | tabs数据数组,每个选项为一个tab配置的json,详情见下方的“tab配置” | array | - | - |
| type | 风格类型 | string | card/border-card | - |
| closable | 标签是否可关闭(type为card/border-card时有效) | boolean | — | false |
| addable | 标签是否可增加 | boolean | - | false |
| value | 绑定值,选中选项卡的 name | string | - | 第一个非disabled的选项卡的 name |
| tabPosition | 选项卡所在位置 | string | top/right/bottom/left | 'top' |
| stretch | 标签的宽度是否自撑开 | boolean | - | false |
| beforeLeave | 切换标签之前的钩子,若返回 false 或者返回 Promise 且被 reject,则阻止切换。 | Function(newName, oldName) | - | - |
| tabClick | tab 被选中时触发 | Function(newName, oldName) | - | - |
| tabRemove | 点击 tab 移除按钮后触发 | Function(name) | - | - |
| tabAdd | 点击 tabs 的新增按钮后触发 | Function | - | - |
tab配置
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| label | 选项卡标题 | string | - | 对应name的值 |
| disabled | 是否禁用 | boolean | - | false |
| name | 必填,选项卡标识符 | string | - | - |
| closable | 标签是否可关闭 | boolean | - | 上方整体参数配置的closable |
| selector | 本tab标签控制的显示元素,其css选择器 | string | - | - |
| content | tab标签对应的主体内容,支持html(优先级低于selector) | string | - | - |
方法
通过 $(el).tabs(xxx, yyy) 调用 tabs 的xxx方法,传入yyy参数(可参考【动态增减标签页】)。
| 事件名称 | 说明 | 参数 |
|---|---|---|
| add | 添加一个标签 | tab配置 |
| remove | 移除某一个标签 | 被删除的标签的 name |
| set | 设置新的激活标签 | 新激活标签的name |
| get | 获取当前激活的标签页的name | - |