切换卡 Tabs

Constructor

Implements: Widget

Tutorials: 控件对象使用快速入门

可设置的属性

NameTypeDescription
nameString控件的名字,唯一标志
titleString控件title
hiddenBoolean隐藏
tabsArray选项卡内容
selectedIndexNumber选中的选项卡索引

可获取的属性

NameTypeDescription
nameString控件的名字,唯一标志
titleString控件title
hiddenBoolean隐藏
selectedIndexNumber选中的选项卡索引

方法

hide

Description: 隐藏一个tab页

NameDescription
调用参数Nameindex
TypeNumber
Description面板索引
返回值

调用举例:

var widget = vjsp.Parser.getWidgetByName('tabs');
widget.doMethod('hide' , 1);

show

Description: 显示一个tab页

NameDescription
调用参数Nameindex
TypeNumber
Description面板索引
返回值

调用举例:

var widget = vjsp.Parser.getWidgetByName('tabs');
widget.doMethod('show' , 1);

addTab

Description: 增加一个tab页

调用参数:

NameTypeAttributesDefaultDescription
textStringtab标签文字
contentString|HTMLElement内容html(或HTML元素)
contentBoolean内容html(或HTML元素)
hiddenString<optional>false是否隐藏

返回值:

调用举例:

var widget = vjsp.Parser.getWidgetByName('tabs');
widget.doMethod('addTab' , '新增Tab' , '新增content');

removeTab

Description: 删除一个tab页

NameDescription
调用参数Nameindex
TypeNumber
Description面板索引
返回值

调用举例:

var widget = vjsp.Parser.getWidgetByName('tabs');
widget.doMethod('removeTab' , 1);

事件

selected

Description: 选项卡被选择

NameDescription
回调函数参数NameselectedIndex
TypeObject
Description被选择的选项卡索引

绑定举例:

var widget = vjsp.Parser.getWidgetByName('tabs');
widget.on('selected' , function(selectedIndex){
    vjsp.alert('切换到tab索引:' + selectedIndex);
});

removeTab

Description: 删除事件 可通过this.reurnValue=false取消删除

NameTypeDescription
回调函数参数NameremoveTabIndex
TypeObject
Description被删除的选项卡索引
returnValueBooleanthis.reurnValue=false 取消删除

绑定举例:

var widget = vjsp.Parser.getWidgetByName('tabs');
widget.on('removeTab' , function(removeTabIndex){
    //禁止删除索引为0的 tab
    if(removeTabIndex === 0){
        this.returnValue = false;
    }
});

hidden

Description: 隐藏事件(隐藏显示触发 回调参数为隐藏状态)

回调函数参数

NameTypeDescription
hiddenStateBoolean隐藏状态true为隐藏、false为取消隐藏

绑定举例:

var widget = vjsp.Parser.getWidgetByName('tabs');
widget.on('hidden' , function(hiddenState){
    if(hiddenState){
        vjsp.alert('控件被隐藏');
    }else{
        vjsp.alert('控件取消隐藏');
    }
});