From 3674fd12f3e8a23caba8eed0cf4f0372d8bd261d Mon Sep 17 00:00:00 2001
From: Huuyii-sleeping <3134846106@qq.com>
Date: Mon, 6 Jul 2026 23:07:56 +0800
Subject: [PATCH 1/2] feat(textarea): support clearable

---
 packages/components/textarea/Textarea.tsx     | 29 +++++++++-
 .../textarea/__tests__/textarea.test.tsx      | 39 +++++++++++--
 .../textarea/_example/clearable.tsx           | 20 +++++++
 .../components/textarea/_usage/props.json     |  8 ++-
 packages/components/textarea/defaultProps.ts  |  1 +
 .../components/textarea/textarea.en-US.md     | 50 ++++++++--------
 packages/components/textarea/textarea.md      | 50 ++++++++--------
 packages/components/textarea/type.ts          | 57 +++++++++++++++----
 8 files changed, 189 insertions(+), 65 deletions(-)
 create mode 100644 packages/components/textarea/_example/clearable.tsx

diff --git a/packages/components/textarea/Textarea.tsx b/packages/components/textarea/Textarea.tsx
index a78dc72db0..4613f3cd97 100644
--- a/packages/components/textarea/Textarea.tsx
+++ b/packages/components/textarea/Textarea.tsx
@@ -1,5 +1,6 @@
 import React, { forwardRef, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
 import classNames from 'classnames';
+import { CloseCircleFilledIcon as TdCloseCircleFilledIcon } from 'tdesign-icons-react';
 import calcTextareaHeight from '@tdesign/common-js/utils/calcTextareaHeight';
 import { getCharacterLength, getUnicodeLength, limitUnicodeMaxLength } from '@tdesign/common-js/utils/helper';
 
@@ -9,6 +10,7 @@ import useConfig from '../hooks/useConfig';
 import useControlled from '../hooks/useControlled';
 import useDefaultProps from '../hooks/useDefaultProps';
 import useEventCallback from '../hooks/useEventCallback';
+import useGlobalIcon from '../hooks/useGlobalIcon';
 import useIsomorphicLayoutEffect from '../hooks/useLayoutEffect';
 import { textareaDefaultProps } from './defaultProps';
 
@@ -49,9 +51,12 @@ const Textarea = forwardRef<TextareaRefInterface, TextareaProps>((originalProps,
     tips,
     allowInputOverMax,
     rows,
+    clearable,
+    onClear,
     ...otherProps
   } = props;
   const hasMaxcharacter = typeof maxcharacter !== 'undefined';
+  const readOnlyProp = props.readOnly || props.readonly;
 
   const [value = '', setValue] = useControlled(props, 'value', props.onChange);
 
@@ -72,6 +77,10 @@ const Textarea = forwardRef<TextareaRefInterface, TextareaProps>((originalProps,
   }, [value, allowInputOverMax, maxcharacter]);
 
   const { classPrefix } = useConfig();
+  const { CloseCircleFilledIcon } = useGlobalIcon({
+    CloseCircleFilledIcon: TdCloseCircleFilledIcon,
+  });
+  const isShowClearIcon = clearable && value && !disabled && !readOnlyProp;
 
   const textareaPropsNames = Object.keys(otherProps).filter(
     (key) => !/^on[A-Z]/.test(key) && !OMIT_PROPS.includes(key),
@@ -140,6 +149,13 @@ const Textarea = forwardRef<TextareaRefInterface, TextareaProps>((originalProps,
     }
   }
 
+  function handleClear(e: React.MouseEvent<SVGSVGElement>) {
+    composingRef.current = false;
+    setComposingValue('');
+    setValue('', { e, trigger: 'clear' });
+    onClear?.({ e });
+  }
+
   function handleCompositionStart() {
     composingRef.current = true;
   }
@@ -216,7 +232,13 @@ const Textarea = forwardRef<TextareaRefInterface, TextareaProps>((originalProps,
   );
 
   return (
-    <div style={style} ref={wrapperRef} className={classNames(`${classPrefix}-textarea`, className)}>
+    <div
+      style={style}
+      ref={wrapperRef}
+      className={classNames(`${classPrefix}-textarea`, className, {
+        [`${classPrefix}-textarea--clearable`]: clearable,
+      })}
+    >
       <textarea
         {...textareaProps}
         {...eventProps}
@@ -224,7 +246,7 @@ const Textarea = forwardRef<TextareaRefInterface, TextareaProps>((originalProps,
         value={composingRef.current ? composingValue : value}
         style={textareaStyle}
         className={textareaClassNames}
-        readOnly={props.readOnly || props.readonly}
+        readOnly={readOnlyProp}
         autoFocus={autofocus}
         disabled={disabled}
         onChange={inputValueChangeHandle}
@@ -235,6 +257,9 @@ const Textarea = forwardRef<TextareaRefInterface, TextareaProps>((originalProps,
         onCompositionEnd={handleCompositionEnd}
         ref={textareaRef}
       />
+      {isShowClearIcon ? (
+        <CloseCircleFilledIcon className={`${classPrefix}-textarea__clear`} onClick={handleClear} />
+      ) : null}
       {textTips || limitText ? (
         <div
           className={classNames(`${classPrefix}-textarea__info_wrapper`, {
diff --git a/packages/components/textarea/__tests__/textarea.test.tsx b/packages/components/textarea/__tests__/textarea.test.tsx
index 21ffd9999e..c3029804f2 100644
--- a/packages/components/textarea/__tests__/textarea.test.tsx
+++ b/packages/components/textarea/__tests__/textarea.test.tsx
@@ -16,6 +16,29 @@ describe('Textarea 组件测试', () => {
     expect(container.querySelectorAll('.t-is-disabled')).not.toBeNull();
   });
 
+  test('clearable', async () => {
+    const onChange = vi.fn();
+    const onClear = vi.fn();
+    const { container } = render(
+      <Textarea defaultValue="Hello TDesign" clearable onChange={onChange} onClear={onClear} />,
+    );
+
+    expect(container.querySelector('.t-textarea__clear')).not.toBeNull();
+
+    fireEvent.click(container.querySelector('.t-textarea__clear'));
+    expect(container.querySelector('textarea')).toHaveValue('');
+    expect(onChange).toHaveBeenCalledWith('', expect.objectContaining({ trigger: 'clear' }));
+    expect(onClear).toHaveBeenCalledTimes(1);
+  });
+
+  test('clearable hidden when disabled or readonly', async () => {
+    const { container: disabledContainer } = render(<Textarea value="Hello TDesign" clearable disabled />);
+    expect(disabledContainer.querySelector('.t-textarea__clear')).toBeNull();
+
+    const { container: readOnlyContainer } = render(<Textarea value="Hello TDesign" clearable readOnly />);
+    expect(readOnlyContainer.querySelector('.t-textarea__clear')).toBeNull();
+  });
+
   // 测试输入
   test('input', async () => {
     render(<Textarea maxcharacter={5} />);
@@ -26,17 +49,23 @@ describe('Textarea 组件测试', () => {
     fireEvent.change(document.querySelector('textarea'), { target: { value } });
     expect(document.querySelector('textarea').textContent).toBe(value);
 
-    fireEvent.change(document.querySelector('textarea'), { target: { value: 'hi,tzmax' } });
+    fireEvent.change(document.querySelector('textarea'), {
+      target: { value: 'hi,tzmax' },
+    });
     expect(document.querySelector('textarea').textContent.length).toBe(5);
 
     const onChange = vi.fn();
     const { container } = render(<Textarea maxLength={1} onChange={onChange} />);
     fireEvent.compositionStart(container.querySelector('textarea'));
-    fireEvent.change(container.querySelector('textarea'), { target: { value: 'tian' } });
+    fireEvent.change(container.querySelector('textarea'), {
+      target: { value: 'tian' },
+    });
     fireEvent.compositionEnd(container.querySelector('textarea'), {
       currentTarget: { value: '天' },
     });
-    fireEvent.change(container.querySelector('textarea'), { target: { value: '天' } });
+    fireEvent.change(container.querySelector('textarea'), {
+      target: { value: '天' },
+    });
     expect(onChange).toHaveBeenLastCalledWith('天', expect.objectContaining({}));
   });
 
@@ -82,7 +111,9 @@ describe('Textarea 组件测试', () => {
 
     event = null;
     changeValue = '';
-    fireEvent.change(document.querySelector('textarea'), { target: { value: 'hi,tzmax' } });
+    fireEvent.change(document.querySelector('textarea'), {
+      target: { value: 'hi,tzmax' },
+    });
     expect(changeValue).not.toBeNull();
     expect(event).not.toBeNull();
   });
diff --git a/packages/components/textarea/_example/clearable.tsx b/packages/components/textarea/_example/clearable.tsx
new file mode 100644
index 0000000000..37c5dc04be
--- /dev/null
+++ b/packages/components/textarea/_example/clearable.tsx
@@ -0,0 +1,20 @@
+import React, { useState } from 'react';
+import { Textarea } from 'tdesign-react';
+
+export default function TextareaClearable() {
+  const [value, setValue] = useState('这是一段可以被快速清空的多行文本。');
+
+  return (
+    <Textarea
+      value={value}
+      clearable
+      placeholder="请输入内容"
+      onChange={(value) => {
+        setValue(value);
+      }}
+      onClear={() => {
+        console.log('onClear');
+      }}
+    />
+  );
+}
diff --git a/packages/components/textarea/_usage/props.json b/packages/components/textarea/_usage/props.json
index 856b190a74..d1e0f13da3 100644
--- a/packages/components/textarea/_usage/props.json
+++ b/packages/components/textarea/_usage/props.json
@@ -11,6 +11,12 @@
     "defaultValue": false,
     "options": []
   },
+  {
+    "name": "clearable",
+    "type": "Boolean",
+    "defaultValue": false,
+    "options": []
+  },
   {
     "name": "disabled",
     "type": "Boolean",
@@ -23,4 +29,4 @@
     "defaultValue": false,
     "options": []
   }
-]
\ No newline at end of file
+]
diff --git a/packages/components/textarea/defaultProps.ts b/packages/components/textarea/defaultProps.ts
index 4009d88bcc..b3b19feed1 100644
--- a/packages/components/textarea/defaultProps.ts
+++ b/packages/components/textarea/defaultProps.ts
@@ -8,6 +8,7 @@ export const textareaDefaultProps: TdTextareaProps = {
   allowInputOverMax: false,
   autofocus: false,
   autosize: false,
+  clearable: false,
   disabled: false,
   placeholder: undefined,
   readonly: false,
diff --git a/packages/components/textarea/textarea.en-US.md b/packages/components/textarea/textarea.en-US.md
index 1c9d38ad82..f50850eb6d 100644
--- a/packages/components/textarea/textarea.en-US.md
+++ b/packages/components/textarea/textarea.en-US.md
@@ -4,27 +4,29 @@
 
 ### Textarea Props
 
-name | type | default | description | required
--- | -- | -- | -- | --
-className | String | - | className of component | N
-style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | 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
-count | Boolean / Function | - | Character counter. It is enabled by default when `maxLength` or `maxCharacter` is set.。Typescript: `boolean \| ((ctx: { value: string; count: number; maxLength?: number; maxCharacter?: number }) => TNode)`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-disabled | Boolean | false | \- | N
-maxcharacter | Number | - | \- | N
-maxlength | Number | - | Typescript: `number` | N
-name | String | - | \- | N
-placeholder | String | undefined | \- | N
-readOnly | Boolean | false | \- | N
-status | String | default | options：default/success/warning/error | N
-tips | TNode | - | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-value | String | - | Typescript: `TextareaValue` `type TextareaValue = string`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts) | N
-defaultValue | String | - | uncontrolled property。Typescript: `TextareaValue` `type TextareaValue = string`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts) | N
-onBlur | Function |  | Typescript: `(value: TextareaValue, context: { e: FocusEvent }) => void`<br/> | N
-onChange | Function |  | Typescript: `(value: TextareaValue, context?: { e?: InputEvent }) => void`<br/> | N
-onFocus | Function |  | Typescript: `(value: TextareaValue, context : { e: FocusEvent }) => void`<br/> | N
-onKeydown | Function |  | Typescript: `(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/> | N
-onKeypress | Function |  | Typescript: `(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/> | N
-onKeyup | Function |  | Typescript: `(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/> | N
+| name              | type               | default   | description                                                                                                                                                                                                                                                                                                                   | required |
+| ----------------- | ------------------ | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
+| className         | String             | -         | className of component                                                                                                                                                                                                                                                                                                        | N        |
+| style             | Object             | -         | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties`                                                                                                                                                                                                                                                                | 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        |
+| clearable         | Boolean            | false     | Whether the textarea is clearable                                                                                                                                                                                                                                                                                             | N        |
+| count             | Boolean / Function | -         | Character counter. It is enabled by default when `maxLength` or `maxCharacter` is set.。Typescript: `boolean \| ((ctx: { value: string; count: number; maxLength?: number; maxCharacter?: number }) => TNode)`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N        |
+| disabled          | Boolean            | false     | \-                                                                                                                                                                                                                                                                                                                            | N        |
+| maxcharacter      | Number             | -         | \-                                                                                                                                                                                                                                                                                                                            | N        |
+| maxlength         | Number             | -         | Typescript: `number`                                                                                                                                                                                                                                                                                                          | N        |
+| name              | String             | -         | \-                                                                                                                                                                                                                                                                                                                            | N        |
+| placeholder       | String             | undefined | \-                                                                                                                                                                                                                                                                                                                            | N        |
+| readOnly          | Boolean            | false     | \-                                                                                                                                                                                                                                                                                                                            | N        |
+| status            | String             | default   | options：default/success/warning/error                                                                                                                                                                                                                                                                                        | N        |
+| tips              | TNode              | -         | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts)                                                                                                                                                                                  | N        |
+| value             | String             | -         | Typescript: `TextareaValue` `type TextareaValue = string`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts)                                                                                                                                               | N        |
+| defaultValue      | String             | -         | uncontrolled property。Typescript: `TextareaValue` `type TextareaValue = string`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts)                                                                                                                        | N        |
+| onBlur            | Function           |           | Typescript: `(value: TextareaValue, context: { e: FocusEvent }) => void`<br/>                                                                                                                                                                                                                                                 | N        |
+| onChange          | Function           |           | Typescript: `(value: TextareaValue, context?: { e?: InputEvent \| MouseEvent; trigger?: 'input' \| 'clear' }) => void`<br/>`trigger=clear` means it is triggered by clicking the clear button                                                                                                                                 | N        |
+| onClear           | Function           |           | Typescript: `(context: { e: MouseEvent }) => void`<br/>Triggered when the clear button is clicked                                                                                                                                                                                                                             | N        |
+| onFocus           | Function           |           | Typescript: `(value: TextareaValue, context : { e: FocusEvent }) => void`<br/>                                                                                                                                                                                                                                                | N        |
+| onKeydown         | Function           |           | Typescript: `(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>                                                                                                                                                                                                                                              | N        |
+| onKeypress        | Function           |           | Typescript: `(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>                                                                                                                                                                                                                                              | N        |
+| onKeyup           | Function           |           | Typescript: `(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>                                                                                                                                                                                                                                              | N        |
diff --git a/packages/components/textarea/textarea.md b/packages/components/textarea/textarea.md
index 543751ba8c..757009a338 100644
--- a/packages/components/textarea/textarea.md
+++ b/packages/components/textarea/textarea.md
@@ -4,27 +4,29 @@
 
 ### Textarea Props
 
-名称 | 类型 | 默认值 | 描述 | 必传
--- | -- | -- | -- | --
-className | String | - | 类名 | N
-style | Object | - | 样式，TS 类型：`React.CSSProperties` | 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
-count | Boolean / Function | - | 文字计数元素。设置 `maxlength` 或 `maxchanacter` 时，默认为 true。TS 类型：`boolean \| ((ctx: { value: string; count: number; maxLength?: number; maxCharacter?: number }) => TNode)`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-disabled | Boolean | false | 是否禁用文本框 | N
-maxcharacter | Number | - | 用户最多可以输入的字符个数，一个中文汉字表示两个字符长度 | N
-maxlength | Number | - | 用户最多可以输入的字符个数 | N
-name | String | - | 名称，HTML 元素原生属性 | N
-placeholder | String | undefined | 占位符 | N
-readOnly | Boolean | false | 只读状态 | N
-status | String | default | 文本框状态。可选项：default/success/warning/error | N
-tips | TNode | - | 输入框下方提示文本，会根据不同的 `status` 呈现不同的样式。TS 类型：`string \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-value | String | - | 文本框值。TS 类型：`TextareaValue` `type TextareaValue = string`。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts) | N
-defaultValue | String | - | 文本框值。非受控属性。TS 类型：`TextareaValue` `type TextareaValue = string`。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts) | N
-onBlur | Function |  | TS 类型：`(value: TextareaValue, context: { e: FocusEvent }) => void`<br/>失去焦点时触发 | N
-onChange | Function |  | TS 类型：`(value: TextareaValue, context?: { e?: InputEvent }) => void`<br/>输入内容变化时触发 | N
-onFocus | Function |  | TS 类型：`(value: TextareaValue, context : { e: FocusEvent }) => void`<br/>获得焦点时触发 | N
-onKeydown | Function |  | TS 类型：`(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>键盘按下时触发 | N
-onKeypress | Function |  | TS 类型：`(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>按下字符键时触发（keydown -> keypress -> keyup） | N
-onKeyup | Function |  | TS 类型：`(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>释放键盘时触发 | N
+| 名称              | 类型               | 默认值    | 描述                                                                                                                                                                                                                                                                                       | 必传 |
+| ----------------- | ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---- |
+| className         | String             | -         | 类名                                                                                                                                                                                                                                                                                       | N    |
+| style             | Object             | -         | 样式，TS 类型：`React.CSSProperties`                                                                                                                                                                                                                                                       | 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    |
+| clearable         | Boolean            | false     | 是否可清空                                                                                                                                                                                                                                                                                 | N    |
+| count             | Boolean / Function | -         | 文字计数元素。设置 `maxlength` 或 `maxchanacter` 时，默认为 true。TS 类型：`boolean \| ((ctx: { value: string; count: number; maxLength?: number; maxCharacter?: number }) => TNode)`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N    |
+| disabled          | Boolean            | false     | 是否禁用文本框                                                                                                                                                                                                                                                                             | N    |
+| maxcharacter      | Number             | -         | 用户最多可以输入的字符个数，一个中文汉字表示两个字符长度                                                                                                                                                                                                                                   | N    |
+| maxlength         | Number             | -         | 用户最多可以输入的字符个数                                                                                                                                                                                                                                                                 | N    |
+| name              | String             | -         | 名称，HTML 元素原生属性                                                                                                                                                                                                                                                                    | N    |
+| placeholder       | String             | undefined | 占位符                                                                                                                                                                                                                                                                                     | N    |
+| readOnly          | Boolean            | false     | 只读状态                                                                                                                                                                                                                                                                                   | N    |
+| status            | String             | default   | 文本框状态。可选项：default/success/warning/error                                                                                                                                                                                                                                          | N    |
+| tips              | TNode              | -         | 输入框下方提示文本，会根据不同的 `status` 呈现不同的样式。TS 类型：`string \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts)                                                                                                  | N    |
+| value             | String             | -         | 文本框值。TS 类型：`TextareaValue` `type TextareaValue = string`。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts)                                                                                                               | N    |
+| defaultValue      | String             | -         | 文本框值。非受控属性。TS 类型：`TextareaValue` `type TextareaValue = string`。[详细类型定义](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/textarea/type.ts)                                                                                                   | N    |
+| onBlur            | Function           |           | TS 类型：`(value: TextareaValue, context: { e: FocusEvent }) => void`<br/>失去焦点时触发                                                                                                                                                                                                   | N    |
+| onChange          | Function           |           | TS 类型：`(value: TextareaValue, context?: { e?: InputEvent \| MouseEvent; trigger?: 'input' \| 'clear' }) => void`<br/>输入内容变化时触发。`trigger=clear` 表示点击清空按钮触发                                                                                                           | N    |
+| onClear           | Function           |           | TS 类型：`(context: { e: MouseEvent }) => void`<br/>清空按钮点击时触发                                                                                                                                                                                                                     | N    |
+| onFocus           | Function           |           | TS 类型：`(value: TextareaValue, context : { e: FocusEvent }) => void`<br/>获得焦点时触发                                                                                                                                                                                                  | N    |
+| onKeydown         | Function           |           | TS 类型：`(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>键盘按下时触发                                                                                                                                                                                                | N    |
+| onKeypress        | Function           |           | TS 类型：`(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>按下字符键时触发（keydown -> keypress -> keyup）                                                                                                                                                              | N    |
+| onKeyup           | Function           |           | TS 类型：`(value: TextareaValue, context: { e: KeyboardEvent }) => void`<br/>释放键盘时触发                                                                                                                                                                                                | N    |
diff --git a/packages/components/textarea/type.ts b/packages/components/textarea/type.ts
index 2895808159..9fff849fec 100644
--- a/packages/components/textarea/type.ts
+++ b/packages/components/textarea/type.ts
@@ -4,8 +4,8 @@
  * 该文件为脚本自动生成文件，请勿随意修改。如需修改请联系 PMC
  * */
 
-import { TNode } from '../common';
-import { KeyboardEvent, FocusEvent, FormEvent } from 'react';
+import { TNode } from "../common";
+import { KeyboardEvent, FocusEvent, FormEvent, MouseEvent } from "react";
 
 export interface TdTextareaProps {
   /**
@@ -26,7 +26,19 @@ export interface TdTextareaProps {
   /**
    * 文字计数元素。设置 `maxlength` 或 `maxchanacter` 时，默认为 true
    */
-  count?: boolean | ((ctx: { value: string; count: number; maxLength?: number; maxCharacter?: number }) => TNode);
+  count?:
+    | boolean
+    | ((ctx: {
+        value: string;
+        count: number;
+        maxLength?: number;
+        maxCharacter?: number;
+      }) => TNode);
+  /**
+   * 是否可清空
+   * @default false
+   */
+  clearable?: boolean;
   /**
    * 是否禁用文本框
    * @default false
@@ -64,7 +76,7 @@ export interface TdTextareaProps {
    * 文本框状态
    * @default default
    */
-  status?: 'default' | 'success' | 'warning' | 'error';
+  status?: "default" | "success" | "warning" | "error";
   /**
    * 输入框下方提示文本，会根据不同的 `status` 呈现不同的样式
    */
@@ -80,27 +92,52 @@ export interface TdTextareaProps {
   /**
    * 失去焦点时触发
    */
-  onBlur?: (value: TextareaValue, context: { e: FocusEvent<HTMLTextAreaElement> }) => void;
+  onBlur?: (
+    value: TextareaValue,
+    context: { e: FocusEvent<HTMLTextAreaElement> },
+  ) => void;
   /**
    * 输入内容变化时触发
    */
-  onChange?: (value: TextareaValue, context?: { e?: FormEvent<HTMLTextAreaElement> }) => void;
+  onChange?: (
+    value: TextareaValue,
+    context?: {
+      e?: FormEvent<HTMLTextAreaElement> | MouseEvent<SVGElement>;
+      trigger?: "input" | "clear";
+    },
+  ) => void;
+  /**
+   * 清空按钮点击时触发
+   */
+  onClear?: (context: { e: MouseEvent<SVGElement> }) => void;
   /**
    * 获得焦点时触发
    */
-  onFocus?: (value: TextareaValue, context: { e: FocusEvent<HTMLTextAreaElement> }) => void;
+  onFocus?: (
+    value: TextareaValue,
+    context: { e: FocusEvent<HTMLTextAreaElement> },
+  ) => void;
   /**
    * 键盘按下时触发
    */
-  onKeydown?: (value: TextareaValue, context: { e: KeyboardEvent<HTMLTextAreaElement> }) => void;
+  onKeydown?: (
+    value: TextareaValue,
+    context: { e: KeyboardEvent<HTMLTextAreaElement> },
+  ) => void;
   /**
    * 按下字符键时触发（keydown -> keypress -> keyup）
    */
-  onKeypress?: (value: TextareaValue, context: { e: KeyboardEvent<HTMLTextAreaElement> }) => void;
+  onKeypress?: (
+    value: TextareaValue,
+    context: { e: KeyboardEvent<HTMLTextAreaElement> },
+  ) => void;
   /**
    * 释放键盘时触发
    */
-  onKeyup?: (value: TextareaValue, context: { e: KeyboardEvent<HTMLTextAreaElement> }) => void;
+  onKeyup?: (
+    value: TextareaValue,
+    context: { e: KeyboardEvent<HTMLTextAreaElement> },
+  ) => void;
 }
 
 export type TextareaValue = string;

From 173e73689ce2fa5560ffc8ad873b3f875548dfae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?w=C5=AB=20y=C4=81ng?= <uyarnchen@gmail.com>
Date: Wed, 29 Jul 2026 17:54:41 +0800
Subject: [PATCH 2/2] chore: update common to common pr

---
 packages/common | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/common b/packages/common
index 17b62abaed..ee109a4547 160000
--- a/packages/common
+++ b/packages/common
@@ -1 +1 @@
-Subproject commit 17b62abaedb8f4d2bac8e2aad53bc17bc68d5fd9
+Subproject commit ee109a4547b88f86bd97e4b4b6da0c142cc78c7b