Zone de texte

L’acteur Zone de texte permet de renseigner du texte, il est généralement utilisé pour écrire du texte brut.

Sommaire

🔧 propriété · ℹ️ information · ⚙️ méthode · ⚡ évènement · 🔒 lecture seule

Propriétés

Actif?

this.properties.enabled · boolean · défaut true · modifie : Style CSS

Permet d’activer / désactiver le champ de saisie.

Auto complétion?

this.properties.autocomplete · boolean · défaut false

Activation de l’auto-complétion.

Permet d’activer / désactiver la saisie automatique sur les navigateurs.

État de validation

this.properties.validationState · 'default' | 'valid' | 'invalid' · défaut 'default' · modifie : Gabarit

État de validation de l’acteur.

Permet de donner une décoration prédéfinie au champ de saisie.

Lecture seule?

this.properties.isReadOnly · boolean · défaut false

En lecture seule ?

Permet d’activer / désactiver la saisie de valeur dans le champ de saisie.

Longueur max

this.properties.maxLength · string · défaut null

Longueur maximum du texte en nombre de caractère. Par défaut, il n’y a pas de limite (=null).

Permet de limiter la taille de la chaine de caractère de Valeur.

Le caractère vide ‘espace’ est comptabilisé comme tout autre caractère.

Retaille

this.properties.resize · 'both' | 'vertical' | 'horizontal' | 'none' · défaut 'vertical'

Mode de redimensionnement de la zone de texte.

Taille

this.properties.size · 'default' | 'large' | 'small' · défaut 'default' · modifie : Taille

Taille de l’acteur.

La propriété spécifique Taille permet de changer celle de l’acteur.

Cette propriété possède trois options :

  • Par défaut.
  • Grand.
  • Petit.

Seul le choix par défaut vous laisse la possibilité de modifier la taille du texte. Les autres options prennent le pas sur tout autre réglage.

Texte si vide

this.properties.placeHolder · string · défaut ''

Chaîne de remplacement lorsque l’acteur est vide.

Valeur

this.properties.value · string · défaut '' · modifie : Taille

Texte. Accepte des retour à la ligne et tabulation.

La propriété spécifique Valeur permet de définir la valeur actuelle de l’acteur.

La valeur attendue est un une chaine de caractère.

Il n’est pas possible de décorer le texte au sein de cet acteur, pour ajouter de la décoration au texte il est préférable d’utiliser un acteur HTML.

Hérite de

Outre ce qui est décrit ici, l’acteur a tout ce que décrit l’acteur de base : propriétés communes (taille, disposition, aspect, texte, bordures, effets…), évènements communs (cycle de vie, souris, clavier…) et membres accessibles par script.

Il hérite aussi de :

  • InputBase : Base pour les acteurs de saisie.