Zone de texte
`<gcds-textarea>`

Autres noms : saisie de texte, zone d'entrée.

Une zone de texte est un espace permettant de saisir une réponse détaillée à une question ou à une directive.

GitHub
Figma

Aperçu du composant de zone de texte

Sur cette page

Codage et accessibilité des zones de texte
Exemples
Générateur de code

Codage et accessibilité des zones de texte

Appliquez les attributs essentiels

Utilisez toujours les attributs essentiels suivants avec gcds-textarea :

name
label
textarea-id

Adapter la taille du champ à la réponse

Utilisez l’attribut rows pour définir la hauteur d’une zone de texte de façon à ce qu’elle corresponde à la quantité de texte attendue.
Utilisez le composant champ de saisie pour les réponses qui nécessitent moins de 75 caractères.
Évitez de définir une largeur inférieure à 50 %.
Utilisez une hauteur maximale de 7 lignes pour les réponses sans longueur fixe.

Ajouter du texte explicatif

Utilisez l'attribut hint pour ajouter du texte explicatif.
Évitez d’ajouter, directement dans un champ, du texte explicatif qui disparaît lorsque le champ est sélectionné ou lorsqu'on y saisit une réponse.

Ajoutez des limites de caractères

Utilisez l’attribut max-length pour activer les limites de caractères. Cela ajoute automatiquement le texte « Caractères restants : » sous la zone de texte.
Utilisez l’attribut hide-limit pour masquer visuellement le texte.

Masquer l'étiquette

Réglez l'attribut hide-label à true (vrai) pour masquer visuellement l'étiquette tout en la conservant pour les technologies d'assistance.
Évitez d'ajouter un texte explicatif lorsque l'étiquette est masquée.

Ajouter la validation et les messages d'erreur

Utilisez l'attribut required pour activer la validation et les messages d'erreur intégrés pour la zone de texte.
Les champs comportant des exigences de saisie spécifiques feront l'objet d'une validation, même s'ils ne sont pas obligatoires.
Pour les champs facultatifs qui doivent être validés, par exemple pour vérifier le format d'une adresse courriel, ajoutez une validation et des messages d'erreur personnalisés.

Exemples

Explorez les différentes façons de configurer le composant. Chaque exemple présente une mise en œuvre fonctionnelle et du code prêt à copier.

Attributs essentiels

Ces attributs sont requis pour que le composant fonctionne correctement.

`label`

L’attribut label définit l’étiquette de la zone de texte.

<gcds-textarea
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`name`

L’attribut name identifie la zone de texte dans le formulaire. Il permet de récupérer la valeur saisie après la soumission.

<gcds-textarea
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`textarea-id`

L’attribut textarea-id définit l’identifiant unique de la zone de texte.

<gcds-textarea
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

Attributs facultatifs

Ces attributs vous permettent de personnaliser ou d’enrichir le comportement et la présentation du composant.

`autofocus`

L’attribut autofocus contrôle si la zone de texte est ciblée automatiquement au chargement de la page. Par défaut, il est défini à false. Lorsqu’il est défini à true, la zone de texte est ciblée à l’affichage.

<gcds-textarea
  autofocus="true"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`cols`

L’attribut cols définit la largeur visible de la zone de texte en nombre de caractères moyens. La largeur minimale est de 50 % de son conteneur.

<gcds-textarea
  cols="8"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`disabled`

L’attribut disabled contrôle si la zone de texte est désactivée ou non. Par défaut, il est défini à false.

<gcds-textarea
  disabled="true"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`error-message`

L’attribut error-message définit le message d’erreur à afficher pour une zone de texte invalide.

<gcds-textarea
  error-message="Message d'erreur"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`form`

L’attribut form définit l’identifiant du formulaire auquel appartient la zone de texte.

<gcds-textarea
  form="form-id"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`hide-label`

L’attribut hide-label contrôle si l’étiquette est masquée ou non.

<gcds-textarea
  hide-label="true"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`hide-limit`

L’attribut hide-limit contrôle si le compteur de limite de caractères est affiché ou non. Lorsqu’il est défini à true, le compteur n’est pas affiché. Par défaut, il est défini à false.

<gcds-textarea
  hide-limit="true"
  maxlength="20"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`hint`

L’attribut hint définit le texte explicatif affiché sous l’étiquette.

<gcds-textarea
  hint="Texte explicatif / Exemple de message."
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`maxlength`

L’attribut maxlength définit le nombre maximum de caractères acceptés par la zone de texte.

<gcds-textarea
  maxlength="10"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`minlength`

L’attribut minlength définit le nombre minimum de caractères acceptés par la zone de texte.

<gcds-textarea
  minlength="5"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`required`

L’attribut required contrôle si la zone de texte est obligatoire ou non. Lorsqu’il est défini à true, il ajoute « obligatoire » après l’étiquette, et active le validateur de champ obligatoire.

<gcds-textarea
  required="true"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`rows`

L’attribut rows définit le nombre de lignes visibles dans la zone de texte, ce qui détermine sa hauteur.

<gcds-textarea
  rows="3"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`validate-on`

L’attribut validate-on définit l’événement de validation pour la zone de texte.

<gcds-textarea
  validate-on="other"
  required="true"
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

`value`

L’attribut value définit le contenu initial de la zone de texte. Il se met à jour pour refléter la valeur saisie par l’utilisateur.

<gcds-textarea
  value="Contenu de la zone de texte."
  textarea-id="textarea-example"
  label="Libellé de champ"
  name="textarea-example"
></gcds-textarea>

Générateur de code

Générez une version du composant dont vous avez besoin en sélectionnant les propriétés de code correspondantes ou explorez les possibilités en choisissant différentes valeurs de code.

Choisissez des valeurs de code pour obtenir l'élément que vous voulez.
Obtenez le code et intégrez-le dans votre environnement.
Ajoutez tout contenu nécessaire au composant (comme le texte du libellé).

Remarque : Conformément à la pratique courante, le générateur de code utilise l'anglais pour tous les éléments de code.

Aidez-nous à nous améliorer

Vous avez des questions ou des demandes? Faites-nous part de vos commentaires à l'aide de notre formulaire de contact.

Quelque chose ne va pas? Signalez-le sur GitHub en créant un compte. Vous pourrez accéder aux réponses de l'équipe, suivre les progrès réalisés concernant votre problèmes et voir les problèmes signalés par d'autres personnes.

Fournir des commentaires

Signaler un problème sur GitHub

2026-09-09

Zone de texte<gcds-textarea>

Aperçu du composant de zone de texte

Sur cette page

Codage et accessibilité des zones de texte

Appliquez les attributs essentiels

Adapter la taille du champ à la réponse

Ajoutez des limites de caractères

Exemples

Dans cette section

Attributs essentiels

label

name

textarea-id

Attributs facultatifs

autofocus

cols

disabled

error-message

form

hide-label

hide-limit

hint

maxlength

minlength

required

rows

validate-on

value