Textarea
Zone de texte multiligne
Un contrôle étiqueté pour saisir ou modifier un texte libre sur plusieurs lignes.
Avec vos mots
Ce que les gens décrivent
Alias documentés : champ multiligne, zone de commentaire, saisie de texte long
- une grande zone pour écrire un message
- saisir plusieurs lignes de retour
- un champ de commentaire qui peut grandir
- écrire une description avec des retours à la ligne
- une zone redimensionnable pour des notes
- afficher un compteur sous une longue réponse
Essayer
Saisir du texte
Comparer les trois comportements
Scénario comparatif partagé : Un formulaire recueille du texte, la longueur du contenu et l'intention d'envoi déterminant le contrôle de saisie approprié.
Ce contexte reste fixe. Changez de concept pour observer la mission, le cas limite et le spécimen propres à chaque comportement.
Zone de texte multiligne
Textarea accepte les retours à la ligne et un contenu libre long ; Text field tient sur une ligne, tandis que Search field envoie une requête.
Votre mission
Écrire deux paragraphes, redimensionner le champ, dépasser la limite et corriger sans perdre le brouillon.
Cas limite à vérifier
À la limite, la saisie et le collage sont traités de façon cohérente et une erreur précise reliée conserve tout le brouillon.
Mission
Zone de texte - Textarea
Écrire deux paragraphes, redimensionner le champ, dépasser la limite et corriger sans perdre le brouillon.
Parties du spécimen
Sélectionnez un repère directement sur le spécimen, ou utilisez la liste ci-dessous, pour afficher son rôle. Masquez les repères pour manipuler librement le labo.
Libellé
Le texte persistant qui nomme un contrôle ou un champ.
À utiliser quand
- Recueillir un message, une note ou une description
- Permettre des paragraphes pertinents
À éviter quand
- La valeur doit rester sur une courte ligne
- L'utilisateur a besoin de mise en forme riche
Comparer les concepts proches
Build pack
Transformer ce concept en prompt utile
Choisissez la tâche et la destination. Les noms techniques restent en anglais.
Détails techniques
Comportements
Saisir plusieurs lignes
Entrée insère une nouvelle ligne, et le contrôle peut grandir ou défiler sans masquer son libellé.
Expliquer la validation
Un message précis dans le contexte identifie le champ invalide et explique comment le corriger.
États
Brouillon dans la limite
Brouillon dans la limite
Brouillon au-delà de la limite
Brouillon au-delà de la limite
Transitions d’état
Brouillon dans la limite → Brouillon au-delà de la limite
La saisie ou le collage porte le brouillon multiligne conservé au-delà de 500 caractères.
Brouillon au-delà de la limite → Brouillon dans la limite
La modification du brouillon conservé à 500 caractères ou moins résout l’erreur reliée.
Scénarios de test
- Contexte
- Un formulaire d'assistance recueille une description du problème limitée à 500 caractères.
- Mission
- Écrire deux paragraphes, redimensionner le champ, dépasser la limite et corriger sans perdre le brouillon.
- État principal
- La valeur multiligne, l'aide et le compteur restent lisibles à 200 % de zoom.
- Cas limite
- À la limite, la saisie et le collage sont traités de façon cohérente et une erreur précise reliée conserve tout le brouillon.
Accessibilité
- Role
- native multiline textbox
- Nom accessible
- Le contrôle principal ou la région nommée possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
- Focus
- Le focus visible entoure le contrôle et reste perceptible pendant le défilement du texte.
- Fermeture
- Sans objet : le brouillon reste jusqu'à sa réinitialisation, son envoi ou son effacement volontaire.
- Scroll
- Le champ actif, le texte d'aide et le message de validation restent visibles lorsque la page ou un clavier virtuel modifie la zone d'affichage.
- Annonce
- Le libellé, le rôle multiligne, l'aide, la limite, l'état invalide et l'erreur sont exposés sans annoncer chaque caractère.
- Clavier
- Tab focalise la zone
- Entrée insère une nouvelle ligne
- Les raccourcis natifs de saisie et défilement restent disponibles
Bindings
label with textarea
- implementationKind
- native
- nativeElement
- label with textarea
- ariaPattern
- textbox
- radixPrimitive
- Non applicable
- shadcnRecipe
- Non applicable
- runtimeDependency
- Non applicable
- packageName
- Non applicable
- exportName
- Non applicable
- exactVersion
- Non applicable
- status
- verified
- verifiedAt
- 2026-07-16
- deprecationStatus
- active
- replacement
- Non applicable
- validFrom
- Non applicable
- validUntil
- Non applicable
Limite d’équivalence : The native multiline control preserves Enter for line breaks, resize behavior, and form semantics while labels and errors stay associated.
Vérifier la source du binding
Sources
- WHATWG HTML: The textarea element
WHATWG · standard · 2026-07-16
Affirmation couverte : Textarea: native multiline text entry, labeling, value, wrapping, and form participation.
- WHATWG HTML: Forms
WHATWG · standard · 2026-07-16
Affirmation couverte : Textarea: native form controls, labels, submission, validation, and disabled-state behavior.
Vérifié le 2026-07-16 · rev. 1
- Responsable
- SkillCodex Editorial
- Statut
- review
- Relecture
- Independent editorial review pending
- Prochaine revue
- 2026-10-16
- Publication
- Non publiée
- Historique
- Brouillon initial sourcé du MVP, en attente de relecture indépendante.