diff --git a/packages/opendesign/src/_components/in-textarea/InTextarea.vue b/packages/opendesign/src/_components/in-textarea/InTextarea.vue
index 56f3403ae8bfe8269ee595559f87e83053a87166..cc629e75f47dc600cea7089a414d6465dd5fae22 100644
--- a/packages/opendesign/src/_components/in-textarea/InTextarea.vue
+++ b/packages/opendesign/src/_components/in-textarea/InTextarea.vue
@@ -4,7 +4,7 @@ import { inTextareaProps } from './types';
 import { IconClose } from '../../_utils/icons';
 import { useInput } from '../../_headless/use-input';
 import { useI18n } from '../../locale';
-import { vScrollbar } from '../../scrollbar';
+import { vScrollbar, type BaseScrollerPropsT } from '../../scrollbar';
 
 const props = defineProps(inTextareaProps);
 
@@ -89,8 +89,8 @@ const mirrorValue = computed(() => {
 const scrollbarProps = computed(() => {
   if (props.scrollbar === true) {
     return {
-      showType: 'hover',
-      size: 'small',
+      showType: 'hover' as BaseScrollerPropsT['showType'],
+      size: 'small' as BaseScrollerPropsT['size'],
     };
   }
   return props.scrollbar;
diff --git a/packages/opendesign/src/_components/in-textarea/types.ts b/packages/opendesign/src/_components/in-textarea/types.ts
index c8c439ca6ea7f86015b73b5d781760a9e2097406..69b5bd3e3fdebcd8234fc0ff7624d5b71099d0b2 100644
--- a/packages/opendesign/src/_components/in-textarea/types.ts
+++ b/packages/opendesign/src/_components/in-textarea/types.ts
@@ -6,121 +6,141 @@ export type TextareaResizeT = (typeof TextareaResizeTypes)[number];
 
 export const inTextareaProps = {
   /**
-   * 下拉框的值
-   * v-model
+   * @zh-CN 双向绑定值
+   * @en-US Two-way binding value
    */
   modelValue: {
     type: String,
   },
   /**
-   * 下拉框的默认值
-   * 非受控
+   * @zh-CN 非受控默认值
+   * @en-US Non-controlled default value
    */
   defaultValue: {
     type: String,
   },
   /**
-   * 提示文本
+   * @zh-CN 提示文本
+   * @en-US Prompt text
    */
   placeholder: {
     type: String,
   },
   /**
-   * 是否禁用
+   * @zh-CN 是否禁用
+   * @en-US Whether to disable
    */
   disabled: {
     type: Boolean,
   },
   /**
-   * 是否只读
+   * @zh-CN 是否只读
+   * @en-US Whether to read-only
    */
   readonly: {
     type: Boolean,
   },
   /**
-   * 是否可以清除
+   * @zh-CN 是否可以清除
+   * @en-US Whether to clear
    */
   clearable: {
     type: Boolean,
   },
   /**
-   * 对值格式化，控制显示格式
+   * @zh-CN 格式化函数，控制显示格式
+   * @en-US Format function, control display format
    */
   format: {
     type: Function as PropType<(value: string) => string>,
   },
   /**
-   * 判断值的有效性
+   * @zh-CN 校验函数
+   * @en-US Validation function
    */
   validate: {
     type: Function as PropType<(value: string) => boolean>,
   },
   /**
-   * 输入为无效值时，在blur
+   * @zh-CN 输入非法值时的回调
+   * @en-US Callback when input value is invalid
    */
   valueOnInvalidChange: {
     type: Function as PropType<(inputValue: string, lastValidInputValue: string) => string>,
   },
   /**
-   * 显示的行数
+   * @zh-CN 同 textarea 的 rows 属性
+   * @en-US The rows attribute of textarea
    */
   rows: {
     type: Number,
     default: undefined,
   },
   /**
-   * 显示的列数
+   * @zh-CN 同 textarea 的 cols 属性
+   * @en-US The cols attribute of textarea
    */
   cols: {
     type: Number,
     default: undefined,
   },
   /**
-   * 是否支持调整尺寸 ResizeT
+   * @zh-CN 是否支持调整尺寸
+   * @en-US Whether to support resizing
+   * @default 'vertical'
    */
   resize: {
     type: String as PropType<TextareaResizeT>,
     default: 'vertical',
   },
   /**
-   * 最小字符长度
+   * @zh-CN 字符最小长度
+   * @en-US Minimum length of characters
    */
   minLength: {
     type: Number,
   },
   /**
-   * 最大字符长度
+   * @zh-CN 字符最大长度
+   * @en-US Maximum length of characters
    */
   maxLength: {
     type: Number,
   },
   /**
-   * 获取长度方法
+   * @zh-CN 获取长度方法
+   * @en-US The method of getting length
    */
   getLength: {
     type: Function as PropType<(val: string) => number>,
   },
   /**
-   * 超过最大字符长度时是否允许输入
+   * @zh-CN 超过最大字符长度时是否允许输入
+   * @en-US Whether to allow input when exceeding the maximum character length
+   * @default true
    */
   inputOnOutlimit: {
     type: Boolean,
     default: true,
   },
   /**
-   * 根据内容自动计算高度
+   * @zh-CN 根据内容自动计算高度
+   * @en-US Whether to automatically calculate height based on content
    */
   autoSize: {
     type: Boolean,
   },
   /**
-   * textarea id, 用于label关联
+   * @zh-CN id, 用于关联label
+   * @en-US id, for associating label
    */
   textareaId: {
     type: String,
   },
   /**
-   * 使用内置scrollbar，支持传递scrollbar配置项
+   * @zh-CN scrollbar配置
+   * @en-US scrollbar configuration
+   * @default true
    */
   scrollbar: {
     type: [Boolean, Object] as PropType<boolean | Partial<BaseScrollerPropsT>>,
diff --git a/packages/opendesign/src/_headless/use-input.ts b/packages/opendesign/src/_headless/use-input.ts
index b122e9ca9687c85b7a51c31b0c7842e7b8a84b8f..5c62559875b37c2d09d6ec624af4f5e1b328c606 100644
--- a/packages/opendesign/src/_headless/use-input.ts
+++ b/packages/opendesign/src/_headless/use-input.ts
@@ -98,7 +98,7 @@ export function useInput(options: InputOptionT) {
     return r;
   };
 
-  const inputEl = ref<HTMLInputElement>();
+  const inputEl = ref<HTMLInputElement | HTMLTextAreaElement>();
 
   // 正在输入中文，处理输入过程中触发input事件
   const composition = useComposition({ el: inputEl });
diff --git a/packages/opendesign/src/textarea/OTextarea.vue b/packages/opendesign/src/textarea/OTextarea.vue
index ce7b7db8a43da60368d93a8e5b9dfe950c75eb6e..08df185d0f917e85be2daee5bc5744d1e6046409 100644
--- a/packages/opendesign/src/textarea/OTextarea.vue
+++ b/packages/opendesign/src/textarea/OTextarea.vue
@@ -79,10 +79,14 @@ onMounted(() => {
 });
 
 defineExpose({
+  /** expose: Focus method */
   focus: () => inTextareaRef.value?.focus(),
+  /** expose: Blur method */
   blur: () => inTextareaRef.value?.blur(),
+  /** expose: Clear method */
   clear: () => inTextareaRef.value?.clear(),
-  inputEl: () => inTextareaRef.value?.inputEl,
+  /** expose: Textarea element */
+  inputEl: () => inTextareaRef.value?.inputEl as HTMLTextAreaElement | undefined,
 });
 </script>
 <template>
diff --git a/packages/opendesign/src/textarea/__docs__/__case__/textareaUsage.ts b/packages/opendesign/src/textarea/__docs__/__case__/TextareaUsage.vue
similarity index 36%
rename from packages/opendesign/src/textarea/__docs__/__case__/textareaUsage.ts
rename to packages/opendesign/src/textarea/__docs__/__case__/TextareaUsage.vue
index 1c8240f9e10bfa11612345a211e22fce5ea43c83..1ce818bab301a642c04d6bb619e6ad810f43542f 100644
--- a/packages/opendesign/src/textarea/__docs__/__case__/textareaUsage.ts
+++ b/packages/opendesign/src/textarea/__docs__/__case__/TextareaUsage.vue
@@ -1,66 +1,37 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+### 使用
+
+<!-- en-US -->
+
+### Usage
+</docs>
+<script setup lang="ts">
 import { propsToAttrStr } from '../../../_demo/utils';
 import { reactive } from 'vue';
 import { DocDemoSchema, DocDemoTemplate } from '../../../_demo/types.ts';
 
-export const docs = {
-  'zh-CN':
-    '文本域是常见的表单类输入组件，提供了较长文本输入和查看的能力，可设置项如下：  \n' +
-    '- 提示文本`placeholder`  \n' +
-    '- 是否禁用`disabled`  \n' +
-    '- 是否只读`readonly`  \n' +
-    '- 是否可以清除`clearable`  \n' +
-    '- 显示的行数`rows`  \n' +
-    '- 显示的列数`cols`  \n' +
-    '- 是否支持调整尺寸`resize`  \n' +
-    '- 最小字符长度`minLength`  \n' +
-    '- 最大字符长度`maxLength`  \n' +
-    '- 超过最大字符长度时是否允许输入`inputOnOutlimit`  \n' +
-    '- 根据内容自动计算高度`autoSize`  \n' +
-    '- 大小`size`  \n' +
-    '- 圆角值`round`  \n' +
-    '- 颜色类型`color`  \n' +
-    '- 按钮类型`variant`  \n' +
-    '\n\n更多的可配置参数参考下方API小节',
-  'en-US':
-    'Textarea is a common form input component that provides capabilities for inputting and viewing longer text. Configurable items include:  \n' +
-    '- Prompt text `placeholder`  \n' +
-    '- Disabled state `disabled`  \n' +
-    '- Readonly state `readonly`  \n' +
-    '- Clearable option `clearable`  \n' +
-    '- Number of displayed rows `rows`  \n' +
-    '- Number of displayed columns `cols`  \n' +
-    '- Resize support `resize`  \n' +
-    '- Minimum character length `minLength`  \n' +
-    '- Maximum character length `maxLength`  \n' +
-    '- Input allowance beyond max length `inputOnOutlimit`  \n' +
-    '- Auto height calculation based on content `autoSize`  \n' +
-    '- Size `size`  \n' +
-    '- Corner roundness `round`  \n' +
-    '- Color type `color`  \n' +
-    '- Button style variant `variant`  \n' +
-    '\n\nFor more configurable parameters, refer to the API section below.'
-};
-
-export const ctx = reactive({
-  modelValue: 'this is value'
+const _ctx = reactive({
+  modelValue: 'this is value',
 });
 
-export const schema = {
+const _schema = {
   placeholder: {
     type: 'string',
-    default: 'input something'
+    default: 'input something',
   },
   disabled: {
     type: 'boolean',
-    default: false
+    default: false,
   },
   readonly: {
     type: 'boolean',
-    default: false
+    default: false,
   },
   clearable: {
     type: 'boolean',
-    default: true
+    default: true,
   },
   rows: {
     type: 'number',
@@ -72,15 +43,15 @@ export const schema = {
   },
   resize: {
     type: 'list',
-    list: ['both', 'horizontal', 'h', 'vertical', 'v', 'none'] as const
+    list: ['both', 'horizontal', 'h', 'vertical', 'v', 'none'] as const,
   },
   minLength: {
     type: 'number',
-    default: 0
+    default: 0,
   },
   maxLength: {
     type: 'number',
-    default: 100
+    default: 100,
   },
   inputOnOutlimit: {
     type: 'boolean',
@@ -96,7 +67,7 @@ export const schema = {
   },
   round: {
     type: 'string',
-    default: 'pill'
+    default: '4px',
   },
   color: {
     type: 'list',
@@ -105,9 +76,11 @@ export const schema = {
   variant: {
     type: 'list',
     list: ['solid', 'outline', 'text'] as const,
+    default: 'outline',
   },
 } satisfies Record<string, DocDemoSchema>;
 
-export const template: DocDemoTemplate<typeof schema> = (_props) => {
+const _template: DocDemoTemplate<typeof _schema> = (_props) => {
   return `<OTextarea ${propsToAttrStr(_props)} v-model="ctx.modelValue"/>`;
 };
+</script>
diff --git a/packages/opendesign/src/textarea/__docs__/index.en-US.md b/packages/opendesign/src/textarea/__docs__/index.en-US.md
index 9270c0c7b46e0d6166724c734e60cbd184f7f543..6214f6f2b1ded7b491f8b3ddf59187aa3c5c6c77 100644
--- a/packages/opendesign/src/textarea/__docs__/index.en-US.md
+++ b/packages/opendesign/src/textarea/__docs__/index.en-US.md
@@ -7,15 +7,15 @@ kind: input
 
 ## Usage
 
-<!-- @usage textareaUsage -->
+<!-- @usage TextareaUsage -->
 
-## Cases
+## Demo
 
 <!-- @case TextareaBasic -->
 <!-- @case TextareaAutoHeight -->
 <!-- @case TextareaSlot -->
 <!-- @case TextareaEvent -->
 
-## Api
+## API
 
 <!-- @api OTextarea -->
\ No newline at end of file
diff --git a/packages/opendesign/src/textarea/__docs__/index.zh-CN.md b/packages/opendesign/src/textarea/__docs__/index.zh-CN.md
index b964dabda9615fb7aceeddd4a0509ec630dd3e7c..9ad9ec020a3d58448956d2c21719757b3dd251fe 100644
--- a/packages/opendesign/src/textarea/__docs__/index.zh-CN.md
+++ b/packages/opendesign/src/textarea/__docs__/index.zh-CN.md
@@ -7,7 +7,7 @@ kind: input
 
 ## 使用
 
-<!-- @usage textareaUsage -->
+<!-- @usage TextareaUsage -->
 
 ## 示例
 
@@ -16,6 +16,6 @@ kind: input
 <!-- @case TextareaSlot -->
 <!-- @case TextareaEvent -->
 
-## Api
+## API
 
 <!-- @api OTextarea -->
\ No newline at end of file
diff --git a/packages/opendesign/src/textarea/style/theme-ascend.scss b/packages/opendesign/src/textarea/style/theme-ascend.scss
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..6bd5cbdc78c8d586284b118677be8e5553d41f37 100644
--- a/packages/opendesign/src/textarea/style/theme-ascend.scss
+++ b/packages/opendesign/src/textarea/style/theme-ascend.scss
@@ -0,0 +1 @@
+@use './theme-common.scss' as *;
diff --git a/packages/opendesign/src/textarea/style/theme-common.scss b/packages/opendesign/src/textarea/style/theme-common.scss
new file mode 100644
index 0000000000000000000000000000000000000000..7f461b302af3f9bb9237ca75680c5e44e324898b
--- /dev/null
+++ b/packages/opendesign/src/textarea/style/theme-common.scss
@@ -0,0 +1,9 @@
+@use '../../_styles/mixin.scss' as *;
+
+.o-textarea {
+  height: 126px;
+
+  @include respond-to('<=pc_s') {
+    height: 116px;
+  }
+}
diff --git a/packages/opendesign/src/textarea/style/theme-kunpeng.scss b/packages/opendesign/src/textarea/style/theme-kunpeng.scss
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..6bd5cbdc78c8d586284b118677be8e5553d41f37 100644
--- a/packages/opendesign/src/textarea/style/theme-kunpeng.scss
+++ b/packages/opendesign/src/textarea/style/theme-kunpeng.scss
@@ -0,0 +1 @@
+@use './theme-common.scss' as *;
diff --git a/packages/opendesign/src/textarea/style/theme-openeuler.scss b/packages/opendesign/src/textarea/style/theme-openeuler.scss
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..6bd5cbdc78c8d586284b118677be8e5553d41f37 100644
--- a/packages/opendesign/src/textarea/style/theme-openeuler.scss
+++ b/packages/opendesign/src/textarea/style/theme-openeuler.scss
@@ -0,0 +1 @@
+@use './theme-common.scss' as *;
diff --git a/packages/opendesign/src/textarea/types.ts b/packages/opendesign/src/textarea/types.ts
index 810758c7ced6d351083bb51db6baad23936d7ca1..826fb302abbe18de56fe48b714229aa2213a8ebf 100644
--- a/packages/opendesign/src/textarea/types.ts
+++ b/packages/opendesign/src/textarea/types.ts
@@ -5,26 +5,30 @@ import { inTextareaProps } from '../_components/in-textarea/types';
 export const textareaProps = {
   ...inTextareaProps,
   /**
-   * 大小 SizeT
+   * @zh-CN 尺寸
+   * @en-US Size
    */
   size: {
     type: String as PropType<SizeT>,
   },
   /**
-   * 圆角值 RoundT
+   * @zh-CN 圆角
+   * @en-US Round
    */
   round: {
     type: String as PropType<RoundT>,
   },
   /**
-   * 颜色类型 Color2T
+   * @zh-CN 颜色类型
+   * @en-US Color type
    */
   color: {
     type: String as PropType<Color2T>,
     default: 'normal',
   },
   /**
-   * 按钮类型 VariantT
+   * @zh-CN 形状变体
+   * @en-US Shape variant
    */
   variant: {
     type: String as PropType<VariantT>,