Função que cria um item no menu. 

Open

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.

Open

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.

Open

Nesta página