Type de champ de formulaire file

From Joomla! Documentation

This page is a translated version of the page File form field type and the translation is 100% complete.

Other languages:
English • ‎español • ‎français • ‎Nederlands

fournit un champ de saisie pour les fichiers.

  • type (obligatoire) doit être "file".
  • name (nom) (obligatoire) est le nom unique du champ.
  • label (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
  • description (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
  • default (par défaut) (facultatif) (non-traduisible) est la valeur par défaut, mais n'a pas de réelle signification pour un fichier.
  • size (taille) (facultatif) est la largeur de la zone de fichier en nombre de caractères.
  • accept (optional) (accepté) (facultatif) permet d'indiquer au navigateur les types MIME que vous autorisez au téléchargement.
  • class (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML.
  • labelclass (facultatif) ajoute une classe CSS pour les étiquettes du champ de de formulaire. Depuis Joomla! 2.5.4+
  • disabled (désactivé) (facultatif) attribut d'équivalent HTML
  • onchange (facultatif) attribut d'équivalent HTML (utilisation de javascript)
  • obligatoire Ne peut pas être utilisé avec ce type de champ. Si le champ est marqué comme requis, la validation échouera toujours, qu'un fichier ait été téléchargé ou non. La solution de contournement suggérée est d'ajouter un attribut filerequired qui peut être testé dans votre propre code de manipulation de fichiers.
  • validate (valider) (facultatif) si Joomla doit valider le champ selon des règles prédéfinies
  • showon (facultatif) permet de masquer le champ en fonction de la/les valeur(s) d'un autre champ. Depuis Joomla! 3.2.4+

Note : Lors de l'utilisation du type d'entrée de fichier, vous devriez toujours ajouter l'attribut enctype="multipart/form-data" à votre balise de formulaire. Sinon, les fichiers téléchargés ne seront pas joints correctement. Note 2 : Vous pouvez fixer une limite de taille de fichier en ajoutant un champ caché avec name="MAX_FILE_SIZE" ainsi que la valeur maximum autorisée d'octets dans votre gestion PHP, mais également dans votre code.

Exemple de définition de champ XML :

<field name="myfilevalue" type="file" label="Enter some text" description="Choose an image from your computer with maximum 100KB" size="10" accept="image/*" />

Voir également