# bi.editor ## 文本框,基类[BI.Single](/core/single.md) {% method %} [source](https://jsfiddle.net/fineui/4eLytgve/) {% common %} ```javascript 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 | — | — | | mouseOut | | boolean | true,false | false | | 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 | 输入框为空时触发 | ---