Joomla! Documentation™

Le type de champ de formulaire imagelist fournit une liste de fichiers image d'un dossier spécifique. Seuls les fichiers avec l'extension .png, .gif, .jpg, .bmp, .ico sont listés. 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 "imagelist".
• 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 image 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 images sélectionnées pour inclusion dans la liste déroulante. Si ce paramètre est omis, toutes les images du répertoire seront incluses. 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 images 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 des images seront supprimés de la liste des noms des images. Notez également que le nom des images sera enregistré également sans l'extension.
• hide_none (facultatif) est un argument booléen. Si la valeur est 'true', l'élément '- Do not use -' 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="myimage" type="imagelist" default="" label="Select an image" description="" directory="" exclude="" stripext="" />

Voir également

• Liste des types de champ de formulaires standards