Campo de Formulario, Tipo file
From Joomla! Documentation
Proporciona un campo de entrada para archivos
- type (obligatorio) debe ser file.
- name (obligatorio) es el nombre único del campo.
- label (obligatoria) (traducible) es el título descriptivo del campo.
- description (opcional) (traducible) es el texto que será mostrado como un texto de ayuda cuando el usuario mueve el ratón sobre el cuadro de lista desplegable.
- default (opcional) (no traducible) es el valor predeterminado, pero no significa mucho para un archivo.
- size (opcional) es el ancho de la caja de archivo en caracteres.
- accept (opcional) Le indica al navegador qué tipos MIME permitirás subir a tu formulario.
- class (opcional) es un nombre de clase CSS para el campo del formulario HTML.
- labelclass (opcional) añade una clase CSS para la etiqueta del campo de formulario; para Joomla 2.5.4+
- disabled (opcional) equivalente al atributo HTML
- onchange (opcional) equivalente al atributo HTML (usado en javascript)
- required No se puede utilizar con este tipo de campo. Si el campo está marcado como requerido, siempre fallará la validación, independientemente de si se ha cargado o no un archivo. La solución sugerida, es agregar un atributo filerequired que se pueda probar en tu propio código de manejo de archivos.
- validate (opcional) Si el campo se va a validar según las reglas de Joomlaǃ
- showon (opcional) Permite ocultar el campo basado(s) en el(los) valor(es) de otro(s) campo(s); para Joomla 3.2.4+
- multiple (opcional) Permite cargar varios archivos a la vez cuando se establece multiple = "true"
Nota:
Cuando se utiliza el tipo de entrada file siempre debe se añadir el atributo enctype="multipart/form-data" a la etiqueta form. De lo contrario, los archivos subidos no serán adjuntados correctamente.
Nota 2:
Puedes poner un límite al tamaño del archivo mediante la adición de un campo oculto con name="MAX_FILE_SIZE" y el valor máximo permitido de bytes que es manejado por php, pero también puedes manejarlo en tu código con o sin él.
Ejemplo de Definición XML del campo:
<field name="myfilevalue" type="file" label="Enter some text" description="Choose an image from your computer with maximum 100KB" size="10" accept="image/*" />