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 - 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. |
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. |
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. |
| 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. |
Permitir Valores Nulos
O componente Checkbox pode possuir três estados (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
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
Compatibilidade
Formulário mobile
Equivalente web
Botão do Componente
Imagem no Editor Visual
