Guia de Navegação com Parâmetros de Rota
Como parte do suporte ao estado da aplicação, o uso de variáveis no App Builder agora facilita a navegação dentro da aplicação com um tipo especial de variáveis, ou seja, Parâmetros de rota.
Entendendo Parâmetros de Rota
Os parâmetros de rota funcionam como variáveis, permitindo aos usuários criar, armazenar valores, atribuir valores e vinculá-los a outras propriedades na aplicação. No entanto, esses parâmetros de rota têm um uso principal específico - permitir que os usuários construam navegação dentro do app (consulte Navegação). Quando uma rota de navegação requer vinculação de parâmetros, os usuários podem vincular um parâmetro de rota para facilitar esse processo.
Distinções principais entre Variáveis de App e parâmetros de rota:
- Os parâmetros de rota só podem ser criados em uma visualização filha, onde a visualização filha pode servir como página de destino para uma rota de navegação específica.
- Os parâmetros de rota só podem ser dos tipos
string,numericouboolean. O suporte para outros tipos será introduzido em versões futuras. - Os parâmetros de rota suportam valores iniciais, com parâmetros de rota
booleansuportando apenas um valor inicialFALSE. - Os parâmetros de rota não são variáveis de destino para uma ação Set Variable.
Introdução a Variáveis
Criando um Parâmetro de Rota
Os usuários podem criar um Parâmetro de Rota de duas formas:
- Através do fluxo Nova Variável > Param. de rota na seção Variáveis.
- Usando o botão + adicionar na seção Parâmetros de Rota, parte do painel Propriedades.
O nome do parâmetro passa pela mesma validação que uma variável.
Criar Parâmetro de Rota
Uso de Parâmetro de Rota
-
Se uma visualização filha tem apenas um Parâmetro de Rota, ele é tratado como um parâmetro de caminho para roteamento de aplicação. Isso permite navegação para
/child-view/pathParameterenquanto passa um certo valor para o pathParameter. -
Quando mais de um parâmetro de rota é criado para a visualização, esses parâmetros são tratados como parâmetros de consulta na navegação:
/child-view/pathParameter=value1&pathParameter2=value2. Se o único parâmetro de rota em uma visualização é do tipo boolean, ele é tratado como um parâmetro de consulta.
Parâmetros de Rota Opcionais e Obrigatórios
Se um Parâmetro de Rota tem um valor inicial, ele é tratado como um parâmetro opcional na navegação. Criar um Parâmetro de Rota opcional significa que sua aplicação terá duas rotas válidas:
/app/customerDetails/customerIDapp/customerDetails
Na opção 2, quando um valor para o parâmetro customerID não é definido, o tratamento da propriedade customerID pode variar dependendo do seu framework de destino. Os frameworks Angular e WebComponents atribuirão um valor de undefined por padrão, mas esse valor será substituído pelo valor inicial definido para a propriedade no App Builder.
Navegar para uma Página Filha usando Parâmetro de Rota
-
Adicione um componente na superfície de design (por exemplo, um botão) e anexe uma interação
Navegar paraa ele, escolhendo uma visualização filha na lista suspensa. -
Se a visualização filha selecionada tem Parâmetros de Rota, o usuário terá a opção de abrir um diálogo, onde os Parâmetros de Rota podem ser fornecidos com ou vinculados a valores:
Inicializar dados de um endpoint
