Textarea

多行输入框。该组件是原生组件，使用时请注意相关限制

支持情况：

参考文档

类型

ComponentType<TextareaProps>

示例代码

React

export default class PageView extends Component {
  constructor() {
    super(...arguments)
  }

  render() {
    return (
      <View className='components-page'>
        <Text>输入区域高度自适应，不会出现滚动条</Text>
        <Textarea style='background:#fff;width:100%;min-height:80px;padding:0 30rpx;' autoHeight/>
        <Text>这是一个可以自动聚焦的 textarea</Text>
        <Textarea style='background:#fff;width:100%;height:80px;padding:0 30rpx;' autoFocus/>
      </View>
    )
  }
}

Vue

<template>
  <view class="components-page">
    <text>输入区域高度自适应，不会出现滚动条</text>
    <textarea style="background:#efefef;width:100%;min-height:80px;padding:0 30rpx;" :auto-height="true" />
    <text>这是一个可以自动聚焦的 textarea</text>
    <textarea style="background:#efefef;width:100%;height:80px;padding:0 30rpx;" :auto-focusd="true" />
  </view>
</template>

TextareaProps

参数	类型	默认值	必填	说明
value	string		否	输入框的内容
defaultValue	string		否	设置 React 非受控输入框的初始内容
placeholder	string		否	输入框为空时占位符
placeholderStyle	string		否	指定 placeholder 的样式
placeholderClass	string	"textarea-placeholder"	否	指定 placeholder 的样式类
disabled	boolean	false	否	是否禁用
maxlength	number	140	否	最大输入长度，设置为 -1 的时候不限制最大长度
autoFocus	boolean	false	否	自动聚焦，拉起键盘
focus	boolean	false	否	获取焦点
autoHeight	boolean	false	否	是否自动增高，设置 autoHeight 时，style.height不生效
fixed	boolean	false	否	如果 Textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true
cursorSpacing	number	0	否	指定光标与键盘的距离，单位 px 。取 Textarea 距离底部的距离和 cursorSpacing 指定的距离的最小值作为光标与键盘的距离
cursor	number	-1	否	指定 focus 时的光标位置
showConfirmBar	boolean	true	否	是否显示键盘上方带有”完成“按钮那一栏
selectionStart	number	-1	否	光标起始位置，自动聚集时有效，需与 selectionEnd 搭配使用
selectionEnd	number	-1	否	光标结束位置，自动聚集时有效，需与 selectionStart 搭配使用
adjustPosition	boolean	true	否	键盘弹起时，是否自动上推页面
holdKeyboard	boolean	false	否	focus 时，点击页面的时候不收起键盘
disableDefaultPadding	boolean	false	否	是否去掉 iOS 下的默认内边距
nativeProps	Record<string, unknown>		否	用于透传 WebComponents 上的属性到内部 H5 标签上
confirmType	"send" or "search" or "next" or "go" or "done" or "return"		否	设置键盘右下角按钮的文字
confirmHold	boolean		否	点击键盘右下角按钮时是否保持键盘不收起
name	string		否	组件名字，用于表单提交获取数据。
showCount	boolean	true	否	是否渲染字数统计功能（是否删除默认计数器/是否显示字数统计）。
controlled	boolean	false	否	是否为受控组件。为 true 时，value 内容会完全受 setData 控制。
ariaLabel	string		否	无障碍访问，（属性）元素的额外描述
adjustKeyboardTo	boolean	false	否	键盘对齐位置
onFocus	CommonEventFunction<onFocusEventDetail>		否	输入框聚焦时触发
onBlur	CommonEventFunction<onBlurEventDetail>		否	输入框失去焦点时触发
onLineChange	CommonEventFunction<onLineChangeEventDetail>		否	输入框行数变化时调用
onInput	CommonEventFunction<onInputEventDetail>		否	当键盘输入时，触发 input 事件 onInput 处理函数的返回值并不会反映到 textarea 上
onConfirm	CommonEventFunction<onConfirmEventDetail>		否	点击完成时， 触发 confirm 事件
onKeyboardHeightChange	CommonEventFunction<onKeyboardHeightChangeEventDetail>		否	键盘高度发生变化的时候触发此事件

API 支持度

API	微信小程序	百度小程序	支付宝小程序	抖音小程序	QQ 小程序	京东小程序	H5	React Native	Harmony	Harmony hybrid
TextareaProps.value	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.defaultValue	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.placeholder	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.placeholderStyle	✔️	✔️	✔️	✔️	✔️	✔️
TextareaProps.placeholderClass	✔️	✔️	✔️	✔️	✔️	✔️
TextareaProps.disabled	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.maxlength	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.autoFocus	✔️	✔️			✔️	✔️	✔️			✔️
TextareaProps.focus	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.autoHeight	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.fixed	✔️	✔️			✔️	✔️
TextareaProps.cursorSpacing	✔️	✔️		✔️	✔️	✔️
TextareaProps.cursor	✔️	✔️		✔️	✔️	✔️
TextareaProps.showConfirmBar	✔️	✔️		✔️	✔️	✔️
TextareaProps.selectionStart	✔️	✔️		✔️	✔️	✔️		✔️
TextareaProps.selectionEnd	✔️	✔️		✔️	✔️	✔️		✔️
TextareaProps.adjustPosition	✔️	✔️		✔️	✔️	✔️
TextareaProps.holdKeyboard	✔️			✔️
TextareaProps.disableDefaultPadding	✔️			✔️
TextareaProps.nativeProps							✔️			✔️
TextareaProps.confirmType	✔️	✔️	✔️	✔️
TextareaProps.confirmHold	✔️	✔️		✔️
TextareaProps.name			✔️
TextareaProps.showCount			✔️
TextareaProps.controlled			✔️
TextareaProps.ariaLabel					✔️
TextareaProps.adjustKeyboardTo	✔️
TextareaProps.onFocus	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.onBlur	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.onLineChange	✔️	✔️		✔️	✔️	✔️		✔️
TextareaProps.onInput	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.onConfirm	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️		✔️
TextareaProps.onKeyboardHeightChange	✔️			✔️

onFocusEventDetail

参数	类型	说明
value	string	输入值
height	number	键盘高度

onBlurEventDetail

参数	类型	说明
value	string	输入值
cursor	number	光标位置

onLineChangeEventDetail

参数	类型
height	number
heightRpx	number
lineCount	number

onInputEventDetail

参数	类型	说明
value	string	输入值
cursor	number	光标位置
keyCode	number	键值

onConfirmEventDetail

参数	类型	说明
value	string	输入值

onKeyboardHeightChangeEventDetail

参数	类型	说明
height	number	键盘高度
duration	number	持续时间