From ea926472df25fbb6d64431481e6742f0673dc5b3 Mon Sep 17 00:00:00 2001
From: btea <2356281422@qq.com>
Date: Thu, 5 Mar 2026 19:08:29 +0800
Subject: [PATCH] feat(components): [input] textarea supports clearing effects
 (#23723)

* feat(components): [input] textarea supports clearing effects

* Update packages/components/input/__tests__/input.test.tsx

Co-authored-by: rzzf <cszhjh@gmail.com>

* feat: update

* Apply suggestions from code review

Co-authored-by: Noblet Ouways <91417411+Dsaquel@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Noblet Ouways <91417411+Dsaquel@users.noreply.github.com>

* style: update

* Update packages/components/input/src/input.vue

Co-authored-by: rzzf <cszhjh@gmail.com>

---------

Co-authored-by: rzzf <cszhjh@gmail.com>
Co-authored-by: Noblet Ouways <91417411+Dsaquel@users.noreply.github.com>
---
 docs/en-US/component/input.md                 |  2 +-
 docs/examples/input/clear-icon.vue            | 30 +++++++++++---
 docs/examples/input/clearable.vue             | 30 +++++++++++---
 .../components/input/__tests__/input.test.tsx | 39 ++++++++++++++-----
 packages/components/input/src/input.vue       | 14 ++++++-
 packages/theme-chalk/src/input.scss           | 23 +++++++++++
 6 files changed, 115 insertions(+), 23 deletions(-)

diff --git a/docs/en-US/component/input.md b/docs/en-US/component/input.md
index 8ffed0f367..3f5c4121f1 100644
--- a/docs/en-US/component/input.md
+++ b/docs/en-US/component/input.md
@@ -25,7 +25,7 @@ input/disabled
 
 ## Clearable
 
-:::demo Make the Input clearable with the `clearable` attribute.
+:::demo Make the Input clearable with the `clearable` attribute. After version ^(2.13.4), the clearable feature is also available for textarea type of Input.
 
 input/clearable
 
diff --git a/docs/examples/input/clear-icon.vue b/docs/examples/input/clear-icon.vue
index 945e7ee71c..28a3b172ec 100644
--- a/docs/examples/input/clear-icon.vue
+++ b/docs/examples/input/clear-icon.vue
@@ -1,10 +1,19 @@
 <template>
-  <el-input
-    v-model="input"
-    clearable
-    :clear-icon="CloseBold"
-    placeholder="Custom clear icon"
-  />
+  <div class="input-group">
+    <el-input
+      v-model="input"
+      clearable
+      :clear-icon="CloseBold"
+      placeholder="Custom clear icon"
+    />
+    <el-input
+      v-model="textareaInput"
+      clearable
+      :clear-icon="CloseBold"
+      placeholder="Custom clear icon"
+      type="textarea"
+    />
+  </div>
 </template>
 
 <script lang="ts" setup>
@@ -12,4 +21,13 @@ import { ref } from 'vue'
 import { CloseBold } from '@element-plus/icons-vue'
 
 const input = ref('Custom clear icon')
+const textareaInput = ref('Custom clear icon')
 </script>
+
+<style scoped>
+.input-group {
+  display: flex;
+  flex-direction: column;
+  gap: 1em;
+}
+</style>
diff --git a/docs/examples/input/clearable.vue b/docs/examples/input/clearable.vue
index 0a594019b5..d90a1194ed 100644
--- a/docs/examples/input/clearable.vue
+++ b/docs/examples/input/clearable.vue
@@ -1,14 +1,32 @@
 <template>
-  <el-input
-    v-model="input"
-    style="width: 240px"
-    placeholder="Please input"
-    clearable
-  />
+  <div class="input-group">
+    <el-input
+      v-model="input"
+      style="width: 240px"
+      placeholder="Please input"
+      clearable
+    />
+    <el-input
+      v-model="textareaInput"
+      style="width: 240px"
+      placeholder="Please input"
+      type="textarea"
+      clearable
+    />
+  </div>
 </template>
 
 <script lang="ts" setup>
 import { ref } from 'vue'
 
 const input = ref('')
+const textareaInput = ref('')
 </script>
+
+<style scoped>
+.input-group {
+  display: flex;
+  align-items: center;
+  gap: 1em;
+}
+</style>
diff --git a/packages/components/input/__tests__/input.test.tsx b/packages/components/input/__tests__/input.test.tsx
index 27e1370387..fe1605ef29 100644
--- a/packages/components/input/__tests__/input.test.tsx
+++ b/packages/components/input/__tests__/input.test.tsx
@@ -457,28 +457,49 @@ describe('Input.vue', () => {
       const handleClear = vi.fn()
       const handleInput = vi.fn()
       const content = ref('a')
+      const handleTextareaClear = vi.fn()
+      const handleTextareaInput = vi.fn()
+      const textareaContent = ref('a')
 
       const wrapper = mount(() => (
-        <Input
-          placeholder="请输入内容"
-          clearable
-          v-model={content.value}
-          onClear={handleClear}
-          onInput={handleInput}
-        />
+        <>
+          <Input
+            placeholder="请输入内容"
+            clearable
+            v-model={content.value}
+            onClear={handleClear}
+            onInput={handleInput}
+          />
+          <Input
+            type="textarea"
+            placeholder="请输入内容"
+            clearable
+            v-model={textareaContent.value}
+            onClear={handleTextareaClear}
+            onInput={handleTextareaInput}
+          />
+        </>
       ))
 
       const input = wrapper.find('input')
-      const vm = wrapper.vm
+      const textarea = wrapper.find('textarea')
       // focus to show clear button
       await input.trigger('focus')
       await nextTick()
-      vm.$el.querySelector('.el-input__clear').click()
+      wrapper.find('.el-input__clear').trigger('click')
       await nextTick()
       expect(content.value).toEqual('')
       expect(handleClear).toBeCalled()
       expect(handleClear).toBeCalledWith(expect.any(MouseEvent))
       expect(handleInput).toBeCalled()
+      // textarea
+      await textarea.trigger('focus')
+      await nextTick()
+      wrapper.find('.el-textarea__clear').trigger('click')
+      await nextTick()
+      expect(textareaContent.value).toEqual('')
+      expect(handleTextareaClear).toBeCalled()
+      expect(handleTextareaInput).toBeCalled()
     })
 
     test('event:input', async () => {
diff --git a/packages/components/input/src/input.vue b/packages/components/input/src/input.vue
index 198f63cb4c..80d33ca370 100644
--- a/packages/components/input/src/input.vue
+++ b/packages/components/input/src/input.vue
@@ -121,7 +121,11 @@
       <textarea
         :id="inputId"
         ref="textarea"
-        :class="[nsTextarea.e('inner'), nsInput.is('focus', isFocused)]"
+        :class="[
+          nsTextarea.e('inner'),
+          nsInput.is('focus', isFocused),
+          nsTextarea.is('clearable', clearable),
+        ]"
         v-bind="attrs"
         :name="name"
         :minlength="minlength"
@@ -146,6 +150,14 @@
         @change="handleChange"
         @keydown="handleKeydown"
       />
+      <el-icon
+        v-if="showClear"
+        :class="[nsTextarea.e('icon'), nsTextarea.e('clear')]"
+        @mousedown.prevent="NOOP"
+        @click="clear"
+      >
+        <component :is="clearIcon" />
+      </el-icon>
       <span
         v-if="isWordLimitVisible"
         :style="countStyle"
diff --git a/packages/theme-chalk/src/input.scss b/packages/theme-chalk/src/input.scss
index c0bc00dc8c..a4b8df7a45 100644
--- a/packages/theme-chalk/src/input.scss
+++ b/packages/theme-chalk/src/input.scss
@@ -82,6 +82,11 @@
     transition: getCssVar('transition-box-shadow');
     border: none;
 
+    @include when(clearable) {
+      padding: 5px map.get($input-padding-horizontal, 'default') + 14px 5px
+        map.get($input-padding-horizontal, 'default')-$border-width;
+    }
+
     &::placeholder {
       color: getCssVarWithDefault(
         'input-placeholder-color',
@@ -99,6 +104,20 @@
     }
   }
 
+  @include e(clear) {
+    position: absolute;
+    right: 11px;
+    top: 15px;
+    transform: translateY(-50%);
+    color: getCssVar('input-icon-color');
+    font-size: map.get($input-font-size, 'default');
+    cursor: pointer;
+
+    &:hover {
+      color: getCssVar('input-clear-hover-color');
+    }
+  }
+
   & .#{$namespace}-input__count {
     color: getCssVar('color-info');
     background: getCssVar('fill-color', 'blank');
@@ -107,6 +126,7 @@
     line-height: 14px;
     bottom: 5px;
     right: 10px;
+
     @include when(outside) {
       position: absolute;
       background: transparent;
@@ -182,12 +202,14 @@
       display: inline-block;
       padding-left: 8px;
     }
+
     @include when(outside) {
       height: unset;
       position: absolute;
       padding-top: 2px;
       top: 100%;
       right: 0;
+
       .#{$namespace}-input__count-inner {
         background: transparent;
         padding-left: 0px;
@@ -401,6 +423,7 @@
         padding: $border-width
           map.get($input-padding-horizontal, $size)-$border-width;
       }
+
       & {
         @include set-css-var-value(
           'input-inner-height',