Cria um item no menu dinâmico.

Open

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.

Open

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.

O resultado de execução da função do arquivo blockly acima pode ser visto na imagem a seguir.

Open

Nesta página