文本框组件
@beisen-phoenix/textarea
概述
高度自适应,默认 3 行,最小 1 行,最大 5 行
若传入 autoHeight 为 true,则没有最大高度的限制
若用户通过右下角图标拖拽过文本域的大小,则高度不再自适应,只能由用户拖拽控制
API
参数 | 说明 | 类型 | 默认值 | 是否必传 |
---|---|---|---|---|
size | 文本域尺寸,仅支持 default large
|
string | 'default' | No |
value | 文本域内容 | string | - | No |
defaultValue | 文本域默认内容,若使用了 value,则 defaultValue 无效 | string | - | No |
placeholder | 同原生 textarea | string | 请输入 | No |
status | 输入框状态,正常、禁用、提示、错误,支持 normal disabled isHint error
|
string | 'normal' | No |
minLength | 最少字数,不传表示不显示 | number | - | No |
maxLength | 最大字数,不传表示不显示 | number | - | No |
autoHeight | 是否有最大高度的限制,默认状态下最大高度为 5 行 | boolean | false | No |
allowResize | 是否允许用户通过右下角图标拖拽大小 | boolean | true | No |
translation | 国际化 | object | - | No |
onChange | 文本域内容变化时的回调 | function(value: string) | - | No |
onFocus | 获取焦点时的回调 | function(value: string) | - | No |
onBlur | 失去焦点时的回调 | function(value: string) | - | No |
onClick | 鼠标点击文本域的回调 | function(event) | - | No |
onPaste | 粘贴事件的回调函数 | function(event) | - | No |
onKeyDown | 按下键盘的回调 | function(event) | - | No |
getTextareaRef | 获取 textarea dom 节点,在 componentDidMount 和 componentDidUpdate 中执行 | function(ref: HTMLTextAreaElement) | - | No |
lang | 当前语言环境(zh_CN,en_US,zh_TW) | string | zh_CN | 否 |
translation
translation: {
placeholder: '请输入',
minLengthMessage:'至少输入{{0}}个字',//优先使用
minLengthBefore: '至少输入',//不建议使用,或许会废弃掉,请使用minLengthMessage
minLengthAfter: '个字'//不建议使用,或许会废弃掉,请使用minLengthMessage
}
changelog
2019/11/21
新增 lang 属性,用于表示当前的语言环境,取值范围为“zh_CN,zh_TW,en_US”内部新增中文简体、英文、中文繁体语言包。
translation 对象下的新增 minLengthMessage 属性,后续会废弃 minLengthBefore 和 minLengthAfter 属性