本节介绍navtab组件的参数、方法及事件。

参数(options)

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...
            })