Les fonctions Navigate et Back

  • 6 minutes

Voyons comment ajouter des arguments aux fonctions Navigate et Back pour améliorer l’interface utilisateur d’une application Power Apps. Dans la syntaxe, les crochets indiquent des paramètres facultatifs.

Voici la décomposition de la syntaxe de la fonction Navigate :

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

  • ScreenName (obligatoire) : écran à afficher.

  • ScreenTransition (facultatif) : transition visuelle à utiliser entre l’écran actif et l’écran suivant. En cas d’omission, la valeur par défaut est ScreenTransition.None.

  • ContextRecord (facultatif) : enregistrement comportant un ou plusieurs noms de variables de contexte et leurs valeurs. Il définit ou met à jour les variables de contexte sur le nouvel écran.

Vous devez spécifier le premier paramètre pour indiquer l’écran auquel accéder. Le second paramètre contrôle éventuellement l’effet de transition. Le troisième vous permet de transmettre des valeurs de contexte au nouvel écran.

Fonction Back

Voici la syntaxe de la fonction Back :

Back([ScreenTransition])

  • ScreenTransition (facultatif) : transition visuelle à utiliser lorsque vous revenez à l’écran précédent. Par défaut, il s’agit de l’inverse de la transition permettant d’atteindre l’écran actif.

La fonction Back doit inclure des parenthèses : Back().

La fonction Back permet à l’utilisateur de revenir à l’écran consulté précédemment. Power Apps tient à jour un historique de navigation, y compris les transitions d’écran. Lorsque la fonction Back est utilisée, Power Apps inverse la transition (sauf si une transition spécifique est définie).

Transitions d’écran

Les transitions d’écran peuvent être utilisées avec les fonctions Navigate et Back. Voici les options disponibles :

  • ScreenTransition.Cover : le nouvel écran s’affiche par glissement de la droite vers la gauche et recouvre l’écran actif.

  • ScreenTransition.CoverRight : le nouvel écran s’affiche par glissement de la gauche vers la droite.

  • ScreenTransition.Fade : l’écran actif disparaît par atténuation, affichant ainsi le nouveau.

  • ScreenTransition.None (par défaut) : passe instantanément au nouvel écran.

  • ScreenTransition.UnCover : l’écran actif disparaît par glissement de la droite vers la gauche.

  • ScreenTransition.UnCoverRight : l’écran actif disparaît par glissement de la gauche vers la droite.

Exemples

Le tableau suivant donne quelques exemples de formules utilisant des transitions pour les fonctions Navigate et Back. Le tableau comprend également certains des paramètres UpdateContextRecord sur des exemples Navigate, afin que vous puissiez visualiser à quoi ils ressembleraient dans votre application.

Formule Description Résultat
Navigate(Details) Accède à l’écran Details sans transition ni changement de contexte. L’écran Details s’affiche immédiatement.
Navigate(Details, ScreenTransition.Fade) Accède à l’écran Details à l’aide d’une transition Fade. L’écran actif disparaît par atténuation pour afficher l’écran Details.
Navigate(Details, ScreenTransition.Fade, {ID: 12}) Ajoute une transition de fondu et définit la variable de contexte ID. L’écran Details s’affiche avec la variable de contexte ID définie sur 12.
Navigate(Details, ScreenTransition.Fade, {ID: 12 , Shade: Color.Red}) Affiche l’écran Details avec une transition Fade. Redéfinit la variable de contexte ID sur 12. Redéfinit la variable de contexte Shade sur Color.Red. L’écran actif disparaît par atténuation pour afficher l’écran Details. La variable de contexte ID sur l’écran Details est définie sur 12 et la variable de contexte Shade sur Color.Red. Si vous définissez la propriété Fill d’un contrôle sur l’écran Details sur Shade, ce contrôle s’affiche en rouge.
Back() Permet de revenir à l’écran précédent à l’aide de la transition inverse. Power Apps annule la dernière transition pour afficher l’écran précédent.
Back(ScreenTransition.Cover) Permet de revenir à l’écran précédent à l’aide de la transition Cover. Utilise la transition Cover quelle que soit la façon dont l’écran actif a été saisi.

En résumé, les fonctions Navigate et Back prennent en charge des paramètres pour un contrôle amélioré. Avec la fonction Navigate, vous pouvez rediriger les utilisateurs vers un autre écran, appliquer des transitions et définir des variables de contexte. La fonction Back permet la navigation inverse avec des transitions par défaut ou spécifiées.

Jusqu’à présent, vous avez activé la navigation entre les écrans à l’aide de la propriété OnSelect. Dans l’unité suivante, vous allez découvrir d’autres manières d’y parvenir.