Campo de Formulario, Tipo fieldlist
From Joomla! Documentation
El campo de formulario, tipo filelist proporciona una lista desplegable de los archivos de un directorio especificado. Si el campo tiene un valor guardado este es seleccionado cuando la página se carga por primera vez. Si no, el valor predeterminado (si existe) es seleccionado.
De forma predeterminada, el primer elemento en la lista es '- No utilizar -' (que es traducible) y se le da el valor ' -1' y esto es seguido por '- Usar predeterminado -' (también traducible) que toma el valor '0'.
- type (obligatorio) debe ser filelist.
- name (obligatorio) es el nombre único del campo.
- label (obligatoria) (traducible) es el título descriptivo del campo.
- directory (opcional) es la ruta de acceso del sistema de archivos al directorio que contiene los archivos a listar. Si se omite el directorio, se asume el dado por JPATH_ROOT.
- default (opcional) es el nombre de archivo predeterminado.
- 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.
- filter (
) o fileFilter (
y posterior) (opcional) es una expresión regular que se utiliza para filtrar la lista de archivos seleccionados para su inclusión en la lista desplegable. Si se omite, todos los archivos en el directorio son incluidos. la expresión del argumento filter se aplica antes que la expresión del argumento exclude. Para obtener información sobre la construcción de expresiones regulares ver Expresiones Regulares en los argumentos de los parámetros. - exclude (opcional) es una expresión regular que se utiliza para excluir archivos de la lista. La expresión del argumento exclude se aplica después que la expresión del argumento filter. Para obtener información sobre la construcción de expresiones regulares ver Expresiones Regulares en los argumentos de los parámetros.
- stripext (opcional) es un argumento de tipo Boleano. Si es verdadero entonces las extensiones del nombre de los archivos serás quitadas de la lista. También tenga en cuenta que el nombre del archivo será guardado sin la extensión.
- hide_none (opcional) es un argumento de tipo Boleano. Si es verdadero, se omite el ítem '- No seleccionado -' de la lista desplegable.
- hide_default (opcional) es un argumento de tipo Boleano. Si es verdadero, se omite el ítem '- Usar predeterminado -' de la lista desplegable.
Ejemplo de Definición XML del campo:
<field name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" />