---
title: "Ext.form.field.FileButton"
description: "xtype 为 filebutton 的 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.FileButton

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

## 创建示例

```javascript
var component = Ext.create("Ext.form.field.FileButton", {
  xtype: "filebutton",
  autoEl: {,
  childEls: [,
  cls: Ext.baseCSSPrefix + 'form-file-btn',
  inputCls: Ext.baseCSSPrefix + 'form-file-input',
  renderTo: Ext.getBody()
});
```

## 属性

| 属性 | 类型 | 默认值 | 说明 | 配置示例 |
| --- | --- | --- | --- | --- |
| `autoEl` | `Object` | `{` | 配置组件的 `autoEl` 选项。 | `autoEl: {` |
| `childEls` | `Array` | `[` | 组件创建后需要引用的子 DOM 元素集合。 | `childEls: [` |
| `cls` | `Mixed` | `Ext.baseCSSPrefix + 'form-file-btn'` | 附加到组件根元素的 CSS 类名。 | `cls: Ext.baseCSSPrefix + 'form-file-btn'` |
| `inputCls` | `Mixed` | `Ext.baseCSSPrefix + 'form-file-input'` | 配置 `inputCls` 对应的 CSS 类名。 | `inputCls: Ext.baseCSSPrefix + 'form-file-input'` |
| `preventDefault` | `Boolean` | `false` | 控制是否启用 `preventDefault` 行为。 | `preventDefault: false` |
| `renderTpl` | `Array` | `[` | 配置生成组件内容的 `renderTpl` 模板。 | `renderTpl: [` |

## 方法

| 方法 | 参数 | 说明 | 调用示例 |
| --- | --- | --- | --- |
| `getTemplateArgs` | `` | 调用并直接返回父类的值，不对结果作额外转换。 | `component.getTemplateArgs()` |
| `afterRender` | `` | 生成 `after` 的渲染结果。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.afterRender()` |
| `fireChange` | `e` | 触发 `change`。 执行时会派发 `change` 事件。源码涉及 `fireEvent()`。 | `component.fireChange(...)` |
| `createFileInput` | `isTemporary` | 创建 `fileInput`。 执行时会更新 `fileInputEl` 状态。 | `component.createFileInput(...)` |
| `reset` | `remove` | 将组件恢复为初始状态。源码涉及 `createFileInput()`。 | `component.reset(...)` |
| `restoreInput` | `el` | 还原 `input`。 执行时会更新 `fileInputEl` 状态。 | `component.restoreInput(...)` |
| `onDisable` | `` | 处理 `disable` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.onDisable()` |
| `onEnable` | `` | 处理 `enable` 回调。 执行时会保留父类默认行为。源码涉及 `callParent()`。 | `component.onEnable()` |

## 事件

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

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