Função que cria um item no menu. 

Figura 1 - Bloco Criar Item do Menu

Compatibilidade

• Bloco cliente (mobile): cronapi.screen.createMenuItemMobile()

Retorno

Retorna um objeto contendo as informações passadas nos parâmetros do bloco.

Características do 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 (mobile). 

Parâmetros

Nome

Nome que identifica o item criado no menu.

• Posição: 1
• Inglês: Name
• Tipo: Texto / String
• Exemplo: "Meu item"

Título

Título do item que será exibido ao executar o projeto.

• Posição: 2
• Inglês: Title
• Tipo: Texto / String
• Exemplo: "Meu item"

Classname do ícone

ComboBox contendo vários ícones para exibição ao lado do título do item.

• Posição: 3
• Inglês: Icon class name
• Tipo: Texto / String
• Exemplo: "android-person"

Expressão para ocultar

Determina se o item será ocultado (true) ou não (false). Caso o campo seja deixado em branco, o valor atribuído será "false". 

• Posição: 4
• Inglês: Expression to hide
• Tipo: Booleano / Boolean
• Exemplo: true

Segurança do item

Define as regras de segurança de acesso ao item do menu. Este campo que recebe o bloco de programação Criar as regras de segurança.

• Posição: 5
• Inglês: Item security
• Tipo: Objeto / Object
• Exemplo: utilização do bloco de programação 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ã0: 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').

• Posição: 6
• Inglês: Expression to action
• Tipo: Texto / String
• Exemplo: "cronapi.screen.changeView('#/app/logged/pessoa')"

Posição do texto

Indica a posição que o título será exibido, podendo ser à esquerda, ao centro ou à direita.

• Posição: 7
• Inglês: Text position
• Tipo: Texto / String
• Exemplo: "Left"
• Opções: 
  • Left: posiciona o título à esquerda do menu.
  • Center posiciona o título no centro do menu. 
  • Right: posiciona o título à direita do menu.

Posição do ícone

Indica a posição que o ícone será exibido, podendo ser à esquerda ou à direita.

• Posição: 8
• Inglês: Icon position
• Tipo: Texto / String
• Exemplo: "Left"
• Opções: 
  • Left: posiciona o ícone à esquerda do menu.
  • Right: posiciona o ícone à direita do menu.

Tema do texto

Indica o tema que será exibido no título, são eles: Light, Assertive, Balanced, Energized, Stable, Calm, Positive, Royal e Dark

• Posição: 9
• Inglês: Text theme
• Tipo: Texto / String
• Exemplo: "Light"
• Opções: 
  • Light: define o tema do texto com a cor branca.
  • Assertive: define o tema do texto com a cor branca um pouco mais claro.
  • Balanced: define o tema do texto com a cor verde.
  • Energized: define o tema do texto com a cor amarela.
  • Stable: define o tema do texto com a cor cinza claro.
  • Calm: define o tema do texto com a cor azul turquesa.
  • Positive: define o tema do texto com a cor azul escuro.
  • Royal: define o tema do texto com a cor lilás.
  • Dark: define o tema do texto com a cor cinza escuro.

Tema do ícone

Indica o tema que será exibido no ícone, são eles: Light, Assertive, Balanced, Energized, Stable, Calm, Positive, Royal e Dark

• Posição: 10
• Inglês: Icon theme
• Tipo: Texto / String
• Exemplo: "Light"
• Opções: 
  • Light: define o tema do ícone com a cor branca.
  • Assertive: define o tema do ícone com a cor branca um pouco mais claro.
  • Balanced: define o tema do ícone com a cor verde.
  • Energized: define o tema do ícone com a cor amarela.
  • Stable: define o tema do ícone com a cor cinza claro.
  • Calm: define o tema do ícone com a cor azul turquesa.
  • Positive: define o tema do ícone com a cor azul escuro.
  • Royal: define o tema do ícone com a cor lilás.
  • Dark: define o tema do ícone com a cor cinza escuro.

Exemplo

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

Figura 2 - Função que cria um item do menu

1. O primeiro parâmetro, "nome", recebe o nome de identificação do item.

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

3. "Classname do ícone" atribui um ícone para o item.

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

5. "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 permissionavéis terão acesso ao item.

6. 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.
7. Em posição do texto, definimos que o título será exibido à esquerda.
8. A mesma coisa acontece para a posição do ícone.
9. O tema do texto foi definido como "Light".
10. O mesmo tema foi escolhido para o ícone.
11. Por fim, inserimos o bloco Criar Menu Dinâmico no retorno da função para criar o menu.

A figura 2 apresenta o exemplo de um menu dinâmico criado a partir do bloco de programação Criar Item do Menu.

Figura 2.1 - Representação da execução da função da figura 2