F.js - 企业级前端界面库

Class: TimePicker

F. TimePicker

new F.TimePicker(options)

form/F.TimePicker.js, line 3

时间选择控件

Name Type Description

options

Object

初始参数

Name	Type	Default	Description
`minValue`	string	''	最小值
`maxValue`	string	''	最大值
`increment`	number	30	每个可选项间隔的分钟数
`editable`	boolean	true	是否可编辑（覆盖 F.DropDownList 的设置）
`type`	string	'timepicker'	控件类型

Extends

F.DropDownList

Members

bodyEljQuery

字段主体对应的jQuery节点对象

eljQuery

控件对应的jQuery节点对象

itemsObject

子控件列表

Methods

inherited add(value) F.Container.js, line 55

添加新的子控件到当前控件

Name	Type	Description
`value`	Object \| Array.<Object>	控件实例数组

Example

menu1.add(['-', {
		type: 'menuitem',
		text: '新菜单项'
}]);

inherited blur() form/F.Field.js, line 87

取消焦点

inherited clearDirty() form/F.Field.js, line 138

清空已改变状态（接受当前已改变的值）

inherited clearInvalid() form/F.TriggerBox.js, line 105

清空无效标记

inherited clearValue() form/F.Field.js, line 73

清空值

inherited disable() form/F.TextBox.js, line 61

禁用控件

inherited doLayout(startFormTopmostComonent) F.Component.js, line 122

执行布局操作

Name	Type	Default	Description
`startFormTopmostComonent`	boolean	false	optional 从最顶层的控件开始布局

inherited enable() form/F.TextBox.js, line 67

启用控件

inherited focus(selectText, delayMilliseconds) form/F.Field.js, line 81

设置焦点

Name	Type	Description
`selectText`	boolean	是否同时选中文本
`delayMilliseconds`	number	设置焦点前延迟的毫秒数

inherited getAttr(key){string} F.Component.js, line 101

获取节点属性

Name	Type	Description
`key`	string	节点属性键

Returns:

Type	Description
string	节点属性值

inherited getFieldLabel(){string} form/F.Field.js, line 106

获取字段标签

Returns:

Type	Description
string	字段标签

inherited getFormFields(){Array.<F.Field>} F.Container.js, line 64

获取容器内的所有表单字段

Returns:

Type	Description
Array.<F.Field>	表单字段数组

inherited getHeight(){number} F.Component.js, line 136

获取控件高度

Returns:

Type	Description
number	高度

inherited getItem(value){F.Component} F.Container.js, line 112

获取子控件

Name	Type	Description
`value`	number \| string \| function	子控件索引、标识符或者函数

Returns:

Type	Description
F.Component	子控件实例

inherited getText(){string} form/F.TextBox.js, line 81

获取显示文本

Returns:

Type	Description
string	显示文本

inherited getTextByValue(value){string} form/F.DropDownList.js, line 100

获取值对应的显示文本

Name	Type	Description
`value`	string	值

Returns:

Type	Description
string	值对应的显示文本

inherited getTooltip(){string} F.Component.js, line 196

获取提示信息

Returns:

Type	Description
string	提示信息

inherited getValue(){string|Array.<string>} form/F.DropDownList.js, line 82

获取下拉列表的值

Returns:

Type	Description
string \| Array.<string>	下拉列表的值

inherited getValueByText(text){string} form/F.DropDownList.js, line 109

获取显示文本对应的值

Name	Type	Description
`text`	string	显示文本

Returns:

Type	Description
string	显示文本对应的值

inherited getWidth(){number} F.Component.js, line 130

获取控件宽度

Returns:

Type	Description
number	宽度

inherited hide() F.Component.js, line 262

隐藏控件

inherited hideLoading() F.Container.js, line 95

隐藏加载动画

inherited hidePopEl() form/F.DropDownList.js, line 74

隐藏弹出框

inherited hideTrigger() form/F.TriggerBox.js, line 82

隐藏触发按钮

inherited hideTrigger1() form/F.TriggerBox.js, line 86

隐藏第一个触发按钮

inherited hideTrigger2() form/F.TriggerBox.js, line 90

隐藏第二个触发按钮

inherited insert(insertIndex, value) F.Container.js, line 44

插入新的子控件到当前控件

Name	Type	Description
`insertIndex`	number	插入的位置
`value`	Object \| Array.<Object>	控件实例数组

Example

menu1.insert(0, ['-', {
		type: 'menuitem',
		text: '新菜单项'
}]);

inherited isDirty(){boolean} form/F.Field.js, line 132

字段值是否已经改变

Returns:

Type	Description
boolean	字段值是否已经改变

inherited isDisabled(){boolean} F.Component.js, line 224

是否禁用

Returns:

Type	Description
boolean	是否禁用

inherited isFocused(){boolean} form/F.Field.js, line 93

是否焦点元素

Returns:

Type	Description
boolean	是否焦点元素

inherited isTriggerVisible(triggerNumber){boolean} form/F.TriggerBox.js, line 64

触发按钮是否可见

Name	Type	Description
`triggerNumber`	number	触发按钮序号（1或者2，从左开始计数）

Returns:

Type	Description
boolean	是否可见

inherited isType(value){boolean} F.Base.js, line 23

检测当前实例是否指定的控件类型

Name	Type	Description
`value`	Object	控件类型

Returns:

Type	Description
boolean	如果当前实例是指定的控件类型，返回true；否则返回false

Example

grid1.isType('panel') // 返回true
grid1.isType('grid')  // 返回true

inherited isUserInput(){boolean} form/F.DropDownList.js, line 133

是否为用户自行输入值

Returns:

Type	Description
boolean	是否为用户自行输入值

inherited isValid(onlyFirstInvalidField){Array.<Object>} F.Container.js, line 71

容器内的表单字段是否有效

Name	Type	Default	Description
`onlyFirstInvalidField`	boolean	false	是否仅返回第一个无效的字段

Returns:

Type	Description
Array.<Object>	容器内的表单字段是否有效（[isValid, firstInvalidField, secondInvalidField, thirdInvalidField...]）

inherited isVisible(){boolean} F.Component.js, line 216

是否可见

Returns:

Type	Description
boolean	是否可见

inherited loadData(data, value) form/F.DropDownList.js, line 126

加载数据

Name	Type	Description
`data`	Array.<Object>	数据
`value`	string \| Array.<string>	选中的值

inherited markInvalid(errorMsg) form/F.TriggerBox.js, line 99

将字段标记为无效

Name	Type	Description
`errorMsg`	string	错误提示消息

inherited off(eventNames, fn) F.Component.js, line 181

移除事件

Name	Type	Description
`eventNames`	string	事件名称（可以空格分割多个事件名称）
`fn`	F_Component_on	之前注册的事件处理函数

inherited on(eventNames, fn) F.Component.js, line 174

注册事件

Name	Type	Description
`eventNames`	string	事件名称（可以空格分割多个事件名称）
`fn`	F_Component_on	触发事件时执行的函数

inherited remove() F.Component.js, line 115

删除父控件中移除当前控件

inherited removeAttr(key) F.Component.js, line 108

删除节点属性

Name	Type	Description
`key`	string	节点属性键

inherited removeTooltip() F.Component.js, line 208

删除提示信息

inherited reset() form/F.Field.js, line 125

重置字段

inherited setAttr(key, value) F.Component.js, line 94

设置节点属性

Name	Type	Description
`key`	string	节点属性键
`value`	string	节点属性值

inherited setAttrs(attrs) F.Component.js, line 86

设置节点属性

Name	Type	Description
`attrs`	Object	节点属性对象

inherited setDisabled(disabled) F.Component.js, line 248

设置控件的禁用状态

Name	Type	Description
`disabled`	boolean	是否禁用

inherited setEditable(editable) form/F.TextBox.js, line 155

设置是否可编辑

Name	Type	Description
`editable`	boolean	是否可编辑

inherited setEmptyText(emptyText) form/F.TextBox.js, line 73

设置空白文本

Name	Type	Description
`emptyText`	string	空白文本

inherited setEnabled(enabled) F.Component.js, line 254

设置控件的启用状态

Name	Type	Description
`enabled`	boolean	是否启用

inherited setFieldLabel(label) form/F.Field.js, line 100

设置字段标签

Name	Type	Description
`label`	string	字段标签

inherited setHeight(height) F.Component.js, line 143

设置控件高度

Name	Type	Description
`height`	number	高度

inherited setHidden(hidden) F.Component.js, line 286

设置控件的隐藏状态

Name	Type	Description
`hidden`	boolean	是否隐藏

inherited setMaxLength(maxLength) form/F.TextBox.js, line 111

设置最大长度

Name	Type	Description
`maxLength`	number	最大长度

inherited setMinLength(minLength) form/F.TextBox.js, line 117

设置最小长度

Name	Type	Description
`minLength`	number	最小长度

inherited setReadonly(readonly) form/F.Field.js, line 113

设置只读

Name	Type	Description
`readonly`	boolean	只读状态

inherited setRedStar(redStar) form/F.Field.js, line 119

设置是否显示红色星号

Name	Type	Description
`redStar`	boolean	是否显示红色星号

inherited setRegex(regex) form/F.TextBox.js, line 129

设置正则表达式

Name	Type	Description
`regex`	Regex	正则表达式

inherited setRegexPattern(regexPattern) form/F.TextBox.js, line 135

设置正则表达式规则

Name	Type	Description
`regexPattern`	string	正则表达式规则

inherited setRequired(required) form/F.TextBox.js, line 123

设置是否必填

Name	Type	Description
`required`	boolean	是否必填

inherited setSize(width, height) F.Component.js, line 158

设置控件尺寸

Name	Type	Description
`width`	number	宽度
`height`	number	高度

inherited setText(text, forceNoValidate) form/F.TextBox.js, line 89

设置显示文本

Name	Type	Description
`text`	string	显示文本
`forceNoValidate`	boolean	是否验证

inherited setTooltip(tooltip) F.Component.js, line 202

设置提示信息

Name	Type	Description
`tooltip`	string	提示信息

inherited setTriggerVisible(triggerNumber, visible) form/F.TriggerBox.js, line 57

设置触发按钮的显示状态

Name	Type	Description
`triggerNumber`	number	触发按钮序号（1或者2，从左开始计数）
`visible`	boolean	显示状态

inherited setValue(value, forceNoValidate) form/F.DropDownList.js, line 91

设置下拉列表的值

Name	Type	Description
`value`	string \| Array.<string>	下拉列表的值
`forceNoValidate`	boolean	是否验证

inherited setVisible(visible) F.Component.js, line 280

设置控件的显示状态

Name	Type	Description
`visible`	boolean	是否可见

inherited setWidth(width) F.Component.js, line 150

设置控件宽度

Name	Type	Description
`width`	number	宽度

inherited show() F.Component.js, line 268

显示控件

inherited showLoading(opacity, container) F.Container.js, line 103

显示加载动画

Name	Type	Description
`opacity`	number	透明度（默认值：0.65）
`container`	jQuery	显示动画的目标元素（留空则为内容元素）

inherited showPopEl() form/F.DropDownList.js, line 117

显示弹出框

inherited showTrigger() form/F.TriggerBox.js, line 69

显示触发按钮

inherited showTrigger1() form/F.TriggerBox.js, line 73

显示第一个触发按钮

inherited showTrigger2() form/F.TriggerBox.js, line 77

显示第二个触发按钮

inherited toggleEnabled() F.Component.js, line 230

切换启用状态

inherited toggleVisible() F.Component.js, line 274

切换显示状态

inherited trigger(eventName, args) F.Component.js, line 189

触发事件

Name	Type	Description
`eventName`	string	事件名称
`args`	Object	事件参数

inherited triggerDefaultAction() form/F.TriggerBox.js, line 49

触发缺省动作

inherited validate(){boolean} form/F.Field.js, line 159

验证字段的有效性

Returns:

Type	Description
boolean	是否有效

Events

inherited beforehide F.Component.js, line 57

隐藏控件之前触发（返回false则取消隐藏操作）

inherited beforeselect form/F.DropDownList.js, line 43

选中列表项之前触发（返回false则取消选中操作）

Name	Type	Description
`event`	jQuery.Event	事件对象
`selectedValue`	string	即将选中的值
`originalValue`	string	原来的值

inherited beforeshow F.Component.js, line 69

显示控件之前触发（返回false则取消显示操作）

inherited blur form/F.TextBox.js, line 49

输入框失去焦点时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

inherited change form/F.TextBox.js, line 28

输入框值改变时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

inherited cleariconclick form/F.DropDownList.js, line 52

点击清空图标时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

inherited enter form/F.TextBox.js, line 42

输入框获取焦点并按下ENTER键时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

inherited focus form/F.TextBox.js, line 35

输入框获取焦点时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

inherited hide F.Component.js, line 63

隐藏控件时触发

inherited layout F.Component.js, line 45

布局控件时触发

inherited render F.Component.js, line 51

渲染控件时触发

inherited select form/F.DropDownList.js, line 59

选中列表项时触发

Name	Type	Description
`event`	jQuery.Event	事件对象
`selectedValue`	string	选中的值
`originalValue`	string	原来的值

inherited show F.Component.js, line 75

显示控件时触发

inherited trigger1click form/F.TriggerBox.js, line 21

点击第一个触发图标时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

inherited trigger2click form/F.TriggerBox.js, line 37

点击第二个触发图标时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

inherited triggerclick form/F.TriggerBox.js, line 29

点击触发图标时触发

Name	Type	Description
`event`	jQuery.Event	事件对象

F.js v8.2.1

Class: TimePicker

new F.TimePicker(options)

Extends

Members

bodyEljQuery

eljQuery

itemsObject

Methods

inherited add(value)

Example

inherited blur()

inherited clearDirty()

inherited clearInvalid()

inherited clearValue()

inherited disable()

inherited doLayout(startFormTopmostComonent)

inherited enable()

inherited focus(selectText, delayMilliseconds)

inherited getAttr(key){string}

Returns:

inherited getFieldLabel(){string}

Returns:

inherited getFormFields(){Array.<F.Field>}

Returns:

inherited getHeight(){number}

Returns:

inherited getItem(value){F.Component}

Returns:

inherited getText(){string}

Returns:

inherited getTextByValue(value){string}

Returns:

inherited getTooltip(){string}

Returns:

inherited getValue(){string|Array.<string>}

Returns:

inherited getValueByText(text){string}

Returns:

inherited getWidth(){number}

Returns:

inherited hide()

inherited hideLoading()

inherited hidePopEl()

inherited hideTrigger()

inherited hideTrigger1()

inherited hideTrigger2()

inherited insert(insertIndex, value)

Example

inherited isDirty(){boolean}

Returns:

inherited isDisabled(){boolean}

Returns:

inherited isFocused(){boolean}

Returns:

inherited isTriggerVisible(triggerNumber){boolean}

Returns:

inherited isType(value){boolean}

Returns:

Example

inherited isUserInput(){boolean}

Returns:

inherited isValid(onlyFirstInvalidField){Array.<Object>}

Returns:

inherited isVisible(){boolean}

Returns:

inherited loadData(data, value)

inherited markInvalid(errorMsg)

inherited off(eventNames, fn)

inherited on(eventNames, fn)

inherited remove()

inherited removeAttr(key)

inherited removeTooltip()

inherited reset()

inherited setAttr(key, value)

inherited setAttrs(attrs)

inherited setDisabled(disabled)

inherited setEditable(editable)

inherited setEmptyText(emptyText)

inherited setEnabled(enabled)