#bi.text_editor
#####通过鼠标或键盘输入字符

## 基础用法

{% method %}
[source](https://jsfiddle.net/fineui/cna5o200/)

{% common %}
```javascript
BI.createWidget({
  type: "bi.text_editor",
  element: "#wrapper",
  width: 200,
  height: 30,
  watermark:"请输入内容"
});
```

{% endmethod %}

## 不可为空输入框

{% method %}
[source](https://jsfiddle.net/fineui/d7td9tfr/)

{% common %}
```javascript
BI.createWidget({
  type: "bi.text_editor",
  element: "#wrapper",
  width: 200,
  height: 30,
  watermark:"这个不予许空",
  value: "这是一个不可为空的输入框",
  allowBlank: false,
  errorText:  "不允许为空"      
});
```

{% endmethod %}

## 可为空输入框

{% method %}
[source](https://jsfiddle.net/fineui/kjmyg9ps/)

{% common %}
```javascript
BI.createWidget({
  type: "bi.text_editor",
  element: "#wrapper",
  width: 200,
  height: 30,
  allowBlank: true,
  errorText: "不能输入只输入a!",
  validationChecker: function (v) {
    if (v == "a") {
      return false;
    }
    return true;
  },
});
```

{% 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   |   |  null    |
| value    |   文本框默认值    |    string   |     |  |
| errorText    |  错误提示     |  string     | | null      |
| width    |   文本框宽度    |    number   |   |     |
| height    |   文本框高度    |    number   |  |  30    |

--- ---