From 53fb228dacd5b11f7f9a8058e447e1be9e023646 Mon Sep 17 00:00:00 2001
From: RSS1102 <jimmyrss1102@gmail.com>
Date: Fri, 22 Aug 2025 11:39:49 +0800
Subject: [PATCH] feat(Textarea): add `allowInputOverMax` prop to control input
 behavior after exceeding `maxlength`

---
 src/textarea/props.ts          | 2 ++
 src/textarea/textarea.en-US.md | 2 +-
 src/textarea/textarea.md       | 2 +-
 src/textarea/textarea.tsx      | 4 +++-
 src/textarea/type.ts           | 5 +++++
 5 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/src/textarea/props.ts b/src/textarea/props.ts
index 6f3b2c6f7..fce902001 100644
--- a/src/textarea/props.ts
+++ b/src/textarea/props.ts
@@ -8,6 +8,8 @@ import { TdTextareaProps } from './type';
 import { PropType } from 'vue';
 
 export default {
+  /** 超出 `maxlength` 或 `maxcharacter` 之后是否还允许输入 */
+  allowInputOverMax: Boolean,
   /** 自动聚焦，拉起键盘 */
   autofocus: Boolean,
   /** 高度自动撑开。 autosize = true 表示组件高度自动撑开，同时，依旧允许手动拖高度。如果设置了 autosize.maxRows 或者 autosize.minRows 则不允许手动调整高度 */
diff --git a/src/textarea/textarea.en-US.md b/src/textarea/textarea.en-US.md
index 8d1e9db63..4a20bded4 100644
--- a/src/textarea/textarea.en-US.md
+++ b/src/textarea/textarea.en-US.md
@@ -5,7 +5,7 @@
 
 name | type | default | description | required
 -- | -- | -- | -- | --
-allowInputOverMax | Boolean | false | \- | N
+allowInputOverMax | Boolean | false | Allow input after exceeding `maxlength` or `maxcharacter` | N
 autofocus | Boolean | false | \- | N
 autosize | Boolean / Object | false | Typescript：`boolean \| { minRows?: number; maxRows?: number }` | N
 disabled | Boolean | false | \- | N
diff --git a/src/textarea/textarea.md b/src/textarea/textarea.md
index 9a4028f43..44515a233 100644
--- a/src/textarea/textarea.md
+++ b/src/textarea/textarea.md
@@ -5,7 +5,7 @@
 
 名称 | 类型 | 默认值 | 说明 | 必传
 -- | -- | -- | -- | --
-allowInputOverMax | Boolean | false | 超出maxlength或maxcharacter之后是否还允许输入 | N
+allowInputOverMax | Boolean | false | 超出 `maxlength` 或 `maxcharacter` 之后是否还允许输入 | N
 autofocus | Boolean | false | 自动聚焦，拉起键盘 | N
 autosize | Boolean / Object | false | 高度自动撑开。 autosize = true 表示组件高度自动撑开，同时，依旧允许手动拖高度。如果设置了 autosize.maxRows 或者 autosize.minRows 则不允许手动调整高度。TS 类型：`boolean \| { minRows?: number; maxRows?: number }` | N
 disabled | Boolean | false | 是否禁用文本框 | N
diff --git a/src/textarea/textarea.tsx b/src/textarea/textarea.tsx
index 8f3049858..237d55dc5 100644
--- a/src/textarea/textarea.tsx
+++ b/src/textarea/textarea.tsx
@@ -184,7 +184,9 @@ export default mixins(Vue as VueConstructor<Textarea>, classPrefixMixins).extend
         }
         if (this.maxcharacter && this.maxcharacter >= 0) {
           const stringInfo = getCharacterLength(val, this.maxcharacter);
-          val = typeof stringInfo === 'object' && stringInfo.characters;
+          if (!this.allowInputOverMax) {
+            val = typeof stringInfo === 'object' && stringInfo.characters;
+          }
         }
       }
 
diff --git a/src/textarea/type.ts b/src/textarea/type.ts
index 2cf85a0ea..9d93f3185 100644
--- a/src/textarea/type.ts
+++ b/src/textarea/type.ts
@@ -7,6 +7,11 @@
 import { TNode } from '../common';
 
 export interface TdTextareaProps {
+  /**
+   * 超出 `maxlength` 或 `maxcharacter` 之后是否还允许输入
+   * @default false
+   */
+  allowInputOverMax?: boolean;
   /**
    * 自动聚焦，拉起键盘
    * @default false