Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 14 Próxima »

Função

O componente Entrada de texto é utilizado quando se quer obter dados de entrada do usuário. Por padrão o componente é iniciado com configurações básicas, mas são facilmente alteradas através do menu de propriedades do componente.


Figura 1 - Exemplo de imagem do componente executando no browser

Principais propriedades

Nome

Propriedade

Função

Conteúdo

content

Define o rótulo.

Valor

ng-model

Propriedade AngularJS que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação.

Tipo

type

Propriedade usada para definir o tipo de entrada, exemplo: data, financeiro, e-mail e outros. (valor padrão: text).

Mascara

mask

Propriedade de máscara aplicada ao campo de entrada de texto. Ver mais em Máscara HTML.

Requerido

ng-required

Define que o campo é de preenchimento obrigatório.

Sugestão

placeholder

Exibe um exemplo de resposta para o usuário quando o campo está vazio.

Sugestão de Máscara

mask-placeholder

Exibe um exemplo de resposta no momento que o usuário insere os dados, os caracteres são substituídos à medida que o usuário digita.
Essa propriedade só deve ser utilizada em campos do tipo texto usando máscaras de CPF, CNPJ, telefone e outras.

Identificador

id

Atributo que especifica um ID exclusivo para o componente. Por padrão, um ID é gerado automaticamente e atribuído ao componente.

Exibir

ng-show

Propriedade AngularJS usada para mostrar ou oculta o componente.

Segurança

cronapp-security

Propriedade do Cronapp que trata as permissões de segurança da aplicação. Usado para permitir ou não edição e visualização do componente com base nos perfis de selecionados.

Propriedades do subcomponente input

As propriedades abaixo não são nativas do componente. Para adicionar essas ou outras propriedades será necessário selecionar o subcomponente input.

NomePropriedadeFunção
Tamanho máximomaxlength

Define o número máximo de caracteres aceito no campo.

Algumas máscaras possuem caracteres que ocupam espaços, dessa forma, ao informar o número máximo de caracteres nesta propriedade, leve em consideração a quantidade de caracteres utilizados pela máscara.
Ex,: Um CPF possui 11 dígitos, porém mais 3 caracteres são exibidos ao utilizar a máscara CPF (2 "." e 1 "-"). Sendo necessário informar o valor 14 nessa propriedade.

Tamanho mínimominlength

Define o número mínimo de caracteres aceito no campo. A linha do campo ficará em vermelho até que o usuário digite o mínimo de caracteres necessários.

Algumas máscaras possuem caracteres que ocupam espaços, dessa forma, ao informar o número mínimo de caracteres nesta propriedade, leve em consideração a quantidade de caracteres utilizados pela máscara.
Ex,: Um CPF possui 11 dígitos, porém mais 3 caracteres são exibidos ao utilizar a máscara CPF (2 "." e 1 "-"). Sendo necessário informar o valor 14 nessa propriedade.

Apenas leiturang-readonly

Bloqueia edições no campo e exibe seu conteúdo apenas para leitura. Por padrão, possui as opções "Sim" e "Não".

Essa propriedade também aceita expressões, permitindo por exemplo, bloquear um campo vinculado a um fonte de dados:

  • "datasource.editing" para bloquear o campo quando a fonte de dados estiver em modo de edição ou
  • "datasource.editing || datasource.inserting" para bloquear o campo quando a fonte de dados estiver em modo de edição ou inserção.


Aba de Estilos

Na tabela abaixo esta descrito os tipos de estilos disponíveis para o componente Entrada de Texto.

Nome em portuguêsNome em inglêsDescrição

Título

Title

Estiliza o título do componente.

Entrada de texto

Input

Estiliza a entrada de texto do componente.

Sugestão

Placeholder

Estiliza a sugestão do componente.


Subcomponentes

O componente Entrada de texto é formado por dois subcomponentes agrupados: label e input. Ao clicar no botão bolha com ícone de cadeado (Figura 2) o componente é desbloqueado, permitindo a seleção de seus subcomponentes. 

Dica

Consulte o tópico "Acesso aos subcomponentes" da documentação Componentes visuais para mais informações.


Figura 2 - Desagrupar componente para acessar subcomponentes

Nome em inglês

Input


Nesta página


Compatibilidade

  • Formulário web


Equivalente mobile

Entrada de Texto (mobile)


Botão do Componente



Imagem no Editor Visual



  • Sem rótulos