As funções Navigate e Back

  • 6 minutos

Vejamos como você pode adicionar argumentos às funções Navigate e Back para aprimorar a interface do usuário em um aplicativo do Power Apps. Na sintaxe, colchetes indicam parâmetros opcionais.

Veja a seguir um detalhamento da sintaxe de Navigate:

Navigate(ScreenName, ScreenTransition.TransitionType, {ContextRecord: NewValue})

  • ScreenName (obrigatório): a tela a ser exibida.

  • ScreenTransition (opcional): a transição visual a ser usada entre a tela atual e a próxima. Se omitido, o padrão será ScreenTransition.None.

  • ContextRecord (opcional): um registro que contém um ou mais nomes de variáveis de contexto e seus valores. Esse registro define ou atualiza as variáveis de contexto na nova tela.

Você deve especificar o primeiro parâmetro para indicar para qual tela navegar. O segundo parâmetro controla opcionalmente o efeito de transição. O terceiro parâmetro permite passar valores de contexto para a nova tela.

Função Back

Esta é a sintaxe para a função Back:

Back([ScreenTransition])

  • ScreenTransition (opcional): a transição visual a ser usada ao retornar à tela anterior. Por padrão, ela é o inverso da transição usada para acessar a tela atual.

A função Back deve incluir parênteses: Back().

A função Back retorna o usuário para a tela exibida anteriormente. O Power Apps mantém um histórico de navegação, incluindo transições de tela. Quando Back é usada, o Power Apps reverte a transição (a menos que uma transição específica seja definida).

Transições de tela

As transições de tela podem ser usadas com as funções Navigate e Back. As opções disponíveis incluem:

  • ScreenTransition.Cover: a nova tela desliza da direita para a esquerda, cobrindo a tela atual.

  • ScreenTransition.CoverRight: a nova tela desliza da esquerda para a direita.

  • ScreenTransition.Fade: a tela atual desaparece, revelando a nova tela.

  • ScreenTransition.None: (Padrão) alterna instantaneamente para a nova tela.

  • ScreenTransition.UnCover: a tela atual desliza da direita para a esquerda.

  • ScreenTransition.UnCoverRight: a tela atual desliza da esquerda para a direita.

Exemplos

A tabela a seguir fornece alguns exemplos de fórmulas que usam transições para Navigate e Back. A tabela também inclui alguns dos parâmetros de UpdateContextRecord em exemplos de Navigate, para que você possa visualizar como eles seriam em seu aplicativo.

Fórmula Descrição Resultado
Navigate(Details) Navega para a tela Details sem uma transição ou alteração de contexto. A tela Details é exibida imediatamente.
Navigate(Details, ScreenTransition.Fade) Navega para a tela Details usando uma transição Fade. A tela atual desaparece na tela Details.
Navigate(Details, ScreenTransition.Fade, {ID: 12}) Adiciona uma transição de esmaecimento e define a variável de contexto ID. A tela Details aparece com ID definida como 12.
Navigate(Details, ScreenTransition.Fade, {ID: 12 , Shade: Color.Red}) Exibe a tela Details com uma transição Fade. Atualiza o valor da variável de contexto ID para 12. Atualiza o valor da variável de contexto Shade para Color.Red. A tela atual desaparece para mostrar a tela Details. A variável de contexto ID na tela Details é definida como 12, e a variável de contexto Shade é definida como Color.Red. Se você definir a propriedade Fill de um controle na tela Details como Shade, esse controle será exibido em vermelho.
Back() Retorna à tela anterior usando a transição inversa. O Power Apps reverte a última transição para exibir a tela anterior.
Back(ScreenTransition.Cover) Retorna à tela anterior usando a transição Cover. Usa a transição Cover independentemente de como a tela atual foi inserida.

Em resumo, Navigate e Back dão suporte a parâmetros para controle aprimorado. Com Navigate, você pode direcionar os usuários para outra tela, aplicar transições e definir variáveis de contexto. A função Back permite a navegação reversa com transições padrão ou especificadas.

Até agora, você usou a propriedade OnSelect para habilitar a navegação na tela. Na próxima unidade, você vai explorar outras maneiras de implementar a navegação de aplicativo.