字節(jié)跳動小程序開發(fā)組件文檔 textarea

2019-08-09 14:28 更新

多行輸入框。

屬性名	類型	默認值	說明	最低版本
value	String		輸入框的內(nèi)容	1.0.0
placeholder	String		輸入框為空時占位符	1.0.0
placeholder-style	String		指定 placeholder 的樣式	1.0.0
disabled	Boolean	false	是否禁用	1.0.0
maxlength	Number	140	最大輸入長度，設(shè)置為 -1 的時候不限制最大長度	1.0.0
focus	Boolean	false	是否獲得焦點	1.0.0
auto-height	Boolean	false	是否自動增高，設(shè)置auto-height時，設(shè)置height樣式不生效	1.0.0
fixed	Boolean	false	是否固定位置，如果設(shè)置了css樣式`position:fixed`，需要將改屬性設(shè)置為true	1.0.0
cursor-spacing	Number	0	指定軟鍵盤彈出時，與光標的距離是多少，單位是px	1.0.0
cursor	Number	-1	指定focus時的光標位置	1.0.0
selection-start	Number	-1	指定focus時選中片段的起始位置	1.0.0
selection-end	Number	-1	指定focus時選中片段的結(jié)束位置	1.0.0
bindinput	EventHandler		鍵盤輸入時觸發(fā)，e.detail={value, cursor}	1.0.0
bindfocus	EventHandler		輸入框聚焦時觸發(fā)，event.detail={value,height}，height是軟鍵盤的高度	1.0.0
bindblur	EventHandler		輸入框失去焦點時觸發(fā)，event.detail={value}	1.0.0
bindconfirm	EventHandler		用戶點擊鍵盤的完成按鈕時觸發(fā)，event.detail={value}	1.0.0

WARNING

請勿在 scroll-view、swiper、picker-view 中使用 textarea 組件
css 動畫對 textarea 組件無效
如果樣式上設(shè)置為fixed元素，請在組件上添加fixed屬性

示例

開發(fā)者工具中預(yù)覽

<textarea
    bindfocus="onTextFocus"
    bindblur="onTextBlur"
    bindinput="onTextInput"
    bindconfirm="onTextConfirm"
    placeholder="請輸入"
/>

<text>用戶輸入：{{value}}</text>

Page({
  data: {
    value: ''
  },
  onTextFocus: function (e) {
    console.log(e)
  },
  onTextBlur: function (e) {
    console.log(e)
  },
  onTextInput: function (e) {
    this.setData({
      value: e.detail.value
    })
  },
  onTextConfirm: function (e) {
    tt.showToast({title: 'confirm'})
  }
})

以上內(nèi)容是否對您有幫助：

寫筆記

我要補充