Type de champ de formulaire text

From Joomla! Documentation

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

Le type de champ de formulaire text (texte) affiche une case texte pour l'entrée de données. 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.text.jpg
  • type (obligatoire) doit être "text".
  • name (nom) (obligatoire) est le nom unique du champ.
  • label (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
  • size (dimension) (facultatif) 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 de cette dimension ne limite pas le nombre de caractères qui peuvent être saisis.
  • maxlength (facultatif) nombre maximum de caractères pouvant ê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.
  • readonly (lecture seule) (facultatif) le champ ne pourra pas être modifié et héritera automatiquement de la valeur par défaut. (Valeurs possibles : "true", "1", "readonly" pour mettre à "true").
  • disabled (facultatif) le champ ne peut pas être modifié et héritera automatiquement de la valeur par défaut - ne sera pas transmise. (Valeurs possibles : "true", "1", "readonly" pour mettre à "true").
  • required (facultatif) le champ doit être complété avant la soumission du formulaire.(Valeurs possibles : "true", "1", "readonly" pour mettre à "true").
  • filter (filtre) (facultatif) autorise le système à sauvegarder certaines balises html ou des données brutes.
  • message (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
  • hint (facultatif) Le texte affiché dans l'emplacement html prévu à cet effet, habituellement une suggestion de couleur plus claire dans un champ blanc.
  • inputtype (facultatif) Affiche le type d'entrée HTML5.
  • pattern (facultatif) Une expression régulière à utiliser pour la validation.

The Text field can also take an array of option sub elements in order to show suggestions to user in the text field.

Exemple de définition de champ XML :

<field name="mytextvalue" type="text" default="Some text" label="Enter some text" description="" size="10" />

Utilisez le filtre integer (des entiers) pour vous assurer que les types lettres soient traités lorsque le formulaire est envoyé.

<field name="myintvalue" type="text" default="8" label="Enter some text" description="Enter some description" filter="integer" />

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

<field name="myhtmlvalue" type="text" default="" label="Enter some text" description="Enter some description" filter="raw" />

Voir également