From fbec7d38d0f22dadc8a715f74d2c0fa1e255cd7e Mon Sep 17 00:00:00 2001
From: hanyuxinting <hanyuxinting@sina.cn>
Date: Wed, 21 May 2025 16:57:08 +0800
Subject: [PATCH 1/5] =?UTF-8?q?feat(Textarea):=20=E5=A2=9E=E5=8A=A0=20ref?=
 =?UTF-8?q?=20=E5=B1=9E=E6=80=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/packages/input/doc.en-US.md               |  11 +
 src/packages/input/doc.md                     |  11 +
 src/packages/input/doc.taro.md                |  11 +
 src/packages/input/doc.zh-TW.md               |  11 +
 src/packages/textarea/doc.en-US.md            |  11 +
 src/packages/textarea/doc.md                  |  11 +
 src/packages/textarea/doc.taro.md             |  11 +
 src/packages/textarea/doc.zh-TW.md            |  11 +
 src/packages/textarea/textarea.taro.tsx       |  37 ++-
 src/packages/textarea/textarea.tsx            | 260 ++++++++++--------
 .../doc/docs/react/migrate-from-v2.en-US.md   |   1 +
 .../doc/docs/react/migrate-from-v2.md         |   1 +
 .../doc/docs/taro/migrate-from-v2.en-US.md    |   1 +
 .../doc/docs/taro/migrate-from-v2.md          |   1 +
 14 files changed, 258 insertions(+), 131 deletions(-)

diff --git a/src/packages/input/doc.en-US.md b/src/packages/input/doc.en-US.md
index 3184cb85b5..b619d0b76d 100644
--- a/src/packages/input/doc.en-US.md
+++ b/src/packages/input/doc.en-US.md
@@ -148,6 +148,17 @@ import { Input } from '@nutui/nutui-react'
 | onClear | Triggered when the clear button is clicked | `(value: string) => void` | `-` |
 | onClick | Triggered when the input container is clicked | `(value: MouseEvent<HTMLDivElement>) => void` | `-` |
 
+### Ref
+
+You can get Ref of Input.
+
+| Event | Description | Arguments |
+| --- | --- | --- |
+| clear | clear the value of input | `-` |
+| focus | focus the input | `-` |
+| blur | blur the input | `-` |
+| get | get the input ref | `-` |
+
 ## Theming
 
 ### CSS Variables
diff --git a/src/packages/input/doc.md b/src/packages/input/doc.md
index 4afade339a..4648149b74 100644
--- a/src/packages/input/doc.md
+++ b/src/packages/input/doc.md
@@ -151,6 +151,17 @@ import { Input } from '@nutui/nutui-react'
 
 此外还支持以下原生属性：`onCompositionStart` `onCompositionEnd`
 
+### Ref
+
+通过 ref 可以获取到 Input 实例并调用实例方法。
+
+| 方法名 | 说明 | 参数 |
+| --- | --- | --- |
+| clear | 清除容器中的数据 | `-` |
+| focus | 使容器获取焦点 | `-` |
+| blur | 使容器失去焦点 | `-` |
+| get | 获取当前容器 | `-` |
+
 ## 主题定制
 
 ### 样式变量
diff --git a/src/packages/input/doc.taro.md b/src/packages/input/doc.taro.md
index dd30bafc90..4896dbd987 100644
--- a/src/packages/input/doc.taro.md
+++ b/src/packages/input/doc.taro.md
@@ -151,6 +151,17 @@ import { Input } from '@nutui/nutui-react-taro'
 
 此外还支持 Taro 中的 [Input 属性](https://docs.taro.zone/docs/components/forms/input/)
 
+### Ref
+
+通过 ref 可以获取到 Input 实例并调用实例方法。
+
+| 方法名 | 说明 | 参数 |
+| --- | --- | --- |
+| clear | 清除容器中的数据 | `-` |
+| focus | 使容器获取焦点 | `-` |
+| blur | 使容器失去焦点 | `-` |
+| get | 获取当前容器 | `-` |
+
 ## 主题定制
 
 ### 样式变量
diff --git a/src/packages/input/doc.zh-TW.md b/src/packages/input/doc.zh-TW.md
index f430a7406f..16e85a7dca 100644
--- a/src/packages/input/doc.zh-TW.md
+++ b/src/packages/input/doc.zh-TW.md
@@ -148,6 +148,17 @@ import { Input } from '@nutui/nutui-react'
 | onClear | 点击清空按钮时触发 | `(value: string) => void` | `-` |
 | onClick | 点击 input 容器触发 | `(value: MouseEvent<HTMLDivElement>) => void` | `-` |
 
+### Ref
+
+通過 ref 可以獲取到 Input 實例並調用實例方法。
+
+| 方法名 | 說明 | 參數 |
+| --- | --- | --- |
+| clear | 清除容器中的數據 | `-` |
+| focus | 使容器獲取焦點 | `-` |
+| blur | 使容器失去焦點 | `-` |
+| get | 獲取當前容器 | `-` |
+
 ## 主题定制
 
 ### 样式变量
diff --git a/src/packages/textarea/doc.en-US.md b/src/packages/textarea/doc.en-US.md
index 135a6061a4..aa8c8a7c4a 100644
--- a/src/packages/textarea/doc.en-US.md
+++ b/src/packages/textarea/doc.en-US.md
@@ -95,6 +95,17 @@ import { TextArea } from '@nutui/nutui-react'
 | onFocus | Triggered when focusing | `(event: FocusEvent<HTMLTextAreaElement>) => void` | `-` |
 | onBlur | Triggered when out of focus | `(event: FocusEvent<HTMLTextAreaElement>) => void` | `-` |
 
+### Ref
+
+You can get Ref of Textarea.
+
+| Event | Description | Arguments |
+| --- | --- | --- |
+| clear | clear the value of textarea | `-` |
+| focus | focus the textarea | `-` |
+| blur | blur the textarea | `-` |
+| get | get the textarea ref | `-` |
+
 ## Theming
 
 ### CSS Variables
diff --git a/src/packages/textarea/doc.md b/src/packages/textarea/doc.md
index a0d6979f2f..184321a204 100644
--- a/src/packages/textarea/doc.md
+++ b/src/packages/textarea/doc.md
@@ -95,6 +95,17 @@ import { TextArea } from '@nutui/nutui-react'
 | onFocus | 聚焦时触发 | `(event: FocusEvent<HTMLTextAreaElement>) => void` | `-` |
 | onBlur | 失焦时触发 | `(event: FocusEvent<HTMLTextAreaElement>) => void` | `-` |
 
+### Ref
+
+通过 ref 可以获取到 Textarea 实例并调用实例方法。
+
+| 方法名 | 说明 | 参数 |
+| --- | --- | --- |
+| clear | 清除容器中的数据 | `-` |
+| focus | 使容器获取焦点 | `-` |
+| blur | 使容器失去焦点 | `-` |
+| get | 获取当前容器 | `-` |
+
 ## 主题定制
 
 ### 样式变量
diff --git a/src/packages/textarea/doc.taro.md b/src/packages/textarea/doc.taro.md
index e8d62792f2..8a6d7eb37a 100644
--- a/src/packages/textarea/doc.taro.md
+++ b/src/packages/textarea/doc.taro.md
@@ -95,6 +95,17 @@ import { TextArea } from '@nutui/nutui-react-taro'
 | onFocus | 聚焦时触发 | `(event) => void` | `-` |
 | onBlur | 失焦时触发 | `(event) => void` | `-` |
 
+### Ref
+
+通过 ref 可以获取到 Textarea 实例并调用实例方法。
+
+| 方法名 | 说明 | 参数 |
+| --- | --- | --- |
+| clear | 清除容器中的数据 | `-` |
+| focus | 使容器获取焦点 | `-` |
+| blur | 使容器失去焦点 | `-` |
+| get | 获取当前容器 | `-` |
+
 ## 主题定制
 
 ### 样式变量
diff --git a/src/packages/textarea/doc.zh-TW.md b/src/packages/textarea/doc.zh-TW.md
index b3c633436d..c3d9e2d727 100644
--- a/src/packages/textarea/doc.zh-TW.md
+++ b/src/packages/textarea/doc.zh-TW.md
@@ -94,6 +94,17 @@ import { TextArea } from '@nutui/nutui-react'
 | onFocus | 聚焦時觸發 | `(event) => void` | `-` |
 | onBlur | 失焦時觸發 | `(event) => void` | `-` |
 
+### Ref
+
+通過 ref 可以獲取到 Textarea 實例並調用實例方法。
+
+| 方法名 | 說明 | 參數 |
+| --- | --- | --- |
+| clear | 清除容器中的數據 | `-` |
+| focus | 使容器獲取焦點 | `-` |
+| blur | 使容器失去焦點 | `-` |
+| get | 獲取當前容器 | `-` |
+
 ## 主題定制
 
 ### 樣式變量
diff --git a/src/packages/textarea/textarea.taro.tsx b/src/packages/textarea/textarea.taro.tsx
index 9ad57c399b..7a89cfeac7 100644
--- a/src/packages/textarea/textarea.taro.tsx
+++ b/src/packages/textarea/textarea.taro.tsx
@@ -1,4 +1,4 @@
-import React, { FunctionComponent, useRef } from 'react'
+import React, { forwardRef, useRef, useImperativeHandle } from 'react'
 import classNames from 'classnames'
 import Taro from '@tarojs/taro'
 import { BaseEventOrig, Textarea, View } from '@tarojs/components'
@@ -19,9 +19,7 @@ const defaultProps = {
   plain: false,
   status: 'default',
 } as TaroTextAreaProps
-export const TextArea: FunctionComponent<Partial<TaroTextAreaProps>> = (
-  props
-) => {
+export const TextArea = forwardRef((props: Partial<TaroTextAreaProps>, ref) => {
   const { locale } = useConfig()
   const {
     className,
@@ -54,20 +52,21 @@ export const TextArea: FunctionComponent<Partial<TaroTextAreaProps>> = (
     return value
   }
 
-  const [inputValue, setInputValue] = usePropsValue<string>({
+  const [innerValue, setInnerValue] = usePropsValue<string>({
     value,
     defaultValue,
     finalValue: format(defaultValue),
     onChange,
   })
+  const textareaRef = useRef<HTMLTextAreaElement>(null)
 
   const handleChange = (event: BaseEventOrig) => {
     const text = event?.detail?.value
     if (text) {
       const value = compositionRef.current ? text : format(text)
-      setInputValue(value)
+      setInnerValue(value)
     } else {
-      setInputValue('')
+      setInnerValue('')
     }
   }
 
@@ -83,6 +82,23 @@ export const TextArea: FunctionComponent<Partial<TaroTextAreaProps>> = (
     onBlur?.(event)
   }
 
+  useImperativeHandle(ref, () => {
+    return {
+      clear: () => {
+        setInnerValue('')
+      },
+      focus: () => {
+        textareaRef.current?.focus()
+      },
+      blur: () => {
+        textareaRef.current?.blur()
+      },
+      get nativeElement() {
+        return textareaRef.current
+      },
+    }
+  })
+
   return (
     <>
       <View
@@ -101,6 +117,7 @@ export const TextArea: FunctionComponent<Partial<TaroTextAreaProps>> = (
       >
         <Textarea
           {...rest}
+          ref={textareaRef}
           nativeProps={{
             style,
             readOnly,
@@ -118,7 +135,7 @@ export const TextArea: FunctionComponent<Partial<TaroTextAreaProps>> = (
           style={Taro.getEnv() === 'WEB' ? undefined : style}
           disabled={Taro.getEnv() === 'WEB' ? disabled : disabled || readOnly}
           // @ts-ignore
-          value={inputValue}
+          value={innerValue}
           onInput={handleChange}
           onBlur={handleBlur}
           onFocus={handleFocus}
@@ -134,12 +151,12 @@ export const TextArea: FunctionComponent<Partial<TaroTextAreaProps>> = (
               [`${classPrefix}-limit-disabled`]: disabled,
             })}
           >
-            {inputValue.length}/{maxLength < 0 ? 0 : maxLength}
+            {innerValue.length}/{maxLength < 0 ? 0 : maxLength}
           </View>
         )}
       </View>
     </>
   )
-}
+})
 
 TextArea.displayName = 'NutTextArea'
diff --git a/src/packages/textarea/textarea.tsx b/src/packages/textarea/textarea.tsx
index 94906a42c2..8576ea4918 100644
--- a/src/packages/textarea/textarea.tsx
+++ b/src/packages/textarea/textarea.tsx
@@ -1,5 +1,10 @@
 import type { ChangeEvent, FocusEvent } from 'react'
-import React, { FunctionComponent, useEffect, useRef } from 'react'
+import React, {
+  useEffect,
+  useRef,
+  forwardRef,
+  useImperativeHandle,
+} from 'react'
 import classNames from 'classnames'
 import { useConfig, useRtl } from '@/packages/configprovider'
 import { ComponentDefaults } from '@/utils/typings'
@@ -19,139 +24,152 @@ const defaultProps = {
   plain: false,
   status: 'default',
 } as WebTextAreaProps
-export const TextArea: FunctionComponent<
-  Partial<WebTextAreaProps> &
-    Omit<
-      React.HTMLAttributes<HTMLTextAreaElement>,
-      'onChange' | 'onBlur' | 'onFocus'
-    >
-> = (props) => {
-  const { locale } = useConfig()
-  const {
-    className,
-    value,
-    defaultValue,
-    showCount,
-    maxLength,
-    rows,
-    placeholder,
-    readOnly,
-    disabled,
-    autoSize,
-    style,
-    plain,
-    status,
-    onChange,
-    onBlur,
-    onFocus,
-    ...rest
-  } = { ...defaultProps, ...props }
 
-  const classPrefix = 'nut-textarea'
-  const textareaRef = useRef<any>(null)
-  const compositionRef = useRef(false)
-  const rtl = useRtl()
+export const TextArea = forwardRef(
+  (
+    props: Partial<WebTextAreaProps> &
+      Omit<
+        React.HTMLAttributes<HTMLTextAreaElement>,
+        'onChange' | 'onBlur' | 'onFocus'
+      >,
+    ref
+  ) => {
+    const { locale } = useConfig()
+    const {
+      className,
+      value,
+      defaultValue,
+      showCount,
+      maxLength,
+      rows,
+      placeholder,
+      readOnly,
+      disabled,
+      autoSize,
+      style,
+      plain,
+      status,
+      onChange,
+      onBlur,
+      onFocus,
+      ...rest
+    } = { ...defaultProps, ...props }
 
-  const format = (value: string) => {
-    if (maxLength !== -1 && value.length > maxLength) {
-      return value.substring(0, maxLength)
+    const classPrefix = 'nut-textarea'
+    const textareaRef = useRef<any>(null)
+    const compositionRef = useRef(false)
+    const rtl = useRtl()
+
+    const format = (value: string) => {
+      if (maxLength !== -1 && value.length > maxLength) {
+        return value.substring(0, maxLength)
+      }
+      return value
     }
-    return value
-  }
 
-  const [inputValue, setInputValue] = usePropsValue<string>({
-    value,
-    defaultValue,
-    finalValue: format(defaultValue),
-    onChange,
-  })
+    const [innerValue, setInnerValue] = usePropsValue<string>({
+      value,
+      defaultValue,
+      finalValue: format(defaultValue),
+      onChange,
+    })
 
-  useEffect(() => {
-    if (autoSize) setContentHeight()
-  }, [autoSize, defaultValue, inputValue])
+    useEffect(() => {
+      if (autoSize) setContentHeight()
+    }, [autoSize, defaultValue, innerValue])
 
-  const setContentHeight = () => {
-    const textarea: any = textareaRef.current
-    if (textarea) {
-      textarea.style.height = 'auto'
-      const height = textarea?.scrollHeight
-      if (height) {
-        textarea.style.height = `${height}px`
+    const setContentHeight = () => {
+      const textarea: any = textareaRef.current
+      if (textarea) {
+        textarea.style.height = 'auto'
+        const height = textarea?.scrollHeight
+        if (height) {
+          textarea.style.height = `${height}px`
+        }
       }
     }
-  }
 
-  const handleChange = (event: ChangeEvent<HTMLTextAreaElement>) => {
-    const text = event.target
-    const value = compositionRef.current ? text.value : format(text.value)
-    setInputValue(value)
-  }
+    const handleChange = (event: ChangeEvent<HTMLTextAreaElement>) => {
+      const text = event.target
+      const value = compositionRef.current ? text.value : format(text.value)
+      setInnerValue(value)
+    }
 
-  const isDisabled = () => disabled || readOnly
+    const isDisabled = () => disabled || readOnly
 
-  const handleFocus = (event: FocusEvent<HTMLTextAreaElement>) => {
-    if (isDisabled()) return
-    onFocus?.(event)
-  }
+    const handleFocus = (event: FocusEvent<HTMLTextAreaElement>) => {
+      if (isDisabled()) return
+      onFocus?.(event)
+    }
 
-  const handleBlur = (event: FocusEvent<HTMLTextAreaElement>) => {
-    if (isDisabled()) return
-    onBlur?.(event)
-  }
+    const handleBlur = (event: FocusEvent<HTMLTextAreaElement>) => {
+      if (isDisabled()) return
+      onBlur?.(event)
+    }
+
+    useImperativeHandle(ref, () => ({
+      clear: () => setInnerValue(''),
+      focus: () => textareaRef.current?.focus(),
+      blur: () => textareaRef.current?.blur(),
+      get nativeElement() {
+        return textareaRef.current
+      },
+    }))
 
-  return (
-    <>
-      <div
-        className={classNames(
-          classPrefix,
-          {
-            [`${classPrefix}-disabled`]: disabled,
-            [`${classPrefix}-readonly`]: readOnly,
-            [`${classPrefix}-rtl`]: rtl,
-            [`${classPrefix}-plain`]: plain,
-            [`${classPrefix}-container`]: !plain,
-            [`${classPrefix}-${status}`]: status,
-          },
-          className
-        )}
-      >
-        <textarea
-          {...rest}
-          ref={textareaRef}
-          className={classNames(`${classPrefix}-textarea`, {
-            [`${classPrefix}-textarea-disabled`]: disabled,
-          })}
-          style={style}
-          disabled={disabled}
-          readOnly={readOnly}
-          value={inputValue}
-          onChange={handleChange}
-          onBlur={handleBlur}
-          onFocus={handleFocus}
-          onCompositionEnd={() => {
-            compositionRef.current = false
-          }}
-          onCompositionStart={() => {
-            compositionRef.current = true
-          }}
-          rows={rows}
-          maxLength={maxLength === -1 ? undefined : maxLength}
-          placeholder={
-            placeholder !== undefined ? placeholder : locale.placeholder
-          }
-        />
-        {showCount && (
-          <div
-            className={classNames(`${classPrefix}-limit`, {
-              [`${classPrefix}-limit-disabled`]: disabled,
+    return (
+      <>
+        <div
+          className={classNames(
+            classPrefix,
+            {
+              [`${classPrefix}-disabled`]: disabled,
+              [`${classPrefix}-readonly`]: readOnly,
+              [`${classPrefix}-rtl`]: rtl,
+              [`${classPrefix}-plain`]: plain,
+              [`${classPrefix}-container`]: !plain,
+              [`${classPrefix}-${status}`]: status,
+            },
+            className
+          )}
+        >
+          <textarea
+            {...rest}
+            ref={textareaRef}
+            className={classNames(`${classPrefix}-textarea`, {
+              [`${classPrefix}-textarea-disabled`]: disabled,
             })}
-          >
-            {inputValue.length}/{maxLength < 0 ? 0 : maxLength}
-          </div>
-        )}
-      </div>
-    </>
-  )
-}
+            style={style}
+            disabled={disabled}
+            readOnly={readOnly}
+            value={innerValue}
+            onChange={handleChange}
+            onBlur={handleBlur}
+            onFocus={handleFocus}
+            onCompositionEnd={() => {
+              compositionRef.current = false
+            }}
+            onCompositionStart={() => {
+              compositionRef.current = true
+            }}
+            rows={rows}
+            maxLength={maxLength === -1 ? undefined : maxLength}
+            placeholder={
+              placeholder !== undefined ? placeholder : locale.placeholder
+            }
+          />
+          {showCount && (
+            <div
+              className={classNames(`${classPrefix}-limit`, {
+                [`${classPrefix}-limit-disabled`]: disabled,
+              })}
+            >
+              {innerValue.length}/{maxLength < 0 ? 0 : maxLength}
+            </div>
+          )}
+        </div>
+      </>
+    )
+  }
+)
 
 TextArea.displayName = 'NutTextArea'
diff --git a/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md b/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md
index 99ea575d07..d01a68e1b4 100644
--- a/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md
+++ b/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md
@@ -180,6 +180,7 @@ If your project uses these components, please read the documentation carefully a
 
 - Added a plain attribute to mark it as a plain text type. The default value is false, indicating it is a container type.
 - Added a status attribute, with possible values of default | error, to define the state of the input box.
+- Add `ref`，and apis `clear` `focus` `blur` `get`.
 - Removed some basic style variables and recommended using foundational style variables, such as $textarea-font, $textarea-limit-color, and $textarea-disabled-color.
 
 #### Uploader
diff --git a/src/sites/sites-react/doc/docs/react/migrate-from-v2.md b/src/sites/sites-react/doc/docs/react/migrate-from-v2.md
index 5f0ec51588..d9c39ff157 100644
--- a/src/sites/sites-react/doc/docs/react/migrate-from-v2.md
+++ b/src/sites/sites-react/doc/docs/react/migrate-from-v2.md
@@ -197,6 +197,7 @@ plugins: [
 
 - 新增 `plain` 属性，标记为 纯文本型；该值默认为false，标记为 container 容器型
 - 新增 `status` 属性，值为 `default` | `error`，可定义输入框的状态
+- 新增 `ref` 属性，支持 `clear` `focus` `blur` `get` 等方法
 - 删掉一些可使用基础样式变量，并且建议使用基础样式变量的样式变量，比如 `$textarea-font` `$textarea-limit-color` `$textarea-disabled-color`
 
 #### Uploader
diff --git a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md
index 6eb5d63e42..4fa475731c 100644
--- a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md
+++ b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md
@@ -180,6 +180,7 @@ If your project uses these components, please read the documentation carefully a
 
 - Added a plain attribute to mark it as a plain text type. The default value is false, indicating it is a container type.
 - Added a status attribute, with possible values of default | error, to define the state of the input box.
+- Add `ref`，and apis `clear` `focus` `blur` `get`.
 - Removed some basic style variables and recommended using foundational style variables, such as $textarea-font, $textarea-limit-color, and $textarea-disabled-color.
 
 #### Uploader
diff --git a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md
index 3c940b839d..7468c5a2bb 100644
--- a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md
+++ b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md
@@ -196,6 +196,7 @@ plugins: [
 
 - 新增 `plain` 属性，标记为 纯文本型；该值默认为false，标记为 container 容器型
 - 新增 `status` 属性，值为 `default` | `error`，可定义输入框的状态
+- 新增 `ref` 属性，支持 `clear` `focus` `blur` `get` 等方法
 - 删掉一些可使用基础样式变量，并且建议使用基础样式变量的样式变量，比如 `$textarea-font` `$textarea-limit-color` `$textarea-disabled-color`
 
 #### Uploader

From 2729fb8ff2110b8195125ade2c2fe5029700d369 Mon Sep 17 00:00:00 2001
From: hanyuxinting <hanyuxinting@sina.cn>
Date: Wed, 21 May 2025 17:45:23 +0800
Subject: [PATCH 2/5] feat: add get functions

---
 src/packages/input/input.taro.tsx       | 1 +
 src/packages/input/input.tsx            | 1 +
 src/packages/textarea/textarea.taro.tsx | 9 +++------
 src/packages/textarea/textarea.tsx      | 1 +
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/packages/input/input.taro.tsx b/src/packages/input/input.taro.tsx
index 32e8a4e518..e0adb98625 100644
--- a/src/packages/input/input.taro.tsx
+++ b/src/packages/input/input.taro.tsx
@@ -88,6 +88,7 @@ export const Input = forwardRef((props: Partial<TaroInputProps>, ref) => {
       blur: () => {
         inputRef.current?.blur()
       },
+      get: () => inputRef.current,
       get nativeElement() {
         return inputRef.current
       },
diff --git a/src/packages/input/input.tsx b/src/packages/input/input.tsx
index b81deac1e8..9d4d12b8a5 100644
--- a/src/packages/input/input.tsx
+++ b/src/packages/input/input.tsx
@@ -85,6 +85,7 @@ export const Input = forwardRef(
       clear: () => setValue(''),
       focus: () => inputRef.current?.focus(),
       blur: () => inputRef.current?.blur(),
+      get: () => inputRef.current,
       get nativeElement() {
         return inputRef.current
       },
diff --git a/src/packages/textarea/textarea.taro.tsx b/src/packages/textarea/textarea.taro.tsx
index 7a89cfeac7..8fcef8e960 100644
--- a/src/packages/textarea/textarea.taro.tsx
+++ b/src/packages/textarea/textarea.taro.tsx
@@ -87,12 +87,9 @@ export const TextArea = forwardRef((props: Partial<TaroTextAreaProps>, ref) => {
       clear: () => {
         setInnerValue('')
       },
-      focus: () => {
-        textareaRef.current?.focus()
-      },
-      blur: () => {
-        textareaRef.current?.blur()
-      },
+      focus: () => textareaRef.current?.focus(),
+      blur: () => textareaRef.current?.blur(),
+      get: () => textareaRef.current,
       get nativeElement() {
         return textareaRef.current
       },
diff --git a/src/packages/textarea/textarea.tsx b/src/packages/textarea/textarea.tsx
index 8576ea4918..a5db534b27 100644
--- a/src/packages/textarea/textarea.tsx
+++ b/src/packages/textarea/textarea.tsx
@@ -111,6 +111,7 @@ export const TextArea = forwardRef(
       clear: () => setInnerValue(''),
       focus: () => textareaRef.current?.focus(),
       blur: () => textareaRef.current?.blur(),
+      get: () => textareaRef.current,
       get nativeElement() {
         return textareaRef.current
       },

From 3eb28202be9da89785737504e0b89364a13ea7be Mon Sep 17 00:00:00 2001
From: hanyuxinting <hanyuxinting@sina.cn>
Date: Fri, 23 May 2025 16:38:53 +0800
Subject: [PATCH 3/5] =?UTF-8?q?fix:=20=E6=9A=B4=E9=9C=B2=20nativeElement?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/packages/textarea/doc.en-US.md                            | 2 +-
 src/packages/textarea/doc.md                                  | 2 +-
 src/packages/textarea/doc.taro.md                             | 2 +-
 src/packages/textarea/doc.zh-TW.md                            | 2 +-
 src/packages/textarea/textarea.taro.tsx                       | 1 -
 src/packages/textarea/textarea.tsx                            | 1 -
 src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md | 2 +-
 src/sites/sites-react/doc/docs/react/migrate-from-v2.md       | 2 +-
 src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md  | 2 +-
 src/sites/sites-react/doc/docs/taro/migrate-from-v2.md        | 2 +-
 10 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/src/packages/textarea/doc.en-US.md b/src/packages/textarea/doc.en-US.md
index aa8c8a7c4a..8745464c3e 100644
--- a/src/packages/textarea/doc.en-US.md
+++ b/src/packages/textarea/doc.en-US.md
@@ -104,7 +104,7 @@ You can get Ref of Textarea.
 | clear | clear the value of textarea | `-` |
 | focus | focus the textarea | `-` |
 | blur | blur the textarea | `-` |
-| get | get the textarea ref | `-` |
+| nativeElement | get the textarea ref | `-` |
 
 ## Theming
 
diff --git a/src/packages/textarea/doc.md b/src/packages/textarea/doc.md
index 184321a204..c347195c0c 100644
--- a/src/packages/textarea/doc.md
+++ b/src/packages/textarea/doc.md
@@ -104,7 +104,7 @@ import { TextArea } from '@nutui/nutui-react'
 | clear | 清除容器中的数据 | `-` |
 | focus | 使容器获取焦点 | `-` |
 | blur | 使容器失去焦点 | `-` |
-| get | 获取当前容器 | `-` |
+| nativeElement | 获取当前容器 | `-` |
 
 ## 主题定制
 
diff --git a/src/packages/textarea/doc.taro.md b/src/packages/textarea/doc.taro.md
index 8a6d7eb37a..ebb3a32d5b 100644
--- a/src/packages/textarea/doc.taro.md
+++ b/src/packages/textarea/doc.taro.md
@@ -104,7 +104,7 @@ import { TextArea } from '@nutui/nutui-react-taro'
 | clear | 清除容器中的数据 | `-` |
 | focus | 使容器获取焦点 | `-` |
 | blur | 使容器失去焦点 | `-` |
-| get | 获取当前容器 | `-` |
+| nativeElement | 获取当前容器 | `-` |
 
 ## 主题定制
 
diff --git a/src/packages/textarea/doc.zh-TW.md b/src/packages/textarea/doc.zh-TW.md
index c3d9e2d727..daba8b0bce 100644
--- a/src/packages/textarea/doc.zh-TW.md
+++ b/src/packages/textarea/doc.zh-TW.md
@@ -103,7 +103,7 @@ import { TextArea } from '@nutui/nutui-react'
 | clear | 清除容器中的數據 | `-` |
 | focus | 使容器獲取焦點 | `-` |
 | blur | 使容器失去焦點 | `-` |
-| get | 獲取當前容器 | `-` |
+| nativeElement | 獲取當前容器 | `-` |
 
 ## 主題定制
 
diff --git a/src/packages/textarea/textarea.taro.tsx b/src/packages/textarea/textarea.taro.tsx
index 8fcef8e960..477466488a 100644
--- a/src/packages/textarea/textarea.taro.tsx
+++ b/src/packages/textarea/textarea.taro.tsx
@@ -89,7 +89,6 @@ export const TextArea = forwardRef((props: Partial<TaroTextAreaProps>, ref) => {
       },
       focus: () => textareaRef.current?.focus(),
       blur: () => textareaRef.current?.blur(),
-      get: () => textareaRef.current,
       get nativeElement() {
         return textareaRef.current
       },
diff --git a/src/packages/textarea/textarea.tsx b/src/packages/textarea/textarea.tsx
index a5db534b27..8576ea4918 100644
--- a/src/packages/textarea/textarea.tsx
+++ b/src/packages/textarea/textarea.tsx
@@ -111,7 +111,6 @@ export const TextArea = forwardRef(
       clear: () => setInnerValue(''),
       focus: () => textareaRef.current?.focus(),
       blur: () => textareaRef.current?.blur(),
-      get: () => textareaRef.current,
       get nativeElement() {
         return textareaRef.current
       },
diff --git a/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md b/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md
index d01a68e1b4..622e20e372 100644
--- a/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md
+++ b/src/sites/sites-react/doc/docs/react/migrate-from-v2.en-US.md
@@ -180,7 +180,7 @@ If your project uses these components, please read the documentation carefully a
 
 - Added a plain attribute to mark it as a plain text type. The default value is false, indicating it is a container type.
 - Added a status attribute, with possible values of default | error, to define the state of the input box.
-- Add `ref`，and apis `clear` `focus` `blur` `get`.
+- Add `ref`，and apis `clear` `focus` `blur` `nativeElement`.
 - Removed some basic style variables and recommended using foundational style variables, such as $textarea-font, $textarea-limit-color, and $textarea-disabled-color.
 
 #### Uploader
diff --git a/src/sites/sites-react/doc/docs/react/migrate-from-v2.md b/src/sites/sites-react/doc/docs/react/migrate-from-v2.md
index d9c39ff157..43e57aa4d3 100644
--- a/src/sites/sites-react/doc/docs/react/migrate-from-v2.md
+++ b/src/sites/sites-react/doc/docs/react/migrate-from-v2.md
@@ -197,7 +197,7 @@ plugins: [
 
 - 新增 `plain` 属性，标记为 纯文本型；该值默认为false，标记为 container 容器型
 - 新增 `status` 属性，值为 `default` | `error`，可定义输入框的状态
-- 新增 `ref` 属性，支持 `clear` `focus` `blur` `get` 等方法
+- 新增 `ref` 属性，支持 `clear` `focus` `blur` `nativeElement` 等方法
 - 删掉一些可使用基础样式变量，并且建议使用基础样式变量的样式变量，比如 `$textarea-font` `$textarea-limit-color` `$textarea-disabled-color`
 
 #### Uploader
diff --git a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md
index 4fa475731c..5bba0af6a8 100644
--- a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md
+++ b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.en-US.md
@@ -180,7 +180,7 @@ If your project uses these components, please read the documentation carefully a
 
 - Added a plain attribute to mark it as a plain text type. The default value is false, indicating it is a container type.
 - Added a status attribute, with possible values of default | error, to define the state of the input box.
-- Add `ref`，and apis `clear` `focus` `blur` `get`.
+- Add `ref`，and apis `clear` `focus` `blur` `nativeElement`.
 - Removed some basic style variables and recommended using foundational style variables, such as $textarea-font, $textarea-limit-color, and $textarea-disabled-color.
 
 #### Uploader
diff --git a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md
index 7468c5a2bb..70f51c074c 100644
--- a/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md
+++ b/src/sites/sites-react/doc/docs/taro/migrate-from-v2.md
@@ -196,7 +196,7 @@ plugins: [
 
 - 新增 `plain` 属性，标记为 纯文本型；该值默认为false，标记为 container 容器型
 - 新增 `status` 属性，值为 `default` | `error`，可定义输入框的状态
-- 新增 `ref` 属性，支持 `clear` `focus` `blur` `get` 等方法
+- 新增 `ref` 属性，支持 `clear` `focus` `blur` `nativeElement` 等方法
 - 删掉一些可使用基础样式变量，并且建议使用基础样式变量的样式变量，比如 `$textarea-font` `$textarea-limit-color` `$textarea-disabled-color`
 
 #### Uploader

From 9c689ffc406dd3bccd16ced2cc0956f9ff2f8414 Mon Sep 17 00:00:00 2001
From: hanyuxinting <hanyuxinting@sina.cn>
Date: Fri, 23 May 2025 16:50:06 +0800
Subject: [PATCH 4/5] fix: input nativeElement

---
 src/packages/input/doc.en-US.md   | 2 +-
 src/packages/input/doc.md         | 2 +-
 src/packages/input/doc.taro.md    | 2 +-
 src/packages/input/doc.zh-TW.md   | 2 +-
 src/packages/input/input.taro.tsx | 1 -
 src/packages/input/input.tsx      | 1 -
 6 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/packages/input/doc.en-US.md b/src/packages/input/doc.en-US.md
index b619d0b76d..6a01fc913c 100644
--- a/src/packages/input/doc.en-US.md
+++ b/src/packages/input/doc.en-US.md
@@ -157,7 +157,7 @@ You can get Ref of Input.
 | clear | clear the value of input | `-` |
 | focus | focus the input | `-` |
 | blur | blur the input | `-` |
-| get | get the input ref | `-` |
+| nativeElement | get the input ref | `-` |
 
 ## Theming
 
diff --git a/src/packages/input/doc.md b/src/packages/input/doc.md
index 4648149b74..c3b1d735b9 100644
--- a/src/packages/input/doc.md
+++ b/src/packages/input/doc.md
@@ -160,7 +160,7 @@ import { Input } from '@nutui/nutui-react'
 | clear | 清除容器中的数据 | `-` |
 | focus | 使容器获取焦点 | `-` |
 | blur | 使容器失去焦点 | `-` |
-| get | 获取当前容器 | `-` |
+| nativeElement | 获取当前容器 | `-` |
 
 ## 主题定制
 
diff --git a/src/packages/input/doc.taro.md b/src/packages/input/doc.taro.md
index 4896dbd987..b59430823d 100644
--- a/src/packages/input/doc.taro.md
+++ b/src/packages/input/doc.taro.md
@@ -160,7 +160,7 @@ import { Input } from '@nutui/nutui-react-taro'
 | clear | 清除容器中的数据 | `-` |
 | focus | 使容器获取焦点 | `-` |
 | blur | 使容器失去焦点 | `-` |
-| get | 获取当前容器 | `-` |
+| nativeElement | 获取当前容器 | `-` |
 
 ## 主题定制
 
diff --git a/src/packages/input/doc.zh-TW.md b/src/packages/input/doc.zh-TW.md
index 16e85a7dca..c4b69c1d33 100644
--- a/src/packages/input/doc.zh-TW.md
+++ b/src/packages/input/doc.zh-TW.md
@@ -157,7 +157,7 @@ import { Input } from '@nutui/nutui-react'
 | clear | 清除容器中的數據 | `-` |
 | focus | 使容器獲取焦點 | `-` |
 | blur | 使容器失去焦點 | `-` |
-| get | 獲取當前容器 | `-` |
+| nativeElement | 獲取當前容器 | `-` |
 
 ## 主题定制
 
diff --git a/src/packages/input/input.taro.tsx b/src/packages/input/input.taro.tsx
index e0adb98625..32e8a4e518 100644
--- a/src/packages/input/input.taro.tsx
+++ b/src/packages/input/input.taro.tsx
@@ -88,7 +88,6 @@ export const Input = forwardRef((props: Partial<TaroInputProps>, ref) => {
       blur: () => {
         inputRef.current?.blur()
       },
-      get: () => inputRef.current,
       get nativeElement() {
         return inputRef.current
       },
diff --git a/src/packages/input/input.tsx b/src/packages/input/input.tsx
index 9d4d12b8a5..b81deac1e8 100644
--- a/src/packages/input/input.tsx
+++ b/src/packages/input/input.tsx
@@ -85,7 +85,6 @@ export const Input = forwardRef(
       clear: () => setValue(''),
       focus: () => inputRef.current?.focus(),
       blur: () => inputRef.current?.blur(),
-      get: () => inputRef.current,
       get nativeElement() {
         return inputRef.current
       },

From 08f01d3118be121bd3516fdf413a19e0ab90323a Mon Sep 17 00:00:00 2001
From: hanyuxinting <hanyuxinting@sina.cn>
Date: Fri, 30 May 2025 10:05:23 +0800
Subject: [PATCH 5/5] =?UTF-8?q?fix(input):=20=E5=8E=BB=E6=8E=89get?=
 =?UTF-8?q?=E6=96=B9=E6=B3=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/packages/input/doc.en-US.md   |  1 +
 src/packages/input/doc.md         |  1 +
 src/packages/input/doc.taro.md    |  1 +
 src/packages/input/doc.zh-TW.md   | 37 ++++++++++++++++---------------
 src/packages/input/input.taro.tsx |  1 -
 src/packages/input/input.tsx      |  1 -
 6 files changed, 22 insertions(+), 20 deletions(-)

diff --git a/src/packages/input/doc.en-US.md b/src/packages/input/doc.en-US.md
index 6a01fc913c..90d590e3a9 100644
--- a/src/packages/input/doc.en-US.md
+++ b/src/packages/input/doc.en-US.md
@@ -131,6 +131,7 @@ import { Input } from '@nutui/nutui-react'
 | defaultValue | default value | `string` | `-` |
 | value | input value | `string` | `-` |
 | type | input box type, supports all `type` attributes of native `input` tags, and also supports `number` `digit` | `string` | `text` |
+| plain | Input box is plain | `boolean` | `false` |
 | name | Component name, used for form submission to get data | `string` | `-` |
 | placeholder | placeholder when the input box is empty | `string` | `-` |
 | align | Alignment of input box content, optional values `left`, `center`, `right` | `string` | `left` |
diff --git a/src/packages/input/doc.md b/src/packages/input/doc.md
index c3b1d735b9..40bc547ce3 100644
--- a/src/packages/input/doc.md
+++ b/src/packages/input/doc.md
@@ -131,6 +131,7 @@ import { Input } from '@nutui/nutui-react'
 | defaultValue | 初始默认值 | `string` | `-` |
 | value | 初始默认值 | `string` | `-` |
 | type | 输入框类型，支持原生 `input` 标签的所有 `type` 属性，另外还支持 `number` `digit` | `string` | `text` |
+| plain | 输入框是容器型还是文本型，容器型一般都是带外边框的 | `boolean` | `false` |
 | name | 组件名字，用于表单提交获取数据 | `string` | `-` |
 | placeholder | 输入框为空时占位符 | `string` | `-` |
 | align | 输入框内容对齐方式，可选值 `left`、`center`、`right` | `string` | `left` |
diff --git a/src/packages/input/doc.taro.md b/src/packages/input/doc.taro.md
index b59430823d..80da3714e3 100644
--- a/src/packages/input/doc.taro.md
+++ b/src/packages/input/doc.taro.md
@@ -131,6 +131,7 @@ import { Input } from '@nutui/nutui-react-taro'
 | defaultValue | 初始默认值 | `string` | `-` |
 | value | 初始默认值 | `string` | `-` |
 | type | 输入框类型，支持原生 `input` 标签的所有 `type` 属性，另外还支持 `number` `digit` | `string` | `text` |
+| plain | 输入框是容器型还是文本型，容器型一般都是带外边框的 | `boolean` | `false` |
 | name | 组件名字，用于表单提交获取数据 | `string` | `-` |
 | placeholder | 输入框为空时占位符 | `string` | `-` |
 | align | 输入框内容对齐方式，可选值 `left`、`center`、`right` | `string` | `left` |
diff --git a/src/packages/input/doc.zh-TW.md b/src/packages/input/doc.zh-TW.md
index c4b69c1d33..9319429378 100644
--- a/src/packages/input/doc.zh-TW.md
+++ b/src/packages/input/doc.zh-TW.md
@@ -126,27 +126,28 @@ import { Input } from '@nutui/nutui-react'
 
 ### Props
 
-| 属性 | 说明 | 类型 | 默认值 |
+| 屬性 | 說明 | 類型 | 默認值 |
 | --- | --- | --- | --- |
-| defaultValue | 初始默认值 | `string` | `-` |
-| value | 初始默认值 | `string` | `-` |
-| type | 输入框类型，支持原生 `input` 标签的所有 `type` 属性，另外还支持 `number` `digit` | `string` | `text` |
-| name | 组件名字，用于表单提交获取数据 | `string` | `-` |
-| placeholder | 输入框为空时占位符 | `string` | `-` |
-| align | 输入框内容对齐方式，可选值 `left`、`center`、`right` | `string` | `left` |
+| defaultValue | 初始默認值 | `string` | `-` |
+| value | 初始默認值 | `string` | `-` |
+| type | 輸入框類型，支持原生 `input` 標簽的所有 `type` 屬性，另外還支持 `number` `digit` | `string` | `text` |
+| plain | 輸入框是容器型還是文本型，容器型一般都是帶外邊框的 | `boolean` | `false` |
+| name | 組件名字，用於表單提交獲取數據 | `string` | `-` |
+| placeholder | 輸入框為空時占位符 | `string` | `-` |
+| align | 輸入框內容對齊方式，可選值 `left`、`center`、`right` | `string` | `left` |
 | disabled | 是否禁用 | `boolean` | `false` |
-| readOnly | 是否只读 | `boolean` | `false` |
-| autoFocus | 是否自动获得焦点，iOS 系统不支持该属性 | `boolean` | `false` |
-| maxLength | 限制最长输入字符 | `string` \| `number` | `-` |
+| readOnly | 是否只讀 | `boolean` | `false` |
+| autoFocus | 是否自動獲得焦點，iOS 系統不支持該屬性 | `boolean` | `false` |
+| maxLength | 限製最長輸入字符 | `string` \| `number` | `-` |
 | clearable | 展示清除 Icon | `boolean` | `false` |
-| clearIcon | 清除图标 Icon <a href="#/icon">可参考 Icon </a> | `ReactNode` | `MaskClose` |
-| formatter | 输入内容格式化函数 | `(val: string) => string` | `-` |
-| formatTrigger | 格式化函数触发的时机，可选值为 `onChange`、`onBlur` | `string` | `-` |
-| onChange | 输入框内容变化时触发 | `(value: string) => void` | `-` |
-| onBlur | 失去焦点后触发 | `(value: string) => void` | `-` |
-| onFocus | 获得焦点后触发 | `(value: string) => void` | `-` |
-| onClear | 点击清空按钮时触发 | `(value: string) => void` | `-` |
-| onClick | 点击 input 容器触发 | `(value: MouseEvent<HTMLDivElement>) => void` | `-` |
+| clearIcon | 清除圖標 Icon <a href="#/icon">可參考 Icon </a> | `ReactNode` | `MaskClose` |
+| formatter | 輸入內容格式化函數 | `(val: string) => string` | `-` |
+| formatTrigger | 格式化函數觸發的時機，可選值為 `onChange`、`onBlur` | `string` | `-` |
+| onChange | 輸入框內容變化時觸發 | `(value: string) => void` | `-` |
+| onBlur | 失去焦點後觸發 | `(value: string) => void` | `-` |
+| onFocus | 獲得焦點後觸發 | `(value: string) => void` | `-` |
+| onClear | 點擊清空按鈕時觸發 | `(value: string) => void` | `-` |
+| onClick | 點擊 input 容器觸發 | `(value: MouseEvent<HTMLDivElement>) => void` | `-` |
 
 ### Ref
 
diff --git a/src/packages/input/input.taro.tsx b/src/packages/input/input.taro.tsx
index e0adb98625..32e8a4e518 100644
--- a/src/packages/input/input.taro.tsx
+++ b/src/packages/input/input.taro.tsx
@@ -88,7 +88,6 @@ export const Input = forwardRef((props: Partial<TaroInputProps>, ref) => {
       blur: () => {
         inputRef.current?.blur()
       },
-      get: () => inputRef.current,
       get nativeElement() {
         return inputRef.current
       },
diff --git a/src/packages/input/input.tsx b/src/packages/input/input.tsx
index 9d4d12b8a5..b81deac1e8 100644
--- a/src/packages/input/input.tsx
+++ b/src/packages/input/input.tsx
@@ -85,7 +85,6 @@ export const Input = forwardRef(
       clear: () => setValue(''),
       focus: () => inputRef.current?.focus(),
       blur: () => inputRef.current?.blur(),
-      get: () => inputRef.current,
       get nativeElement() {
         return inputRef.current
       },