屬性名	類型	默認(rèn)值	說明	最低版本
value	String		輸入框的內(nèi)容
placeholder	String		輸入框為空時占位符
placeholder-style	String		指定 placeholder 的樣式
placeholder-class	String	textarea-placeholder	指定 placeholder 的樣式類
disabled	Boolean	false	是否禁用
maxlength	Number	140	最大輸入長度，設(shè)置為 -1 的時候不限制最大長度
auto-focus	Boolean	false	自動聚焦，拉起鍵盤。
focus	Boolean	false	獲取焦點
auto-height	Boolean	false	是否自動增高，設(shè)置auto-height時，style.height不生效
fixed	Boolean	false	如果 textarea 是在一個 `position:fixed` 的區(qū)域，需要顯示指定屬性 fixed 為 true
cursor-spacing	Number	0	指定光標(biāo)與鍵盤的距離，單位 px 。取 textarea 距離底部的距離和 cursor-spacing 指定的距離的最小值作為光標(biāo)與鍵盤的距離
cursor	Number		指定focus時的光標(biāo)位置	1.5.0
show-confirm-bar	Boolean	true	是否顯示鍵盤上方帶有”完成“按鈕那一欄	1.6.0
selection-start	Number	-1	光標(biāo)起始位置，自動聚集時有效，需與selection-end搭配使用	1.9.0
selection-end	Number	-1	光標(biāo)結(jié)束位置，自動聚集時有效，需與selection-start搭配使用	1.9.0
adjust-position	Boolean	true	鍵盤彈起時，是否自動上推頁面	1.9.90
bindfocus	EventHandle		輸入框聚焦時觸發(fā)，event.detail = { value, height }，height 為鍵盤高度，在基礎(chǔ)庫 1.9.90 起支持
bindblur	EventHandle		輸入框失去焦點時觸發(fā)，event.detail = {value, cursor}
bindlinechange	EventHandle		輸入框行數(shù)變化時調(diào)用，event.detail = {height: 0, heightRpx: 0, lineCount: 0}
bindinput	EventHandle		當(dāng)鍵盤輸入時，觸發(fā) input 事件，event.detail = {value, cursor}， bindinput 處理函數(shù)的返回值并不會反映到 textarea 上
bindconfirm	EventHandle		點擊完成時，觸發(fā) confirm 事件，event.detail = {value: value}

2、使用示例

下面給出我們的的示例，備注輸入框的值與details綁定，當(dāng)失去焦點（默認(rèn)為輸入完成）時將textarea的輸入框內(nèi)的值賦值給details，而執(zhí)行完某些業(yè)務(wù)（提交訂單or支付訂單）時設(shè)置details為空字符串。

//wxml
<textarea class="detailText" 
    placeholder="輸入您的備注"
    bindblur="bindTextAreaBlur"
    value="{{details}}">
</textarea>


//js
bindTextAreaBlur: function(e) {
    console.log(e.detail.value);
    var that = this;
    that.setData({
      details: e.detail.value
    });
  },

...

//提交訂單或支付訂單時清空備注
var that = this;
that.setData({
              details: '',
            })

由于備注部分在頁面上只占一部分位置，因此設(shè)置其css樣式為固定高度，而不是設(shè)其屬性auto-height。

3、效果

支持多行輸入，超過給定高度出現(xiàn)滾動條

獲取輸入框內(nèi)的文字

4、Bug & Tip bug:

bug: 微信版本 6.3.30，textarea 在列表渲染時，新增加的 textarea 在自動聚焦時的位置計算錯誤。
tip: textarea 的 blur 事件會晚于頁面上的 tap 事件，如果需要在 button 的點擊事件獲取 textarea，可以使用 form 的 bindsubmit。
tip: 不建議在多行文本上對用戶的輸入進(jìn)行修改，所以 textarea 的 bindinput 處理函數(shù)并不會將返回值反映到 textarea 上。
tip: textarea 組件是由客戶端創(chuàng)建的原生組件，它的層級是最高的，不能通過 z-index 控制層級。
tip: 請勿在 scroll-view、swiper、picker-view、movable-view 中使用 textarea 組件。
tip: css 動畫對 textarea 組件無效。

更多資料請查看官網(wǎng)文檔。