Função
O Componente caixa de checagem permite que o usuário escolha entre dois ou três estados para um item. Normalmente escolhas que são mutuamente exclusivas, por exemplo: definir um texto em “negrito” ou “não negrito”.
Figura 1. 1 - Exemplo do componente rodando no simulador
Principais
propriedadesPropriedades
Na tabela abaixo estão descritos descritas as principais propriedades (Figura 2) para o funcionamento básico do componente.
Nome | Propriedade | Função | Conteúdo|
|---|---|---|---|
| Título | content | DefineAltera o | rótulotexto do Título. |
valorValor | ng-model | Propriedade AngularJS Angular que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação. | |
xattr-theme | Define um tema para o checkbox.* | ||
Valor inicial | ng-initial-value | Define o status inicial ao carregar o componente checkbox. | |
crn-allow-null-values | Permite que a caixa de seleção possa ter três status: True, False e Null. | ||
| Valor se falso | ng-false-value | Realiza uma ação caso o valor do campo seja falso. | |
| Valor se verdadeiro | ng-true-value | Realiza uma ação caso o valor do campo seja verdadeiro. | |
Requerido | ng-required | Define o preenchimento obrigatório pelo usuário. | |
identificadorIdentificador | id | Atributo que especifica um ID exclusivo para o componente. Por padrão um id é gerado automaticamente e atribuído ao componente. |
* Os temas exibidos são padrões do Ionic framework.
componente. | ||
| Estilo | style | Altera o estilo do componente da forma inline. |
| Exibir | ng-show | Propriedade Angular usada para 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 selecionados. |
| Skin | crn-skin | Permite selecionar um skin que afetará apenas o componente selecionado. |
| Classes CSS | class | Adiciona classes CSS que já foram criadas. |
Adicionando Estilos
Na tabela abaixo estão descritos as principais propriedades de estilo do componente.
Nome | Nome em inglês | Função |
|---|---|---|
Plano de fundo | Background | Estiliza o plano de fundo do componente. |
Título | Title | Estiliza o título do componente. |
| Âncora | ||||
|---|---|---|---|---|
|
Permitir Valores Nulos
O componente Checkbox pode possuir dois status (true e false) ou três três estados (true, false e Indeterminate indeterminate). O valor indeterminado normalmente é utilizado para informar que o usuário ainda não definiu esse campo, salvando-o como nulo no banco de dados.
Figura 2 .1 - Os três valores do checkbox
| Informações | ||
|---|---|---|
| ||
Para permitir salvar o status Indeterminado no banco de dados, o campo da entidade , no diagrama Diagrama de dados, deve está configurado como Lógico (booleano) e a opção Não Nulo desmarcada. |
| Âncora | ||||
|---|---|---|---|---|
|
Tema da Caixa de Checagem
A propriedade tema permite personalizar e padronizar cada componentes em um total de 9 cores distintas. Veja abaixo a lista disponível.
Essa propriedade irá exibir 2 grupos de cores em sua lista, as primeiras são as cores definidas pelo tema e, em seguida, uma seleção fixa de cores pré-definidas.
As cores definidas pelo tema (Padrão do tema, Secundário, Sucesso, Informação, Aviso, Perigo, Claro, Editável, Real e Escuro) podem variar a partir das seguintes situações:
- Alteração do tema do projeto (menor prioridade);
- Adição da Skin do projeto através do campo "Skin do Tema Mobile" na janela de Configurações do Projeto.
- Seleção da Skin na propriedade "Skin" do componente visual. (maior prioridade).
Nome em inglês
Checkbox
Nessa página
| Índice | ||||
|---|---|---|---|---|
|
Compatibilidade
Formulário mobile
Equivalente web
Checkbox Caixa de checagem (web)
Botão do Componente
Imagem no Editor Visual
