- Created by Fábio Duarte Freitas, last modified by Laila Maria Vieira Souza on 08/07/2024
Cria um item no menu dinâmico.
Figura 1 - Bloco Criar Item do Menu
Para exibir os itens do menu é necessário atribuir a função à propriedade Configuração do menu da view que deseja exibi-lo.
Compatibilidade
- Bloco cliente (web): cronapi.screen.createMenuItemWeb()
Retorno
Retorna um objeto contendo os dados inseridos no bloco, como o nome e o título do item do menu, o ícone selecionado e os subitens.
Parâmetros
Nome
Nome que identifica o item criado no menu.
- Posição: 1
- Inglês: Name
- Tipo: Texto / String
- Exemplo: "Admin"
Título
Título do item do menu que será exibido ao executar o projeto.
- Posição: 2
- Inglês: Title
- Tipo: Texto / String
- Exemplo: "Admin"
Classname do ícone
Seleção do Ícone que será exibido ao lado do título do item do menu.
- Posição: 3
- Inglês: Icon classname
- Tipo: Texto / String
- Exemplo: "Gears"
Expressão para ocultar
Determina se o item do menu será ocultado (true) ou não (false). O campo em branco também representa o valor "false" e o item do menu é exibido.
- Posição: 4
- Inglês: Expression to hide
- Tipo: Lógico / Boolean
- Exemplo: verdadeiro
Segurança do item
Define as regras de segurança de acesso ao item do menu. Deve-se utilizar o bloco de programação Criar as regras de segurança.
- Posição: 5
- Inglês: Security rules
- Tipo: Objeto / Object
- Exemplo: uso do bloco Criar as regras de segurança
Expressão para ação
Define o link de redirecionamento para a outra view da aplicação ou outra página da web. Para direcionar para outra view da aplicação, utilize a expressão "cronapi.screen.changeView('#/home/logged/<nome-do-formulário>', [])
". E para direcionar para uma página qualquer da web, utilize a expressão "cronapi.screen.openUrl('url-da-página')
". É importante destacar que subitens esse campo deve permanecer em branco.
- Posição: 6
- Inglês: Expression to action
- Tipo: Texto / String
- Exemplo: "
cronapi.screen.changeView('#/home/logged/usuarios', [])
"
SubItem(ns)
Recebe outro bloco de programação Criar Item do Menu, a fim de criar itens filho ou neto. Para criar um menu com mais de um item, é necessário utilizar o bloco de programação criar lista com.
- Posição: 7
- Inglês: SubItem(s)
- Tipo: Objeto / Object
- Exemplo: uso do bloco Criar Item do Menu
Exemplo
A imagem abaixo apresenta um exemplo de uso do bloco Criar Item do Menu.
Figura 2 - Exemplo de uso do bloco Criar Item do Menu
Destaques da Figura 2:
O parâmetro Nome recebe o nome "Admin" como identificação do item.
O parâmetro Título recebe o título "Admin" que será exibido executar a aplicação.
O parâmetro Classname do ícone atribui o ícone "Gear" para o item.
O parâmetro Expressão para ocultar permanece em branco. O bloco irá interpretar o valor como "false" e o item do menu será exibido.
O parâmetro Segurança do item recebe o bloco de programação Criar as regras de segurança, que define quais permissionáveis terão acesso ao item.
- O parâmetro Expressão para ação também deixamos em branco.
- O parâmetro Subitem(ns) também deixamos em branco, assim o item não terá subitens.
A Figura 2.1 apresenta o exemplo de um menu dinâmico criado a partir do bloco de programação Criar Item do Menu. A função que gerou esse exemplo é um pouco extensa e, portanto, não foi incluída nesta documentação. Para entender melhor como esse exemplo foi gerado, baixe e importe o arquivo blockly disponível abaixo.
Função utilizada na Figura 2.1
O resultado de execução da função do arquivo blockly acima pode ser visto na imagem a seguir.
Figura 2.1 - Resultado de execução do arquivo blockly da função acima
Nesta página