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 -