Skip to content

文本域组件

文本域组件

文本域组件,用于多行文本输入,支持自适应高度、字数限制、换行控制等功能。

基础用法

基础的文本域用法,通过v-model绑定文本域的值。

当前值:
显示代码箭头
复制GitHub

禁用状态

添加disabled属性可以禁用文本域。

显示代码箭头
复制GitHub

大小调整

文本域默认可以调整大小,通过isResize属性可以控制是否允许调整大小。

可调整大小(默认):
禁止调整大小:
显示代码箭头
复制GitHub

换行控制

文本域默认允许换行,通过isEnter属性可以控制是否允许换行。

允许换行(默认):
当前值:
禁止换行:
当前值:
显示代码箭头
复制GitHub

字数限制

设置maxLength属性可以限制文本域的最大输入长度,默认会显示当前光标所在行数和字数统计,可以通过isCursor属性控制是否显示光标行数。

显示光标行数(默认):
不显示光标行数:
当前长度:0/50
显示代码箭头
复制GitHub

防抖输入

设置debounce属性可以实现防抖输入,延迟触发输入事件。

实时值:
防抖值(延迟1秒):
显示代码箭头
复制GitHub

不同尺寸

文本域支持三种尺寸:small、default 和 large。

小尺寸:
默认尺寸:
大尺寸:
显示代码箭头
复制GitHub

事件处理

文本域提供了多种事件:focus、blur、enter、input。

事件记录:
显示代码箭头
复制GitHub

文本域 API

属性

属性名说明类型可选值默认值
v-model绑定值string
size尺寸stringsmall / default / largedefault
placeholder占位文本string
disabled是否禁用booleanfalse
maxLength最大输入长度number
isCursor是否显示当前光标所在行数booleantrue
isResize是否允许调整大小booleantrue
isEnter是否允许换行输入booleantrue
isTip是否显示提示文本booleantrue
tip自定义提示文本string
tipClass提示文本类名string
debounce防抖事件回调(data?: string) => void
debounceDelay防抖延迟时间(ms)number1000

事件

事件名说明回调参数
focus获得焦点时触发(value: string)
blur失去焦点时触发(value: string)
input输入值变化时触发(value: string)
enter按下回车键时触发(value: string)
clear点击清空按钮时触发

样式变量

文本域组件使用了以下样式变量,可通过 SCSS 变量进行自定义:

变量名说明
$theme-color-primary主题色-主要
$border-color-default边框颜色-默认
$font-size-default字体大小-默认

基于MIT许可发布