Cria um item no menu dinâmico.

Figura 1 - Bloco Criar Item do Menu

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:

1. O parâmetro Nome recebe o nome "Admin" como identificação do item.

2. O parâmetro Título recebe o título "Admin" que será exibido executar a aplicação.

3. O parâmetro Classname do ícone atribui o ícone "Gear" para o item.

4. 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.

5. 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.

6. O parâmetro Expressão para ação também deixamos em branco.
7. 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.

CreateMenuItemWeb.blockly

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