twaver.Tab Class
选项卡对象
选项卡是一种基本元素,它是存在于选项卡容器中的(TabBox)。选项卡是用来显示在选项卡面板中的基本元素
Constructor
twaver.Tab
-
[id]
Parameters:
-
[id]Object optionalID为选项卡的唯一标识。如果为null,TWaver内部会按照一定的规则赋值。ID可以为string,number类型,也可以为Object类型。为string或number类型时指的是选项卡的ID,如果为Object类型,可以传入一个带选项卡属性的对象,比如: var tab = new twaver.Tab({ width:50, closable:true, resizable:true });
Returns:
Item Index
Methods
- twaver.Data.addChild
- twaver.Data.clearChildren
- twaver.Data.deserializeClientJson
- twaver.Data.deserializeClientXml
- twaver.Data.deserializeJson
- twaver.Data.deserializePropertyJson
- twaver.Data.deserializePropertyXml
- twaver.Data.deserializeXml
- twaver.Data.getChildAt
- twaver.Data.getChildren
- twaver.Data.getChildrenSize
- twaver.Data.getClient
- twaver.Data.getClientMap
- twaver.Data.getClientProperties
- twaver.Data.getIcon
- twaver.Data.getId
- twaver.Data.getName
- twaver.Data.getName2
- twaver.Data.getParent
- twaver.Data.getToolTip
- twaver.Data.hasChildren
- twaver.Data.isDescendantOf
- twaver.Data.isParentOf
- twaver.Data.isRelatedTo
- twaver.Data.newInstance
- twaver.Data.onChildAdded
- twaver.Data.onChildRemoved
- twaver.Data.onChildrenCleared
- twaver.Data.onClientChanged
- twaver.Data.onParentChanged
- twaver.Data.removeChild
- twaver.Data.serializeClientJson
- twaver.Data.serializeClientXml
- twaver.Data.serializeJson
- twaver.Data.serializePropertyJson
- twaver.Data.serializePropertyXml
- twaver.Data.serializeXml
- twaver.Data.setClient
- twaver.Data.setIcon
- twaver.Data.setName
- twaver.Data.setName2
- twaver.Data.setParent
- twaver.Data.setToolTip
- twaver.Data.toChildren
- twaver.PropertyChangeDispatcher.addPropertyChangeListener
- twaver.PropertyChangeDispatcher.firePropertyChange
- twaver.PropertyChangeDispatcher.getClassName
- twaver.PropertyChangeDispatcher.onPropertyChanged
- twaver.PropertyChangeDispatcher.removePropertyChangeListener
- twaver.Tab.getView
- twaver.Tab.getWidth
- twaver.Tab.isClosable
- twaver.Tab.isDisabled
- twaver.Tab.isMovable
- twaver.Tab.isResizable
- twaver.Tab.isVisible
- twaver.Tab.setClosable
- twaver.Tab.setDisabled
- twaver.Tab.setMovable
- twaver.Tab.setResizable
- twaver.Tab.setView
- twaver.Tab.setVisible
- twaver.Tab.setWidth
Methods
twaver.Data.addChild
-
child -
[index]
在父亲数据下添加孩子数据,index为添加的孩子数据的顺序号,树中同层下的孩子顺序可以通过这个参数来控制。默认为空,添加在最后一个位置
Parameters:
-
childtwaver.Data添加的孩子数据
-
[index]Number optional添加的孩子数据的顺序,树中的同层下的孩子顺序是通过这个参数来控制的。默认为空,也就是添加在最后一个位置
Returns:
添加成功返回true,否则为false
twaver.Data.clearChildren
()
Boolean
清除这个数据下所有的孩子。注意,这个方法只是切断它们之间的父子关系,并不会从DataBox中将孩子数据删除
Returns:
true为操作成功,false为操作失败
twaver.Data.deserializeClientJson
-
serializer -
json -
clientProp
反序列化JSON数据到数据对象的自定义属性
Parameters:
-
serializertwaver.JsonSerializerJSON序列化对象
-
jsonStringJSON数据
-
clientPropString自定义的属性名
twaver.Data.deserializeClientXml
-
serializer -
clientXml -
clientProp
反序列化XML数据到数据对象的自定义属性值
Parameters:
-
serializertwaver.XmlSerializerXML的序列化对象
-
clientXmlStringXML数据片段
-
clientPropString自定义属性名
twaver.Data.deserializeJson
-
serializer -
json
将JSON数据反序列化为数据对象
Parameters:
-
serializertwaver.JsonSerializerJSON序列化对象
-
jsonStringJSON数据
twaver.Data.deserializePropertyJson
-
serializer -
json -
property
反序列化JSON数据到数据对象的自身属性
Parameters:
-
serializertwaver.JsonSerializerJSON序列化对象
-
jsonStringJSON数据片段
-
propertyString数据自身属性名
twaver.Data.deserializePropertyXml
-
serializer -
propertyXml -
property
反序列化XML数据到数据对象的自身属性
Parameters:
-
serializertwaver.XmlSerializerXML序列化对象
-
propertyXmlStringXML数据片段
-
propertyString数据自身属性名
twaver.Data.deserializeXml
-
serializer -
xml
将XML数据反序列化为数据对象
Parameters:
-
serializertwaver.XmlSerializerXML序列化对象
-
xmlStringXML数据
twaver.Data.getChildAt
-
index
获取某个序号值上的孩子对象
Parameters:
-
indexNumber数据的顺序值
Returns:
孩子数据对象
twaver.Data.getChildrenSize
()
Number
获取数据对象下孩子的数量
Returns:
孩子数据的数量
twaver.Data.getClient
-
clientProp
获取自定义的属性,Client属性一般用于存放用户自定在数据对象上的属性
Parameters:
-
clientPropString自定义的属性名
Returns:
返回属性值
twaver.Data.getClientProperties
()
twaver.List
获取所有自定义的属性名。Client属性一般用于存放用户自定在数据对象上的属性
Returns:
自定义属性的集合
twaver.Data.getIcon
()
String
得到这个数据的图标,图标是用于在树上显示的。
Returns:
返回图标的名称
twaver.Data.getId
()
Object
得到数据的ID,ID是用于唯一标识数据对象的,在同一个数据容器中的数据ID不能重复
Returns:
数据的ID编号
twaver.Data.getName
()
String
获取数据对象的名称
Returns:
数据对象的名称值
twaver.Data.getName2
()
String
获取数据对象的名称2
Returns:
返回数据对象的名称2
twaver.Data.getToolTip
()
String
获取数据对象的悬浮标签,悬浮标签是用于在视图上显示的,比如network,tree,table。悬浮标签在视图上显示片刻便会消失。
Returns:
数据对象的悬浮标签内容
twaver.Data.hasChildren
()
Boolean
判断这个数据对象下是否有孩子对象
Returns:
true为有孩子对象,否则为false
twaver.Data.isDescendantOf
-
data
判断是否是指定数据对象的子孙节点
Parameters:
-
datatwaver.Data指定的数据对象
Returns:
true为子孙节点,否则为false
twaver.Data.isParentOf
-
data
判断是否是指定数据对象的父亲
Parameters:
-
datatwaver.Data指定的数据对象
Returns:
true为指定数据对象的父亲,否则为false
twaver.Data.isRelatedTo
-
data
判断是否和指定数据对象有关联关系,如果这个数据是指定数据对象的子孙或者指定数据对象是这个数据的子孙都称为有关联关系
Parameters:
-
datatwaver.Data指定的数据对象
Returns:
true为有关联关系,否则为false
twaver.Data.onChildAdded
-
child -
index
添加完孩子成功后会回调这个方法
Parameters:
-
childtwaver.Data添加的孩子对象
-
indexNumber孩子添加的顺序
twaver.Data.onChildRemoved
-
child -
index
删除指定孩子对象时会回调这个方法
Parameters:
-
childtwaver.Data删除的孩子对象
-
indexNumber删除的孩子对象的顺序序号
twaver.Data.onChildrenCleared
-
children
清除所有指定孩子对象时会回调这个方法
Parameters:
-
childrentwaver.List清除的孩子对象集合
twaver.Data.onClientChanged
-
clientProp -
oldValue -
newValue
当数据对象的Client属性发生更改时会回调此方法
Parameters:
-
clientPropString属性名
-
oldValueString原值
-
newValueString新值
twaver.Data.onParentChanged
-
oldParent -
parent
当数据对象的父亲发生更改时回调此方法
Parameters:
-
oldParenttwaver.Data数据对象原来的父亲节点
-
parentString数据对象新的父亲节点
twaver.Data.removeChild
-
child
删除指定的孩子对象
Parameters:
-
childtwaver.Data指定的孩子对象
Returns:
返回true表示删除成功,false为删除失败
twaver.Data.serializeClientJson
-
serializer -
clientPrope -
newInstance -
dataObject
序列化数据元素的自定义属性到JSON片段
Parameters:
-
serializertwaver.JsonSerializerJSON序列化对象
-
clientPropeString数据对象的自定义属性名
-
newInstancetwaver.Data序列化的数据对象
-
dataObjectObjectJSON数据对象
twaver.Data.serializeClientXml
-
serializer -
clientPrope -
newInstance
序列化数据元素的自定义属性到XML片段
Parameters:
-
serializertwaver.XmlSerializerXML序列化对象
-
clientPropeString自定义的属性名称
-
newInstancetwaver.Data序列化的实例对象
twaver.Data.serializeJson
-
serializer -
newInstance -
dataObject
将数据元素序列化成JSON片段
Parameters:
-
serializertwaver.JsonSerializerJSON序列化对象
-
newInstancetwaver.Data序列化的实例对象
-
dataObjectObjectJSON数据对象
twaver.Data.serializePropertyJson
-
serializer -
property -
newInstance -
dataObject
序列化数据元素属性到JSON片段
Parameters:
-
serializertwaver.JsonSerializerJSON序列化对象
-
propertyString序列化的属性名称
-
newInstancetwaver.Data序列化的实例对象
-
dataObjectObjectJSON数据对象
twaver.Data.serializePropertyXml
-
serializer -
property -
newInstance
序列化数据元素属性到XML片段
Parameters:
-
serializertwaver.XmlSerializerXML序列化对象
-
propertyString数据元素的属性名称
-
newInstancetwaver.Data序列化的实例对象
twaver.Data.serializeXml
-
serializer -
newInstance
将数据元素序列化成XML片段
Parameters:
-
serializertwaver.XmlSerializerXML序列化对象
-
newInstancetwaver.Data序列化的实例对象
twaver.Data.setClient
-
clientProp -
newValue
设置自定义的属性的值
Parameters:
-
clientPropString自定义属性的名称
-
newValueObject自定义属性的值
Returns:
数据对象本身
twaver.Data.setIcon
-
v
设置数据元素的Icon。Icon和Image是类似的,但需要注意,Icon一般是在树上显示的,而Image是在network上显示的。
Parameters:
-
vString数据元素的Icon名称
twaver.Data.setName
-
v
设置数据元素的名称
Parameters:
-
vString数据元素的名称
twaver.Data.setName2
-
v
设置数据对象的名称2
Parameters:
-
vString数据对象的名称2
twaver.Data.setToolTip
-
v
设置悬浮标签的显示内容。当鼠标移至数据元素时,视图上就会显示这个悬浮标签一段时间。
Parameters:
-
vString悬浮标签显示的内容
twaver.Data.toChildren
-
matchFunction -
scope
根据指定的函数,将数据元素的孩子转换成List集合
Parameters:
-
matchFunctionFunction指定的函数
-
scopeString函数的作用域,为空时指的是window
Returns:
孩子数据的集合
twaver.PropertyChangeDispatcher.addPropertyChangeListener
-
listener -
[scope] -
[ahead]
添加属性变化监听器,用于监听属性变化
Parameters:
-
listenerFunction属性变化监听器
-
[scope]Object optional可选,属性变化监听器的作用域,默认为null,即全局
-
[ahead]Boolean optional可选,是否将此监听放在最前面,默认为false
Example:
var dispatcher = new twaver.PropertyChangeDispatcher(); dispatcher.addPropertyChangeListener(function (e) { console.log(e.property, e.newValue, e.oldValue); });
twaver.PropertyChangeDispatcher.firePropertyChange
-
property -
oldValue -
newValue
派发属性变化事件,属性变化时调用此方法
Parameters:
-
propertyString发生变化的属性
-
oldValueObject和此属性相关的旧值
-
newValueObject和此属性相关的新值
Returns:
如果新值和旧值相等则返回false,否则返回true
twaver.PropertyChangeDispatcher.getClassName
()
String
获取此类的字符串类名
Returns:
返回此类的字符串类名
twaver.PropertyChangeDispatcher.onPropertyChanged
-
e
属性变化时(firePropertyChange)触发的动作,不需要调用此方法,但可以重载此方法执行自定义逻辑
Parameters:
-
eObject属性变化事件,包含property、oldValue和newValue的Object对象
twaver.PropertyChangeDispatcher.removePropertyChangeListener
-
listener -
[scope]
删除指定作用域的属性变化监听器,作用域必须和添加监听器时的作用域一致,相同的作用域的相同监听器只能成功添加一次
Parameters:
-
listenerFunction属性变化监听器
-
[scope]Object optional属性变化监听器的作用域,可选,默认为null,代表全局
twaver.Tab.getView
()
Object
获取显示在选项卡中的视图组件
Returns:
视图组件
twaver.Tab.getWidth
()
Number
获取选项卡的宽度
Returns:
选项卡的宽度
twaver.Tab.isClosable
()
Boolean
获取选项卡是否可关闭。默认值为false
Returns:
true为可关闭,false不可关闭
twaver.Tab.isDisabled
()
Boolean
获取选项卡是否不可用。默认值为false
Returns:
true为可用,false不可用
twaver.Tab.isMovable
()
Boolean
判断是否可移动,默认值为true
Returns:
true为可移动,否则为false
twaver.Tab.isResizable
()
Boolean
判断是否可改变大小,默认值为true
Returns:
true为可改变大小,否则为false
twaver.Tab.isVisible
()
Boolean
判断是否可见
Returns:
true为可见,否则为false
twaver.Tab.setClosable
-
v
设置选项卡是否可关闭。默认值为false
Parameters:
-
vBooleantrue为可关闭,false不可关闭
twaver.Tab.setDisabled
-
v
设置选项卡是否不可用,默认值为false
Parameters:
-
vBooleantrue为可用,false不可用
twaver.Tab.setMovable
-
v
设置是否可移动,默认值为true
Parameters:
-
vBooleantrue为可移动,否则为false
twaver.Tab.setResizable
-
v
设置是否可改变大小,默认值为true
Parameters:
-
vBooleantrue为可改变大小,否则为false
twaver.Tab.setView
-
v
设置显示在选项卡中的视图组件
Parameters:
-
vObject视图组件
twaver.Tab.setVisible
-
v
设置是否可见,默认值为true
Parameters:
-
vBooleantrue为可见,否则为false
twaver.Tab.setWidth
-
v
设置选项卡的宽度
Parameters:
-
vNumber选项卡的宽度
Properties
IClient
Boolean
IClient标志,默认为true,表明这个对象是IClient类型。
IData
Boolean
IData属性标志,默认为true,表明这个对象是IData的类型
ITab
Boolean
是否是选项卡的标识
