fineui/docs/base/editor/editor.md

bi.editor

文本框,基类BI.Single

{% method %} source

{% common %}

BI.createWidget({
	type: "bi.editor",
	element: "#wrapper",
	errorText: "字段不可重名!",
	width: 200,
	height: 30
});

{% endmethod %}

API

基础属性

参数	说明	类型	可选值	默认值
hgap	效果相当于文本框左右padding值	number	—	4
vgap	效果相当于文本框上下padding值	number	—	2
lgap	效果相当于文本框left-padding值	number	—	0
rgap	效果相当于文本框right-padding值	number	—	0
tgap	效果相当于文本框top-padding值	number	—	0
bgap	效果相当于文本框bottom-padding值	number	—	0
validationChecker	输入较验函数	function	—	—
quitChecker	是否允许退出编辑函数	function	—	—
allowBlank	是否允许空值	boolean	true,false	false
watermark	文本框placeholder	string	—	" "
errorText	错误提示	string/function	—	" "
tipType	提示类型	string	success,warning	"warning"
inputType	输入框类型	string	参考input输入框类型	"text"

对外方法

名称	说明	回调参数
setErrorText	设置错误文本	text
getErrorText	获取错误文本	—
setErrorVisible	设置错误文本可见	b
disableError	设置error不可用	—
enableError	设置error可用	—
disableWaterMark	设置文本框placeholder不可用	—
enableWaterMark	恢复文本框placeholder可用	—
focus	文本框获取焦点	—
blur	文本框失焦	—
selectAll	选中文本框文本	—
setValue	设置文本框值	value
getLastValidValue	获取文本框最后一次输入的有效值	—
resetLastValidValue	重置文本框最后一次输入的有效值	value
getValue	获取文本框值	—
isEditing	文本框是否处于编辑状态	—
isValid	文本框值是否有效	—

事件

事件	说明
BI.Editor.EVENT_CHANGE	editor的value发生改变触发
BI.Editor.EVENT_FOCUS	focus事件
BI.Editor.EVENT_BLUR	blur事件
BI.Editor.EVENT_CLICK	点击编辑框触发(不在编辑状态时)
BI.Editor.EVENT_KEY_DOWN	keyDown时触发
BI.Editor.EVENT_SPACE	按下空格触发
BI.Editor.EVENT_BACKSPACE	按下Backspace触发
BI.Editor.EVENT_START	开始输入触发
BI.Editor.EVENT_PAUSE	暂停输入触发(输入空白字符)
BI.Editor.EVENT_STOP	停止输入触发
BI.Editor.EVENT_CONFIRM	确定输入触发（blur时且输入值有效）
BI.Editor.EVENT_VALID	输入值有效的状态事件
BI.Editor.EVENT_ERROR	输入值无效的状态事件
BI.Editor.EVENT_ENTER	回车事件
BI.Editor.EVENT_RESTRICT	回车但是值不合法
BI.Editor.EVENT_REMOVE	输入为空时按下backspace
BI.Editor.EVENT_EMPTY	输入框为空时触发

---