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 | - |