Criar Item do Menu
Função que cria um item no menu.
Parâmetros de Entrada
| Parâmetro | Nome | Tipo | Doc |
|---|---|---|---|
| Parâmetro 1 | Nome | String | Nome do item criado no menu. |
| Parâmetro 2 | Título | String | Título do item que será exibido ao executar o projeto. |
| Parâmetro 3 | Classname do ícone | String | ComboBox contendo vários ícones para exibição ao lado do título do item. |
| Parâmetro 4 | Expressão para ocultar | Boolean | Determina se o item será exibido (true) ou não (false), campo em branco também significa "false". |
| Parâmetro 5 | Segurança do item | Objeto | Campo que recebe o bloco de programação Criar as regras de segurança. |
| Parâmetro 6 | Expressão para ação | String | Campo destinado a receber o link para a outra página, exemplo: cronapi.screen.changeView('#/home/logged/<nomeDoForm>', []) |
| Parâmetro 7 | Subitem | Objeto | Campo que recebe outro bloco de programação Criar Item do menu, com o intuito de criar um item filho ou neto. |
Retorno
Retorna um objeto contendo o título do item do menu e o ícone.
Compatibilidade
Cliente
Exemplo
O exemplo da figura 1 representa a criação de um item do menu na barra de navegação.
Figura 1 - Bloco de programação Criar Item do Menu
O primeiro parâmetro, "nome", recebe o nome de identificação do item.
O parâmetro "título" recebe o título que será exibido na web ao executar a aplicação.
"Classname do ícone" atribui um ícone para o item.
O parâmetro "Expressão para ocultar" recebe um valor true ou false para exibir ou não o item, caso o campo fique em branco, o bloco interpreta o valor como false.
"Segurança do item" é um dos campos mais importantes, pois recebe o bloco de programação Criar as regras de segurança, que define quais permissionáveis terão acesso ao item.
- Em "Expressão para ação" definimos o link da página de redirecionamento da aba. Em Itens pai ou avôs esse campo deve permanecer em branco.
- O último parâmetro, "Subitem", recebe o bloco de programação Criar Item do Menu, vale lembrar que para criar um menu com mais de um item é necessário utilizar o bloco de programação Criar lista com.
A figura 2 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 grande e ficaria inviável colocar nesta documentação, por isso, baixe e importe o arquivo blockly abaixo para entender melhor como foi gerado esse exemplo.
Função CriarItensMenu.blockly
Figura 2 - Representação de um menu gerado a partir do bloco
Sobre o bloco
O bloco de programação Criar Item do Menu é uma representação da tela janela de opções do menu dinâmico, para mais informações consulte a documentação do componente Barra de Navegação(web).
Para exibir o menu é necessário atribuir a função à propriedade Configuração do menu da página que deseja exibi-lo.