Campo de Formulario, Tipo imagelist
From Joomla! Documentation
El campo de formulario tipo imagelist proporciona una lista desplegable de los archivos de imagen en un directorio especificado. Sólo los archivos con extensiones .png, .gif, .jpg, .bmp, .ico estarán en la lista. 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) está 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 imagelist.
- name (obligatorio) es el nombre único del campo.
- label (obligatorio) (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 de imagen a listar. Si se omite el directorio, se asume el dado por JPATH_ROOT.
- default (opcional) es el nombre de archivo de imagen 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 (opcional) es una expresión regular que se utiliza para filtrar la lista de archivos de imagen 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 imagen 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 de imagen serán quitadas de la lista. También ten 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 utilizar -' 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="myimage" type="imagelist" default="" label="Select an image" description="" directory="" exclude="" stripext="" />