EditText: o que é, atributos e trabalho com campo de entrada no Android

O que é EditText no Android

EditText é uma classe do pacote android.widget que implementa um campo de texto interativo para entrada de dados do usuário. Na hierarquia de herança do Android, EditText estende TextView, portanto herda todas as propriedades de um rótulo de texto, incluindo gerenciamento de fontes, cores e alinhamento. A principal diferença entre EditText e TextView é a capacidade de editar conteúdo — o usuário pode inserir, excluir e modificar texto diretamente na interface.

Cada EditText está associado a uma instância Editable que armazena o texto inserido e suporta operações de inserção, exclusão e substituição. Ao digitar, o EditText gerencia automaticamente a posição do cursor, a seleção de texto e um histórico de alterações para desfazer/refazer. De acordo com o Android Developers Guide (2026), o EditText também suporta autocompletar através da classe AutoCompleteTextView, que herda de EditText.

A arquitetura do EditText é baseada na separação do modelo (Editable), visão (TextView) e controlador (InputConnection). Ao obter foco, o EditText cria um InputConnection através do qual o sistema de entrada passa caracteres, pressionamentos de teclas e comandos de edição. Esse mecanismo garante compatibilidade com qualquer método de entrada — desde teclados virtuais até teclados Bluetooth físicos e entrada por voz.

val editText = EditText(context).apply {
    hint = "Insira o texto"
    inputType = InputType.TYPE_CLASS_TEXT
    maxLines = 1
    setTextColor(Color.parseColor("#000000"))
}

Atributos principais do EditText

EditText fornece dezenas de atributos para ajustar finamente o comportamento e a aparência. Eles podem ser definidos tanto em layouts XML quanto programaticamente via Kotlin ou Java. Os atributos são divididos em categorias: controle de texto, restrições, estilo visual e interação com o teclado.

O atributo android:hint é um dos mais importantes — ele informa ao usuário quais dados são esperados no campo. Quando o texto é inserido, a dica é ocultada automaticamente. A dica não participa do envio do formulário nem é salva como valor do campo. O Material Design recomenda usar TextInputLayout com rótulo flutuante em vez de uma dica simples para uma aparência mais moderna.

• android:selectAllOnFocus — seleciona todo o texto ao obter foco (útil para campos de busca).
• android:maxLength — limita o número de caracteres inseridos, truncando o excesso.
• android:lines — define uma altura fixa do campo em linhas (diferente de minLines).
• android:gravity — alinhamento do texto dentro do campo: 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" />

Modos de entrada e inputType

O atributo inputType determina qual tipo de teclado será mostrado ao usuário e quais caracteres são permitidos para entrada. É uma máscara de bits onde a classe de entrada (TYPE_CLASS_TEXT, TYPE_CLASS_NUMBER, TYPE_CLASS_PHONE) é combinada com modificadores.

Cada modo de entrada não apenas altera o layout do teclado, mas também afeta o processamento do texto: no modo numérico apenas dígitos e separadores decimais são permitidos, no modo e-mail o símbolo @ e extensões de domínio estão disponíveis, e no modo telefone são exibidos dígitos e os símbolos +, #, *. Escolher o inputType correto afeta criticamente a experiência do usuário — um teclado inadequado obriga os usuários a trocar de modo, aumentando o tempo de preenchimento do formulário em 30–50%.

De acordo com as Material Design Guidelines (2025), recomenda-se usar o inputType mais específico para cada campo: textPassword para senhas, numberDecimal para preços, phone para números de telefone, textMultiLine para entrada multilinha. Isso acelera o preenchimento de formulários e reduz erros de entrada.

// Configuração programática de inputType
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_AUTO_CORRECT

Listeners do EditText: TextWatcher e OnEditorActionListener

TextWatcher é uma interface para rastrear alterações de texto no EditText em tempo real. Contém três métodos: beforeTextChanged é chamado antes de uma alteração, onTextChanged é chamado durante a alteração, afterTextChanged é chamado após a conclusão da alteração do texto. O TextWatcher é usado para validação de entrada, contagem de caracteres, busca e autocompletar.

OnEditorActionListener lida com ações do usuário no teclado: pressionar Done (IME_ACTION_DONE), Search (IME_ACTION_SEARCH), Send (IME_ACTION_SEND), Next (IME_ACTION_NEXT) e outras. Este listener é especialmente útil para organizar a navegação do formulário — ao pressionar Next, o foco move-se automaticamente para o próximo campo, e ao pressionar Done, o teclado é ocultado e o envio é realizado.

De acordo com o Android Developers Blog (2025), o uso adequado do OnEditorActionListener com o atributo android:imeOptions permite criar formulários intuitivos sem botões de envio adicionais — o usuário preenche os campos e pressiona Done no teclado, o que aciona o salvamento ou a busca.

// TextWatcher para validação de 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 para envio de formulário
editText.setOnEditorActionListener { _, actionId, _ ->
    if (actionId == EditorInfo.IME_ACTION_DONE) {
        submitForm()
        true
    } else false
}

Exemplos de código com EditText

Vamos ver um exemplo completo de criação de uma tela de login usando EditText para inserir e-mail e senha. Este exemplo demonstra a configuração de inputType, validação através de TextWatcher e manipulação do pressionamento do botão de login.

Layout XML da tela de login

@+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" />

Configuração programática do 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
        }
    }
}

Estilização do EditText

EditText suporta personalização através de atributos XML, temas e estilos. É possível alterar a cor do texto, a cor da dica, a cor do sublinhado (backgroundTint), o estilo da fonte, o tamanho do texto e muito mais. O Material Components fornece o tema MaterialComponents.EditText com atributos personalizados incluindo boxStrokeColor, boxBackgroundColor e endIconMode.

Para alterar a cor do sublinhado do EditText, use o atributo android:backgroundTint, que define a cor para os estados normal e de foco. No Material Design, a cor do sublinhado é gerenciada através do colorPrimary do tema. Para personalização completa, você pode criar um drawable personalizado para o fundo na pasta res/drawable.

Para criar um estilo consistente para todos os campos EditText no seu aplicativo, recomenda-se definir um estilo global no tema. O Material Design oferece o estilo Widget.MaterialComponents.TextInputLayout.OutlinedBox, que é aplicado automaticamente a todos os campos de entrada que usam TextInputLayout. Isso garante uma aparência consistente sem duplicar atributos em cada layout.