bi.editor
文本框,基类BI.Single
BI.createWidget({
type: "bi.editor",
element: "#wrapper",
errorText: "字段不可重名!",
width: 200,
height: 30
});
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 | 选中文本框文本 | — |
onKeyDown | 按键事件 | key |
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 | 输入框为空时触发 |