Teal TealUI

选择框ui/select

提供多个选项供用户选择。

import { VNode, render } from "ui/control";
import { ListItem } from "ui/listBox";
import Select from "ui/select";

render(
    __root__,
    <Select value="2">
        <ListItem key="1">A</ListItem>
        <ListItem key="2">B</ListItem>
        <ListItem key="3">C</ListItem>
        <ListItem key="4">D</ListItem>
    </Select>
);

API

Select 类

继承自：ComboBox

表示一个选择框。

字段 类型 描述 继承自
⮞ selectedItem : any

(已覆盖)选中的第一项。

继承自

ComboBox

 any

(已覆盖)选中的第一项。

 ComboBox
⮞ value : any

(已覆盖)值。

继承自

ComboBox

 any

(已覆盖)值。

 ComboBox
⮞ defaultValue : any

(已覆盖)默认值。

继承自

ComboBox

 any

(已覆盖)默认值。

 ComboBox
⮞ menu : List

(已覆盖)(只读)下拉菜单控件。

继承自

Picker

 List

(已覆盖)(只读)下拉菜单控件。

 Picker
⮞ items : ListItem[]

继承自

ComboBox

 ListItem[] ComboBox
⮞ selectedIndex : number

选中的第一项的索引。

继承自

ComboBox

 number

选中的第一项的索引。

 ComboBox
⮞ keyMappings : KeyPressOptions

(只读)

继承自

ComboBox

 KeyPressOptions

(只读)

 ComboBox
⮞ onSelect : (item: ListItem, e: UIEvent, sender: Select) => boolean | void

选中项事件。

继承自

ComboBox

 function

选中项事件。

 ComboBox
⮞ button : HTMLButtonElement

按钮。

继承自

Picker

 HTMLButtonElement

按钮。

 Picker
⮞ icon : string

图标。

继承自

Picker

 string

图标。

 Picker
⮞ disabled : boolean

是否禁用。

继承自

Input

 boolean

是否禁用。

 Input
⮞ readOnly : boolean

是否只读。

继承自

Input

 boolean

是否只读。

 Input
⮞ menuOptions : Partial<List>

下拉菜单控件的选项。

继承自

Picker

 Partial<List>

下拉菜单控件的选项。

 Picker
⮞ resizeMode : "auto" | "fitInput" | "fitDropDown" | "none"

下拉框大小模式。

  • auto（默认）: 确保下拉菜单比文本框宽度大。
  • fitInput: 下拉菜单适应文本框宽度。
  • fitDropDown: 文本框适应下拉菜单宽度。
  • none：不处理下拉框大小。

继承自

Picker

 string

下拉框大小模式。

  • auto（默认）: 确保下拉菜单比文本框宽度大。
  • fitInput: 下拉菜单适应文本框宽度。
  • fitDropDown: 文本框适应下拉菜单宽度。
  • none：不处理下拉框大小。
 Picker
⮞ body : HTMLElement

(只读)获取用于包含子控件和节点的根元素。

继承自

Control

 HTMLElement

(只读)获取用于包含子控件和节点的根元素。

 Control
⮞ dropDown : Popup

(只读)下拉菜单。

继承自

Picker

 Popup

(只读)下拉菜单。

 Picker
⮞ dropDownOptions : Partial<Popup>

下拉菜单的选项。

继承自

Picker

 Partial<Popup>

下拉菜单的选项。

 Picker
⮞ onDropDownShow : (sender: Select) => void

下拉菜单显示事件。

继承自

Picker

 function

下拉菜单显示事件。

 Picker
⮞ onDropDownHide : (sender: Select) => void

下拉菜单隐藏事件。

继承自

Picker

 function

下拉菜单隐藏事件。

 Picker
⮞ onSelectEnd : (e: UIEvent, sender: Select) => void

选择结束事件。

参考

继承自

TextBox

 function

选择结束事件。

 TextBox
⮞ input : HTMLInputElement

(只读)内部关联的输入框元素。

继承自

Input

 HTMLInputElement

(只读)内部关联的输入框元素。

 Input
⮞ name : string

名字。

继承自

Input

 string

名字。

 Input
⮞ type : string

输入框的类型。

继承自

Input

 string

输入框的类型。

 Input
⮞ placeholder : string

未输入内容时的占位符。

继承自

Input

 string

未输入内容时的占位符。

 Input
⮞ tabIndex : number

TAB 键切换顺序。

继承自

Input

 number

TAB 键切换顺序。

 Input
⮞ tabStop : boolean

是否允许 TAB 键停靠。

继承自

Input

 boolean

是否允许 TAB 键停靠。

 Input
⮞ onCopy : (e: ClipboardEvent, sender: Select) => void

复制事件。

参考

继承自

Input

 function

复制事件。

 Input
⮞ onCut : (e: ClipboardEvent, sender: Select) => void

剪切事件。

参考

继承自

Input

 function

剪切事件。

 Input
⮞ onPaste : (e: ClipboardEvent, sender: Select) => void

粘贴事件。

参考

继承自

Input

 function

粘贴事件。

 Input
⮞ onBeforeCopy : (e: ClipboardEvent, sender: Select) => void

即将复制事件。

参考

继承自

Input

 function

即将复制事件。

 Input
⮞ onBeforeCut : (e: ClipboardEvent, sender: Select) => void

即将剪切事件。

参考

继承自

Input

 function

即将剪切事件。

 Input
⮞ onBeforePaste : (e: ClipboardEvent, sender: Select) => void

即将粘贴事件。

参考

继承自

Input

 function

即将粘贴事件。

 Input
⮞ onFocus : (e: FocusEvent, sender: Select) => void

获取焦点事件。

参考

继承自

Input

 function

获取焦点事件。

 Input
⮞ onBlur : (e: FocusEvent, sender: Select) => void

失去焦点事件。

参考

继承自

Input

 function

失去焦点事件。

 Input
⮞ onFocusIn : (e: FocusEvent, sender: Select) => void

当前元素和子元素获取焦点事件。

参考

继承自

Input

 function

当前元素和子元素获取焦点事件。

 Input
⮞ onFocusOut : (e: FocusEvent, sender: Select) => void

当前元素和子元素失去焦点事件。

参考

继承自

Input

 function

当前元素和子元素失去焦点事件。

 Input
⮞ onInput : (e: Event, sender: Select) => void

输入事件。

参考

继承自

Input

 function

输入事件。

 Input
⮞ onChange : (e: Event, sender: Select) => void

更改事件。

参考

继承自

Input

 function

更改事件。

 Input
⮞ onKeyDown : (e: KeyboardEvent, sender: Select) => void

键盘按下事件。

参考

继承自

Input

 function

键盘按下事件。

 Input
⮞ onKeyPress : (e: KeyboardEvent, sender: Select) => void

键盘点击事件。

参考

继承自

Input

 function

键盘点击事件。

 Input
⮞ onKeyUp : (e: KeyboardEvent, sender: Select) => void

键盘按上事件。

参考

继承自

Input

 function

键盘按上事件。

 Input
⮞ onEnter : (e: KeyboardEvent, sender: Select) => void

回车事件。

继承自

Input

 function

回车事件。

 Input
⮞ status : Status

控件状态。

继承自

Input

 Status

控件状态。

 Input
⮞ statusClassPrefix : string

控件状态前缀。

继承自

Input

 string

控件状态前缀。

 Input
⮞ hideSuccess : boolean

是否隐藏验证成功状态。

继承自

Input

 boolean

是否隐藏验证成功状态。

 Input
⮞ noValidate : boolean

是否禁用验证。

继承自

Input

 boolean

是否禁用验证。

 Input
⮞ validateEvent : string

触发验证的事件。

继承自

Input

 string

触发验证的事件。

 Input
⮞ required : boolean

字段是否必填。

继承自

Input

 boolean

字段是否必填。

 Input
⮞ requiredMessage : string

字段不满足必填时的提示文案。

继承自

Input

 string

字段不满足必填时的提示文案。

 Input
⮞ maxLength : number

最大长度。-1 表示不限制。

继承自

Input

 number

最大长度。-1 表示不限制。

 Input
⮞ maxLengthMessage : string

字段不满足最大长度时的提示文案。

继承自

Input

 string

字段不满足最大长度时的提示文案。

 Input
⮞ minLength : number

最小长度。-1 表示不限制。

继承自

Input

 number

最小长度。-1 表示不限制。

 Input
⮞ minLengthMessage : string

字段不满足最小长度时的提示文案。

继承自

Input

 string

字段不满足最小长度时的提示文案。

 Input
⮞ max : any

最大值。

继承自

Input

 any

最大值。

 Input
⮞ maxMessage : string

字段不满足最大值时的提示文案。

继承自

Input

 string

字段不满足最大值时的提示文案。

 Input
⮞ min : any

最小值。

继承自

Input

 any

最小值。

 Input
⮞ minMessage : string

字段不满足最小值时的提示文案。

继承自

Input

 string

字段不满足最小值时的提示文案。

 Input
⮞ pattern : RegExp

匹配格式的正则表达式。

继承自

Input

 RegExp

匹配格式的正则表达式。

 Input
⮞ patternMessage : string

字段不满足格式时的提示文案。

继承自

Input

 string

字段不满足格式时的提示文案。

 Input
⮞ validateErrorMessage : string

验证失败的提示文案。

继承自

Input

 string

验证失败的提示文案。

 Input
⮞ validateStartMessage : string

开始异步验证的提示文案。

继承自

Input

 string

开始异步验证的提示文案。

 Input
⮞ validateStartMessagePrefix : string

开始异步验证的提示文案前缀。

继承自

Input

 string

开始异步验证的提示文案前缀。

 Input
⮞ validateInfoMessagePrefix : string

验证信息状态的提示文案前缀。

继承自

Input

 string

验证信息状态的提示文案前缀。

 Input
⮞ validateErrorMessagePrefix : string

验证失败状态的提示文案前缀。

继承自

Input

 string

验证失败状态的提示文案前缀。

 Input
⮞ validateWarningMessagePrefix : string

验证警告状态的提示文案前缀。

继承自

Input

 string

验证警告状态的提示文案前缀。

 Input
⮞ validateSuccessMessagePrefix : string

验证成功状态的提示文案前缀。

继承自

Input

 string

验证成功状态的提示文案前缀。

 Input
⮞ willValidate : boolean

(只读)判断当前输入域是否需要验证。

继承自

Input

 boolean

(只读)判断当前输入域是否需要验证。

 Input
⮞ validateDelay : number

验证事件触发后延时验证的毫秒数。

继承自

Input

 number

验证事件触发后延时验证的毫秒数。

 Input
⮞ revalidateDelay : number

重新验证事件触发后延时验证的毫秒数。

继承自

Input

 number

重新验证事件触发后延时验证的毫秒数。

 Input
⮞ onValidate : (value: any, sender: Select) => ValidityResult

验证事件。

继承自

Input

 function

验证事件。

 Input
⮞ onReportValidity : (validityResult: NormalizedValidityResult, sender: Select) => boolean | void

报告验证结果事件。

继承自

Input

 function

报告验证结果事件。

 Input
⮞ validityToolTipOptions : Partial<ToolTip>

验证工具提示的选项。

继承自

Input

 Partial<ToolTip>

验证工具提示的选项。

 Input
⮞ readyState : ControlState

获取当前控件的渲染状态。

继承自

Control

 ControlState

获取当前控件的渲染状态。

 Control
⮞ elem : HTMLElement

关联的元素。

继承自

Control

 HTMLElement

关联的元素。

 Control
⮞ vNode : VNode

(保护的)获取当前控件关联的虚拟节点。

继承自

Control

 VNode

(保护的)获取当前控件关联的虚拟节点。

 Control
⮞ sourceVNode : VNode

获取创建该控件使用的源虚拟节点。

继承自

Control

 VNode

获取创建该控件使用的源虚拟节点。

 Control
⮞ alwaysUpdate : boolean

控件是否使用主动更新模式。

继承自

Control

 boolean

控件是否使用主动更新模式。

 Control
⮞ duration : number = 200

渐变的持续毫秒数。如果为 0 则不使用渐变。

继承自

Control

 number

渐变的持续毫秒数。如果为 0 则不使用渐变。

 Control
⮞ class : string

CSS 类名。

继承自

Control

 string

CSS 类名。

 Control
⮞ hidden : boolean

是否隐藏。

继承自

Control

 boolean

是否隐藏。

 Control
⮞ style : string | { [key: string]: string | number; }

控件样式。

继承自

Control

 string | object

控件样式。

 Control
⮞ id : string

控件序号。

继承自

Control

 string

控件序号。

 Control
⮞ content : NodeLike

控件内容。

继承自

Control

 NodeLike

控件内容。

 Control
⮞ onSelectStart : (e: Event, sender: Select) => void

选择开始事件。

参考

继承自

Control

 function

选择开始事件。

 Control
⮞ onClick : (e: MouseEvent, sender: Select) => void

点击事件。

参考

继承自

Control

 function

点击事件。

 Control
⮞ onAuxClick : (e: MouseEvent, sender: Select) => void

中键点击事件。

参考

继承自

Control

 function

中键点击事件。

 Control
⮞ onDblClick : (e: MouseEvent, sender: Select) => void

双击事件。

参考

继承自

Control

 function

双击事件。

 Control
⮞ onContextMenu : (e: PointerEvent, sender: Select) => void

右键菜单事件。

参考

继承自

Control

 function

右键菜单事件。

 Control
⮞ onMouseDown : (e: MouseEvent, sender: Select) => void

鼠标按下事件。

参考

继承自

Control

 function

鼠标按下事件。

 Control
⮞ onMouseUp : (e: MouseEvent, sender: Select) => void

鼠标按上事件。

参考

继承自

Control

 function

鼠标按上事件。

 Control
⮞ onMouseOver : (e: MouseEvent, sender: Select) => void

鼠标移入事件。

参考

继承自

Control

 function

鼠标移入事件。

 Control
⮞ onMouseOut : (e: MouseEvent, sender: Select) => void

鼠标移开事件。

参考

继承自

Control

 function

鼠标移开事件。

 Control
⮞ onMouseEnter : (e: MouseEvent, sender: Select) => void

鼠标进入事件。

参考

继承自

Control

 function

鼠标进入事件。

 Control
⮞ onMouseLeave : (e: MouseEvent, sender: Select) => void

鼠标离开事件。

参考

继承自

Control

 function

鼠标离开事件。

 Control
⮞ onMouseMove : (e: MouseEvent, sender: Select) => void

鼠标移动事件。

参考

继承自

Control

 function

鼠标移动事件。

 Control
⮞ onWheel : (e: WheelEvent, sender: Select) => void

鼠标滚轮事件。

参考

继承自

Control

 function

鼠标滚轮事件。

 Control
⮞ onScroll : (e: UIEvent, sender: Select) => void

滚动事件。

参考

继承自

Control

 function

滚动事件。

 Control
⮞ onTouchStart : (e: TouchEvent, sender: Select) => void

触摸开始事件。

参考

继承自

Control

 function

触摸开始事件。

 Control
⮞ onTouchMove : (e: TouchEvent, sender: Select) => void

触摸移动事件。

参考

继承自

Control

 function

触摸移动事件。

 Control
⮞ onTouchEnd : (e: TouchEvent, sender: Select) => void

触摸结束事件。

参考

继承自

Control

 function

触摸结束事件。

 Control
⮞ onTouchCancel : (e: TouchEvent, sender: Select) => void

触摸撤销事件。

参考

继承自

Control

 function

触摸撤销事件。

 Control
⮞ onPointerEnter : (e: PointerEvent, sender: Select) => void

指针进入事件。

参考

继承自

Control

 function

指针进入事件。

 Control
⮞ onPointerLeave : (e: PointerEvent, sender: Select) => void

指针离开事件。

参考

继承自

Control

 function

指针离开事件。

 Control
⮞ onPointerOver : (e: PointerEvent, sender: Select) => void

指针移入事件。

参考

继承自

Control

 function

指针移入事件。

 Control
⮞ onPointerOut : (e: PointerEvent, sender: Select) => void

指针移开事件。

参考

继承自

Control

 function

指针移开事件。

 Control
⮞ onPointerDown : (e: PointerEvent, sender: Select) => void

指针按下事件。

参考

继承自

Control

 function

指针按下事件。

 Control
⮞ onPointerMove : (e: PointerEvent, sender: Select) => void

指针移动事件。

参考

继承自

Control

 function

指针移动事件。

 Control
⮞ onPointerUp : (e: PointerEvent, sender: Select) => void

指针松开事件。

参考

继承自

Control

 function

指针松开事件。

 Control
⮞ onPointerCancel : (e: PointerEvent, sender: Select) => void

指针取消事件。

参考

继承自

Control

 function

指针取消事件。

 Control
⮞ onGotPointerCapture : (e: PointerEvent, sender: Select) => void

指针开始捕获事件。

参考

继承自

Control

 function

指针开始捕获事件。

 Control
⮞ onLostPointerCapture : (e: PointerEvent, sender: Select) => void

指针停止捕获事件。

参考

继承自

Control

 function

指针停止捕获事件。

 Control
方法 描述 继承自
⮞ init()():void

(保护的)

返回值

类型：void

继承自

ComboBox

(保护的)(已覆盖)当被子类重写时负责在关联元素后初始化当前控件。

 ComboBox
⮞ createDropDown()():Popup

(保护的)

返回值

类型：Popup

继承自

ComboBox

(保护的)(已覆盖)当被子类重写时负责创建下拉菜单。

 ComboBox
⮞ handleButtonClick()():void

(保护的)

返回值

类型：void

继承自

ComboBox

(保护的)(已覆盖)处理按钮点击事件。

 ComboBox
⮞ createMenu()():Control

(保护的)

返回值

类型：Control

继承自

Picker

(保护的)当被子类重写时负责创建下拉菜单。

 Picker
⮞ handleMenuSelect(item, e)(item:ListItem, e:UIEvent):void

(保护的)处理项选中事件。

参数 类型 描述 默认值
item* ListItem —
e* UIEvent —

返回值

类型：void

继承自

ComboBox

(保护的)处理项选中事件。

 ComboBox
⮞ updateMenu()():void

(保护的)

返回值

类型：void

继承自

Picker

(保护的)当被子类重写时负责更新下拉菜单的值。

 Picker
⮞ render()():VNode

(保护的)

返回值

类型：VNode

继承自

Control

(保护的)当被子类重写时负责返回当前控件的虚拟节点。

 Control
⮞ handleDropDownShow()():void

(保护的)处理下拉菜单显示事件。

返回值

类型：void

继承自

Picker

(保护的)处理下拉菜单显示事件。

 Picker
⮞ handleDropDownHide()():void

(保护的)处理下拉菜单隐藏事件。

返回值

类型：void

继承自

Picker

(保护的)处理下拉菜单隐藏事件。

 Picker
⮞ handleInput()():void

(保护的)处理输入事件。

返回值

类型：void

继承自

Picker

(保护的)处理输入事件。

 Picker
⮞ select()():void

全选当前控件。

返回值

类型：void

继承自

TextBox

全选当前控件。

 TextBox
⮞ isHidden()():boolean

判断输入域样式是否被隐藏。

返回值

类型：boolean

如果控件或其父元素被隐藏则返回 true，否则返回 false。

继承自

Input

判断输入域样式是否被隐藏。

 Input
⮞ handleValidateEvent()():void

(保护的)处理验证事件。

返回值

类型：void

继承自

Input

(保护的)处理验证事件。

 Input
⮞ checkValidity()():NormalizedValidityResult | Promise<NormalizedValidityResult>

验证当前输入域。

返回值

类型：NormalizedValidityResult | Promise<NormalizedValidityResult>

返回验证结果。如果正在执行异步验证则返回一个确认对象。

继承自

Input

验证当前输入域。

 Input
⮞ validate(value)(value:this["value"]):ValidityResult

(保护的)当被子类重写时负责验证指定的值。

参数 类型 描述 默认值
value* this["value"] —

返回值

类型：ValidityResult

返回验证结果。如果正在执行异步验证则返回一个确认对象。

继承自

Input

(保护的)当被子类重写时负责验证指定的值。

 Input
⮞ normlizeValidityResult(r)(r:ValidityResult):NormalizedValidityResult | Promise<NormalizedValidityResult>

(保护的)规范化验证结果对象。

参数 类型 描述 默认值
r* ValidityResult —

返回值

类型：NormalizedValidityResult | Promise<NormalizedValidityResult>

继承自

Input

(保护的)规范化验证结果对象。

 Input
⮞ reportValidity()():NormalizedValidityResult | Promise<NormalizedValidityResult>

向用户报告验证结果。

返回值

类型：NormalizedValidityResult | Promise<NormalizedValidityResult>

返回验证结果。如果正在执行异步验证则返回一个确认对象。

继承自

Input

向用户报告验证结果。

 Input
⮞ setCustomValidity(validityResult)(validityResult:string | boolean | Partial<NormalizedValidityResult>):void

设置自定义的验证消息。

参数 类型 描述 默认值
validityResult* string | boolean | Partial<NormalizedValidityResult> —

返回值

类型：void

继承自

Input

设置自定义的验证消息。

 Input
⮞ createValidityToolTip()():ToolTip

(保护的)当被子类重写时负责创建当前输入框的默认验证提示。

返回值

类型：ToolTip

继承自

Input

(保护的)当被子类重写时负责创建当前输入框的默认验证提示。

 Input
⮞ reset()():void

重置当前输入域。

返回值

类型：void

继承自

Input

重置当前输入域。

 Input
⮞ focus()():void

令当前控件获得焦点。

返回值

类型：void

继承自

Input

令当前控件获得焦点。

 Input
⮞ blur()():void

令当前控件失去焦点。

返回值

类型：void

继承自

Input

令当前控件失去焦点。

 Input
⮞ layout(changes)(changes:Changes):void
参数 类型 描述 默认值
changes* Changes —

返回值

类型：void

继承自

Control

重新布局当前控件。

 Control
⮞ uninit()():void

(保护的)当被子类重写时负责在元素被取消关联前取消初始化当前控件。

返回值

类型：void

继承自

Control

(保护的)当被子类重写时负责在元素被取消关联前取消初始化当前控件。

 Control
⮞ update()():void

重新渲染当前控件。

返回值

类型：void

继承自

Control

重新渲染当前控件。

 Control
⮞ invalidate()():void

使当前控件无效并在下一帧重新渲染。

返回值

类型：void

继承自

Control

使当前控件无效并在下一帧重新渲染。

 Control
⮞ renderTo(parent, ...)(parent:Control | Node, refChild?:Control | Node):void

将当前控件渲染到指定的父控件或节点。

参数 类型 描述 默认值
parent* Control | Node —
refChild Control | Node —

返回值

类型：void

继承自

Control

将当前控件渲染到指定的父控件或节点。

 Control
⮞ find(selector)(selector:string):Control | HTMLElement

在当前控件查找指定的子控件或节点。

参数 类型 描述 默认值
selector* string —

返回值

类型：Control | HTMLElement

返回子控件或节点。如果找不到则返回 null。

继承自

Control

在当前控件查找指定的子控件或节点。

 Control
⮞ query(selector)(selector:string):(Control | HTMLElement)[]

在当前控件查找匹配的所有子控件或节点。

参数 类型 描述 默认值
selector* string —

返回值

类型：(Control | HTMLElement)[]

返回子控件或节点列表。

继承自

Control

在当前控件查找匹配的所有子控件或节点。

 Control