Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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
Informações |
---|
Para exibir os itens do menu é necessário atribuir a função à propriedade Configuração do menu da view que deseja exibi-lo. |
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
StringTí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
Parâmetro 4do menu.
- Posição: 3
- Inglês: Icon classname
- Tipo: Texto / String
- Exemplo: "Gears"
Expressão para ocultar
BooleanDetermina se o item do menu será
exibidoocultado (true) ou não (false)
,. O campo em branco também
significarepresenta 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çãoprogramação Criar as regras de segurança.
Parâmetro 6- 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
, exemplo:da web. Para direcionar para outra view da aplicação, utilize a expressão "cronapi.screen.changeView('#/home/logged/
nomeDoForm
><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, com o intuitoMenu, a fim de criar
um itemitens 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:
O parâmetro Nome recebe o nome "Admin" como
Retorno
Retorna uma objeto.
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
identificação do item.
O parâmetro
"título" Título recebe o título "Admin" que será exibido
na web ao executar a aplicação.
"classname O parâmetro Classname do ícone
" atribui
um o ícone "Gear" para o item.
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 permanece em branco. O bloco irá interpretar o valor como "false" e o item do menu será exibido.
"O parâmetro 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 permissionáveis terão acesso ao item.
Em "- 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
- também deixamos em branco.
- O último parâmetro, "subitem" recebe o bloco de programação Criar Item do Menu, vale lembrar para criar um menu com mais de um item é necessário utilizar o bloco de programação Criar lista com.
- 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
grande e ficaria inviável colocar nesta documentação, por isso,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
abaixo para entender melhor como foi gerado esse exemplodisponível abaixo.
CriarItemMenu View file name CreateMenuItemWeb.blockly height 250
Função CriarItensMenu.blocklyutilizada 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
Image Removed
Figura 2.1 - Representação de um menu gerado a partir do blocoResultado de execução do arquivo blockly da função acima
Nesta página
Índice |
---|
Sobre o 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(web).