Função

A caixa de seleção é um componente do tipo combobox e seus itens são alimentados manualmente nas configurações do componente. Normalmente é utilizado em situações onde há necessidade de exibir uma pequena lista de opções com valores fixos ou enviar valores recorrentes - seja para manter o padrão de inserção no banco de dados ou para facilitar a seleção pelo usuário.

A forma como o componente é renderizado varia com o sistema operacional usado: no Android a aplicação é escurecida e é exibido uma caixa de opções (Figura 1.1), já no iOS a caixa sobreposta possui um efeito visual de rolagem (Figura 1.2).


Figura 1.1 - Exemplo do componente rodando no Android


Figura 1.2 - Exemplo do componente rodando no iOS

Principais propriedades

Na tabela abaixo estão descritas as principais propriedades do componente. As propriedades exibidas ao selecionar o componente são diferentes das propriedades ao selecionar um dos itens.

Caixa de seleção

Nome

Propriedade

Função

Valor

ng-model

Propriedade Angular que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação.

TítulocontentDefine um rótulo.

Identificador

id

Atributo que especifica um ID exclusivo para o componente. Por padrão um id é gerado automaticamente e atribuído ao componente.

EstilostyleAltera o estilo do componente da forma inline.

Exibir

ng-show

Propriedade Angular usada para mostrar ou ocultar o componente.

Repetircrn-repeatPropriedade 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.

Skincrn-skinPermite selecionar um skin que afetará apenas o componente selecionado.

Classes CSS

class

Adiciona classes CSS que já foram criadas.

Aba de Estilos

Na tabela abaixo estão descritos os tipos de estilos disponíveis para o componente Caixa de seleção.

Nome em português

Nome em inglês

Descrição

Plano de fundo do Título

Title background

Estiliza o plano de fundo no título do componente.
TítuloTitleEstiliza o título do componente.
Item Selecionado/ Seta Selected ItemEstiliza o item selecionado.

Item da caixa de seleção

Nome

Propriedade

Função

IdentificadoridAtributo que especifica um ID exclusivo para o componente.

Valor

value

Define um identificador para o item.

Conteúdo

content

Esse campo define o texto que será exibido ao usuário, podendo ser internacionalizado.

DesabilitadodisabledValor booleano, sim ou não, que habilita ou desabilita o componente, por padrão o componente vem habilitado.
Desabilitar seng-disabled

Directiva usada para desabilitar um componente quando a expressão vinculada for verdadeira.

EstilostyleAltera o estilo do componente da forma inline.

Exibir

ng-show

Propriedade Angular usada para mostrar ou ocultar o componente.

Repetircrn-repeatPropriedade 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.

Skincrn-skinPermite selecionar um skin que afetará apenas o componente selecionado.
Classes CSSclassAdiciona classes CSS que já foram criadas.

Itens

A propriedade Itens faz referência as opções presentes no componente, permitindo adicionar uma nova opção (1 da Figura 3.1), excluir (2 da Figura 3.1), alterar a ordem de exibição dessas opções (3 da Figura 3.1) e ao clicar sobre uma opção, é possível acessar suas configurações (Figura 3.2).


Figura 3.1 - Itens da Caixa de Seleção


Figura 3.2 - Editando o item da Caixa de Seleção

Nome em inglês

Combobox


Nessa página


Compatibilidade

  • Formulário mobile


Equivalente web

Caixa de Seleção Fixa


Botão do Componente



Imagem no Editor Visual