---
title: "Ext.form.field.TextArea"
description: "xtype 为 textareafield 的 Ext JS 原生组件参考。"
---

> Documentation Index
> Fetch the complete documentation index at: https://ag.879818327.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Ext.form.field.TextArea

源码定义：`ext-all-debug.js:94976`。分类：表单与字段。

## 创建示例

```javascript
var component = Ext.create("Ext.form.field.TextArea", {
  xtype: "textareafield",
  cols: 20,
  componentLayout: 'textareafield',
  enterIsSpecial: false,
  fieldSubTpl: [,
  renderTo: Ext.getBody()
});
```

## 属性

| 属性 | 类型 | 默认值 | 说明 | 配置示例 |
| --- | --- | --- | --- | --- |
| `cols` | `Number` | `20` | 配置组件的 `cols` 选项。 | `cols: 20` |
| `componentLayout` | `String` | `'textareafield'` | 组件采用的内部布局策略。 | `componentLayout: 'textareafield'` |
| `enterIsSpecial` | `Boolean` | `false` | 控制是否启用 `enterIsSpecial` 行为。 | `enterIsSpecial: false` |
| `fieldSubTpl` | `Array` | `[` | 字段 HTML 的子模板片段。 | `fieldSubTpl: [` |
| `growAppend` | `String` | `'\n-'` | 配置组件的 `growAppend` 选项。 | `growAppend: '\n-'` |
| `growMax` | `Number` | `1000` | 配置组件的 `growMax` 选项。 | `growMax: 1000` |
| `growMin` | `Number` | `60` | 配置组件的 `growMin` 选项。 | `growMin: 60` |
| `inputCls` | `Mixed` | `Ext.baseCSSPrefix + 'form-textarea'` | 配置 `inputCls` 对应的 CSS 类名。 | `inputCls: Ext.baseCSSPrefix + 'form-textarea'` |
| `labelSeparator` | `String` | `''` | 配置组件的 `labelSeparator` 选项。 | `labelSeparator: ''` |
| `preventScrollbars` | `Boolean` | `false` | 控制是否启用 `preventScrollbars` 行为。 | `preventScrollbars: false` |
| `returnRe` | `Mixed` | `/\r/g` | 配置组件的 `returnRe` 选项。 | `returnRe: /\r/g` |
| `rows` | `Number` | `4` | 配置组件的 `rows` 选项。 | `rows: 4` |
| `setGrowSizePolicy` | `Mixed` | `Ext.emptyFn` | 配置组件的 `setGrowSizePolicy` 选项。 | `setGrowSizePolicy: Ext.emptyFn` |

## 方法

| 方法 | 参数 | 说明 | 调用示例 |
| --- | --- | --- | --- |
| `getSubTplData` | `` | 读取并返回 `subTplData`。 执行时会保留父类默认行为。源码涉及 `getFieldStyle()`、`callParent()`。 | `component.getSubTplData()` |
| `afterRender` | `` | 生成 `after` 的渲染结果。 执行时会保留父类默认行为、更新 `needsMaxCheck` 状态。源码涉及 `callParent()`。 | `component.afterRender()` |
| `transformRawValue` | `value` | 转换 `rawValue`。源码涉及 `stripReturns()`。 | `component.transformRawValue(...)` |
| `transformOriginalValue` | `value` | 转换 `originalValue`。源码涉及 `stripReturns()`。 | `component.transformOriginalValue(...)` |
| `getValue` | `` | 读取并返回 `value`。 执行时会保留父类默认行为。源码涉及 `stripReturns()`、`callParent()`。 | `component.getValue()` |
| `valueToRaw` | `value` | 将 `value` 转换为 `raw`。 执行时会保留父类默认行为。源码涉及 `stripReturns()`、`callParent()`。 | `component.valueToRaw(...)` |
| `stripReturns` | `value` | 清理 `returns`。 | `component.stripReturns(...)` |
| `onPaste` | `e` | 处理 `paste` 回调。 执行时会更新 `pasteTask` 状态。 | `component.onPaste(...)` |
| `pasteCheck` | `` | 处理 `pasteCheck` 操作。 执行时会更新组件值。源码涉及 `getValue()`、`setValue()`。 | `component.pasteCheck()` |
| `fireKey` | `e` | 触发 `key`。 执行时会派发 `specialkey` 事件。源码涉及 `fireEvent()`、`isCutCopyPasteSelectAll()`、`getValue()`。 | `component.fireKey(...)` |
| `isCutCopyPasteSelectAll` | `e, key` | 判断 `cutCopyPasteSelectAll` 状态。 | `component.isCutCopyPasteSelectAll(...)` |
| `autoSize` | `` | 自动计算尺寸当前组件。 执行时会派发 `autosize` 事件、刷新界面或布局、更新 `lastInputHeight` 状态。源码涉及 `updateLayout()`、`fireEvent()`。 | `component.autoSize()` |
| `beforeDestroy` | `` | 在 `destroy` 前执行预处理。 执行时会保留父类默认行为、更新 `pasteTask` 状态。源码涉及 `callParent()`。 | `component.beforeDestroy()` |

## 事件

源码中未找到该组件自身注册的事件；可监听继承事件。

Source: https://ag.879818327.xyz/ext/form/form-field-textarea/index.mdx