微信小程序輸入多行文本的實(shí)戰(zhàn)記錄

更新時(shí)間：2022年03月21日 11:58:50 作者：Arururururu

多行輸入框組件是原生組件,這篇文章主要給大家介紹了關(guān)于微信小程序輸入多行文本的相關(guān)資料,文中通過實(shí)例代碼介紹的介紹的非常詳細(xì),需要的朋友可以參考下

引言

昨天把系分的項(xiàng)目又加了一點(diǎn)邏輯判斷，比如已經(jīng)下單的菜品不能減少，不能重復(fù)下單，應(yīng)該先下單再支付等…

弄完購物車的邏輯之后，發(fā)現(xiàn)一直沒有管備注那一塊，于是輸入了一下試試，結(jié)果發(fā)現(xiàn)不能換行…就非常丑陋

后來查閱相關(guān)資料發(fā)現(xiàn)，我用的wxml組件是input，只能單行輸入，如果要支持多行輸入，應(yīng)該用textarea。

下面就來介紹一下textarea：

1、textarea的屬性相關(guān)介紹

屬性名	類型	默認(rèn)值	說明	最低版本
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	最大輸入長度，設(shè)置為 -1 的時(shí)候不限制最大長度
auto-focus	Boolean	false	自動(dòng)聚焦，拉起鍵盤。
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)與鍵盤的距離，單位 px 。取 textarea 距離底部的距離和 cursor-spacing 指定的距離的最小值作為光標(biāo)與鍵盤的距離
cursor	Number		指定focus時(shí)的光標(biāo)位置	1.5.0
show-confirm-bar	Boolean	true	是否顯示鍵盤上方帶有”完成“按鈕那一欄	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	鍵盤彈起時(shí)，是否自動(dòng)上推頁面	1.9.90
bindfocus	EventHandle		輸入框聚焦時(shí)觸發(fā)，event.detail = { value, height }，height 為鍵盤高度，在基礎(chǔ)庫 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)鍵盤輸入時(shí)，觸發(fā) input 事件，event.detail = {value, cursor}， bindinput 處理函數(shù)的返回值并不會反映到 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: '',
            })

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

3、效果

支持多行輸入，超過給定高度出現(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 事件會晚于頁面上的 tap 事件，如果需要在 button 的點(diǎn)擊事件獲取 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 動(dòng)畫對 textarea 組件無效。

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