Campo de Formulario, Tipo folderlist
From Joomla! Documentation
Outdated translations are marked like this.
El campo de formulario, tipo folderlist proporciona una lista desplegable de las carpetas 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 folderlist.
- 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 las carpetas a listar.
- default (opcional) es el nombre de carpeta predeterminada.
- 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 carpetas seleccionadss para su inclusión en la lista desplegable. Si se omite, todas las carpetas en el directorio son incluidas. 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 carpetas 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.
- 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.
- recursive (optional) is a Boolean argument. If true, the list of folders recursively includes any sub-folders found. Caution: If you have a large number of sub-folders this can make page loading slow.
Ejemplo de Definición XML del campo:
<field name="myfolder" type="folderlist" default="" label="Select a folder" directory="administrator" filter="" exclude="" stripext="" />