Checkbox Group#
Para configurar o widget, é necessário realizar as seguintes ações:
O widget Checkbox Group exibe um campo para criar um grupo de checkboxes, permitindo que os Usuários escolham várias opções entre as apresentadas. Cada checkbox pode ser ativado ou desativado independentemente dos outros.
Para configurar o elemento, clique no ícone de edição .
Uma janela pop-up “Configurações do elemento” será aberta:
Campos para configuração do widget#
Preencha os campos necessários para configurar o widget.
“Obrigatório” – checkbox, preenchido manualmente com o botão esquerdo do mouse. Destina-se a colorir o campo de vermelho, se o Usuário não preencher este widget.
“Nome visível” – campo de texto, preenchido manualmente com o teclado. Permite especificar um nome para o widget.
“Nome do Parâmetro na Tarefa (Task)” – campo de texto, preenchido manualmente com o teclado. Neste campo é exibido o texto que corresponde ao valor do Parâmetro especificado da Tarefa selecionada. O Usuário pode alterar esse valor no campo de texto, e após salvar o formulário, o novo valor será gravado no Parâmetro da Tarefa selecionada. Isso significa que ao fazer alterações no campo de texto, o Usuário pode atualizar as informações na Tarefa, bastando apenas inserir um novo valor e salvar as alterações.
“Placeholder” – campo de texto, preenchido manualmente com o teclado. Permite especificar um texto de placeholder que será exibido no campo de entrada até que o usuário comece a digitar um valor.
“Classe” – campo de texto, preenchido manualmente com o teclado. Permite especificar uma classe CSS que será aplicada ao elemento. Isso permite alterar o estilo do widget, por exemplo, cor, tamanho ou fonte.
“Expressão regular (Regexp)” – campo de texto, preenchido manualmente com o teclado. Permite definir uma expressão regular para validação da entrada.
“Mensagem de erro de validação” – campo de texto, preenchido manualmente com o teclado. Permite especificar um texto que será exibido ao Usuário caso o valor inserido não passe na validação.
“Dica” – campo de texto, preenchido manualmente com o teclado. Permite especificar uma dica adicional que ajudará o usuário a entender o que exatamente deve ser inserido.
“Valor padrão” – campo de texto, preenchido manualmente com o teclado. Permite especificar um valor que será exibido no campo de entrada por padrão.
“Chave” – campo de texto, preenchido manualmente com o teclado. Permite atribuir um identificador único ao controle ou suas opções. A chave é necessária para o processamento de dados no lado do servidor ou ao processar o formulário programaticamente.
“Nome da opção” – campo de texto, preenchido manualmente com o teclado. Permite especificar o texto que será mostrado ao Usuário na interface como uma opção de escolha.
Se for necessário adicionar outras opções de escolha, o Usuário deve clicar no botão .
Exemplo de preenchimento#
| Nome do campo | Valor |
| Checkbox "Obrigatório" | |
| Nome visível | Informe suas preferências |
| Nome do Parâmetro na Tarefa (Task) | preferences |
| Placeholder | Escolha uma ou mais opções |
| Classe | checkbox-group |
| Expressão regular (Regexp) | |
| Mensagem de erro de validação | Por favor, escolha pelo menos uma opção. |
| Dica | Escolha suas preferências entre as opções apresentadas. |
| Valor padrão | |
| Chave | Opção 1 |
| Nome da opção | Café |
| Chave | Opção 2 |
| Nome da opção | Chá |
| Chave | Opção 3 |
| Nome da opção | Suco |
| Chave | Opção 4 |
| Nome da opção | Água |
Resultado: