Système de design GCComposants
Système de design GC Démarrer Aperçu des modèles de pagePage de base Aperçu des composantsAlerteAvisBarre de navigation latéraleBarre de navigation supérieureBascule de langueBoutonBoutons radioCarteCases à cocherChamp de dateChamp de saisieChemin de navigationConteneurDate de modificationDétailsEn-têteGrilleIcôneIndicateur d'étapeJeu de champsLienMasquage accessibleMenu thématiqueMessage d'erreurPaginationPied de pageRechercheRésumé des erreursSélectionSignatureTableauTéléverseur de fichiersTexteTitreZone de texte Aperçu des raccourcis CSS Réinitialisation des styles Mise en page réactiveÉtat Dimensionnement de la boîteDimensionnement du conteneurAffichageDébordementPositionVisibilité PoliceFamille de policeTaille de policeStyle de policeÉpaisseur de policeHauteur de ligneCouleur de lienTaille de lienDécoration de texte de lienStyle de listeAlignement de texteCouleur de texteDébordement de texteTransformation de texteSaut de mot MargeMarge intérieure Alignement de contenuAlignement des élémentsAlignement individuelÉlément flexibleDirection de l’élément flexibleÉlargissement de l’élément flexibleRétrécissement de l’élément flexibleHabillage de l’élément flexibleDégagementColonnes de grilleLignes de grilleJustification de contenuJustification des élémentsJustification individuelleOrdreAgencement de contenuAgencement des élémentsAgencement individuel Couleur de l'arrière-planCouleur de la bordureRayon de la bordureStyle de la bordureLargeur de la bordure Noms des icônesTaille de l'icôneImage CurseurÉvénements de pointeurTransition Aperçu des stylesUnités de styleCouleurEspacementTypographie Nous contacterS'impliquerTrouvez une démo

Champ de saisie
<gcds-input>

Autres noms : saisie de texte, zone d'entrée. Un champ de saisie est un espace permettant de saisir une courte réponse à une question ou à une directive.
  • GitHub
  • Figma

Aperçu du composant de champ de saisie

Sur cette page

Codage et accessibilité des champs de saisie

Appliquez les attributs essentiels

Utilisez toujours les attributs essentiels suivants avec gcds-input :
  • name
  • label
  • input-id

Adapter la taille du champ à la réponse

  • Pour les réponses d’une longueur précise, définissez l’attribut size.
    • Par exemple, 6 caractères pour un code postal ou 10 caractères pour un numéro de téléphone.
    • Taille “50” = 50 caractères.
  • Pour les réponses sans longueur précise, ajustez le champ pour qu’il prenne environ 90 % de la taille du conteneur.
    • Utilisez un maximum de 75 caractères pour les réponses sans longueur fixe.
  • Utilisez le composant zone de texte pour les réponses nécessitant plus de 75 caractères.

Afficher un clavier numérique sur mobile

  • Utilisez inputmode=”numeric” avec type=”text” pour les nombres non incrémentiels, comme les numéros de compte, les numéros de carte de crédit ou les codes d’authentification.
  • Le clavier numérique s’ouvrira sur les appareils mobiles.
  • Cela ne change pas la façon dont la valeur est validée.
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.
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 le champ de saisie.
  • 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.

Dans cette section

Attributs essentiels

Ces attributs sont requis pour que le composant fonctionne correctement.

input-id

L’attribut input-id définit l’identifiant unique du champ de saisie. 
<gcds-input
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

label

L’attribut label définit l’étiquette du champ de saisie. 
<gcds-input
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

name

L’attribut name identifie le champ de saisie dans le formulaire. Il permet de récupérer la valeur saisie après la soumission. 
<gcds-input
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

Attributs facultatifs

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

autocomplete

L’attribut autocomplete contrôle si le navigateur peut suggérer des valeurs précédemment saisies pour le champ. 
<gcds-input
  autocomplete="given-name"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

autofocus

L’attribut autofocus contrôle si le champ de saisie est ciblé automatiquement au chargement de la page. Par défaut, il est défini à false. Lorsqu’il est défini à true, le champ est ciblé à l’affichage. 
<gcds-input
  autofocus="true"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

disabled

L’attribut disabled contrôle si le champ de saisie est désactivé ou non. Par défaut, il est défini à false. 
<gcds-input
  disabled="true"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

error-message

L’attribut error-message définit le message d’erreur à afficher pour un champ invalide. 
<gcds-input
  error-message="Message d'erreur"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

form

L’attribut form définit l’identifiant du formulaire auquel appartient le champ de saisie. 
<gcds-input
  form="form-id"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

hide-label

L’attribut hide-label contrôle si l’étiquette est masquée ou non. 
<gcds-input
  hide-label="true"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

hint

L’attribut hint définit le texte explicatif affiché sous l’étiquette. 
<gcds-input
  hint="Texte explicatif / Exemple de message."
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

inputmode

L’attribut inputmode définit l’apparence du clavier virtuel sur les appareils mobiles. Les options sont :
  • decimal
  • email
  • none
  • numeric
  • search
  • tel
  • text
  • url
<gcds-input
  inputmode="numeric"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

max

L’attribut max définit la valeur maximale acceptée par le champ. Il s’applique uniquement au type de saisie numérique. 
<gcds-input
  max="100"
  type="number"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

maxlength

L’attribut maxlength définit le nombre maximum de caractères acceptés par le champ de saisie. 
<gcds-input
  maxlength="10"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

min

L’attribut min définit la valeur minimale acceptée par le champ de saisie. Il s’applique uniquement au type de saisie numérique. 
<gcds-input
  min="22"
  type="number"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

minlength

L’attribut minlength définit le nombre minimum de caractères acceptés par le champ de saisie. 
<gcds-input
  minlength="5"
  type="number"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

pattern

L’attribut pattern définit l’expression régulière à laquelle la valeur du champ doit correspondre. 
<gcds-input
  pattern="[A-Z]+"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

readonly

L’attribut readonly contrôle si le champ peut être modifié ou non. Lorsqu’il est défini à true, le champ est en lecture seule. 
<gcds-input
  readonly="true"
  value="Readonly"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

required

L’attribut required contrôle si le champ de saisie 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-input
  required="true"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

size

L’attribut size définit la taille du champ de saisie pour indiquer visuellement la longueur de texte attendue. 
<gcds-input
  size="6"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

step

L’attribut step définit la granularité à laquelle la valeur doit se conformer. Utilisez-le avec le type de saisie numérique. 
<gcds-input
  step="10"
  type="number"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

suggestions

L’attribut suggestions définit un tableau (array) d’options de suggestions. 
<gcds-input suggestions='[{ "label": "Suggestion A"}, { "label": "Suggestion B"}, { "label": "Suggestion C"}]' input-id="input-example" label="Étiquette de champ" name="input-example">
</gcds-input>

type

L’attribut type définit le type de saisie. Les options sont :
  • email
  • number
  • password
  • search
  • tel
  • text
  • url
<gcds-input
  type="email"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

validate-on

L’attribut validate-on définit l’événement de validation pour le champ de saisie. 
<gcds-input
  validate-on="other"
  required="true"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>

value

L’attribut value définit la valeur initiale affichée dans le champ de saisie. Il reflète la valeur actuelle au fil des modifications de l’utilisateur. 
<gcds-input
  value="Texte"
  input-id="input-example"
  label="Étiquette de champ"
  name="input-example"
></gcds-input>
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-06-10