Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Função
O componente é muito similar ao entrada de texto, porém possui o subcomponente botão Botão e é utilizado quando se quer obter dados de entrada e executar uma ação em seguida. Por padrão o componente é iniciado com configurações básicas, mas são facilmente alteradas pelo menu de propriedades do componente.
Image RemovedImage Added
Figura 1 - Exemplo de imagem do componente executando no browser
Um exemplo de uso desse componente seria em um cenário onde se deseja, ao clicar no botão, realizar alguma ação com os valores inseridos no campo de texto.
Principais propriedades
Aba propriedades
Na tabela abaixo estão descritas as principais propriedades para o funcionamento básico do componente.
Nome | Propriedade | Função | |
---|---|---|---|
ConteúdoTítulo | 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 dos dados, exemplo: como data, financeiromoeda, e-mail e , entre outros. (valor padrão: text).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. Confira mais detalhes no tópico Tipo. | |
Ícone | class | Abre a janela de seleção de ícones. | |
MáscaraMascara | mask | Propriedade de máscara aplicado aplicada ao campo de entrada de texto. Ver mais em Máscaras Máscara HTML.Requerido | |
Desabilitado | ng- | requiredDefine que o campo é de preenchimento obrigatóriodisabled | Directiva usada para desabilitar um componente quando a expressão vinculada for verdadeira. |
Sugestão | placeholder | Exibe um exemplo de resposta para o usuário quando o campo está vazio.Sugestão de Máscara | |
Valor | maskng- | placeholdermodel | Propriedade Angular que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação. |
Requerido | ng-required | Define que o campo é de preenchimento obrigatório | 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.. |
Identificador | id | Atributo que especifica um ID exclusivo para o componente. Por padrão, um ID é gerado automaticamente e atribuído ao componente. | |
Estilo | style | Altera o estilo geral do componente da forma inline. | |
Exibir | ng-show | Propriedade AngularJS Angular usada para exibir mostrar ou oculta o componente. | |
Repetir | crn-repeat | Propriedade 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 de selecionados. | |
Skin | crn-skin | Permite selecionar um skin que afetará apenas o componente selecionado. | |
Classe CSS | ckass | Adiciona classes CSS já 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 e inserindo, na propriedade Nova propriedade, uma das propriedades abaixo, como mostra a figura 2.
Nome | Propriedade | Função |
---|---|---|
Tamanho máximo | maxlength | 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. |
Tamanho mínimo | minlength | 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. |
Apenas leitura | ng-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:
|
Aba de Eventos
Na tabela abaixo estão descritos os tipos de eventos disponíveis para o componente Entrada de texto com botão.
Nome | Propriedade | Função |
---|---|---|
Ao Iniciar | ng-init | Executa uma ação assim que o componente é renderizado na tela. |
Ao Alterar | ng-change | Executa uma ação assim que algo no componente é alterado. |
Ao Clicar | ng-click | Executa uma ação quando o componente receber um clique com o mouse ou um toque na tela. |
Ao Duplo Clicar | ng-dblclick | Executa uma ação quando o usuário clica duas vezes seguidas com o botão do mouse em um componente. |
Apertar Tecla | ng-keydown | Executa uma ação assim que uma tecla é acionada no teclado. |
Ao Soltar Tecla | ng-keyup | Executa uma ação ao soltar uma tecla do teclado. |
Ao Focar | ng-focus | Executa uma ação assim que o componente é focado. |
Ao Sair do Foco | ng-blur | Executa uma ação assim que o componente sai do foco. |
Ao Entrar com Mouse | ng-mouseenter | Executa uma ação quando o ponteiro do mouse é movido de fora para dentro do elemento. |
Ao Sair com Mouse | ng-mouseleave | Executa uma ação quando o ponteiro do mouse é movido de dentro para fora do elemento. |
Evento de Copiar | ng-copy | Executa uma ação assim que o elemento é copiado do componente. |
Ao Colar | ng-paste | Executa uma ação assim que o elemento é colado no componente. |
Aba de Estilos
Na tabela abaixo estão descritos os tipos de estilos disponíveis para o componente Entrada de texto com botão.
Nome em português | Nome em inglês | Descrição |
---|---|---|
Título | Title | Estiliza o título do componente. |
Entrada de texto | Input | Estiliza entrada de texto do componente. |
Sugestão | Placeholder | Estiliza a sugestão do componente. |
Botão | Button | Estiliza o botão do componente. |
Âncora | ||||
---|---|---|---|---|
|
Subcomponentes
O componente Entrada de texto com botão (web) é formado por três subcomponentes agrupados: label, input e botão. Ao clicar no botão bolha com ícone de cadeado (Figura , na barra de opções (destaque 1 da figura 2) o componente é desbloqueado, permitindo a seleção de seus subcomponentes. Para inserir uma das propriedades mostradas na tabela de subcomponente, acesse a propriedade Nova propriedade (destaque 2 da figura 2).
Informações | ||
---|---|---|
| ||
Consulte o tópico "Acesso aos subcomponentes" da documentação Componentes visuais para mais informações. |
Image RemovedImage Added
Figura 2 - Desagrupar componente para acessar subcomponentessubcomponentes
Âncora | ||||
---|---|---|---|---|
|
Tipo
No parâmetro Tipo (destaque 1 da figura 3) é possível determinar o tipo de informação que o componente Entrada de texto com botão irá receber. Como apresentado na figura 3, arrastamos 2 componentes Entrada de texto com botão e em cada um selecionamos um tipo diferente, são eles Telefone (2) e Data (3).
Image Added
Figura 3 - Selecionando tipos
Nota |
---|
Como dito anteriormente na tabela de propriedades, apesar de ser possível escrever sobre o campo, o usuário deve se limitar a escolher uma das opções disponibilizadas pela propriedade Tipo. |
Após executarmos o projeto e acessarmos a view, verificamos que os dois componentes Entrada de texto com botão inseridos anteriormente na figura 3, estão recebendo tipos de informações diferentes, o primeiro recebe um telefone e o segundo uma data (Figura 3.1).
Image Added
Figura 3.1 - Exemplos de tipos
Além dos tipos mostrados acima, também possuímos outros tipos, abaixo listaremos a funcionalidade de cada um:
- Texto: recebe uma informação do tipo texto;
- Número: aceita números com casas decimais;
- Inteiro: recebe apenas números inteiros;
- Moeda: recebe números inteiros e o separa com pontos a cada 3 dígitos, ex.: 1.000 (mil);
- Decimal de moeda: recebe números e separa, além de pontos a cada 3 dígitos, também por vírgulas os números decimais, ex.: 1.000,50 (mil e cinquenta centavos);
- Senha: recebe informações do tipo senha, escondendo com "*" o valor digitado;
- Data: recebe informações do tipo Data sem hora;
- Data e hora: recebe informações do tipo Data contendo a hora;
- Data e hora local: recebe informações do tipo Data contendo a hora no fuso horário local;
- Cor: recebe cores do tipo RGB;
- E-mail: recebe informações do tipo e-mail, contendo "
email@email
", caso não esteja desta forma, o campo ficará vermelho dando entender ao usuário que o valor digitado não é um e-mail; - Mês: recebe o nome do mês desejado;
- Alcance: muda o formato para uma barra que informará o alcance de 0 a 100;
- Pesquisa: recebe uma informação do tipo texto;
- Telefone: recebe números de telefones já com a máscara (DDD) 00000-0000;
- Hora: recebe informação no formato de horário, ex.: 05:17:13.
- Hora local: recebe informação no formato de horário, ex.: 05:17:13 no fuso horário local;
- Url: recebe informações do tipo Url no formato "
http://exemplo.com/
", caso não esteja desta forma, o campo ficará vermelho dando entender ao usuário que o valor digitado não é uma Url; - Semana: recebe o nome do dia na semana.
Nome em inglês
Input with button
Nesta página
Índice | ||||
---|---|---|---|---|
|
Compatibilidade
Formulário web
Equivalente mobile
Entrada de Texto com Botão (mobile)
Botão do Componente
Image RemovedImage Added
Imagem no Editor Visual
Image RemovedImage Added