Type de champ de formulaire textarea

From Joomla! Documentation

This page is a translated version of the page Textarea form field type and the translation is 100% complete.
Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français

Le type de champ de formulaire textarea (zone de texte) affiche une zone de texte pour l'entrée de données sur plusieurs lignes. Si le champ a une valeur enregistrée, cette valeur sera affichée lors du premier chargement de la page. Si ce n'est pas le cas, la valeur par défaut (si définie) est sélectionnée.

Params.textarea.jpg
  • type (obligatoire) doit être "textarea".
  • name (nom) (obligatoire) est le nom unique du champ.
  • label (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
  • rows (lignes) (obligatoire) est la hauteur de la zone de texte définie en nombre de lignes. Si omis, la hauteur est déterminée par le navigateur lui-même. La valeur de lignes ne limite pas le nombre de lignes qui peuvent faire l'objet de saisies.
  • cols (colonnes) (obligatoire) est la largeur de la zone de texte en nombre de caractères. Si non renseigné, la largeur sera alors déterminée par le navigateur lui-même. La valeur des colonnes ne limite pas le nombre de caractères qui peuvent être saisis.
  • default (par défaut) (facultatif) est la valeur 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.
  • class (classe) (facultatif) est le nom de classe CSS pour le champ de formulaire HTML. Si non défini, 'text_area' sera la valeur par défaut.
  • filter (filtre) (facultatif) autorise le système à sauvegarder certaines balises html ou des données brutes.
  • hint (facultatif) Le texte affiché dans l'emplacement html prévu à cet effet, habituellement une suggestion de couleur plus claire dans un champ blanc.

Exemple de définition de champ XML :

<field name="mytextarea" type="textarea" default="default" label="Enter some text" description="" rows="10" cols="5" />

Utiliser le filtre raw (brut) pour vous assurer que le code html soit conservé lorsque le formulaire est traité :

<field name="mytextarea" type="textarea" default="default" label="Enter some html" description="" rows="10" cols="5" filter="raw"/>

Astuces

  • Si vous avez besoin de saut de ligne, utilisez l'encodage <br /> dans le fichier de configuration XML comme ceci : &lt;br /&gt;
  • Si vous avez besoin d'une nouvelle ligne de caractère dans votre valeur par défaut, ajouter &#13;&#10; au paramètre par défaut.

Voir également