# ui-form-textarea 文本域组

版本:v2.3.11

文本域组件用于输入多行文本,支持自定义行数、字数限制和自动高度

# 基本使用

<template>
  <div class="form-textarea-demo">
    <ui-form-textarea v-model="value" placeholder="请输入内 />
    <p>输入内容:{{ value }}</p>
  </div>
</template>

<script setup>
import { ref } from 'vue';
const value = ref('');
</script>

<style scoped>
.form-textarea-demo {
  padding: 20px;
  display: flex;
  flex-direction: column;
  gap: 16px;
}
</style>

# Props

参数 类型 默认值 说明
modelValue String - 文本域的
placeholder String - 占位符文
disabled Boolean false 是否禁用
readonly Boolean false 是否只读
rows Number 3 行数
maxlength Number - 最大输入长
showWordLimit Boolean false 是否显示字数统计
autoSize Boolean/Object false 是否自动调整高度
resize String 'vertical' 是否允许调整大小,可选值:noneverticalhorizontalboth

# Events

事件 说明 回调参数
change 输入值变化时触发 (value: String) 当前输入
input 实时输入时触 (value: String) 当前输入
focus 获得焦点时触 (event: Event) 焦点事件对象
blur 失去焦点时触 (event: Event) 失去焦点事件对象
lineChange 行数变化时触 (rows: Number) 当前行数

# 示例

# 带字数统计的文本

<template>
  <div class="form-textarea-demo">
    <ui-form-textarea 
      v-model="value" 
      placeholder="请输入内 
      :maxlength="100" 
      showWordLimit 
    />
  </div>
</template>

<script setup>
import { ref } from 'vue';
const value = ref('');
</script>

在线演示

扫码或点击链接在手机上查看完整演示

https://shadow-ui3-demo.nooko.cn/#/pages/form/form-textarea/form-textarea