Allan Day
aday@gnome.org
Calum Benson
Adam Elman
Seth Nickell
Colin Robertson

This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.

Georges Neto
georges.stavracas@gmail.com 2014,
Rafael Fontenelle
rafaelff@gnome.org 2017-2021

# Campos de texto

Um campo de entrada de texto é um elemento de interface para inserir ou editar texto. É um elemento básico com vários usos, incluindo entrada de pesquisa, configurações e preferências, ou configuração da conta e da instalação. Um campo de entrada de texto pode ser pré-preenchido com texto e pode incluir botões ou ícones adicionais.

# Diretrizes gerais

Dimensione os campos de texto de acordo com o tamanho provável do conteúdo que eles conterão. Isso fornece uma indicação visual útil para a quantidade de entrada esperada e evita transbordar.

Em uma caixa de diálogo de aplicação instantânea, valide o conteúdo do campo de entrada quando ele perde o foco ou quando a janela é fechada, não após cada pressionamento de tecla. Exceção: se o campo aceitar apenas um número fixo de caracteres, como um código de cor hexadecimal, valide e aplique a alteração assim que esse número de caracteres for inserido.

Se você implementar um campo de entrada que aceita apenas determinados caracteres, como dígitos, execute o bipe de aviso do sistema quando o usuário tentar digitar um caractere inválido.

Normalmente, pressionar a tecla Tab em um campo de entrada de linha única deve mover o foco para o próximo controle e, em um campo de entrada multilinha, ela deve inserir um caractere de tabulação. Pressionar Ctrl Tab em um campo de entrada multilinha deve mover o foco para o próximo controle.

Se você precisar fornecer um atalho de teclado que insira um caractere de tabulação em um campo de entrada de linha única, use Ctrl Tab. No entanto, é improvável que você encontre muitas situações em que isso seja útil.

# Embutindo informações e controles

Uma variedade de informações e controles adicionais podem ser inseridos dentro de um campo de entrada de texto.

Ícones ou botões de ícones podem ser colocados dentro de um campo de texto para fornecer informações de status ou controles adicionais.

Um ícone no início da entrada pode ser usado para indicar sua finalidade – substituindo a necessidade de a entrada ser rotulada. Campos de entrada de pesquisa são o exemplo clássico disso, onde um ícone de pesquisa é colocado no lado esquerdo do campo de entrada.

Se o texto a ser digitado fizer distinção entre maiúsculas e minúsculas, um ícone de aviso poderá ser exibido dentro do campo de texto se o Caps Lock estiver ativado. Isso é normalmente mostrado no lado direito da entrada.

Se é comum que o campo de texto seja apagado, um botão de ícone claro pode ser colocado dentro do campo, no lado direito.

Se você colocar um ícone em um campo de entrada de texto (como um indicador ou um botão), use sua variante simbólica do Tema de Ícones Simbólicos do GNOME.

Quando um usuário se beneficiaria de informações adicionais para usar um campo de entrada de texto, ele pode ser pré-preenchido com um texto de dica. Como com qualquer decisão de exibir informações adicionais, isso deve ser feito somente quando for necessário.

# Referência de API

GtkEntry

GtkSearchEntry