EditText : qu'est-ce que c'est, attributs et travail avec les champs de saisie dans Android

Qu'est-ce qu'EditText dans Android

EditText est une classe du package android.widget qui implémente un champ de texte interactif pour la saisie de données utilisateur. Dans la hiérarchie d'héritage d'Android, EditText étend TextView, donc il hérite de toutes les propriétés d'une étiquette de texte, y compris la gestion des polices, des couleurs et de l'alignement. La principale différence entre EditText et TextView est la capacité d'éditer le contenu — l'utilisateur peut saisir, supprimer et modifier du texte directement dans l'interface.

Chaque EditText est associé à une instance Editable qui stocke le texte saisi et prend en charge les opérations d'insertion, de suppression et de remplacement. Lors de la frappe, EditText gère automatiquement la position du curseur, la sélection de texte et un historique des modifications pour annuler/rétablir. Selon le Guide des développeurs Android (2026), EditText prend également en charge l'autocomplétion via la classe AutoCompleteTextView, qui hérite d'EditText.

L'architecture d'EditText est basée sur la séparation du modèle (Editable), de la vue (TextView) et du contrôleur (InputConnection). En obtenant le focus, EditText crée un InputConnection par lequel le système de saisie transmet les caractères, les pressions de touches et les commandes d'édition. Ce mécanisme garantit la compatibilité avec toute méthode de saisie — des claviers virtuels aux claviers Bluetooth physiques et à la saisie vocale.

val editText = EditText(context).apply {
    hint = "Saisissez le texte"
    inputType = InputType.TYPE_CLASS_TEXT
    maxLines = 1
    setTextColor(Color.parseColor("#000000"))
}

Attributs principaux d'EditText

EditText fournit des dizaines d'attributs pour affiner le comportement et l'apparence. Ils peuvent être définis à la fois dans les mises en page XML et par programmation via Kotlin ou Java. Les attributs sont divisés en catégories : contrôle du texte, contraintes, style visuel et interaction avec le clavier.

L'attribut android:hint est l'un des plus importants — il indique à l'utilisateur quelles données sont attendues dans le champ. Lorsque du texte est saisi, l'indice est automatiquement masqué. L'indice ne participe pas à l'envoi du formulaire et n'est pas enregistré comme valeur du champ. Material Design recommande d'utiliser TextInputLayout avec une étiquette flottante plutôt qu'un simple indice pour une apparence plus moderne.

• android:selectAllOnFocus — sélectionne tout le texte lors de la prise de focus (utile pour les champs de recherche).
• android:maxLength — limite le nombre de caractères saisis, en tronquant l'excédent.
• android:lines — définit une hauteur fixe du champ en lignes (contrairement à minLines).
• android:gravity — alignement du texte dans le champ : left, center, top, etc.

                <!-- EditText in XML layout -->
@+id/etEmail
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:hint="Enter email"
android:inputType="textEmailAddress"
android:maxLines="1"
android:importantForAutofill="yes" />

Modes de saisie et inputType

L'attribut inputType détermine le type de clavier qui sera affiché à l'utilisateur et les caractères autorisés pour la saisie. C'est un masque de bits où la classe de saisie (TYPE_CLASS_TEXT, TYPE_CLASS_NUMBER, TYPE_CLASS_PHONE) est combinée avec des modificateurs.

Chaque mode de saisie non seulement modifie la disposition du clavier mais affecte également le traitement du texte : en mode numérique, seuls les chiffres et les séparateurs décimaux sont autorisés, en mode e-mail, le symbole @ et les extensions de domaine sont disponibles, et en mode téléphone, les chiffres et les symboles +, #, * sont affichés. Le choix du bon inputType affecte considérablement l'expérience utilisateur — un clavier inapproprié oblige les utilisateurs à changer de mode, augmentant le temps de remplissage du formulaire de 30 à 50 %.

Selon les Directives Material Design (2025), il est recommandé d'utiliser l'inputType le plus spécifique pour chaque champ : textPassword pour les mots de passe, numberDecimal pour les prix, phone pour les numéros de téléphone, textMultiLine pour la saisie multiligne. Cela accélère le remplissage des formulaires et réduit les erreurs de saisie.

// Configuration programmatique d'inputType
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_AUTO_CORRECT

Écouteurs d'EditText : TextWatcher et OnEditorActionListener

TextWatcher est une interface pour suivre les modifications de texte dans EditText en temps réel. Elle contient trois méthodes : beforeTextChanged est appelée avant une modification, onTextChanged pendant la modification, afterTextChanged après l'achèvement de la modification du texte. TextWatcher est utilisé pour la validation des saisies, le comptage de caractères, la recherche et l'autocomplétion.

OnEditorActionListener gère les actions de l'utilisateur sur le clavier : appui sur Done (IME_ACTION_DONE), Search (IME_ACTION_SEARCH), Send (IME_ACTION_SEND), Next (IME_ACTION_NEXT) et autres. Cet écouteur est particulièrement utile pour organiser la navigation dans le formulaire — en appuyant sur Next, le focus se déplace automatiquement au champ suivant, et en appuyant sur Done, le clavier est masqué et l'envoi est effectué.

Selon le Blog des développeurs Android (2025), l'utilisation appropriée d'OnEditorActionListener avec l'attribut android:imeOptions permet de créer des formulaires intuitifs sans boutons d'envoi supplémentaires — l'utilisateur remplit les champs et appuie sur Done sur le clavier, ce qui déclenche la sauvegarde ou la recherche.

// TextWatcher pour la validation d'e-mail
editText.addTextChangedListener(object : TextWatcher {
    override fun afterTextChanged(s: Editable?) {
        val isValid = Patterns.EMAIL_ADDRESS.matcher(s).matches()
        editText.error = if (isValid) null else "Invalid email format"
    }
})

// OnEditorActionListener pour l'envoi de formulaire
editText.setOnEditorActionListener { _, actionId, _ ->
    if (actionId == EditorInfo.IME_ACTION_DONE) {
        submitForm()
        true
    } else false
}

Exemples de code avec EditText

Examinons un exemple complet de création d'un écran de connexion utilisant EditText pour la saisie de l'e-mail et du mot de passe. Cet exemple montre la configuration de l'inputType, la validation via TextWatcher et la gestion de l'appui sur le bouton de connexion.

Mise en page XML de l'écran de connexion

@+id/etLoginEmail
android:layout_width="match_parent"
android:hint="Email"
android:inputType="textEmailAddress"
android:maxLines="1" />

@+id/etLoginPassword
android:layout_width="match_parent"
android:hint="Password"
android:inputType="textPassword"
android:maxLines="1" />

Configuration programmatique d'EditText

class LoginFragment : Fragment() {
    private lateinit var etEmail: EditText
    private lateinit var etPassword: EditText

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        etEmail = view.findViewById(R.id.etLoginEmail)
        etPassword = view.findViewById(R.id.etLoginPassword)

        etEmail.addTextChangedListener(emailWatcher)
        etPassword.setOnEditorActionListener { _, actionId, _ ->
            if (actionId == EditorInfo.IME_ACTION_DONE) {
                performLogin()
                true
            } else false
        }
    }
}

Stylisation d'EditText

EditText prend en charge la personnalisation via les attributs XML, les thèmes et les styles. Vous pouvez modifier la couleur du texte, la couleur de l'indice, la couleur du soulignement (backgroundTint), le style de police, la taille du texte et bien plus encore. Material Components fournit le thème MaterialComponents.EditText avec des attributs personnalisés incluant boxStrokeColor, boxBackgroundColor et endIconMode.

Pour modifier la couleur du soulignement d'EditText, utilisez l'attribut android:backgroundTint qui définit la couleur pour les états par défaut et de focus. Dans Material Design, la couleur du soulignement est gérée via le colorPrimary du thème. Pour une personnalisation complète, vous pouvez créer un drawable personnalisé pour l'arrière-plan dans le dossier res/drawable.

Pour créer un style cohérent pour tous les champs EditText dans votre application, il est recommandé de définir un style global dans le thème. Material Design propose le style Widget.MaterialComponents.TextInputLayout.OutlinedBox, qui est automatiquement appliqué à tous les champs de saisie utilisant TextInputLayout. Cela garantit une apparence cohérente sans dupliquer les attributs dans chaque mise en page.