跳到主要内容

多行文本 Textarea

输入框用于通过键盘输入内容,适用于多行文本

安装使用

import { TiTextarea } from '@titian-design/mobile-react'

用法示例

基本用法

const App: React.FC = () => {
return (
<>
<TiTextarea placeholder="请输入评论文字,限200字以内…" />
</>
)
}

高度自适应

const App: React.FC = () => {
return (
<>
<TiTextarea autoHeight />
</>
)
}

字数统计

const App: React.FC = () => {
return (
<>
<TiTextarea showCount />
</>
)
}

键盘确认按钮文字

const App: React.FC = () => {
return (
<>
<TiTextarea confirmType="done" placeholder="完成" />
<TiTextarea confirmType="send" placeholder="发送" />
<TiTextarea confirmType="search" placeholder="搜索" />
<TiTextarea confirmType="next" placeholder="下一项" />
<TiTextarea confirmType="go" placeholder="前往" />
</>
)
}

TiTextarea API

属性 Properties

名称类型必填默认值说明备注
valuestring-当前输入的值-
placeholderstring-输入框为空时占位符-
placeholderStylestring-指定 placeholder 的样式-
disabledboolean-是否禁用false
showCountboolean-是否显示统计字数false
maxlengthnumber-最大输入长度,设置为 -1 的时候不限制最大长度140
autoFocusboolean-自动聚焦,拉起键盘false
focusboolean-获取焦点false
autoHeightboolean-是否自动增高,设置 auto-height 时,style.height 不生效false
confirmTypestring-设置键盘右下角按钮的文字,仅在 type='text'时生效done
extStylestring | Record<string, string>-根节点样式-

事件 Events

名称参数列表描述备注
onInput(e: CustomEvent<{value: string}>) => void键盘输入时触发,-
onFocus(e: CustomEvent) => void输入框聚焦时触发,-
onBlur(e: CustomEvent<{value: string}>) => void输入框失去焦点时触发-
onConfirm(e: CustomEvent<{value: string}>) => void点击完成按钮时触发-

外部样式类 External Classes

名称说明备注
extClass根节点样式类-
textareaClasstextarea 样式类-

CSS 变量 CSS Variable

变量默认值说明备注
--textarea-height220px文本域高度-
--textarea-padding-v24px文本域垂直方向内边距-
--textarea-padding-h28px文本域水平方向内边距-
--textarea-min-height172px文本域最新高度,自增模式下有效-
--textarea-font-size28px文本域字号-
--textarea-line-height42px文本域行高-