---
title: "Ext.form.Label"
description: "xtype 为 label 的 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.Label

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

## 创建示例

```javascript
var component = Ext.create("Ext.form.Label", {
  xtype: "label",
  autoEl: 'label',
  cls: 'x-form-item-label',
  labelAlign: '',
  maskOnDisable: false,
  renderTo: Ext.getBody()
});
```

## 属性

| 属性 | 类型 | 默认值 | 说明 | 配置示例 |
| --- | --- | --- | --- | --- |
| `autoEl` | `String` | `'label'` | 配置组件的 `autoEl` 选项。 | `autoEl: 'label'` |
| `cls` | `String` | `'x-form-item-label'` | 附加到组件根元素的 CSS 类名。 | `cls: 'x-form-item-label'` |
| `labelAlign` | `String` | `''` | 字段标签相对输入区域的对齐位置。 | `labelAlign: ''` |
| `maskOnDisable` | `Boolean` | `false` | 控制是否启用 `maskOnDisable` 行为。 | `maskOnDisable: false` |

## 方法

| 方法 | 参数 | 说明 | 调用示例 |
| --- | --- | --- | --- |
| `initComponent` | `` | 初始化组件及其子项。 执行时会保留父类默认行为、更新 `cls` 状态。源码涉及 `callParent()`。 | `component.initComponent()` |
| `getElConfig` | `` | 读取并返回 `elConfig`。 执行时会保留父类默认行为、更新 `html` 状态。源码涉及 `callParent()`。 | `component.getElConfig()` |
| `afterRender` | `` | 生成 `after` 的渲染结果。 | `component.afterRender()` |
| `setText` | `text, encode` | 设置 `text`。 执行时会刷新界面或布局、更新 `text`、`html` 状态。源码涉及 `updateLayout()`。 | `component.setText(...)` |

## 事件

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

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