128 lines
3.9 KiB
Markdown
128 lines
3.9 KiB
Markdown
## WC-TEXTAREA
|
||
> 通过鼠标或键盘输入数字。
|
||
|
||
|
||
|
||
### 基础用法
|
||
|
||
<wc-sandbox>
|
||
<wc-lang slot="javascript">
|
||
import '//jscdn.ink/@bd/ui/latest/space/index.js'
|
||
import '//jscdn.ink/@bd/ui/latest/form/textarea.js'
|
||
</wc-lang>
|
||
<wc-lang slot="html">
|
||
<wc-space>
|
||
<wc-textarea type="primary" ></wc-textarea>
|
||
<wc-textarea type="info" ></wc-textarea>
|
||
<wc-textarea type="success" ></wc-textarea>
|
||
<wc-textarea type="warning" ></wc-textarea>
|
||
</wc-space>
|
||
<wc-space>
|
||
<wc-textarea ></wc-textarea>
|
||
<wc-textarea type="help" ></wc-textarea>
|
||
<wc-textarea type="secondary" ></wc-textarea>
|
||
<wc-textarea type="danger"></wc-textarea>
|
||
</wc-space>
|
||
</wc-lang>
|
||
<wc-lang slot="css">
|
||
wc-textarea{ width:200px; }
|
||
</wc-lang>
|
||
</wc-sandbox>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
### 状态
|
||
文本框有2种状态, `readonly` 和 `disabled`, 这2种状态下, value值都无法被修改。
|
||
<wc-sandbox>
|
||
<wc-lang slot="javascript">
|
||
import '//jscdn.ink/@bd/ui/latest/space/index.js'
|
||
import '//jscdn.ink/@bd/ui/latest/form/textarea.js'
|
||
</wc-lang>
|
||
<wc-lang slot="html">
|
||
<wc-space>
|
||
<wc-textarea value="x"></wc-textarea>
|
||
<wc-textarea readonly></wc-textarea>
|
||
<wc-textarea disabled></wc-textarea>
|
||
</wc-space>
|
||
</wc-lang>
|
||
<wc-lang slot="css">
|
||
wc-textarea{ width:250px; }
|
||
</wc-lang>
|
||
</wc-sandbox>
|
||
|
||
|
||
### 显示字数限制
|
||
使用`show-limit` 属性, 可以实时显示当前字符数和最大可输入字数。
|
||
<br/><br/>
|
||
<wc-sandbox>
|
||
<wc-lang slot="javascript">
|
||
import '//jscdn.ink/@bd/ui/latest/space/index.js'
|
||
import '//jscdn.ink/@bd/ui/latest/form/textarea.js'
|
||
import '//jscdn.ink/@bd/ui/latest/icon/index.js'
|
||
</wc-lang>
|
||
<wc-lang slot="html">
|
||
<wc-space>
|
||
<wc-textarea show-limit ></wc-textarea>
|
||
<wc-textarea show-limit maxlength="100" ></wc-textarea>
|
||
|
||
</wc-space>
|
||
<wc-space>
|
||
|
||
</wc-space>
|
||
</wc-lang>
|
||
<wc-lang slot="css">
|
||
wc-textarea{ width:250px; }
|
||
</wc-lang>
|
||
</wc-sandbox>
|
||
|
||
### 高度自适应
|
||
使用`autosize`属性，可让文本域高度自适应内容，当设置`maxheight`时。输入内容超过`maxheight`则出现滚动条。
|
||
<wc-sandbox>
|
||
<wc-lang slot="javascript">
|
||
import '//jscdn.ink/@bd/ui/latest/space/index.js'
|
||
import '//jscdn.ink/@bd/ui/latest/form/textarea.js'
|
||
</wc-lang>
|
||
<wc-lang slot="html">
|
||
<wc-space>
|
||
<wc-textarea autosize></wc-textarea>
|
||
<wc-textarea autosize maxheight="200" placeholder="maxheight:300"></wc-textarea>
|
||
|
||
</wc-space>
|
||
</wc-lang>
|
||
<wc-lang slot="css">
|
||
wc-textarea{ width:250px; }
|
||
</wc-lang>
|
||
</wc-sandbox>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
### 完整APIs
|
||
|
||
| 属性 | 值类型 | 默认值 | 描述 |
|
||
| :-: | :-: | :-: | - |
|
||
| value | String | 无 | 输入框绑定值 |
|
||
| type | String | 无 | 输入框类型, 仅能决定输入框的颜色, 无额外作用, 可选值有: `primary、info、success、warning、default、secondary、danger` |
|
||
| placeholder | String | 无 | 文本域占位文本 |
|
||
| autofocus | Boolean | false | 输入框的加载状态, 为`true`时, 输入框会自动获得焦点 |
|
||
| disbaled | Boolean | false | 输入框的禁用状态, 为`true`时, value不可更改 |
|
||
| readonly | Boolean | false | 输入框的只读状态, 为`true`时value不可更改。|
|
||
| maxlength | Number | 无 | 最大输入字符数 |
|
||
| minlength | Number | 无 | 最小输入字符数，不达到最小字数不会触发`submit`事件 |
|
||
| autosize | Boolean | false | 开启自适应内容高度 |
|
||
| maxheight | Number | 无 | 设置`autosize`后才生效，超过最大高度时显示滚动条 |
|
||
| minheight | Number | 无 | 文本域的最小高度，设置`autosize`后才生效 |
|
||
| lazy | Number | 0 | 为输入框设置节流防抖, 单位毫秒, 设置一个大于0的值之后, 在指定毫秒之内, 无法多次触发`submit`，`input`事件 |
|
||
|
||
### 事件
|
||
| 事件名 | 说明 | 回调参数 |
|
||
| :-: | :-: | :-: | - |
|
||
| input | 输入值时触发 | (event: Event) |
|
||
| submit | 按回车时触发 | (event: Event) |
|