textarea
多行输入框。
属性名 | 类型 | 默认值 | 说明 | 最低版本 |
---|---|---|---|---|
value | String | 输入框的内容 | ||
placeholder | String | 输入框为空时占位符 | ||
placeholder-style | String | 指定 placeholder 的样式 | ||
disabled | Boolean | false | 是否禁用 | |
maxlength | Number | 140 | 最大输入长度,设置为 -1 的时候不限制最大长度 | |
focus | Boolean | false | 是否获得焦点 | |
auto-height | Boolean | false | 是否自动增高,设置auto-height时,设置height样式不生效 | |
fixed | Boolean | false | 是否固定位置,如果设置了position:fixed ,需要将改属性设置为true | |
cursor-spacing | Number | 0 | 指定软键盘弹出时,与光标的距离是多少 | |
cursor | Number | -1 | 指定focus时的光标位置 | |
selection-start | Number | -1 | 指定focus时选中片段的起始位置 | |
selection-end | Number | -1 | 指定focus时选中片段的结束位置 | |
bindinput | EventHandler | 键盘输入时触发,e.detail={value, cursor} | ||
bindfocus | EventHandler | 输入框聚焦时触发,event.detail={value,height},height是软键盘的高度 | ||
bindblur | EventHandler | 输入框失去焦点时触发,event.detail={value} | ||
bindconfirm | EventHandler | 用户点击键盘的完成按钮时触发,event.detail={value} |
WARNING
- 请勿在
scroll-view
、swiper
、picker-view
中使用 textarea 组件 - css 动画对 textarea 组件无效
示例
<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'})
}
})