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.

Aqui está um detalhamento da sintaxe de Navigate:

Navigate(Screen [, ScreenTransition [, UpdateContextRecord ]])

  • Screen (obrigatório): a tela a ser exibida (ou para a qual navegar).

  • ScreenTransition (opcional): a transição visual a ser usada entre a tela atual e a próxima. O valor padrão é None.

  • UpdateContextRecord (opcional): um registro que contém o nome de pelo menos uma coluna e um valor para cada coluna. Esse registro atualiza as variáveis de contexto aplicáveis à nova tela.

Em outras palavras, você deve incluir o primeiro parâmetro para que o Power Apps saiba para qual tela navegar. Você pode usar o segundo parâmetro para definir como a tela antiga muda visualmente para a nova tela. Você pode usar o terceiro parâmetro para passar um valor de contexto para a nova tela.

Função Back

Aqui está um detalhamento da sintaxe de Back:

Back([ScreenTransition])

  • ScreenTransition (opcional): a transição visual a ser usada entre a tela atual e a próxima. O default-value é a transição de tela inversa da função Navigate que trouxe o usuário até a tela.

Quando você adiciona Back ao aplicativo, ele deve incluir parênteses: Back().

A função Back retorna o usuário à tela que o aplicativo exibiu mais recentemente. À medida que o usuário vai para outras telas, o aplicativo rastreia o caminho das telas e as transições usadas. Portanto, quando a função Back for executada, a transição de tela inversa também será executada. Seus usuários podem usar a função Back para retornar à tela exibida quando abriram o aplicativo.

Transições de tela

Vamos examinar mais de perto as transições de tela, pois elas podem fazer parte das fórmulas Navigate e Back. Estas opções estão disponíveis no Power Apps:

  • ScreenTransition.Cover: a nova tela desliza da direita para a esquerda e cobre a tela atual.

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

  • ScreenTransition.Fade: a tela atual desaparece para revelar a nova tela.

  • ScreenTransition.None (padrão): a nova tela substitui rapidamente a tela antiga.

  • ScreenTransition.UnCover: a tela atual desliza para fora da exibição da direita para a esquerda e revela a nova tela.

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

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) Exibe a tela Details sem transição nem alteração do valor de uma variável de contexto. A tela Details é exibida rapidamente.
Navigate(Details, ScreenTransition.Fade) Exibe a tela Details com uma transição Fade. Nenhum valor de uma variável de contexto é alterado. A tela atual desaparece para mostrar a tela Details.
Navigate(Details, ScreenTransition.Fade, {ID: 12}) Exibe a tela Details com uma transição Fade. Atualiza o valor da variável de contexto ID para 12. A tela atual desaparece gradualmente para mostrar a tela Details, e a variável de contexto ID na tela é 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() Exibe a tela anterior com a transição de retorno padrão. O aplicativo exibe a tela anterior por meio da transição inversa da transição com a qual a tela atual foi exibida.
Back(ScreenTransition.Cover) Exibe a tela anterior com a transição Cover. O aplicativo exibe a tela anterior por meio da transição Cover, independentemente da transição com a qual a tela atual foi exibida.

Em resumo, você pode personalizar as funções Navigate e Back aproveitando seus parâmetros. Você pode usar a função Navigate para permitir que os usuários mudem para outra tela, mas também é possível adicionar uma transição visual e até mesmo definir variáveis de contexto no processo. A função Back fornece o inverso de qualquer transição que levou o usuário à tela atual, ou você pode definir uma transição. Você pode determinar a experiência do usuário.

Até agora, você usou apenas a função OnSelect para adicionar navegação ao aplicativo. Na próxima unidade, você aprenderá outras maneiras de adicionar navegação em aplicativos.