Joomla! Documentation™

Le type de champ de formulaire filelist fournit une liste déroulante de fichiers d'un dossier spécifique. Si le champ a une valeur enregistrée, cette option est sélectionnée lors du premier chargement de la page. Sinon, la valeur par défaut (le cas échéant) est sélectionnée.

Par défaut, le premier élément de la liste est '- Ne pas utiliser -' (traduisible) et a pour valeur '-1' et suivi par '- Utiliser par défaut -' (traduisible) avec pour valeur '0'.

• type (obligatoire) doit être "filelist".
• name (nom) (obligatoire) est le nom unique du champ.
• label (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
• directory (répertoire) (facultatif) est le chemin du fichier système d'accès au répertoire contenant les fichiers devant être listés. Si omis, le répertoire donné par JPATH_ROOT sera utilisé.
• default (par défaut) (facultatif) est le nom de fichier par défaut.
• description (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
• filter (filtre) (facultatif) est une expression régulière qui est utilisé pour filtrer la liste des fichiers sélectionnés pour inclusion dans la liste déroulante. Si ce paramètre est omis, tous les fichiers du répertoire sont inclus. L'argument du filtre est appliquée avant l'argument d'exclusion. Pour plus d'informations sur la construction des expressions régulières, veuillez consulter : Les expressions régulières dans les arguments.
• exclude (facultatif) est une expression régulière qui est utilisée pour exclure des fichiers de la liste. L'argument 'exclude' est appliqué après l'argument 'filter'. Pour plus d'informations sur la construction des expressions régulières, veuillez consulter : Les expressions régulières dans les arguments.
• stripext (facultatif) est un argument booléen. Si la valeur est 'true', alors les extensions des noms de fichiers seront supprimés de la liste des noms de fichiers. Notez également que le nom de fichier sera enregistré également sans l'extension.
• hide_none (facultatif) est un argument booléen. Si la valeur est 'true', l'élément '- None Selected -' est exclu de la liste déroulante.
• hide_default (facultatif) est un argument booléen. Si la valeur est 'true', l'élément '- Use default -' est exclu de la liste déroulante.

Exemple de définition de champ XML :

<field name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" />

Voir également

• Type de champ de formulaire folderlist
• Type de champ de formulaire imagelist
• Liste des types de champ de formulaire standards