Skip to content
Material Design 1
Main Navigation
v3
v2
v1

Português – Brasil

English
简体中文
繁體中文
Español
Français
Русский
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Português – Brasil

English
简体中文
繁體中文
Español
Français
Русский
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Aparência

Sidebar Navigation

Material Design

Ambiente

Propriedades do material

Elevação e sombras

Novidades

Movimento

Movimento do Material Design

Duração e easing

Movimento

Transformação do material

Coreografia

Personalização criativa

Estilo

Cor

Ícones

Imagens

Tipografia

Escrita

Layout

Princípios

Unidades e medidas

Métricas e linhas-chave

Estrutura

UI Responsiva

Tela dividida

Componentes

Navegação inferior

Folhas inferiores

Botões

Botões: Botão de ação flutuante

Cartões

Chips

Tabelas de dados

Diálogos

Divisores

Painéis de expansão

Listas em grade

Listas

Listas: Controles

Menus

Seletores

Progresso e atividade

Controles de seleção

Controles deslizantes

Snackbars e toasts

Steppers

Subcabeçalhos

Abas

Campos de texto

Barras de ferramentas

Tooltips

Widgets

Padrões

Confirmação e aviso de conclusão

Formatos de dados

Estados vazios

Erros

Impressão digital

Gestos

Ajuda e feedback

Telas de inicialização

Carregamento de imagens

Navegação

Gaveta de navegação

Transições de navegação

Notificações

Estados offline

Permissões

Técnicas de rolagem

Pesquisa

Seleção

Configurações

Deslizar para atualizar

Crescimento e comunicações

Introdução

Onboarding

Descoberta de recursos

Educação sobre gestos

Usabilidade

Acessibilidade

Bidirecionalidade

Plataformas

Adaptação de plataforma

Android

Recursos

Paletas de cores

Dispositivos

Modelos de layout

Fontes Roboto e Noto

Folhas de adesivos e ícones

Sombras

Nesta página

Campos de texto ​

Os campos de texto permitem que os usuários insiram, editem e selecionem texto.

Os campos de texto normalmente aparecem em formulários, mas também podem ser usados em outros contextos, como diálogos e pesquisas.

Uso

Os campos de texto validam a entrada, ajudam os usuários a corrigir erros, preenchem palavras automaticamente e oferecem sugestões.


Tipos de campo

Campo de linha única
Campo de várias linhas
Área de texto


Tipos de entrada

Entradas formatadas
Menus e seletores aninhados

Campos de texto do Material Design para entrada e edição de texto pelo usuário

Princípios ​

Os campos de texto devem ter as seguintes características:

Identificável

Por meio de um alvo de toque, os campos de texto devem indicar que os usuários podem inserir informações.

Localizável

Deve ser fácil encontrar um campo de texto entre os outros elementos da interface.

Legível

Os campos de texto devem indicar seu estado – habilitado ou desabilitado, vazio ou preenchido, válido ou inválido – com rótulo, texto de entrada e texto de ajuda claros.

Layout ​

Os campos de texto contêm os seguintes elementos:

Rótulo

Os rótulos dos campos de texto indicam o tipo de informação que o campo espera receber. Todo campo de texto deve ter um rótulo.

Os rótulos ficam alinhados com a linha de entrada e estão sempre visíveis. Podem estar em repouso (quando o campo está inativo e vazio) ou flutuantes.

Texto de rótulo em repouso do Material Design
Texto de rótulo em repouso
Espaçamento superior: 16dp
Espaçamento inferior: 8dp
Texto de rótulo flutuante do Material Design
Texto de rótulo flutuante
Espaçamento acima do rótulo: 16dp
Espaçamento abaixo do rótulo: 8dp
Espaçamento abaixo da entrada: 8dp

Linha de entrada

A linha de entrada, exibida abaixo do rótulo, indica onde o texto deve ser inserido.

Quando o campo está ativo ou contém um erro, a cor e a espessura da linha mudam.

Material Design: Rótulos acima da linha quando o campo de texto está vazio
Os rótulos ficam em repouso acima da linha enquanto o campo de texto está vazio.
Material Design: Os rótulos flutuam quando o campo está em foco ou preenchido
Os rótulos flutuam para cima quando o campo de texto está em foco ou preenchido.

Cursor

O cursor indica a posição atual em que o usuário está digitando.

Cursor alinhado ao rótulo até a entrada do usuário no Material Design
O cursor fica alinhado ao rótulo até que o usuário comece a digitar.

Texto de entrada

O texto digitado em um campo de texto é chamado de texto de entrada.

A primeira letra do texto de entrada (e a de cada frase no campo) deve ser maiúscula quando apropriado. Por exemplo, texto que:

  • Designa algo, como um alarme
  • Contém frases, como uma mensagem de texto
Design de campo de entrada ativo no Material Design
Texto de entrada em um campo ativo
Texto de entrada do Material Design
Texto de entrada
Espaçamento superior: 8dp
Espaçamento inferior: 8dp

O texto de entrada pode ser combinado com o preenchimento automático para ajudar usuários com alfabetização limitada ou que escrevem em um idioma estrangeiro. Por exemplo, o preenchimento automático pode:

  • Sugerir texto conforme o usuário digita (atualizando as sugestões a cada tecla pressionada)
  • Preencher o campo com um texto de entrada padrão

Pressionar a tecla Enter aceita a sugestão de preenchimento automático exibida no momento.

Reduzir a opacidade do texto sugerido no Material Design
O texto sugerido é exibido com opacidade reduzida, enquanto o texto digitado permanece com opacidade total.

Texto de espaço reservado (texto de dica)

O texto de espaço reservado permanece no campo até que o usuário comece a inserir texto. Ele pode indicar uma ação ou fornecer um exemplo, como um número de telefone ou um endereço de e-mail.

Texto de espaço reservado do Material Design para campos vazios
O texto de espaço reservado pode ser exibido em um campo de texto vazio até que o usuário insira texto.
Texto de espaço reservado do Material Design
Texto de espaço reservado
Espaçamento acima do rótulo: 16dp
Espaçamento acima do texto de espaço reservado: 8dp
Espaçamento abaixo do texto de espaço reservado: 8dp

Texto de ajuda

O texto de ajuda fornece contexto sobre a entrada do campo, como a finalidade com que a informação será usada.

Ele pode ficar visível de forma persistente ou aparecer apenas quando o campo estiver em foco.

Especificações:

  • Alinhado à esquerda
  • Em uma única linha, sempre que possível, ou com quebra de texto (caso ocupe várias linhas)
Texto de ajuda para contexto abaixo dos campos de texto no Material Design
O texto de ajuda pode fornecer contexto adicional abaixo do campo de texto.
Texto de ajuda do Material Design
Texto de ajuda
Espaçamento acima do texto de ajuda: 8dp
Texto de ajuda do Material Design orienta o usuário com textos de espaço reservado
O texto de ajuda pode complementar o texto de espaço reservado para orientar o usuário.

Mensagem de erro

Quando a entrada não é aceita, os campos de texto podem exibir uma mensagem de erro abaixo da linha de entrada, com instruções sobre como corrigir o problema. Enquanto o erro não for corrigido, a mensagem de erro substitui o texto de ajuda.

Uma mensagem de erro deve caber em uma única linha, sempre que possível.

Mensagem de erro do Material Design orientando o usuário a corrigir a entrada
Uma mensagem de erro orienta o usuário a corrigir uma entrada inválida.
Mensagem de erro do Material Design
Mensagem de erro
Espaçamento acima da mensagem de erro: 8dp

Uma mensagem de erro é precedida pela palavra “Erro” (ou por um ícone de erro) para que o estado de erro fique mais evidente também para usuários daltônicos.

Mensagem de erro no formato do Material Design
O termo “Erro:” (incluindo os dois-pontos) precede a mensagem de erro
Ícone de erro do Material Design com mensagem
Ícone de erro na mesma linha da mensagem de erro

Campo obrigatório

Para indicar que um campo é obrigatório, exiba um asterisco (*) ao lado do rótulo do campo. Na parte inferior do formulário, informe que os asteriscos indicam campos obrigatórios.

Material Design: Asterisco de campo obrigatório em campo vazio
Indicador de campo obrigatório (asterisco) em um campo de texto vazio
Material Design: Asterisco de campo obrigatório em campo de texto preenchido
Indicador de campo obrigatório (asterisco) em um campo de texto preenchido.

Para indicar que um campo é opcional, exiba a palavra “opcional” entre parênteses ao lado do rótulo do campo.

Texto indicador de campo opcional para campo vazio no Material Design
Texto indicador de campo opcional em um campo de texto vazio
Texto indicador de campo opcional do Material Design em campo de texto
Texto indicador de campo opcional em um campo de texto preenchido

Em formulários com alguns campos obrigatórios, marque todos eles como obrigatórios. No entanto, se houver menos campos opcionais, marque apenas esses.

Formulário do Material Design com nome e CEP obrigatórios
Nome e CEP são os únicos campos obrigatórios do formulário.
Campo de descrição opcional em formulário do Material Design
Descrição é o único campo opcional do formulário.

Contador de caracteres ou palavras

Use contadores de caracteres ou palavras quando houver um limite de caracteres ou de palavras.

Especificações:

  • Alinhado à direita
  • Exibido como uma proporção entre os caracteres usados e o limite (formato: caracteres usados / limite de caracteres)
Material Design: 5 de 10 caracteres inseridos
O contador de caracteres mostra que 5 dos 10 caracteres permitidos já foram inseridos.
Contador de caracteres do Material Design
Contador de caracteres
Espaçamento abaixo da linha de entrada de texto: 8dp

Ícone indicador

Os ícones indicam o tipo de informação que o campo de texto espera receber. Eles são exibidos à esquerda do campo.

Os ícones também podem funcionar como alvos de toque para componentes aninhados. Por exemplo, ao tocar em um ícone de calendário, um seletor de data é exibido.

Ícone de calendário para inserção de data no Material Design
Um ícone de calendário indica que o campo de texto serve para inserir uma data.
Ícone indicador do Material Design
Ícone indicador
Largura: 24dp
Espaçamento entre o ícone indicador e o rótulo: 16dp

Ícone de entrada por voz

Um ícone de microfone indica que os usuários podem inserir texto usando a voz.

Os ícones de entrada por voz ficam alinhados à direita e estão sempre habilitados.

Ícone de entrada por voz para usuários do Material Design
Ao tocar no ícone, os usuários podem inserir texto usando a voz.
Ícone de entrada por voz para o Material Design
Ícone de entrada por voz
Largura: 24dp
Espaçamento abaixo do ícone: 8dp

Ícone do menu suspenso

Uma seta de menu suspenso indica que o campo de texto contém seleções aninhadas.

Menu suspenso do Material Design expande o componente de seleção aninhado
Ao tocar na seta do menu suspenso, o componente de seleção aninhado é expandido.
Contêiner da seta do menu suspenso do Material Design
Contêiner da seta do menu suspenso
Largura: 24dp
Altura: 24dp
Espaçamento abaixo do ícone: 8dp

Botão de limpar

Os botões de limpar permitem que os usuários apaguem todo o conteúdo de um campo de entrada.

Eles ficam alinhados à direita dentro do campo.

Ícone de limpar aparece com caracteres no Material Design
O ícone de limpar fica habilitado quando o campo contém caracteres digitados.
Ícone de limpar no Material Design
Ícone de limpar
Largura: 24dp
Altura: 24dp
Espaçamento abaixo do ícone: 8dp

Em formulários com muitos campos ou com campos muito próximos entre si, os campos de texto podem usar um formato mais compacto.

Especificações:

  • Texto de entrada: 13sp
  • Reduzir o espaço entre o rótulo e o texto de entrada
  • Reduzir em 50% o espaço entre a linha de entrada e o texto de ajuda
Espaçamento normal no Material Design
Espaçamento normal
Espaçamento acima do rótulo: 16dp
Espaçamento abaixo do rótulo: 8dp
Espaçamento acima da linha de entrada de texto: 8dp
Espaçamento abaixo da linha de entrada de texto: 8dp
Espaçamento compacto no Material Design
Espaçamento compacto
Espaçamento acima do rótulo: 8dp
Espaçamento abaixo do rótulo: 4dp
Espaçamento acima da linha de entrada de texto: 8dp
Espaçamento abaixo da linha de entrada de texto: 4dp

Estados ​

Os campos de texto têm dois estados principais: habilitado e desabilitado.

No estado habilitado, as seguintes interações do usuário estão disponíveis:

  • Ocioso
  • Hover (passar o cursor)
  • Pressionado
  • Em foco

A entrada de um campo de texto pode ser:

  • Vazia ou preenchida
  • Válida ou inválida
Estados dos campos de texto nos temas claro e escuro do Material Design
Estados dos campos de texto nos temas claro e escuro

Estados dos campos de texto ​

Habilitado

Por padrão, os campos de texto habilitados ficam vazios.

Especificações

  • Os rótulos têm 8dp de espaçamento acima da linha de entrada
  • O texto do rótulo tem o mesmo tamanho do texto de entrada

Acessibilidade

A linha deve ter uma razão de contraste de 3:1 para facilitar a identificação, o mesmo padrão de acessibilidade AA aplicado a textos grandes.

Campo de texto habilitado no tema claro do Material Design
Tema claro

Linha inferior
  • Espessura: 1dp
  • Cor: 42% preto (razão de contraste 3:1)

Texto do rótulo

  • Fonte: Roboto 16sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 16dp superior, 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 16dp à esquerda, 8dp superior
Campo de texto habilitado no tema escuro do Material Design
Tema escuro

Linha inferior
  • Espessura: 1dp
  • Cor: 70% branco (razão de contraste 7:1)

Texto do rótulo

  • Fonte: Roboto 16sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 16dp superior, 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 16dp à esquerda, 8dp superior

Desabilitado

Os campos de texto desabilitados não podem ser editados. Eles exibem uma linha de entrada pontilhada e têm opacidade reduzida, para parecerem menos tocáveis.

Campo de texto desabilitado no tema claro do Material Design
Tema claro

Linha inferior
  • Espessura: 1dp
  • Cor: 42% preto
  • Pontilhada

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 38% preto (razão de contraste 2.21:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 38% preto (razão de contraste 2.21:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior
Campo de texto desabilitado no tema escuro do Material Design
Tema escuro

Linha inferior
  • Espessura: 1dp
  • Cor: 70% branco
  • Pontilhada

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 50% branco (razão de contraste 4.5:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 50% branco (razão de contraste 4.5:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior

Interações do usuário ​

Hover (passar o cursor)

No estado de hover, a opacidade da linha de entrada aumenta, tornando os campos de texto mais perceptíveis em desktops.

Tema claro

Linha inferior
  • Espessura: 2dp
  • Cor: 87% preto (razão de contraste 15:1)

Texto do rótulo

  • Fonte: Roboto 16sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior
Tema escuro

Linha inferior
  • Espessura: 2dp
  • Cor: 100% branco (razão de contraste 13:1)

Texto do rótulo

  • Fonte: Roboto 16sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior

Pressionar

Ao tocar no campo, o rótulo se reduz e flutua para cima, revelando o cursor e qualquer texto de espaço reservado.

Para sinalizar que o campo está ativo, a cor primária da interface é aplicada à linha de entrada, ao texto do rótulo e ao cursor.

Tema claro

Linha inferior
  • Espessura: 2dp
  • Cor: 100% da cor primária (Escuro A700)
  • Movimento: ondulação (ripple) e esmaecimento (wash)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 87% da cor primária (Escuro A700)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de espaço reservado (opcional)

  • Fonte: Roboto 16sp
  • Cor: 42% preto (razão de contraste 3:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior
Tema escuro

Linha inferior
  • Espessura: 2dp
  • Cor: 100% da cor primária (Claro A200)
  • Movimento: ondulação (ripple) e esmaecimento (wash)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 100% da cor primária (Claro A200)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de espaço reservado (opcional)

  • Fonte: Roboto 16sp
  • Cor: 50% branco (razão de contraste 4.5:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior

Foco

Conforme o usuário digita no campo de texto, o texto de entrada substitui o texto de espaço reservado. O texto preenchido automaticamente é exibido à direita do cursor, com o mesmo tamanho de fonte e a mesma cor do texto de espaço reservado.

Campo de texto em foco no tema claro do Material Design
Tema claro

Linha inferior
  • Espessura: 2dp
  • Cor: 100% da cor primária (Escuro A700)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 87% da cor primária (Escuro A700)
  • Espaçamento: 16dp superior e 8dp inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 87% preto (razão de contraste 15:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior
Tema escuro

Linha inferior
  • Espessura: 2dp
  • Cor: 100% da cor primária (Claro A200)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 100% da cor primária (Claro A200)
  • Espaçamento: 16dp superior e 8dp inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 100% branco (razão de contraste 13:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior

Entrada do campo de texto ​

Ocioso e preenchido

Quando o usuário move o foco para outro elemento, o texto de entrada permanece visível no campo.

Campo de texto no tema claro do Material Design
Tema claro

Linha inferior
  • Espessura: 1dp
  • Cor: 42% preto (razão de contraste 3:1)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 16dp superior e 8dp inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 87% preto (razão de contraste 15:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 54% preto (razão de contraste 4.5:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior
Campo de texto no tema escuro do Material Design
Tema escuro

Linha inferior
  • Espessura: 1dp
  • Cor: 70% branco (razão de contraste 7:1)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 16dp superior e 8dp inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 100% branco (razão de contraste 13:1)
  • Espaçamento: 8dp inferior, alinhado à linha inferior

Texto de ajuda (opcional)

  • Fonte: Roboto 12sp
  • Cor: 70% branco (razão de contraste 7:1)
  • Espaçamento: 8dp superior, alinhado à linha inferior

Conteúdo do campo de texto ​

Erro

Se uma entrada for inválida, uma mensagem de erro é exibida quando o usuário move o foco para outro elemento. Para indicar o erro, a linha de entrada e o rótulo usam uma tonalidade mais quente, como vermelho ou laranja.

Especificações

  • Exibir uma mensagem de erro abaixo do campo de texto, substituindo qualquer texto de ajuda
  • Indicar brevemente o motivo do erro e como corrigi-lo
  • Colocar a palavra “Erro” (ou um ícone de erro) antes da mensagem
  • Remover o erro assim que o usuário o corrigir
Campo de texto com erro no tema claro do Material Design
Tema claro

Linha inferior
  • Espessura: 2dp
  • Cor: 100% vermelho (A400)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 100% vermelho (A400)
  • Espaçamento: 16dp superior e 8dp inferior, alinhado à linha inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 87% preto (razão de contraste 15:1)
  • Espaçamento: 16dp à esquerda, 8dp inferior

Texto de erro

  • Fonte: Roboto 12sp
  • Cor: 87% vermelho (A400)
  • Espaçamento: 8dp superior, alinhado à linha inferior
Tema escuro

Linha inferior
  • Espessura: 2dp
  • Cor: 100% vermelho (A400)

Texto do rótulo

  • Fonte: Roboto 12sp
  • Cor: 100% vermelho (A400)
  • Espaçamento: 16dp superior e 8dp inferior, alinhado à linha inferior

Texto de entrada

  • Fonte: Roboto 16sp
  • Cor: 100% branco (razão de contraste 13:1)
  • Espaçamento: 16dp à esquerda, 8dp inferior

Texto de erro

  • Fonte: Roboto 12sp
  • Cor: 100% vermelho (A400)
  • Espaçamento: 8dp superior, alinhado à linha inferior

Tipos de campo ​

Existem vários tipos de campos de texto:

  • Campo de linha única
  • Campo de várias linhas
  • Área de texto

Campos de linha única

Quando o texto inserido é mais longo do que a linha de entrada, ele rola automaticamente para a esquerda conforme o cursor se aproxima da borda direita do campo.

O texto de entrada rola para a esquerda conforme o cursor alcança a extremidade direita de um campo de texto de linha única.
Campos de texto de linha única no Material Design
Campos de texto de linha única
Campos de texto de linha única no Material Design
Campos de texto de linha única

Campos de várias linhas

Os campos de texto de várias linhas quebram o texto em uma nova linha, expandindo a parte inferior do campo e deslocando para baixo os elementos abaixo dele na tela.

Esses campos permitem que os usuários visualizem tudo o que inseriram de uma só vez.

O texto de entrada quebra em uma nova linha, tornando o campo mais alto, conforme o cursor alcança a extremidade direita do campo.
Campo de texto de várias linhas do Material Design
Campo de texto de várias linhas
Campo de texto de várias linhas do Material Design
Campo de texto de várias linhas

Área de texto

As áreas de texto são mais altas do que os campos de texto e quebram o texto excedente em novas linhas. Elas rolam verticalmente quando o cursor alcança a parte inferior do campo.

O texto de entrada rola para cima conforme o cursor alcança a parte inferior direita da área de texto.
Área de texto da caixa de mensagem no Material Design
A caixa de mensagem é uma área de texto
Área de texto da caixa de mensagem no Material Design
A caixa de mensagem é uma área de texto

As áreas de texto devem ter uma borda visível, com a mesma cor e espessura da linha de entrada.

Estados claro e escuro das áreas de texto do Material Design
Estados das áreas de texto nos temas claro e escuro

Tipos de entrada ​

Entradas formatadas ​

Os campos de texto podem ser formatados para indicar os tipos de dados que aceitam, usando texto de espaço reservado, layout predefinido e limites de caracteres. A formatação do texto deve ser exibida apenas quando o campo estiver pressionado, em foco ou preenchido.

Os caracteres podem ser formatados por meio de:

  • Caracteres agrupados
  • Prefixos e sufixos
  • Ocultação de senha

Caracteres agrupados

O texto de entrada pode ser dividido em grupos, com caracteres especiais inseridos em posições apropriadas, como os hífens de um número de telefone. Assim que o primeiro caractere especial é alcançado, o cursor salta automaticamente para o início do grupo seguinte.

Formatação de número de telefone do Material Design
Texto de entrada agrupado e formatado para um número de telefone
Material Design: Número de card de crédito agrupado e formatado
Texto de entrada agrupado e formatado para um número de cartão de crédito

Prefixos e sufixos

Os prefixos e sufixos servem para esclarecer unidades ou antecipar parte da entrada. Os prefixos ficam alinhados à esquerda do campo de texto; os sufixos, à direita. Um campo de texto pode ter prefixo e sufixo ao mesmo tempo.

Prefixo de campo de texto do Material Design para a moeda dólar
Prefixo para a moeda dólar
Sufixo de campo de texto do Material Design para peso
Sufixo para peso
Sufixo de campo de texto do Material Design para domínio de e-mail
Sufixo para domínio de e-mail
Sufixo de campo de texto do Material Design para fuso horário
Sufixo para fuso horário

Ocultação de senha

Por padrão, a senha é mascarada. Reticências na linha média são exibidas para representar cada caractere digitado (por exemplo, •••••••).

Quando um ícone de visibilidade é exibido junto ao campo de texto, ele indica se a entrada está visível ou não. A visibilidade do campo pode ser alternada por meio desse ícone.

Ícone de visibilidade do Material Design mostra caracteres da senha
Quando a visibilidade está habilitada, o ícone de visibilidade é exibido com os caracteres da senha visíveis.
Ícone de invisibilidade para senha oculta no Material Design
Quando a visibilidade está desabilitada, o ícone de invisibilidade é exibido com os caracteres da senha ocultos.

Outras entradas ​

Menus e seletores

Outros componentes, como menus suspensos e seletores, podem ser aninhados a campos de texto para facilitar a entrada de dados.

Menu suspenso do Material Design para selecionar um estado dos EUA
Menu suspenso em um campo de texto para selecionar um estado dos EUA
Campo de texto com seletor de data do Material Design
Seletor em um campo de texto para escolher uma data

Variações de campo ​

Destaque os campos de texto usando estas variações de estilo:

  • Rótulos como títulos
  • Campos independentes
  • Campos de largura total

Rótulos como títulos

Quando um campo de texto é a ação principal da tela, seu rótulo pode ser removido ou transformado em um título.

Nesse caso, o texto de espaço reservado aparece no estado ocioso e é substituído pelo texto de entrada conforme o usuário digita.

Material Design remove o rótulo do campo para onboarding
O texto do rótulo pode ser removido do campo e exibido como um título em fluxos de introdução (onboarding) ou de consulta.
Material Design: Usar título em vez de texto de rótulo
O texto do rótulo pode ser removido do campo e exibido como um título em diálogos.

Campos independentes

Quando um campo de texto é usado para uma única ação, como pesquisa, ele pode ter elevação, com os ícones associados posicionados dentro dele. Nesse caso, a linha de entrada não é necessária.

Em desktops, um botão de pesquisa com elevação deve aparecer à direita do campo de pesquisa.

Ação de pesquisa como campo de texto com elevação no Material Design
Ação de pesquisa como um campo de texto com elevação em desktops
Ação de pesquisa como campo de texto com elevação no Material Design
Ação de pesquisa como um campo de texto com elevação em dispositivos móveis
app bar como campo de entrada de texto no Material Design
A barra de aplicativo atua como um campo de entrada de texto
app bar do Material Design com campo de entrada de texto aninhado
A barra de aplicativo tem um campo de entrada de texto aninhado

Campo de largura total

Os campos de texto de largura total são úteis para tarefas mais detalhadas ou para a inserção de informações complexas.

Campo de texto de largura total do Material Design
Campo de texto de largura total
Campo de texto de largura total do Material Design, linha única/múltiplas linhas
Campo de texto de largura total com comportamento de texto de linha única e de várias linhas
Campo de largura total do Material Design com espaçamento normal
Campo de largura total com espaçamento normal
Altura: 56dp
Espaçamento superior: 20dp
Espaçamento inferior: 20dp
Campo de largura total do Material Design com espaçamento compacto
Campo de largura total com espaçamento compacto
Altura: 48dp
Espaçamento superior: 16dp
Espaçamento inferior: 16dp

Caixas de campo de texto ​

As caixas de campo de texto melhoram a identificação e a leitura rápida dos campos, usando um preenchimento retangular transparente para envolver o rótulo e o texto de entrada.

As caixas de campo de texto usam cor para facilitar a localização do campo, preservando a linha de entrada.

Estados

Em uma caixa de campo de texto, o preenchimento retangular é a principal afordância, ocultando as extremidades da linha de entrada. Uma animação de ripple (ondulação) é exibida nos estados de hover e pressionado.

Estados dos campos de texto do Material Design com formato retangular
Estados dos campos de texto com uma afordância retangular

Preenchimento retangular
  • Altura: 56dp
  • Raio dos cantos: 4dp
  • Cor (tema claro): 6% preto
  • Cor (tema escuro): 10% branco

Linha inferior

  • Espessura: 2dp
  • Oculta pelos cantos arredondados do retângulo

Ocioso e vazio

  • Espaçamento à esquerda: 16dp
  • Espaçamento à direita: 16dp
  • Espaçamento acima do rótulo: 8dp

Hover

  • Espaçamento à esquerda: 16dp
  • Espaçamento acima do rótulo: 20dp
  • Espaçamento abaixo do rótulo: 20dp

Pressionado

  • Espaçamento acima do rótulo: 8dp
  • Espaçamento abaixo do rótulo: 8dp
  • Espaçamento abaixo do texto de espaço reservado: 8dp

Os espaçamentos dos estados de foco, ocioso e preenchido, erro e desabilitado são iguais aos do estado pressionado.

Layouts compactos

As caixas de campo de texto tornam os layouts compactos mais fáceis de ler.

Campo de texto do Material Design com espaçamento normal
Espaçamento normal
Altura: 56dp
Espaçamento acima do rótulo: 8dp
Espaçamento abaixo do rótulo: 8dp
Espaçamento abaixo do campo de texto: 8dp
Espaçamento acima do texto de ajuda: 8dp
Campo de texto do Material Design com espaçamento compacto
Espaçamento compacto
Altura: 44dp
Espaçamento acima do rótulo: 8dp
Espaçamento abaixo do rótulo: 4dp
Espaçamento abaixo do campo de texto: 8dp
Espaçamento acima do texto de ajuda: 4dp

Caixa de campo de texto de linha única

Comportamento de rolagem de texto em um campo de linha única
Campo de texto de linha única do Material Design com rótulo
Campo de texto de linha única com rótulo como título

Caixa de campo de texto de várias linhas

Comportamento de quebra e rolagem de texto em um campo de várias linhas
Campo de várias linhas do Material Design em estado pressionado
Campo de várias linhas em estado pressionado
Campo de várias linhas do Material Design: ocioso e preenchido
Campo de várias linhas ocioso e preenchido

Área da caixa de texto

Comportamento de quebra e rolagem de texto na área da caixa de texto
Área de texto vazia no Material Design
Área de texto vazia e ociosa
Área de texto do Material Design em estado pressionado
Área de texto em estado pressionado

Menus e seletores

Menu suspenso do Material Design em campo de texto retangular
Lista suspensa em um campo de texto retangular
Ícone e seletor de data do Material Design em campo de texto
Ícone e seletor de data em um campo de texto retangular
Pager
AnteriorAbas
PróximoBarras de ferramentas

Distribuído sob a Licença Apache-2.0.

Copyright © 2014-Present Google

https://m1.material.io/components/text-fields.html

Distribuído sob a Licença Apache-2.0.

Copyright © 2014-Present Google