Botões e navegação

Três widgets movem quem está a ver de um sítio para outro.

Link

Uma ligação, com duas modalidades:

Para um ecrã — escolhe-se o ecrã de destino do próprio dashboard e, se ele tiver parâmetros, de onde vem o valor de cada um.

Para um endereço externo — um URL, com a opção de abrir num separador novo.

Propriedades: etiqueta, sublinhado, e o destino conforme a modalidade.

Botão

Um botão não faz nada por si. O que faz está no evento onClick, escrito em TypeScript — ver Eventos e código.

Usos típicos:

// Abrir um ecrã de detalhe por cima
await keplin.ui.openModal("scr_detalhe", { produto: "Café Nortada Clássico 1kg" });

// Limpar todas as selecções de cruzamento do ecrã
keplin.ui.clearDrilldown();

// Recarregar um conjunto de dados
keplin.data.store("vendasMensais").reload();

Para navegar simplesmente para outro ecrã, o Link faz o mesmo sem código.

Breadcrumb

Um trilho de navegação: uma sequência de níveis, cada um com uma etiqueta e opcionalmente um ecrã de destino. O último nível é o actual e pode vir de um campo dos dados.

Faz sentido em dashboards com ecrãs de detalhe encadeados — região, loja, produto —, onde é preciso mostrar onde se está e permitir voltar atrás.

O separador entre níveis é configurável.

Navegar entre ecrãs de detalhe

Os ecrãs auxiliares abrem por cima do ecrã que os chama, e o host mantém a pilha de ecrãs abertos. Fechar um devolve o controlo ao anterior.

Isto significa que a navegação para detalhe não precisa de breadcrumb: fechar o modal já é "voltar". O breadcrumb ganha valor quando os ecrãs são normais, não modais.

Ver Ecrãs auxiliares.

Um aviso sobre navegação externa

Ligações para fora abrem noutro sítio e tiram a pessoa do dashboard. Num dashboard publicado por link público, quem clica pode não saber voltar. Use abrir em separador novo nesses casos.