jQuery EasyUI API 中文文档 - Tabs标签页/选项卡

Tabs 标签页/选项卡

用$.fn.tabs.defaults重写defaults。

依赖
panel
linkbutton
用法示例
创建tabs
1、 经由标记创建Tabs
从标记创建Tabs更容易，我们不需要写任何JavaScript代码。记住把 'easyui-tabs' 类添加到<div/>标记，每个tab panel 经由子<div/>标记被创建，其用法与Panel一样。
复制代码 代码如下:
<div id="tt" class="easyui-tabs" style="width:500px;height:250px;">
<div title="Tab1" style="padding:20px;display:none;">
tab1
</div>
<div title="Tab2" closable="true" style="overflow:auto;padding:20px;display:none;">
tab2
</div>
<div title="Tab3" iconCls="icon-reload" closable="true" style="padding:20px;display:none;">
tab3
</div>
</div>

2. 编程创建Tabs
现在我们编程创建 Tabs，我们同时捕捉 'onSelect' 事件。
复制代码 代码如下:
$('#tt').tabs({
border:false,
onSelect:function(title){
alert(title+' is selected');
}
});

增加新的 tab panel
复制代码 代码如下:
// 增加一个新的 tab panel
$('#tt').tabs('add',{
title:'New Tab',
content:'Tab Body',
closable:true
});

获取选中的 Tab
复制代码 代码如下:
// 获取选中的 tab panel 和它的 tab 对象
var pp = $('#tt').tabs('getSelected');
var tab = pp.panel('options').tab; // 相应的 tab 对象

特性

名称

类型

说明

默认值

width

number

Tabs 容器的宽度。

auto

height

number

Tabs 容器的高度。

auto

plain

boolean

True 就不用背景容器图片来呈现 tab 条。

false

fit

boolean

True 就设置 Tabs 容器的尺寸以适应它的父容器。

false

border

boolean

True 就显示 Tabs 容器边框。

true

scrollIncrement

number

每按一次tab 滚动按钮，滚动的像素数。

100

scrollDuration

number

每一个滚动动画应该持续的毫秒数。

400

tools

array

右侧工具栏，每个工具选项都和 Linkbutton 一样。

null

事件

名称

参数

说明

onLoad

panel

当一个 ajax tab panel 完成加载远程数据时触发。

onSelect

title

当用户选择一个 tab panel 时触发。

onBeforeClose

title

当一个 tab panel 被关闭前触发，返回 false 就取消关闭动作。

onClose

title

当用户关闭一个 tab panel 时触发。

onAdd

title

当一个新的 tab panel 被添加时触发。

onUpdate

title

当一个 tab panel 被更新时触发。

onContextMenu

e, title

当一个 tab panel 被右键点击时触发。

方法

名称

参数

说明

options

none

返回 tabs options。

tabs

none

返回全部 tab panel。

resize

none

调整 tabs 容器的尺寸并做布局。

add

options

增加一个新的 tab panel，options 参数是一个配置对象，更多详细信息请参见  tab panel 特性。

close

title

关闭一个 tab panel，title 参数是指被关闭的 panel。

getTab

title

获取指定的 tab panel。

getSelected

none

获取选中的 tab panel。

select

title

选择一个 tab panel。

exists

title

是指是否存在特定的 panel。

update

param

更新指定的 tab panel，param 包含两个特性：
tab：被更新的 tab panel。
options：panel 的 options。

Tab Panel

Tab panel 特性被定义在 panel 组件里，下面是一些常用的特性。

名称

类型

说明

默认值

title

string

Tab panel 的标题文字。

 

content

string

Tab panel 的内容。

 

href

string

加载远程内容来填充 tab panel 的 URL。

null

cache

boolean

True 就在设定了有效的 href 特性时缓存这个 tab panel。

true

iconCls

string

显示在tab panel 标题上的图标的 CSS 类。

null

width

number

Tab panel 的宽度。

auto

height

number

Tab panel 的高度。

auto

一些附加的特性

名称

类型

说明

默认值

closable

boolean

当设置为 true 时，tab panel 将显示一个关闭按钮，点击它就能关闭这个tab panel。

false

selected

boolean

当设置为 true 时，tab panel 将被选中。

false