Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2804

Função

O componente Entrada de texto em linha é utilizado quando se quer obter dados de entrada. Esse componente se diferencia dos demais por apresentar um rótulo ao lado do campo, definindo a função do campo e economizando espaço na tela.


Image RemovedImage Added

Figura 1 - Exemplo do componente rodando no simulador

Principais propriedades

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

Rótulo rótulo

Nome

Propriedade

Função

TítulocontentDefine o texto do Título.

Valor

ng-model

Propriedade AngularJS Angular 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 , podendo ser texto, número, inteiro, dentre outras opçõesdos dados, como data, moeda, e-mail, entre outros. O tipo padrão é 'Texto'. Algumas dessas opções influenciam a forma como o componente será exibido. O tratamento de máscaras não deve ser feito nesse campo. Embora seja possível escrever no campo, o usuário deve se limitar a selecionar uma das opções disponíveis na lista específica do campo.

Sugestão

placeholder

Especifica uma breve dica que descreve o valor esperado no campo.

Máscara

mask

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

Sugestão de Máscara

mask-placeholder

Especifica uma breve dica que descreve o valor esperado no campo.

Tipo de Teclado

keyboard

Específica qual será o tipo de teclado que será mostrado ao usuário quando esse campo for utilizado.

Tamanho mínimong-minlength

Directiva que adiciona uma restrição em um campo de texto e uma validação em um formulário caso o número mínimo de caracteres não seja atingido.


Máximo de caracteres    ng-maxlength

Directiva que adiciona uma restrição em um campo de texto e uma validação em um formulário caso ultrapasse o número máximo de caracteres.


Identificador

id

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

EstilostyleDefine o estilo do componente.

Exibir

ng-show

Propriedade AngularJS Angular usada para mostrar ou oculta o componente.

Repetircrn-repeatPropriedade que seleciona uma fonte de dados contida na tela e repete o componente baseado no número de itens dessa fonte de dados.

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.

Skincrn-skinPermite selecionar um skin que afetará apenas o componente selecionado.

Classes CSS

class

Adiciona classes CSS que já foram criadas.

Aba de Estilos

Na tabela abaixo estão descritos os tipos de estilos disponíveis para o componente Entrada de texto em linha.

Nome em português

Nome em inglês

Descrição

Título

title

Estiliza o título do componente.
Entrada de textoInputEstiliza a entrada de texto do componente.
Sugestão

Placeholder

Estiliza a sugestão da entrada de texto.

Propriedades do subcomponente 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 input, desagrupando o componente principal e inserindo, na propriedade Nova propriedade,uma das propriedades abaixo, como mostra a figura 2.

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.

Somente
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 uma 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: label input. Ao clicar no botão bolha com ícone de cadeado, localizado na barra de opções (Figura 2), o componente é desbloqueado, permitindo a seleção de seus subcomponentes. Para inserir uma das propriedades mostradas na tabela acima, acesse a propriedade Nova propriedade (destaque 1 da Figura 2).


Informações
titleDica

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

Image Removed


Image Added

Figura 2 - Desagrupar componente para acessar seus subcomponentes

Nome em inglês

Inline Input


Nesta página

Índice
maxLevel3
printablefalse

Compatibilidade

  • Formulário mobile


Equivalente web

Não possui.



Botão do Componente

Image Removed

Image Added


Imagem no Editor Visual

Image Removed

Image Added