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 propriedades
Na tabela abaixo estão descritos as principais propriedades (Figura 2) para o funcionamento básico do componente.
Nome
Propriedade
Função
Conteúdo
content
Define um rótulo.
valor
ng-model
Propriedade AngularJS que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação.
Tema
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.
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.
O componente Checkbox pode possuir dois status (true e false) ou 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.1 - 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
A propriedade tema permite personalizar e padronizar cada componentes em um total de 9 cores distintas. Veja abaixo a lista disponível.