new TabView()
页签组件,以页签的方式呈现多组件,页签支持拖拽和关闭等功能
Methods
-
addPropertyChangeListener(listener, scope, ahead)
-
增加自身属性变化事件监听器
Parameters:
Name Type Argument Description listener
function 监听器函数
scope
Object <optional>
监听器函数域
ahead
Boolean <optional>
是否将当前监听器插入到监听器列表开头
- See:
-
addViewListener(listener, scope, ahead)
-
监听视图事件,如布局、刷新等
Parameters:
Name Type Argument Description listener
function 监听器函数
scope
Object <optional>
监听器函数域
ahead
Boolean <optional>
是否将当前监听器插入到监听器列表开头
-
get(nameOrIndex)
-
获取指定的Tab对象,参数可为Tab的标签文字或索引
Parameters:
Name Type Description nameOrIndex
String | Number 标签文字或索引
-
getContentDiv() → {HTMLDivElement}
-
获取组件的内容区域Div
Returns:
- Type
- HTMLDivElement
-
getCurrentTab() → {ht.Tab}
-
获取当前选中的Tab对象
Returns:
- Type
- ht.Tab
-
getHeight() → {Number}
-
获取布局高度
Returns:
- Type
- Number
-
getInsertColor() → {color}
-
获取提示插入位置颜色
Returns:
- Type
- color
-
getLabel(tab) → {String}
-
获取tab对象显示的文字,默认返回tab.toLabel(),可重载自定义
Parameters:
Name Type Description tab
ht.Tab Returns:
- Type
- String
-
getLabelColor() → {color}
-
获取页签文字颜色,可重载自定义
Returns:
- Type
- color
-
getLabelFont() → {String}
-
获取页签文字字体,可重载自定义
Returns:
- Type
- String
-
getLogicalPoint(event) → {Object}
-
传入HTML事件对象,将事件坐标转换为组件中的逻辑坐标
Parameters:
Name Type Description event
Event 事件对象
- See:
Returns:
- Type
- Object
-
getMoveBackground() → {color}
-
获取移动时的页签背景色
Returns:
- Type
- color
-
getSelectBackground() → {color}
-
获取页签选中线条背景色
Returns:
- Type
- color
-
getSelectWidth() → {Number}
-
获取页签选中的线条宽度,默认值为3
Returns:
- Type
- Number
-
getTabBackground() → {color}
-
获取页签背景色
Returns:
- Type
- color
-
getTabGap() → {Number}
-
获取页签间隔,默认值为1
Returns:
- Type
- Number
-
getTabHeight() → {Number}
-
获取页签高度
Returns:
- Type
- Number
-
getTabModel() → {ht.DataModel}
-
获取页签模型容器,用于增删Tab页签
Returns:
- Type
- ht.DataModel
-
getTabPosition() → {String}
-
获取页签位置,可用值有:top|bottom|left|right|left-vertical|right-vertical,默认值为top
Returns:
- Type
- String
-
getTabWidth(tab) → {Number}
-
获取页签宽度,可重载自定义
Parameters:
Name Type Description tab
ht.Tab 页签
Returns:
- Type
- Number
-
getTitleDiv() → {HTMLDivElement}
-
获取页签的div容器
Returns:
- Type
- HTMLDivElement
-
getTranslateX() → {Number}
-
获取水平平移(滚动)值
Returns:
- Type
- Number
-
getTranslateY() → {Number}
-
获取垂直平移(滚动)值
Returns:
- Type
- Number
-
getView() → {HTMLDivElement}
-
获取组件的根层div
Returns:
- Type
- HTMLDivElement
-
getWidth() → {Number}
-
获取布局宽度
Returns:
- Type
- Number
-
invalidate(delay)
-
无效组件,并调用延时刷新
Parameters:
Name Type Description delay
Number 延迟刷新的间隔事件(单位:ms)
- See:
-
isDisabled() → {Boolean}
-
组件是否处于不可用状态,处于此状态时不能进行任何操作并且会遮挡一层蒙板
Returns:
- Type
- Boolean
-
isMovable() → {Boolean}
-
获取页签是否可拖拽移动改变显示顺序,默认值为true
Returns:
- Type
- Boolean
-
iv(delay)
-
无效组件,并调用延时刷新,invalidate的缩写
Parameters:
Name Type Description delay
Number 延迟刷新的间隔事件(单位:ms)
- See:
-
lp(event) → {Object}
-
传入HTML事件对象,将事件坐标转换为组件中的逻辑坐标,getLogicalPoint的缩写
Parameters:
Name Type Description event
Event 事件对象
- See:
Returns:
- Type
- Object
-
mp(listener, scope, ahead)
-
增加自身属性变化事件监听器,addPropertyChangeListener的缩写
Parameters:
Name Type Argument Description listener
function 监听器函数
scope
Object <optional>
监听器函数域
ahead
Boolean <optional>
是否将当前监听器插入到监听器列表开头
-
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 Argument Description listener
function 监听器函数
scope
Object <optional>
监听器函数域
-
removeViewListener(listener, scope)
-
删除视图事件监听器
Parameters:
Name Type Argument 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 Argument 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 Argument Description listener
function 监听器函数
scope
Object <optional>
监听器函数域
-
validate()
-
立刻刷新组件