Voici l’emplacement du texte du champ Suggestion.
Ici, limite de 200 caractères
Ici, limite de 200 caractères
Les champs de saisie permettent à l’utilisateur de partager des renseignements requis afin d’accomplir une tâche.
Voici l’emplacement du texte du champ Suggestion.
Ici, limite de 200 caractères
Ici, limite de 200 caractères
Utilisez le code ci-dessous pour ajouter cet élément à votre projet. Téléchargez la dernière version de la bibliothèque pour implémenter facilement notre ensemble complet d’éléments.
Effectuer la commande suivante pour installer ce composant.
Importer les éléments suivants dans votre dossier app.module.ts.
<cpc-ds-input-field labelText = "Full name" fieldValue = "This is text" [formControl]="fullNameFormControl" id = 'fullName'> </cpc-ds-input-field>
<cpc-ds-input-field labelText = "Full name" fieldValue = "This is text" [formControl]="disableFullNameFormControl" id = 'fullName'> </cpc-ds-input-field>
<cpc-ds-input-field labelText = "Full name" fieldValue = "This is text" [readOnlyField] = "true" [formControl]="fullNameReadOnlyFormControl" id = 'fullName'> </cpc-ds-input-field>
<cpc-ds-input-field labelText = "Full name" hintText = "Don't disclose personal infos" fieldValue = "This is text" [readOnlyField] = "false" (click)="beep()" [formControl]="fullNameFormControl" id = 'fullName'> </cpc-ds-input-field>
<cpc-ds-input-field labelText = "Password" type="password" id = 'password'> </cpc-ds-input-field>
<cpc-ds-input-field id = 'additionalDetails' inputFormat = "textAreaType" [formControl]="textareaFormControl" labelText = "Additional Information" [showMaxLengthLabel] = "true" [maxchar] = "140"> </cpc-ds-input-field>
Nom | Type | Défaut | Description |
---|---|---|---|
id | string | id |
Identifiant du champ de saisie. |
inputFormat | string |
Deux formats sont disponibles :
Library will show a text field by default. If you want textarea, utilisez inputFormat "textAreaType" |
|
name | string | txt |
Le nom du champ de saisie. |
type | string | text |
Deux types sont disponibles :
|
labelText | string |
Texte de l’étiquette. |
|
hintText | string |
Texte indicatif pour le champ. |
|
readOnlyField | boolean | false |
Rendre le champ en lecture seule. |
showMaxLengthLabel | boolean | false |
Montrer la longueur maximale disponible dans textarea. |
maxchar | number | 120 |
Le nombre de caractères permis dans textarea. |
formControl | Form control |
FormControl pour le champ de saisie. fullNameFormControl = new FormControl({ value: 'TEST', disabled: false }, [Validators.required]); |
|
(click) | event |
Appelez votre méthode click event (événement click).
|
Importer les éléments suivants dans votre thème ou votre page.
<script src="[JS-PLACE-HOLDER]"></script>
<label for="fullname">Full name</label> <input id="fullname" type="text" autocomplete="off">
<label for="error">Full name *</label> <input aria-required="true" aria-invalid="true" aria-describedby="errMsg2" id="error" type="text" class="error" autocomplete="off"> <div id="errMsg2" class="ds-error">Error message goes here</div>
<label id="fullnameHint">Full name</label> <p id="hintText" class="hintText">Hint text goes here</p> <input type="text" autocomplete="off" aria-labelledby="fullnameHint hintText">
<!-- Read Only --> <label for="fullnameReadonly">Full name</label> <input id="fullnameReadonly" readonly value="Read only text here" type="text" autocomplete="off">
<label for="disabled">Full name</label> <input aria-disabled="true" disabled id="disabled" class="disabled" type="text" autocomplete="off">
<label for="textarea" id="textarea-label"> Additional Information </label> <textarea id="textarea" maxLength="102" aria-labelledby="textarea-label textarea-maxCharacter"> </textarea> <p id="textarea-maxCharacter" class="maxCharacter"> 102 Character limit here </p>
<label for="textarea2" id="textarea2-label"> Additional Information </label> <textarea aria-invalid="true" aria-describedby="errMsg" aria-labelledby="textarea2-label textarea2-maxCharacter" id="textarea2" class="error" maxLength="10"> </textarea> <p aria-live="polite" id="textarea2-maxCharacter" class="maxCharacter"> 10 Character limit here </p> <div id="errMsg" class="ds-error"> Error message goes here </div>
Les champs de saisie permettent aux utilisateurs de soumettre des données exclusives ou complexes.
De courts champs de saisie sont utiles pour les noms, les adresses ou tout autre élément d’information exclusif à chaque utilisateur.
Les champs de saisie longs (appelés zones de texte) sont tout indiqués pour recueillir des réponses qualitatives ou des données complexes.
Lorsqu’un utilisateur saisit un mot de passe, celui-ci doit être masqué, à moins qu’il choisisse de le révéler. Pour obtenir plus de renseignements, consultez la page intitulée Formulaires.
Tenez compte de la quantité et du type de renseignements demandés au moment de déterminer la longueur du champ. Alignez les étiquettes dans le haut et à gauche du champ de saisie pour permettre aux utilisateurs de les lire rapidement.
Les champs de saisie sont des composants de grande taille et occupent d’ordinaire la majeure partie d’un formulaire. Il s’agit d’un élément important à prendre en considération lors de la structuration des formulaires. Consultez la page intitulée Formulaires pour apprendre comment les intégrer de façon stratégique.
Le texte d’assistance est un moyen efficace d’influencer les réponses des champs, mais il n’est pas toujours utile. Tenez compte de la valeur du texte d’assistance que vous intégrez à votre conception. Si vous n’êtes pas en mesure de justifier son ajout, supprimez-le!
Les champs de saisie peuvent avoir les états par défaut, de mise en évidence, actif et d’erreur.
Lors de la validation du formulaire, des messages d’erreur s’affichent lorsque l’utilisateur a fourni des renseignements inexacts ou n’a pas respecté au moins une exigence. Fournissez le contexte afin que l’utilisateur puisse corriger ses erreurs. Apprenez-en davantage sur la validation des formulaires par rapport à la validation en temps réel.
Si un utilisateur doit saisir des renseignements selon un format précis, veuillez l’indiquer clairement. Ne vous fiez pas seulement au texte d’espace réservé, car il disparaît rapidement et n’est pas toujours lu par les technologies d’assistance. Plutôt, expliquez les exigences de formatage à l’aide d’un texte explicatif sous le champ.
De nombreux champs de saisie prennent en charge une variété de formats de saisie, traduisant de façon automatique les données en une structure formelle au moment de la soumission. Par exemple, lors de la saisie d’un code postal, les utilisateurs peuvent choisir n’importe quelle combinaison de majuscules, de minuscules, d’espace, d’absence d’espace et de tiret. Ces données sont validées après la soumission, « traduites » dans le format approprié, puis saisies par votre formulaire. Dans de tels cas, il n’est pas nécessaire d’indiquer une exigence relative à un formatage précis.
Utilisez les étiquettes de champ pour vous assurer que les champs de saisie sont annoncés lorsqu’ils sont mis en évidence.
Les technologies d’assistance ne traitent pas le texte d’espace réservé comme des étiquettes. Certains ne sont pas pris en charge et ne sont pas affichés dans les anciens navigateurs Web. Les utilisateurs pourraient même penser que le formulaire est déjà rempli.
Dans la mesure du possible, écrasez un texte explicatif sur le texte d’espace réservé. Fournissez les renseignements dont l’utilisateur a besoin pour remplir le formulaire.
Écrivez les étiquettes de champs de saisie en langage clair. Indiquez aux utilisateurs ce qu’ils doivent saisir dans les champs.
Lignes directrices | Exemples | |
---|---|---|
Longueur recommandée | 1 à 3 mots pour les étiquettes | Date |
Saut de ligne | À éviter | Nom |
Formulation | Un nom ou un groupe de mots qui agit comme une unité | Code de promotion |
Majuscule | Majuscule en début de phrase | Autres directives pour le ramassage |
Pour les formulaires avec cinq champs différents ou plus (champs obligatoires et facultatifs), il est utile d’ajouter l’énoncé suivant.
« Tous les champs doivent être remplis, à moins qu'ils ne soient facultatifs. »
Ajoutez le mot « (facultatif) » entre parenthèses à côté de l’étiquette d’un champ de saisie facultatif.
Utilisez des exemples pour compléter les étiquettes de champs de saisie lorsque des précisions pourraient être utiles. La microcopie supplémentaire peut indiquer la façon de formater les entrées dans les champs et aider les utilisateurs à voir rapidement ce qu’ils doivent saisir. Donner des exemples aux utilisateurs peut améliorer l’efficacité et les aider à éviter les erreurs.
Rédigez des messages d’erreur qui mettent l’accent sur les instructions et la façon dont les utilisateurs peuvent régler rapidement le problème pour poursuivre. Les messages d’erreur doivent être utilisés pour informer les utilisateurs, plutôt que de seulement fournir des commentaires négatifs. Le ton des messages d’erreur doit être poli et constructif. Vous pouvez offrir une solution de rechange au moyen d’un lien, s’il est possible que l’utilisateur ait besoin d’autre chose. Évitez les codes de message d’erreur, utilisez un langage clair et limitez le texte.
Utilisez des messages d’erreur accessibles qui sont visibles pour la technologie d’assistance et redirigent les utilisateurs vers les entrées correspondantes. S’il y a plusieurs erreurs, ajoutez un aperçu des messages d’erreur qui mènera l’utilisateur aux erreurs.
Veuillez noter que ce composant pourrait nécessiter un élément de style supplémentaire.
<matInput>
est une directive qui permet aux éléments <input>
et <textarea>
natifs de fonctionner avec <mat-form-field>
.
Veuillez noter que ce composant pourrait nécessiter un élément de style supplémentaire.
Pour créer un champ de saisie, utilisez les éléments de zone Textbox ou Text dans la trousse d’outils à droite.
Les styles de ces éléments devraient être appliqués automatiquement ainsi que les styles de leurs états d’erreur.
La trousse d’outils Mendix se trouve ici.
Lorsque le champ de saisie est mis en évidence :
Les attributs de saisie automatique facilitent la tâche des personnes qui ont une dextérité réduite ou une incapacité cognitive. Pour en savoir plus, veuillez consulter la liste complète des types de saisie automatique HTML 5.2 (en anglais seulement – lien partagé avec l’autorisation de W3C).
Les personnes qui utilisent un lecteur d’écran doivent être en mesure de connaître la limite de caractère de la zone de texte. Voici la meilleure façon de procéder :
Les rôles et propriétés WAI-ARIA suivants peuvent être associés aux champs de saisie et aux éléments de la zone de texte :
Au moment de tester un champs de saisie, la personne effectue le test doit s’assurer de ce qui suit :