HT for web

Class: DateTimePicker

ht.ui. DateTimePicker

new DateTimePicker(properties)

日期选择器组件；从组件从 ComboBox 继承并使用 ht.ui.DateTimeDropDown 作为下拉模板
组件的 format 属性用于设置日期格式，如 'YYYY-MM-DD' 会将日期格式化为 '2014-01-09'，支持的格式化标记如下：

部位 标记 示例
月 M 1 2 ... 12
MM 01 02 ... 12
MMM Jan Feb ... Dec
MMMM January February ... December
日 D 1 2 ... 31
DD 01 02 ... 31
Do 1st 2nd ... 31st
周 d 0 1 ... 6
ddd Sun Mon ... Sat
dddd Sunday Monday ... Saturday
年 YY 70 71 ... 30
YYYY 1970 1971 ... 2030
上午/下午 A AM PM
a am pm
小时 H 0 1 ... 23
HH 00 01 ... 23
h 1 2 ... 12
hh 01 02 ... 12
分 m 0 1 ... 59
mm 00 01 ... 59
秒 s 0 1 ... 59
ss 00 01 ... 59

样式属性(不含从父类继承)：format

Parameters:
Name Type Argument Description
properties Object <optional>

属性配置对象
Example
dateTimePicker = new ht.ui.DateTimePicker();
dateTimePicker.setFormat('YYYY-MM-DD HH:mm');
dateTimePicker.addPropertyChangeListener(function(e) {
    if (e.property === 'value') {
        console.log(e.newValue);
    }
});
dateTimePicker.addToDOM(window, {x: 10, y: 20, width: 120, height: 26});

Extends

Methods

addPropertyChangeListener(listener, scope, ahead)

增加属性事件变化监听函数

Parameters:
Name Type Argument Description
listener function

监听器函数
scope Object <optional>

函数域
ahead Boolean <optional>

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

addStyleProperty(property)

追加样式属性，将参数属性加入到样式属性列表中

Parameters:
Name Type Description
property String

属性名
Inherited From:

addToDOM(dom, rect)

将组件加到页面的 DOM 树中；如果没有任何参数，或者只指定第一个参数并且第一个参数为 window，则组件会填满整个浏览器窗口， 并且浏览器窗口大小变化时也会自动刷新组件

Parameters:
Name Type Argument Description
dom HTMLElement <optional>

指定组件的父亲 DOM，如果为空，则加到 body 中
rect Object <optional>

组件的范围，格式为 {x: x, y: y, width: width, height: height}；如果为空，则填满父亲 DOM
Inherited From:

addViewListener(listener, scope, ahead)

增加 View 事件监听器，如 invalidate(无效事件)、beginValidate 等事件

Parameters:
Name Type Argument Description
listener function

监听器函数
scope Object <optional>

监听器函数域
ahead Boolean <optional>

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

close()

关闭下拉框

Inherited From:

disableToolTip()

禁用工具提示，同 setToolTipEnabled

Inherited From:
See:

drawBackground(background, x, y, width, height, dom)

绘制背景

Parameters:
Name Type Argument Description
background ht.ui.drawable.Drawable

背景 Drawable
x Number <optional>

起点 x 坐标
y Number <optional>

起点 y 坐标
width Number <optional>

宽度
height Number <optional>

高度
dom HTMLElement <optional>

指定绘制的目标 DOM
Inherited From:

drawBorder(border, x, y, width, height, dom)

绘制边框

Parameters:
Name Type Argument Description
border ht.border.Border

边框对象
x Number <optional>

起点 x 坐标
y Number <optional>

起点 y 坐标
width Number <optional>

宽度
height Number <optional>

高度
dom HTMLElement <optional>

指定绘制的目标 DOM
Inherited From:

drawIcon(drawable, x, y, width, height)

绘制图标

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

图标 Drawable 对象
x Number

绘制范围 x 坐标
y Number

绘制范围 y 坐标
width Number

绘制范围的宽度
height Number

绘制范围的高度
Inherited From:

drawValueIcon(drawable, x, y, width, height)

绘制选中值图标

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

图标 Drawable 对象
x Number

绘制范围 x 坐标
y Number

绘制范围 y 坐标
width Number

绘制范围的宽度
height Number

绘制范围的高度
Inherited From:

enableToolTip()

启用工具提示，同 setToolTipEnabled

Inherited From:
See:

figureMaxSize() → {Object}

计算 maxSize，maxSize 表示组件的最大尺寸，布局器布局时会考虑此尺寸；

Inherited From:
Returns:

maxSize

Type
Object

figureMinSize() → {Object}

计算 minSize，minSize 表示组件的最小尺寸，布局器布局时会考虑此尺寸；

Inherited From:
Returns:

minSize

Type
Object

figurePreferredSize() → {Object}

计算 preferredSize，preferredSize 表示组件自身最合适的尺寸，布局器布局时会考虑此尺寸； 如果自定义组件一般需要重写此函数

Inherited From:
Returns:

preferredSize

Type
Object

fireViewEvent(event)

派发 View 事件

Parameters:
Name Type Description
event Object | String

事件对象；如果是字符串，表示事件类型，函数内自动组装一个事件对象并派发
示例：view.fireViewEvent('myevent') 等同于 view.fireViewEvent({kind: 'myevent'})
Inherited From:

fp(property, oldValue, newValue, compareFunc) → {Boolean}

派发属性变化事件，firePropertyChange 的缩写

Parameters:
Name Type Argument Description
property String

属性名
oldValue Object

属性变化之前的值
newValue Object

属性变化之后的值
compareFunc function <optional>

比较函数，用于比较新值和旧值是否一致，如果一致则不会派发事件
Inherited From:
Returns:

事件是否派发成功

Type
Boolean

getActiveIcon() → {Object}

获取 active 状态下的图标；可以是颜色或者图片等

Inherited From:
See:
Returns:

图标

Type
Object

getActiveIconDrawable() → {ht.ui.drawable.Drawable}

获取 active 状态下的图标的 Drawable 对象

Inherited From:
Returns:

图标

Type
ht.ui.drawable.Drawable

getActiveReadOnlyBackground() → {Object}

获取 active 和 readOnly 状态下的背景；可以是颜色或者图片等

Inherited From:
See:
  • getActiveReadOnlyBackgroundDrawable
Returns:

背景

Type
Object

getActiveReadOnlyBackgroundDrawble() → {ht.ui.drawable.Drawable}

获取 active 和 readOnly 状态下背景的 Drawable 对象

Inherited From:
Returns:

背景

Type
ht.ui.drawable.Drawable

getBackground() → {Object}

获取组件的背景，可以是颜色或者图片等

Inherited From:
See:
Returns:

组件背景

Type
Object

getBackgroundDrawable() → {ht.ui.drawable.Drawable}

获取组件背景的 Drawable 对象

Inherited From:
Returns:

组件背景

Type
ht.ui.drawable.Drawable

getBorder() → {ht.border.Border}

获取组件的边框

Inherited From:
Returns:

组件边框

Type
ht.border.Border

getBorderBottom() → {Number}

获取组件边框的底部高度

Inherited From:
Returns:

组件边框底部高度

Type
Number

getBorderLeft() → {Number}

获取组件边框的左侧宽度

Inherited From:
Returns:

组件边框左侧宽度

Type
Number

getBorderRadius() → {Number|Array}

获取 CSS 边框圆角

Inherited From:
Returns:

边框圆角

Type
Number | Array

getBorderRight() → {Number}

获取组件边框的右侧宽度

Inherited From:
Returns:

组件边框右侧宽度

Type
Number

getBorderTop() → {Number}

获取组件边框的顶部高度

Inherited From:
Returns:

组件边框顶部高度

Type
Number

getBoxShadow() → {String}

获取 CSS 阴影值

Inherited From:
Returns:

阴影值

Type
String

getColor() → {color}

获取文字颜色

Inherited From:
Returns:

文字颜色

Type
color

getContentBottom() → {Number}

获取内容底部距离，即底部边框高度加底部内边距高度

Inherited From:
Returns:

内容底部距离

Type
Number

getContentDiv() → {HTMLElement}

获取内容 div；对于普通组件，contentDiv 里放置了 canvas 画布；对于容器组件，contentDiv 里除了画布，还有所有的子组件

Inherited From:
Returns:

内容 div

Type
HTMLElement

getContentHeight() → {Number}

获取内容高度，即组件高度减去边框高度和上下内边距高度

Inherited From:
Returns:

内容高度

Type
Number

getContentLeft() → {Number}

获取内容左侧距离，即左侧边框宽度加左侧内边距宽度

Inherited From:
Returns:

内容左侧距离

Type
Number

getContentPoint(event) → {Object}

获取内容坐标点；此坐标与内边距和边框无关，是从内容区域左上角开始计算

Parameters:
Name Type Description
event Event

交互事件对象(如鼠标事件对象)
Inherited From:
Returns:

内容坐标点，包含 x、y 坐标

Type
Object

getContentRight() → {Number}

获取内容右侧距离，即右侧边框宽度加右侧内边距宽度

Inherited From:
Returns:

内容右侧距离

Type
Number

getContentTop() → {Number}

获取内容顶部距离，即顶部边框高度加顶部内边距高度

Inherited From:
Returns:

内容顶部距离

Type
Number

getContentWidth() → {Number}

获取内容宽度，即组件宽度减去边框宽度和左右内边距宽度

Inherited From:
Returns:

内容宽度

Type
Number

getContextMenu() → {ht.ui.ContextMenu}

获取绑定的右键菜单

Inherited From:
Returns:

右键菜单

Type
ht.ui.ContextMenu

getCurrentIconDrawable(state) → {ht.ui.drawable.Drawable}

获取图标的 Drawable 对象；此函数根据当前按钮的状态(normal、hover、active) 返回相应的 Drawable，如：hover 状态下返回 getHoverIconDrawable()

Parameters:
Name Type Argument Description
state String <optional>

状态，如果未指定，使用 textField.getIconState()
Inherited From:
Returns:

图标

Type
ht.ui.drawable.Drawable

getCursor() → {String}

获取鼠标样式(CSS 格式)

Inherited From:
Returns:

鼠标样式

Type
String

getDatas() → {Array}

获取下拉数据数组，格式为：[{ id: id1, label: label1, icon: icon1 }, { id: id2, label: label2, icon: icon2 }] 或 [label1, label2, label3]

Inherited From:
Returns:

数据

Type
Array

getDisabledBackground() → {String}

组件被禁用时，遮罩的背景；这个值被设置到遮罩 div 的 background 样式上，因此可以使用所有 CSS 支持的 background 类型

Inherited From:
Returns:

遮罩背景

Type
String

getDisplayField()

只对 ht.ui.ComboBox 起作用，本组件无效

getDisplayFunc() → {function}

获取显示值的格式化函数

Inherited From:
Returns:

格式化函数

Type
function

getDOMProperties() → {Object}

获取 DOM 属性映射表，格式为：{'width': true ...}；这些属性发生变化才会更新 DOM 结构，否则只需要绘制内容即可

Inherited From:
Returns:

DOM 属性映射表

Type
Object

getDropDownConfig() → {Object}

获取下拉模板属性配置表

Inherited From:
Returns:

属性配置表

Type
Object

getDropDownTemplate() → {String|Class}

获取下拉模板类

Inherited From:
Returns:

下拉模板类

Type
String | Class

getErrorMessage() → {String}

获取错误信息

Inherited From:
Returns:

错误信息

Type
String

getFont() → {String}

获取文字字体

Inherited From:
Returns:

文字字体

Type
String

getFormat() → {String}

获取格式

Returns:

格式

Type
String

getFormDataName() → {String}

获取组件在表单中的名称

Inherited From:
Returns:

名称

Type
String

getFormDataProperties() → {Object}

获取影响表单值的属性映射表；这些属性发生变化会使表单工具重新从此组件取值

Inherited From:
Returns:

属性映射表

Type
Object

getFormDataValue() → {Object}

获取组件在表单中的值

Inherited From:
Returns:

值

Type
Object

getHeight() → {Number}

获取组件的高度

Inherited From:
Returns:

组件高度

Type
Number

getHoverIcon() → {Object}

获取 hover 状态下的图标；可以是颜色或者图片等

Inherited From:
See:
Returns:

图标

Type
Object

getHoverIconDrawable() → {ht.ui.drawable.Drawable}

获取 hover 状态下的图标的 Drawable 对象

Inherited From:
Returns:

图标

Type
ht.ui.drawable.Drawable

getHoverReadOnlyBackground() → {Object}

获取 hover 和 readOnly 状态下的背景；可以是颜色或者图片等

Inherited From:
See:
  • getHoverReadOnlyBackgroundDrawable
Returns:

背景

Type
Object

getHoverReadOnlyBackgroundDrawble() → {ht.ui.drawable.Drawable}

获取 hover 和 readOnly 状态下背景的 Drawable 对象

Inherited From:
Returns:

背景

Type
ht.ui.drawable.Drawable

getIcon() → {Object}

获取正常状态下的图标；可以是颜色或者图片等

Inherited From:
See:
Returns:

图标

Type
Object

getIconDrawable() → {ht.ui.drawable.Drawable}

获取正常状态下图标的 Drawable 对象

Inherited From:
Returns:

图标

Type
ht.ui.drawable.Drawable

getIconField()

只对 ht.ui.ComboBox 起作用，本组件无效

getIconHeight() → {Number}

获取图标高度

Inherited From:
Returns:

高度值

Type
Number

getIconPosition() → {String}

获取图标的位置

Inherited From:
Returns:

图标位置，值可能为 'left'|'right'

Type
String

getIconState() → {String}

获取图标状态

Inherited From:
Returns:

图标状态，值可能为：'normal'|'hover'|'active'

Type
String

getIconTextGap() → {Number}

获取图标和文字内容之间的距离

Inherited From:
Returns:

距离值

Type
Number

getIconWidth() → {Number}

获取图标宽度

Inherited From:
Returns:

宽度值

Type
Number

getId() → {Object}

获取唯一标识，根据标识可快速查找到组件

Inherited From:
Returns:

唯一标识

Type
Object

getInput() → {HTMLInputElement}

获取组件内部的 input 框

Inherited From:
Returns:

input 框

Type
HTMLInputElement

getInteractorClasses() → {Array}

获取交互器类名数组

Inherited From:
Returns:

交互器类名数组

Type
Array

getLayoutParams(key) → {Object}

获取布局参数

Parameters:
Name Type Argument Description
key String <optional>

布局参数中的 key
Inherited From:
Returns:

如果指定 key 参数返回布局参数中 key 对应的值，否则返回整个布局参数对象

Type
Object

getMargin() → {Number|Array}

获取组件外边距，如果是数字，说明四边使用相同的外边距；如果是数组，则格式为：[上边距, 右边距, 下边距, 左边距]

Inherited From:
Returns:

外边距

Type
Number | Array

getMarginBottom() → {Number}

获取组件底部外边距高度

Inherited From:
Returns:

底部外边距高度

Type
Number

getMarginRight() → {Number}

获取组件右侧外边距宽度

Inherited From:
Returns:

右侧外边距宽度

Type
Number

getMarginTop() → {Number}

获取组件顶部外边距高度

Inherited From:
Returns:

顶部外边距高度

Type
Number

getMarignLeft() → {Number}

获取组件左侧外边距宽度

Inherited From:
Returns:

左侧外边距宽度

Type
Number

getMaskRe() → {RegExp}

获取输入验证正则表达式

Inherited From:
Returns:

正则表达式

Type
RegExp

getMatchedStyles() → {Object}

获取组件匹配到的样式

Inherited From:
Returns:
Type
Object

getMaxLength() → {Number}

获取输入文本的最大长度

Inherited From:
Returns:

最大长度

Type
Number

getMaxSize() → {Object}

获取 maxSize，maxSize 表示组件自身最合适的尺寸； 如果用户没有设置，则调用 figureMaxSize 计算

Inherited From:
Returns:

maxSize

Type
Object

getMaxSizeProperties() → {Object}

获取 maxSize 属性映射表，格式为：{'border': true ...}；这些属性变化会重新计算 maxSize

Inherited From:
Returns:

maxSize 属性映射表

Type
Object

getMinSize() → {Object}

获取 minSize，minSize 表示组件的最小尺寸； 如果用户没有设置，则调用 figureMinSize 计算

Inherited From:
Returns:

minSize

Type
Object

getMinSizeProperties() → {Object}

获取 minSize 属性映射表，格式为：{'border': true ...}；这些属性变化会重新计算 minSize

Inherited From:
Returns:

minSize 属性映射表

Type
Object

getPadding() → {Number|Array}

获取组件内边距，如果是数字，说明四边使用相同的内边距；如果是数组，则格式为：[上边距, 右边距, 下边距, 左边距]

Inherited From:
Returns:

内边距

Type
Number | Array

getPaddingBottom() → {Number}

获取组件底部内边距高度

Inherited From:
Returns:

底部内边距高度

Type
Number

getPaddingLeft() → {Number}

获取组件左侧内边距宽度

Inherited From:
Returns:

左侧内边距宽度

Type
Number

getPaddingRight() → {Number}

获取组件右侧内边距宽度

Inherited From:
Returns:

右侧内边距宽度

Type
Number

getPaddingTop() → {Number}

获取组件顶部内边距高度

Inherited From:
Returns:

顶部内边距高度

Type
Number

getParent() → {ht.ui.ViewGroup}

获取父容器

Inherited From:
Returns:

父容器

Type
ht.ui.ViewGroup

getPlaceholder() → {String}

获取输入提示

Inherited From:
Returns:

输入提示

Type
String

getPopover() → {ht.ui.Popover}

获取弹框组件

Inherited From:
Returns:

弹框组件

Type
ht.ui.Popover

getPopoverPlacements() → {Array}

获取弹框组件的弹出位置

Inherited From:
Returns:

弹出位置

Type
Array

getPopoverTrigger() → {String}

获取弹框触发器

Inherited From:
Returns:

弹框触发器，值为：click|hover

Type
String

getPreferredSize() → {Object}

获取 preferredSize，preferredSize 表示组件自身最合适的尺寸，布局器布局时会考虑此尺寸； 如果用户没有设置，则调用 figurePreferredSize 计算

Inherited From:
Returns:

preferredSize

Type
Object

getPreferredSizeProperties() → {Object}

获取 preferredSize 属性映射表，格式为：{'border': true ...}；这些属性变化会重新计算 preferredSize

Inherited From:
Returns:

preferredSize 属性映射表

Type
Object

getPropertyValue(name) → {Object}

取组件的某个属性的原始值； 不要直接去取私有变量，例如 padding，不要直接取 _padding 私有变量，而是应该使用此函数取值； 此函数取值顺序：

  • 先取 _padding 私有变量
  • 如果为 undefind，再去取样式表中取值
  • 如果为 undefied，再取 __padding 私有变量
Parameters:
Name Type Description
name String

属性名
Inherited From:
Returns:

属性值

Type
Object
Example
// 这段代码演示了覆盖 getPadding 函数，先取出旧的 padding，再 +2 并返回
button.getPadding = function() {
	var oldPadding = this.getPropertyValue('padding');
	oldPadding += 2;
	return oldPadding;
}

getReadOnlyBackground() → {Object}

获取 readOnly 状态下的背景；可以是颜色或者图片等

Inherited From:
See:
  • getReadOnlyBackgroundDrawable
Returns:

背景

Type
Object

getReadOnlyBackgroundDrawble() → {ht.ui.drawable.Drawable}

获取 readOnly 状态下背景的 Drawable 对象

Inherited From:
Returns:

背景

Type
ht.ui.drawable.Drawable

getReadOnlyIcon() → {Object}

获取 readOnly 状态下的展开图标；可以是颜色或者图片等

Inherited From:
See:
Returns:

图标

Type
Object

getReadOnlyIconDrawable() → {ht.ui.drawable.Drawable}

获取 readOnly 状态下的展开图标的 Drawable 对象

Inherited From:
Returns:

图标

Type
ht.ui.drawable.Drawable

getRootCanvas() → {HTMLCanvasElement}

获取根 Canvas，这个 Canvas 用来绘制背景、边框、内容等

Inherited From:
Returns:

Canvas DOM 对象

Type
HTMLCanvasElement

getRootContext(dom) → {CanvasRenderingContext2D}

获取默认的 canvas 画布的画笔对象，或者获取参数 DOM 对象的画笔； 此函数在绘制背景、边框和自定义组件的情况下经常使用

Parameters:
Name Type Argument Description
dom HTMLElement <optional>

指定目标 DOM，通常是个 canvas 类型的 DOM 对象
Inherited From:
Returns:

画笔对象

Type
CanvasRenderingContext2D

getStyle() → {String}

获取组件的样式名；如果有多个样式名，以空格分开，如：'header title'；注意此样式是指 HT 的样式，而非 CSS 样式

Inherited From:
Returns:

样式名

Type
String

getStyleProperties() → {Object}

获取样式属性映射表，格式为：{'padding': true, 'border': true ...}

Inherited From:
Returns:

样式属性映射表

Type
Object

getStyleValue(property) → {Object}

获取样式属性对应的样式值

Parameters:
Name Type Description
property String

属性名
Inherited From:
Returns:

样式值

Type
Object

getToolTip() → {String}

获取工具提示文本内容

Inherited From:
Returns:

工具提示文本内容

Type
String

getType() → {String}

获取文本框类型；注意：这个属性本质是 input 标签的 type 属性的映射，因此某些特殊 type 类型依赖浏览器是否支持

Inherited From:
Returns:

文本框类型

Type
String

getValue() → {Object}

获取组合框选中的值，默认情况下这个函数的返回值是一个数据对象(datas 数组中的元素)
如果指定了 valueField，此函数返回值为数据对象中的属性值

Inherited From:
Returns:

组件值

Type
Object

getValueField()

只对 ht.ui.ComboBox 起作用，本组件无效

getValueIconHeight() → {Number}

获取选中值的图标的高度

Inherited From:
Returns:

高度值

Type
Number

getValueIconHeight(height)

设置选中值的图标的高度

Parameters:
Name Type Description
height Number

高度值
Inherited From:

getValueIconTextGap() → {Number}

获取选中值的图标的和文字之间的距离

Inherited From:
Returns:

间距值

Type
Number

getValueIconWidth() → {Number}

获取选中值的图标的宽度

Inherited From:
Returns:

宽度值

Type
Number

getValueObject() → {Object}

获取当前选中的属性对象

Inherited From:
Returns:

属性对象

Type
Object

getView() → {HTMLElement}

获取组件最根层的 div

Inherited From:
Returns:

组件 div

Type
HTMLElement

getViewPoint(event) → {Object}

获取组件坐标点；从组件的左上角开始计算

Parameters:
Name Type Description
event Event

交互事件对象(如鼠标事件对象)
Inherited From:
Returns:

组件坐标点，包含 x、y 坐标

Type
Object

getWidth() → {Number}

获取组件的宽度

Inherited From:
Returns:

组件宽度

Type
Number

getX() → {Number}

获取组件的 x 坐标

Inherited From:
Returns:

x 坐标

Type
Number

getY() → {Number}

获取组件的 y 坐标

Inherited From:
Returns:

y 坐标

Type
Number

getZIndex() → {Number}

获取组件的堆叠顺序

Inherited From:
Returns:

堆叠顺序

Type
Number

getZoom() → {Number}

获取缩放值

Inherited From:
Returns:

缩放值

Type
Number

getZoomAnchor() → {Array}

获取缩放锚点

Inherited From:
Returns:

锚点数组

Type
Array

hasContentCanvas() → {Boolean}

判断组件是否有私有 canvas

Inherited From:
Returns:

组件是否有私有 canvas

Type
Boolean

hasFocus() → {Boolean}

判断焦点是否在组件上

Inherited From:
Returns:

焦点是否在组件上

Type
Boolean

hidePopover()

隐藏弹框组件

Inherited From:

iconHitTest(event)

判断是否点击中图标

Parameters:
Name Type Description
event Event

事件对象
Inherited From:

initInput() → {HTMLInputElement}

创建并初始化 input 框

Inherited From:
Returns:

input 框

Type
HTMLInputElement

initView(canvas)

初始化组件的 DOM 结构

Parameters:
Name Type Argument Description
canvas Boolean <optional>

是否创建一个私有的 canvas 用来绘制私有内容，一般情况下在默认的 canvas 中绘制就可以，不需要此参数
Inherited From:

invalidate(forceLayoutChildren)

使组件无效化

Parameters:
Name Type Argument Description
forceLayoutChildren Boolean <optional>

是否强制刷新子组件(即使子组件没有无效标记)
Inherited From:
See:

invalidateDOM()

设置重新布局 DOM 标记并调用 invalidate, 组件下次刷新时会强制更新 DOM

Inherited From:

isDescendantOf(viewGroup) → {Boolean}

判断当前组件是否是参数容器的子孙组件

Parameters:
Name Type Description
viewGroup ht.ui.ViewGroup

容器
Inherited From:
Returns:
Type
Boolean

isDisabled() → {Boolean}

组件是否被禁用

Inherited From:
Returns:

是否被禁用

Type
Boolean

isFocusable() → {Boolean}

组件是否可以获取焦点

Inherited From:
Returns:

是否可获取焦点

Type
Boolean

isInDOM() → {Boolean}

判断组件是否在 DOM 树中

Inherited From:
Returns:

组件是否在 DOM 树中

Type
Boolean

isInstant() → {Boolean}

是否是即时模式；在这种模式下，每输入一个字符 value 属性变化事件就会立即被派发，否则只有失去焦点或敲回车时才被派发

Inherited From:
Returns:

是否是即时模式

Type
Boolean

isMaxSizeSet() → {Boolean}

判断 maxSize 是否被设置(如果为 true, 组件不再调用 figureMaxSize 自动计算)

Inherited From:
Returns:

maxSize 是否被设置

Type
Boolean

isMinSizeSet() → {Boolean}

判断 minSize 是否被设置(如果为 true, 组件不再调用 figureMinSize 自动计算)

Inherited From:
Returns:

minSize 是否被设置

Type
Boolean

isOpened() → {Boolean}

判断下拉框是否处于打开状态

Inherited From:
Returns:

是否处于打开状态

Type
Boolean

isPreferredSizeSet() → {Boolean}

判断 preferredSize 是否被设置(如果为 true, 组件不再调用 figurePreferredSize 自动计算)

Inherited From:
Returns:

preferredSize 是否被设置

Type
Boolean

isReadOnly() → {Boolean|String}

是否只读

Inherited From:
Returns:

是否只读，值为：true|false|'entire'

Type
Boolean | String

isRedrawOnFocus() → {Boolean}

判断组件获取或失去焦点时，是否重绘自身

Inherited From:
Returns:

是否重绘自身

Type
Boolean

isSelfViewEvent(event) → {Boolean}

判断鼠标事件是否发生在组件自身上，例如容器的 div 上监听到一个原生的鼠标点击事件，此事件可能来自容器，也可能来自子组件的冒泡传播； 如果自定义组件，并且改变了组件的 DOM 结构，需要重写此函数

Parameters:
Name Type Description
event Event

事件对象
Inherited From:
Returns:

事件是否发生在自身 DOM 上

Type
Boolean

isStyleProperty(property) → {Boolean}

判断属性是否是样式属性

Parameters:
Name Type Description
property String

属性名
Inherited From:
Returns:

是否是样式属性

Type
Boolean

isToolTipEnabled() → {Boolean}

是否启用工具提示

Inherited From:
Returns:

是否启用工具提示

Type
Boolean

isVisible() → {Boolean}

判断组件是否可见

Inherited From:
Returns:

组件是否可见

Type
Boolean

iv(forceLayoutChildren)

使组件无效化

Parameters:
Name Type Argument Description
forceLayoutChildren Boolean <optional>

是否强制刷新子组件(即使子组件没有无效标记)
Inherited From:
See:

layoutDOM(x, y, width, height)

重新调整组件的 DOM 结构布局，设置坐标、宽高以及内边距等

Parameters:
Name Type Description
x Number

组件的 x 坐标
y Number

组件的 y 坐标
width Number

组件宽度
height Number

组件高度
Inherited From:

makeDisabled(disabled, disabledDiv)

设置禁用组件样式，默认会将 disabedDiv 插入到组件内部

Parameters:
Name Type Description
disabled disabled

是否禁用
disabledDiv HTMLElement

遮罩 div
Inherited From:

mp(listener, scope, ahead)

增加属性事件变化监听函数，addPropertyChangeListener 的缩写

Parameters:
Name Type Argument Description
listener function

监听器函数
scope Object <optional>

函数域
ahead Boolean <optional>

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

off(name, function, scope, ahead)

删除事件监听

Parameters:
Name Type Description
name String

属性名，p: 开头(如 p:value)，表示监听属性变化事件；d: 开头(如 d:mousedown) 表示监听原生 DOM 事件；其它情况当作 viewEvent 处理
function function

监听器函数
scope Object

监听器函数域
ahead Boolean

如果是 DOM 事件，表示 useCapture；否则表示是否将当前监听器插入到监听器列表开头
Inherited From:

on(name, function, scope, ahead)

增加事件监听

Parameters:
Name Type Description
name String

属性名，p: 开头(如 p:value)，表示监听的是属性变化事件；d: 开头(如 d:mousedown) 表示监听原生 DOM 事件；其它情况当作 viewEvent 处理
function function

监听器函数
scope Object

监听器函数域
ahead Boolean

如果是 DOM 事件，表示 useCapture；否则表示是否将当前监听器插入到监听器列表开头
Inherited From:

onOnce(name, function, scope, ahead)

增加一次性事件监听(监听器执行一次，然后马上被删除)

Parameters:
Name Type Description
name String

属性名，p: 开头(如 p:value)，表示监听属性变化事件；d: 开头(如 d:mousedown) 表示监听原生 DOM 事件；其它情况当作 viewEvent 处理
function function

监听器函数
scope Object

监听器函数域
ahead Boolean

如果是 DOM 事件，表示 useCapture；否则表示是否将当前监听器插入到监听器列表开头
Inherited From:

open()

打开下拉框

Inherited From:

processValidate()

绘制组件边框、背景及调用 validateImpl；此函数在 validate 中被调用

Inherited From:

redraw(forceLayoutChildren)

设置所有的重绘标记包括重绘 canvas 标记、重绘 border 标记和重新布局 DOM 标记 并调用 iv

Parameters:
Name Type Argument Description
forceLayoutChildren Boolean <optional>

是否强制刷新子组件(即使子组件没有无效标记)
Inherited From:

removeFromDOM()

将组件从页面的 DOM 树中删除；如果要删除通过 addToDOM 添加到页面的组件，应使用此函数，以免内存泄漏

Inherited From:

removePropertyChangeListener(listener, scope)

删除属性事件变化监听器

Parameters:
Name Type Argument Description
listener function

监听器函数
scope Object <optional>

函数域
Inherited From:

removeStyleProperty(property)

删除样式属性，将参数属性从样式属性列表中移除

Parameters:
Name Type Description
property String

属性名
Inherited From:

removeViewListener(listener, scope)

删除 View 事件监听器

Parameters:
Name Type Argument Description
listener function

监听器函数
scope Object <optional>

监听器函数域
Inherited From:

requestFocus()

请求获取焦点

Inherited From:

selectAt(index)

根据下标选中数据

Parameters:
Name Type Description
index Number

下标
Inherited From:

set(properties)

批量设置组件属性

Parameters:
Name Type Description
properties Object

格式示范：{ background: 'red', border: new ht.ui.border.LineBorder(1, 'red'), padding: 20 }
Inherited From:

setActiveIcon(icon)

设置 active 状态下的图标

Parameters:
Name Type Description
icon Object

图标；可以是颜色或者图片等
Inherited From:
See:

setActiveIconDrawable(drawable)

设置 active 状态下的图标的 Drawable 对象

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

图标
Inherited From:

setActiveReadOnlyBackground(background)

设置 active 和 readOnly 状态下的背景；可以是颜色或者图片等

Parameters:
Name Type Description
background Object

背景
Inherited From:
See:
  • setActiveReadOnlyBackgroundDrawable

setActiveReadOnlyBackgroundDrawble(drawable)

设置 active 和 readOnly 状态下背景的 Drawable 对象

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

背景
Inherited From:

setBackground(background)

设置组件的背景，可以是颜色或者图片等；此值最终会被转换为 Drawable 对象

Parameters:
Name Type Description
background Object

颜色值、图片名、图片路径、矢量对象等
Inherited From:
See:

setBackgroundDrawable(drawable)

设置组件的背景 Drawable 对象；组件渲染时优先使用此 Drawable 对象，如果为空，再用 background 转换

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

Drawable 对象
Inherited From:

setBorder(border)

设置组件的边框

Parameters:
Name Type Description
border ht.border.Border

组件边框
Inherited From:

setBorderRadius(radius)

设置 CSS 边框圆角

Parameters:
Name Type Description
radius Number | Array

边框圆角；如果是数组，则表示[左上角圆角、右上角圆角、右下角圆角、左下角圆角]
Inherited From:

setBoxShadow(boxShadow)

设置 CSS 阴影值

Parameters:
Name Type Description
boxShadow String

阴影值
Inherited From:

setColor(color)

设置文字颜色

Parameters:
Name Type Description
color color

文字颜色
Inherited From:

setContextMenu(contextMenu)

设置绑定的右键菜单

Parameters:
Name Type Description
contextMenu ht.ui.ContextMenu

右键菜单
Inherited From:

setCursor(cursor)

设置鼠标样式(CSS 格式)

Parameters:
Name Type Description
cursor String

鼠标样式
Inherited From:

setDatas(datas)

设置下拉数据数组

Parameters:
Name Type Description
datas Array

数据数组，格式为：[{ id: id1, label: label1, icon: icon1 }, { id: id2, label: label2, icon: icon2 }] 或 [label1, label2, label3]
Inherited From:

setDisabled(disabled)

设置组件是否被禁用

Parameters:
Name Type Description
disabled Boolean | String

是否被禁用；如果为字符串，组件除了被禁用，disabledDiv 还会被设置相应的 CSS 样式名
Inherited From:

setDisabledBackground(background)

设置组件被禁用时，遮罩的背景；这个值被设置到遮罩 div 的 background 样式上，因此可以使用所有 CSS 支持的 background 类型

Parameters:
Name Type Description
background String

遮罩背景
Inherited From:
Example
// 设置一个居中的 gif 图片 作为背景
view.setDisabledBackground('url(a.gif) no-repeat 50% 50%');

setDisplayField()

只对 ht.ui.ComboBox 起作用，本组件无效

setDisplayFunc(func)

设置显示值的格式化函数

Parameters:
Name Type Description
func function

格式化函数，示例：function(value) { return 'Format:' + value };
Inherited From:

setDropDownConfig(config)

设置下拉模板属性配置表

Parameters:
Name Type Description
config Object

属性配置表
Example
comboBox.setDropDownConfig({
	'buttonTexts': ['确定', '取消'], // 下拉模板中的按钮文本改为中文
	'dropDownView.background': 'red', // dropDownView.xxx 用来设置下拉组件(SplitLayout 布局器，上面是 DateTimePane，下面是确定和取消按钮)的属性
 'dateTimePane.type': 'date' // dateTimePane.xxx 用来设置下拉组件容器中的日期时间面板组件的属性
});

setDropDownTemplate(template)

设置下拉模板类；这个模板类必须是 ht.ui.DropDownTemplate 的子类，开发者也可以继承这个类实现自己的下拉组件

Parameters:
Name Type Description
template String | Class

下拉模板类，如果是字符串，可以使用 $ 加样式名指定外部样式，如：'ht.ui.ListDropDown$myList'
Inherited From:

setErrorMessage(message, params) → {ht.ui.ErrorMessagePopover}

设置错误信息

Parameters:
Name Type Description
message String

错误信息
params Object

ErrorMessagePopover 组件的属性配置，如 { placements: ['top'] } 将错误提示显示在上方
Inherited From:
Returns:

错误提示组件

Type
ht.ui.ErrorMessagePopover

setFocusable(focusable)

设置组件是否可以获取焦点

Parameters:
Name Type Description
focusable Boolean

是否可获取焦点
Inherited From:

setFont(font)

设置文字字体

Parameters:
Name Type Description
font String

文字字体
Inherited From:

setFormat(format)

设置格式

Parameters:
Name Type Description
format String

格式

setFormDataName(name)

设置组件在表单中的名称

Parameters:
Name Type Description
name String

名称
Inherited From:

setHeight(height)

设置组件的高度

Parameters:
Name Type Description
height Number

组件高度
Inherited From:

setHoverIcon(icon)

设置 hover 状态下的图标

Parameters:
Name Type Description
icon Object

图标；可以是颜色或者图片等
Inherited From:
See:

setHoverIconDrawable(drawable)

设置 hover 状态下的图标的 Drawable 对象

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

图标
Inherited From:

setHoverReadOnlyBackground(background)

设置 hover 和 readOnly 状态下的背景；可以是颜色或者图片等

Parameters:
Name Type Description
background Object

背景
Inherited From:
See:
  • setHoverReadOnlyBackgroundDrawable

setHoverReadOnlyBackgroundDrawble(drawable)

设置 hover 和 readOnly 状态下背景的 Drawable 对象

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

背景
Inherited From:

setIcon(icon)

设置正常状态下的图标

Parameters:
Name Type Description
icon Object

图标；可以是颜色或者图片等
Inherited From:
See:

setIconDrawable(drawable)

设置正常状态下图标的 Drawable 对象

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

图标
Inherited From:

setIconField()

只对 ht.ui.ComboBox 起作用，本组件无效

setIconHeight(height)

设置图标高度

Parameters:
Name Type Description
height Number

高度值
Inherited From:

setIconPosition(position)

设置图标的位置

Parameters:
Name Type Description
position String

图标位置，值可能为 'left'|'right'
Inherited From:

setIconTextGap(gap)

设置图标和文字内容之间的距离

Parameters:
Name Type Description
gap Number

距离值
Inherited From:

setIconWidth(width)

设置图标宽度

Parameters:
Name Type Description
width Number

宽度值
Inherited From:

setId(id)

设置唯一标识，根据标识可快速查找到组件

Parameters:
Name Type Description
id Object

唯一标识
Inherited From:

setInstant(instant)

设置即时模式；在这种模式下，每输入一个字符 value 属性变化事件就会立即被派发，否则只有失去焦点或敲回车时才被派发

Parameters:
Name Type Description
instant Boolean

是否是即时模式
Inherited From:

setLayoutParams(layoutParams, value)

设置布局参数；这个函数有两种使用方式：

  • view.setLayoutParams({ marginLeft: 20, marginRight: 20 }) 指定布局参数对象
  • view.setLayoutParams('marginLeft', 20) 传入两个参数设置布局参数对象中的属性
Parameters:
Name Type Argument Description
layoutParams Object

布局参数对象或 key
value Object <optional>

布局参数值
Inherited From:

setMargin(margin)

设置组件外边距，如果是数字，说明四边使用相同的外边距；如果是数组，则格式为：[上边距, 右边距, 下边距, 左边距]

Parameters:
Name Type Description
margin Number | Array

外边距；父容器布局时，会动态将此参数填充到 layoutParams 中(优先级低于 layoutParams，如果 layoutParams 参数中没有指定相应的 margin 才会从组件上取值)
Inherited From:

setMaskRe(maskRe)

设置输入验证正则表达式；用户每输入一个字符，都会通过这个正则表达式进行验证，如果验证失败，这个字符会被忽略

Parameters:
Name Type Description
maskRe RegExp

正则表达式
Inherited From:
Example
textField.setMaskRe(/[\d\-]/); // 只允许数字输入

setMaxLength(maxLength)

设置输入文本的最大长度

Parameters:
Name Type Description
maxLength Number

最大长度
Inherited From:

setMaxSize(width, height)

计算 maxSize，maxSize 表示组件的最大尺寸，布局器布局时会考虑此尺寸，尽量不让组件的布局宽高大于此尺寸； 如果设置过 maxSize，就不会再调用 figureMaxSize 计算； 如果要清空设置过的 maxSize，可以调用 setMaxSize(undefined, undefined);

Parameters:
Name Type Description
width Number

最大宽度
height Number

最大高度
Inherited From:

setMinSize(width, height)

计算 minSize，minSize 表示组件的最小尺寸，布局器布局时会考虑此尺寸，尽量不让组件的布局宽高小于此尺寸； 如果设置过 minSize，就不会再调用 figureMinSize 计算； 如果要清空设置过的 minSize，可以调用 setMinSize(undefined, undefined);

Parameters:
Name Type Description
width Number

最小宽度
height Number

最小高度
Inherited From:

setPadding(padding)

设置组件内边距，如果是数字，说明四边使用相同的内边距；如果是数组，则格式为：[上边距, 右边距, 下边距, 左边距]

Parameters:
Name Type Description
padding Number | Array

内边距
Inherited From:

setPlaceholder(placeholder)

设置输入提示

Parameters:
Name Type Description
placeholder String

输入提示
Inherited From:

setPopover(popover, trigger)

设置弹框组件

Parameters:
Name Type Argument Description
popover ht.ui.Popover | String

弹框组件，如果参数是字符串，则用这段文本作为弹框内容(内部自动创建 Popover 和 HtmlView 组件)
trigger String <optional>

触发器，值为：click|hover
Inherited From:

setPopoverPlacements(placements)

设置弹框组件的弹出位置

Parameters:
Name Type Description
placements Array

位置数组
Inherited From:

setPopoverTrigger(trigger)

设置弹框触发器

Parameters:
Name Type Description
trigger String

弹框触发器，值为：click|hover
Inherited From:

setPreferredSize(width, height)

设置 preferredSize，preferredSize 表示组件自身最合适的尺寸，布局器布局时会考虑此尺寸作为布局尺寸； 如果设置过 preferredSize，就不会再调用 figurePreferredSize 计算； 如果要清空设置过的 preferredSize，可以调用 setPreferredSize(undefined, undefined);

Parameters:
Name Type Description
width Number

首选宽度
height Number

首选高度
Inherited From:

setPropertyValue(name, value)

设置属性值并派发事件，自定义 set 函数内部应该调用此函数设值

Parameters:
Name Type Description
name String

属性名
value Object

属性值
Inherited From:

setReadOnly(readOnly)

设置只读

Parameters:
Name Type Description
readOnly Boolean | String

是否只读，值为：true|false|'entire'；当值为 true 时，只有文本框被禁用，右侧图标仍然可以点击；值为 'entire' 时，文本框和右侧图标都不响应交互动作
Inherited From:

setReadOnlyBackground(background)

设置 readOnly 状态下的背景；可以是颜色或者图片等

Parameters:
Name Type Description
background Object

背景
Inherited From:
See:
  • setReadOnlyBackgroundDrawable

setReadOnlyBackgroundDrawble(drawable)

设置 readOnly 状态下背景的 Drawable 对象

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

背景
Inherited From:

setReadOnlyIcon(icon)

设置 readOnly 状态下的展开图标；可以是颜色或者图片等

Parameters:
Name Type Description
icon Object

图标
Inherited From:
See:

setReadOnlyIconDrawable(drawable)

设置 readOnly 状态下的展开图标的 Drawable 对象

Parameters:
Name Type Description
drawable ht.ui.drawable.Drawable

图标
Inherited From:

setRedrawOnFocus(redrawOnFocus)

设置组件获取或失去焦点时，是否重绘自身

Parameters:
Name Type Description
redrawOnFocus Boolean

是否重绘自身
Inherited From:

setStyle(styleName)

设置组件的样式名；如果有多个样式名，以空格分开，如：'header title'；注意此样式是指 HT 的样式，而非 CSS 样式

Parameters:
Name Type Description
styleName String

样式名
Inherited From:

setToolTipEnabled(enabled)

设置是否启用工具提示

Parameters:
Name Type Description
enabled Boolean

是否启用工具提示
Inherited From:

setType(type)

设置文本框类型；注意：这个属性本质是 input 标签的 type 属性的映射，因此某些特殊 type 类型依赖浏览器是否支持

Parameters:
Name Type Description
type String

文本框类型
Inherited From:

setValue(value)

设置组合框的值

Parameters:
Name Type Description
value Object

组件值
Inherited From:

setValueField()

只对 ht.ui.ComboBox 起作用，本组件无效

setValueIconTextGap(gap)

设置选中值的图标的和文字之间的距离

Parameters:
Name Type Description
gap Number

间距值
Inherited From:

setValueIconWidth(width)

设置选中值的图标的宽度

Parameters:
Name Type Description
width Number

宽度值
Inherited From:

setVisible(visible)

设置组件是否可见

Parameters:
Name Type Description
visible Boolean

组件是否可见
Inherited From:

setWidth(width)

设置组件的宽度

Parameters:
Name Type Description
width Number

组件宽度
Inherited From:

setX(x)

设置组件的 x 坐标

Parameters:
Name Type Description
x Number

x 坐标
Inherited From:

setY(y)

设置组件的 y 坐标

Parameters:
Name Type Description
y Number

y 坐标
Inherited From:

setZIndex(zIndex)

设置组件的堆叠顺序

Parameters:
Name Type Description
zIndex Number

堆叠顺序
Inherited From:

setZoom(zoom)

设置缩放

Parameters:
Name Type Description
zoom Number

缩放值
Inherited From:

setZoomAnchor(anchor)

设置缩放锚点

Parameters:
Name Type Description
anchor Array

横向和纵向锚点数组，如右上角为：[1, 0]
Inherited From:

showPopover()

显示弹框组件

Inherited From:

tearDownBorder(border, x, y, width, height, dom)

卸载边框；只有 CSS 类型的边框才需要此函数

Parameters:
Name Type Argument Description
border ht.border.Border

边框对象
x Number <optional>

起点 x 坐标
y Number <optional>

起点 y 坐标
width Number <optional>

宽度
height Number <optional>

高度
dom HTMLElement <optional>

指定绘制的目标 DOM
Inherited From:

toggle()

切换下拉框状态(如果处于关闭状态将其打开；如果处于打开状态则将其关闭)

Inherited From:

ump(listener, scope)

删除属性事件变化监听器，removePropertyChangeListener 的缩写

Parameters:
Name Type Argument Description
listener function

监听器函数
scope Object <optional>

函数域
Inherited From:

validate()

重绘组件；此函数负责重新布局组件 DOM、设置层叠关系、加载需要的图片资源、派发 validate 事件等 如果自定义组件，不要重写此函数，而是重写 validateImpl 函数

Inherited From:
See:

validateImpl(x, y, width, height)

绘制组件内容；如果自定义组件，一般要重写此函数，通过 getRootContext() 获取画笔然后绘制

Parameters:
Name Type Description
x Number

内容范围的 x 坐标
y Number

内容范围的 y 坐标
width Number

内容范围宽度
height Number

内容范围高度
Inherited From:
© 2017 Hightopo Inc. All rights reserved. - Email: service@hightopo.com