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 - Exemplo do componente rodando no simulador
Principais Propriedades
Na tabela abaixo estão descritas as principais propriedades para o funcionamento básico do componente.
Nome
Propriedade
Função
Título
content
Altera o texto do Título.
Valor
ng-model
Propriedade Angular que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação.
Tema da caixa de checagem
xattr-theme
Define um tema para o checkbox.*
Valor inicial
ng-initial-value
Define o status inicial ao carregar o componente checkbox.
Permitir Valores Nulos
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.
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 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.
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.
Permitir Valores Nulos
O componente Checkbox pode possuir três (true, false e 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 - Os três valores do checkbox
LEMBRETE
Para permitir salvar o status Indeterminado no banco de dados, o campo da entidade, no diagrama de dados, deve está configurado como Lógico (booleano) e a opção Não Nulo desmarcada.
Tema da Caixa de Checagem
A propriedade tema permite personalizar e padronizar cada componente em um total de 9 cores distintas. Veja abaixo a lista disponível.