本节介绍navtab组件的参数、方法及事件。
DOM方式初始化navtab的,推荐使用集合属性
data-options定义参数,如果使用data属性定义参数,注意转换成对应的名称,参见data属性一节。
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| id | string | undefined | [必选] 标签的ID,如果指定重复,将覆盖现有的ID相同标签。 |
| title | string | New tab | [可选] 标签打开后显示的名称。 |
| url | string | undefined | [必选] D-Url 请求数据的url,a链接触发时可以将url定义在href属性。 |
| external | boolean | false | [可选] 是否以iframe方式加载外部页面。 |
| type | string | GET | [可选] Http请求方式,可选‘GET/POST’。 |
| data | object | {} | [可选] 请求url时,需要发送的data数据。 |
| loadingmask | boolean | true | [可选] ajax请求时是否显示数据加载遮罩。 |
| fresh | boolean | false | [可选] 是否保持该navtab的新生状态,表现在重复打开该navtab时,是否重新载入内容。 |
| reloadWarn | string | null | [可选] 当准备在已存在的navtab上加载内容时的确认提示信息。 |
| autorefresh | boolean/int(秒) | false | [可选] 指定该navtab是否可自动刷新,为true时默认间隔15秒自动刷新,指定具体的秒数则以指定的间隔秒值自动刷新。 |
| onLoad | function($navtab) | null | [可选] navtab加载完成后的事件回调,回调函数的参数$navtab为该navtab内容区的jQuery对象。 |
| beforeClose | function($navtab) | null | [可选] 返回值: boolean。 navtab关闭前的事件回调,返回true则关闭,返回false不关闭。 |
| onClose | function() | null | [可选] navtab关闭后的事件回调。 |
| 方法名 | 参数类型 | 参数说明 | 描述 |
|---|---|---|---|
| switchTab(tabid) | string | 标签ID | 切换到某个标签。 |
| refresh(tabid) | string | 标签ID,ID为空则刷新当前标签 |
刷新某个标签。 |
| reloadFlag(tabids) | string | 一个或多个标签ID,多个ID以,分隔 |
为某(几)个标签设定重载标记(当切换到该标签时重新载入)。 |
| reload(options) | object | 同navtab默认参数 | 重新载入某个标签,如果未指定ID,则默认重载入当前标签。 |
| closeTab(tabid) | string | 标签ID | 关闭某个标签。 |
| closeCurrentTab([tabid]) | string | 标签ID,可选。 | 关闭当前标签。 |
| closeAllTab() | -- | -- | 关闭所有标签。 |
| 事件名称 | 中文说明 | 描述 |
|---|---|---|
| bjui.beforeLoadNavtab | 载入navtab内容前事件 | 监听该事件,可以在载入navtab内容前进行相关操作。 |
| bjui.beforeCloseNavtab | 关闭navtab前事件 | 监听该事件,可以在关闭navtab前进行相关操作。 |
这样监听navtab的事件:
$(document).on('bjui.beforeLoadNavtab', function(e) {
var $navtab = $(e.target)
// do something...
})