Checkbox (mobile)
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 Cronapp MVC 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 Cronapp MVC 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