From feae6d54bf754f0bd318420cb6350995b4b66a4c Mon Sep 17 00:00:00 2001
From: chenjiajian <770230504@qq.com>
Date: Thu, 27 Apr 2023 11:26:22 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0textarea=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
public/docset/ui/wc-textarea.md | 127 ++++++++++++++++++++++++++++++++
1 file changed, 127 insertions(+)
create mode 100644 public/docset/ui/wc-textarea.md
diff --git a/public/docset/ui/wc-textarea.md b/public/docset/ui/wc-textarea.md
new file mode 100644
index 0000000..fe0aff5
--- /dev/null
+++ b/public/docset/ui/wc-textarea.md
@@ -0,0 +1,127 @@
+## WC-TEXTAREA
+> 通过鼠标或键盘输入数字。
+
+
+
+### 基础用法
+
+
+
+import '//jscdn.ink/@bd/ui/latest/space/index.js'
+import '//jscdn.ink/@bd/ui/latest/form/textarea.js'
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ wc-textarea{ width:200px; }
+
+
+
+
+
+
+
+
+
+### 状态
+文本框有2种状态, `readonly` 和 `disabled`, 这2种状态下, value值都无法被修改。
+
+
+import '//jscdn.ink/@bd/ui/latest/space/index.js'
+import '//jscdn.ink/@bd/ui/latest/form/textarea.js'
+
+
+
+
+
+
+
+
+
+ wc-textarea{ width:250px; }
+
+
+
+
+### 显示字数限制
+使用`show-limit` 属性, 可以实时显示当前字符数和最大可输入字数。
+
+
+
+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-textarea{ width:250px; }
+
+
+
+### 高度自适应
+使用`autosize`属性，可让文本域高度自适应内容，当设置`maxheight`时。输入内容超过`maxheight`则出现滚动条。
+
+
+import '//jscdn.ink/@bd/ui/latest/space/index.js'
+import '//jscdn.ink/@bd/ui/latest/form/textarea.js'
+
+
+
+
+
+
+
+
+
+ wc-textarea{ width:250px; }
+
+
+
+
+
+
+
+
+### 完整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) |