Cria um item no menu dinâmico.

Image Added

Figura 1 - Bloco Criar Item do Menu

Função que cria um item no menu.

Parâmetros de Entrada

Tipo

Doc

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á

exibido

ocultado (true) ou não (false)

,

. O campo em branco também

significa

representa o valor "false" e o item do menu é exibido. 

• Posição: 4
• Inglês: Expression to hide
• Tipo: Lógico / Boolean
• Exemplo: verdadeiro

Parâmetro 5

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.

Image Added

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

Retorno

Retorna um objeto contendo o título do item do menu e o ícone.

Compatibilidade

Image Removed Cliente

Exemplo

O exemplo da figura 1 representa a criação de um item do menu na barra de navegação.

Image Removed

Figura 1 - Bloco de programação Criar Item do Menu

O primeiro parâmetro, "nome", recebe o nome de

1. identificação do item.

2. O parâmetro

"título"

3. Título recebe o título "Admin" que será exibido

na web ao

4. executar a aplicação.

"

5. O parâmetro Classname do ícone

"

6. atribui

um

7. o ícone "Gear" para o item.

8. O parâmetro

"

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

10. permanece em branco. O bloco irá interpretar o valor como "false" e o item do menu será exibido.

"

11. O parâmetro Segurança do item

" é um dos campos mais importantes, pois

12. recebe o bloco de programação Criar as regras de segurança, que define quais permissionáveis terão acesso ao item.

Em "
13. O parâmetro 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
14. também deixamos em branco.
15. O
último
16. parâmetro
, "Subitem", recebe o bloco de programaçãoCriar 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.

1. 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 CriarItensMenu.blockly

Image Removed

Figura 2 - Representação de um menu gerado a partir do bloco

utilizada na Figura 2.1

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

Image Added

Figura 2.1 - Resultado de execução do arquivo blockly da função acima