Cria um item no menu dinâmico.

Image Added

Figura 1 - Bloco Criar Item do Menu

Função que cria um item no 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.

Parâmetro 3

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

Retorno

Retorna uma objeto. 

Compatibilidade

Image Removed Cliente

Exemplo

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

1. permissionáveis terão acesso ao item

Image Removed

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

Image Removed

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

1. .

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

Image Added

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