Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Função

O componente Entrada de texto flutuante é utilizado quando se quer obter dados de entrada. Esse componente se diferencia dos demais por exibir o título somente quando o usuário começa a digitar o conteúdo no campo.


Animação 1 - Exemplo do componente e seus 2 estados: antes e depois de inserir o texto

Principais propriedades

Na tabela abaixo estão descritas as principais propriedades do componente.

Nome

Propriedade

Função

Conteúdo

content

Texto que será exibido no título do campo quando o usuário inserir o texto.

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).

Sugestão

placeholder

Exibe um exemplo de resposta para o usuário quando o campo está vazio. Para esse componente, normalmente essa propriedade contém o mesmo texto da propriedade Conteúdo.

Máscara

mask

Propriedade de máscara aplicado ao campo de entrada de texto. Ver mais em Formatação de máscaras na camada cliente.

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.

Tipo de Teclado

keyboard

Específica qual será o tipo de teclado que será exibido no Smartphone do usuário quando esse campo for utilizado.

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 selecionados.

Classes CSS

class

Adiciona classes CSS que já foram criadas.

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, desagrupando o componente principal.

Nome

Propriedade

Funçã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.

Âncora
subcomponentes
subcomponentes

Subcomponentes

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

Informações
titleDica

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


Figura 1 - Desagrupar componente para acessar subcomponentes

Nome em inglês

Float Input


Nesta página

Índice
maxLevel3
printablefalse

Compatibilidade

  • Formulário mobile


Equivalente web

Não possui.


Botão do Componente


Imagem no Editor Visual