文件表单字段

**文件**表单字段类型提供了一个用于文件的输入字段。

• **type**（必填）必须为file。
• **name**（必填）是字段的唯一名称。
• **label**（必填）（可翻译）是字段的HTML标签。
• **description**（可选）（可翻译）是字段描述。
• **default**（可选）（不可翻译）是默认值，但对于文件来说意义不大。
• **size**（可选）是文件框的宽度（以字符为单位）。
• **accept**（可选）告诉浏览器您的表单将允许上传哪些文件/MIME类型。请参阅accept。
• **class**（可选）是HTML表单字段的CSS类名。
• **labelclass**（可选）为表单字段的标签添加一个CSS类；对于Joomla 2.5.4+禁用（可选）HTML等效属性。
• **onchange**（可选）HTML等效属性（javascript使用）。
• **required**不能与这种字段类型一起使用。如果字段标记为必填，则无论是否已上传文件，它始终都会验证失败。建议的解决方法是添加一个filerequired属性，可以在您自己的文件处理代码中对其进行测试。
• **validate**（可选）是否根据规则对字段进行Joomla验证。
• **showon**（可选）允许您根据另一个字段的值隐藏字段；对于Joomla 3.2.4+
• **multiple**（可选）设置为multiple="true"时，允许您一次上传多个文件。

由以下文件实现：libraries/src/Form/Field/FileField.php

**注意1：**使用文件输入类型时，应始终向表单标签添加属性enctype="multipart/form-data"。否则，上传的文件将无法正确附加。

**注意2：**可以通过添加一个名为“MAX_FILE_SIZE”的隐藏字段并将其值设置为允许的最大字节数来设置文件大小的软限制，该限制由php处理，但您也必须在代码中处理它，无论是否使用它。

XML参数定义示例

<field
        name="myfilevalue" 
        type="file" 
        label="Enter some text" 
        description="Choose an image from your computer with maximum 100KB" 
        size="10" 
        accept="image/*"
/>

另请参阅

• 如何使用文件系统包