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

2、使用示例

下面給出我們的的示例，備注輸入框的值與details綁定，當(dāng)失去焦點(diǎn)（默認(rèn)為輸入完成）時(shí)將textarea的輸入框內(nèi)的值賦值給details，而執(zhí)行完某些業(yè)務(wù)（提交訂單or支付訂單）時(shí)設(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
    });
  },

...

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

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

3、效果

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

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

4、Bug & Tip bug:

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

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