跳到主要内容

多行文本 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文本域行高-