fineui/docs/case/editor/shelter_editor.md

bi.shelter_editor

带标记的文本框,需手动控制进入编辑状态 基类BI.Widget

{% method %} source

{% common %}

BI.createWidget({
    element: "#wrapper",
    type: "bi.shelter_editor",
    cls: "bi-border",
    width: 300,
    watermark: "这个是带标记的"
});

{% 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	true
watermark	文本框placeholder	string	—	" "
errorText	错误提示	string/function	—	" "
height	高度	number	—	30
textAlign	对齐方式	string	left,center,right	"left"

对外方法

名称	说明	回调参数
setErrorText	设置错误文本	text
getErrorText	获取错误文本	—
focus	文本框获取焦点	—
blur	文本框失焦	—
onKeyDown	按键事件	key
setValue	设置文本框值	value
getLastValidValue	获取文本框最后一次输入的有效值	—
setTextStyle	设置文本框样式	style
getValue	获取文本框值	—
isEditing	文本框是否处于编辑状态	—
isValid	文本框值是否有效	—
doRedMark	文本标红	—
unRedMark	取消文本标红	—
doHighLight	文本高亮	—
unHighLight	取消文本高亮	—
setTitle	设置title	title
setWarningTitle	设置错误title	title
setState	设置文本框值	—
getState	获取文本框值	—

事件

事件	说明
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	输入框为空时触发

---