Textarea - 《Taro 文档帮助手册教程》

sidebar_label: Textarea
类型
示例代码
TextareaProps

title: Textarea

sidebar_label: Textarea

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

支持情况： Textarea - 图1 Textarea - 图2 Textarea - 图3

参考文档

类型

ComponentType<TextareaProps>

示例代码

import Tabs from ‘@theme/Tabs’ import TabItem from ‘@theme/TabItem’

tsx
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>
    )
  }
}

html
<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`		否	输入框的内容
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 下的默认内边距
onFocus	`CommonEventFunction<onFocusEventDetail>`		否	输入框聚焦时触发
onBlur	`CommonEventFunction<onBlurEventDetail>`		否	输入框失去焦点时触发
onLineChange	`CommonEventFunction<onLineChangeEventDetail>`		否	输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0}
onInput	`CommonEventFunction<onInputEventDetail>`		否	当键盘输入时，触发 input 事件，event.detail = {value, cursor, keyCode} onInput 处理函数的返回值并不会反映到 textarea 上
onConfirm	`CommonEventFunction<onConfirmEventDetail>`		否	点击完成时，触发 confirm 事件，event.detail = {value: value}
onKeyboardHeightChange	`CommonEventFunction<onKeyboardHeightChangeEventDetail>`		否	键盘高度发生变化的时候触发此事件
nativeProps	`Record<string, unknown>`		否	用于透传 `WebComponents` 上的属性到内部 H5 标签上

API 支持度

API	微信小程序	H5	React Native
TextareaProps.value	✔️	✔️	✔️
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.onFocus	✔️	✔️	✔️
TextareaProps.onBlur	✔️	✔️	✔️
TextareaProps.onLineChange	✔️		✔️
TextareaProps.onInput	✔️	✔️	✔️
TextareaProps.onConfirm	✔️		✔️
TextareaProps.onKeyboardHeightChange	✔️
TextareaProps.nativeProps		✔️

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`	持续时间