ht.widget.TabView()

new TabView()

页签组件,以页签的方式呈现多组件,页签支持拖拽和关闭等功能

Methods

addPropertyChangeListener(listener, scope, ahead)

增加自身属性变化事件监听器

Parameters:
Name Type Attributes Description
listener function

监听器函数

scope Object <optional>

监听器函数域

ahead Boolean <optional>

是否将当前监听器插入到监听器列表开头

See:

addToDOM(parentNode)

将组件加入到指定的DOM元素底下,不指定则加入到 document.body 下

Parameters:
Name Type Description
parentNode DOM

DOM元素,默认为 document.body

addViewListener(listener, scope, ahead)

监听视图事件,如布局、刷新等

Parameters:
Name Type Attributes Description
listener function

监听器函数

scope Object <optional>

监听器函数域

ahead Boolean <optional>

是否将当前监听器插入到监听器列表开头

get(nameOrIndex)

获取指定的Tab对象,参数可为Tab的标签文字或索引

Parameters:
Name Type Description
nameOrIndex String | Number

标签文字或索引

getContentDiv() → {HTMLDivElement}

获取组件的内容区域Div

Returns:
HTMLDivElement

getCurrentTab() → {ht.Tab}

获取当前选中的Tab对象

Returns:
ht.Tab

getHeight() → {Number}

获取布局高度

Returns:
Number

getInsertColor() → {color}

获取提示插入位置颜色

Returns:
color

getLabel(tab) → {String}

获取tab对象显示的文字,默认返回tab.toLabel(),可重载自定义

Parameters:
Name Type Description
tab ht.Tab
Returns:
String

getLabelColor() → {color}

获取页签文字颜色,可重载自定义

Returns:
color

getLabelFont() → {String}

获取页签文字字体,可重载自定义

Returns:
String

getLogicalPoint(event) → {Object}

传入HTML事件对象,将事件坐标转换为组件中的逻辑坐标

Parameters:
Name Type Description
event Event

事件对象

Returns:
Object
See:

getMoveBackground() → {color}

获取移动时的页签背景色

Returns:
color

getSelectBackground() → {color}

获取页签选中线条背景色

Returns:
color

getSelectWidth() → {Number}

获取页签选中的线条宽度,默认值为3

Returns:
Number

getTabBackground() → {color}

获取页签背景色

Returns:
color

getTabGap() → {Number}

获取页签间隔,默认值为1

Returns:
Number

getTabHeight() → {Number}

获取页签高度

Returns:
Number

getTabModel() → {ht.DataModel}

获取页签模型容器,用于增删Tab页签

Returns:
ht.DataModel

getTabPosition() → {String}

获取页签位置,可用值有:top|bottom|left|right|left-vertical|right-vertical,默认值为top

Returns:
String

getTabWidth(tab) → {Number}

获取页签宽度,可重载自定义

Parameters:
Name Type Description
tab ht.Tab

页签

Returns:
Number

getTitleDiv() → {HTMLDivElement}

获取页签的div容器

Returns:
HTMLDivElement

getTranslateX() → {Number}

获取水平平移(滚动)值

Returns:
Number

getTranslateY() → {Number}

获取垂直平移(滚动)值

Returns:
Number

getView() → {HTMLDivElement}

获取组件的根层div

Returns:
HTMLDivElement

getWidth() → {Number}

获取布局宽度

Returns:
Number

invalidate(delay)

无效组件,并调用延时刷新

Parameters:
Name Type Description
delay Number

延迟刷新的间隔事件(单位:ms)

See:

isDisabled() → {Boolean}

组件是否处于不可用状态,处于此状态时不能进行任何操作并且会遮挡一层蒙板

Returns:
Boolean

isMovable() → {Boolean}

获取页签是否可拖拽移动改变显示顺序,默认值为true

Returns:
Boolean

iv(delay)

无效组件,并调用延时刷新,invalidate的缩写

Parameters:
Name Type Description
delay Number

延迟刷新的间隔事件(单位:ms)

See:

lp(event) → {Object}

传入HTML事件对象,将事件坐标转换为组件中的逻辑坐标,getLogicalPoint的缩写

Parameters:
Name Type Description
event Event

事件对象

Returns:
Object
See:

mp(listener, scope, ahead)

增加自身属性变化事件监听器,addPropertyChangeListener的缩写

Parameters:
Name Type Attributes Description
listener function

监听器函数

scope Object <optional>

监听器函数域

ahead Boolean <optional>

是否将当前监听器插入到监听器列表开头

See:

onTabChanged(oldTab, newTab)

当前选中Tab对象变化时回调,可重载做后续处理

Parameters:
Name Type Description
oldTab ht.Tab

旧页签

newTab ht.Tab

新选中的页签

onTabClosed(tab, index)

关闭Tab页签回调函数,可重载做后续处理

Parameters:
Name Type Description
tab ht.Tab

被关闭的页签

index Number

索引

remove(tab)

删除指定的Tab

Parameters:
Name Type Description
tab ht.Tab | Number | String

Tab对象,或整数类型的索引,或页签文字

removePropertyChangeListener(listener, scope)

删除自身属性变化事件监听器

Parameters:
Name Type Attributes Description
listener function

监听器函数

scope Object <optional>

监听器函数域

removeViewListener(listener, scope)

删除视图事件监听器

Parameters:
Name Type Attributes Description
listener function

监听器函数

scope Object <optional>

监听器函数域

select(tab)

选中指定的Tab

Parameters:
Name Type Description
tab ht.Tab | Number | String

Tab对象,或整数类型的索引,或页签文字

setDisabled(value, iconUrl)

设置组件是否处于不可用状态,处于不可用状态时不能进行任何操作并且会遮挡一层蒙板

Parameters:
Name Type Attributes Description
value Boolean

是否禁用组件

iconUrl String <optional>

蒙板上显示的icon的路径

setHeight(height)

设置布局高度

Parameters:
Name Type Description
height Number

高度值

setInsertColor(color)

设置提示插入位置颜色

Parameters:
Name Type Description
color color

setLabelColor(color)

设置页签文字颜色

Parameters:
Name Type Description
color color

setLabelFont(font)

设置页签文字字体

Parameters:
Name Type Description
font String

setMovable(v)

设置页签是否可拖拽移动改变显示顺序,默认值为true

Parameters:
Name Type Description
v Boolean

setMoveBackground(color)

设置移动时的页签背景色

Parameters:
Name Type Description
color color

setSelectBackground(color)

设置页签选中线条背景色

Parameters:
Name Type Description
color color

setSelectWidth(width)

设置页签选中的线条宽度,默认值为3

Parameters:
Name Type Description
width Number

setTabBackground(color)

设置页签背景色

Parameters:
Name Type Description
color color

setTabGap(v)

设置页签间隔,默认值为1

Parameters:
Name Type Description
v Number

setTabHeight(v)

设置页签高度

Parameters:
Name Type Description
v Number

setTabPosition(v)

设置页签位置,可用值有:top|bottom|left|right|left-vertical|right-vertical,默认值为top

Parameters:
Name Type Description
v String

setTranslateX(x)

设置组件水平平移(滚动)值

Parameters:
Name Type Description
x Number

水平平移(滚动)值

setTranslateY(y)

设置组件垂直平移(滚动)值

Parameters:
Name Type Description
y Number

垂直平移(滚动)值

setWidth(width)

设置布局宽度

Parameters:
Name Type Description
width Number

tx(value)

获取或设置水平平移(滚动)值,没有参数时相当于getTranslateX,有参数时相当于setTranslateX

Parameters:
Name Type Description
value Number

平移(滚动)值

ty(value)

获取或设置垂直平移(滚动)值,没有参数时相当于getTranslateY,有参数时相当于setTranslateY

Parameters:
Name Type Description
value Number

平移(滚动)值

ump(listener, scope)

删除自身属性变化事件监听器,removePropertyChangeListener的缩写

Parameters:
Name Type Attributes Description
listener function

监听器函数

scope Object <optional>

监听器函数域

See:

validate()

立刻刷新组件