Fonctions Back et Navigate dans PowerAppsBack and Navigate functions in PowerApps

Permet de modifier l’écran qui s’affiche.Changes which screen is displayed.

Vue d’ensembleOverview

La plupart des applications contiennent plusieurs écrans.Most apps contain multiple screens. Utilisez les fonctions Back et Navigate pour modifier l’écran qui s’affiche.Use the Back and Navigate function to change which screen is displayed. Par exemple, définissez la propriété OnSelect d’un bouton sur une formule qui inclut une fonction Navigate si vous souhaitez afficher un écran différent lorsqu’un utilisateur appuie sur ce bouton.For example, set the OnSelect property of a button to a formula that includes a Navigate function if you want to show a different screen when a user selects that button. Dans cette formule, vous pouvez indiquer une transition visuelle, par exemple un effet de fondu, pour contrôler le passage d’un écran à un autre.In that formula, you can specify a visual transition, such as Fade, to control how one screen changes to another.

Back et Navigate modifient uniquement l’écran qui s’affiche.Back and Navigate change only which screen is displayed. Les écrans qui ne s’affichent pas continuent de fonctionner à l’arrière-plan.Screens that aren't currently displayed continue to operate behind the scenes. Vous pouvez créer des formules qui font référence à des propriétés de contrôles sur d’autres écrans.You can build formulas that refer to properties of controls on other screens. Par exemple, un utilisateur peut modifier la valeur d’un curseur sur un écran, accéder à un autre écran qui utilise cette valeur dans une formule et déterminer la façon dont il affecte ce qui se produit dans le nouvel écran.For example, a user can change the value of a slider on one screen, navigate to a different screen that uses that value in a formula, and ascertain how it affects what happens in the new screen. L’utilisateur peut ensuite revenir à l’écran d’origine et confirmer que le curseur a conservé sa valeur.The user can then navigate back to the original screen and confirm that the slider has retained its value.

Les variables de contexte sont également préservées lorsqu’un utilisateur navigue d’un écran à l’autre.Context variables are also preserved when a user navigates between screens. Vous pouvez utiliser Navigate afin de définir une ou plusieurs variables de contexte pour l’écran que la formule va afficher. Il s’agit là du seul moyen de définir une variable de contexte depuis l’extérieur de l’écran.You can use Navigate to set one or more context variables for the screen that the formula will display, which is the only way to set a context variable from outside the screen. Utilisez cette approche pour transmettre des paramètres à un écran.You can use this approach to pass parameters to a screen. Si vous avez utilisé un autre outil de programmation, cette approche est similaire à celle consistant à transmettre des paramètres à des procédures.If you've used another programming tool, this approach is similar to passing parameters to procedures.

Vous pouvez utiliser l’une ou l’autre fonction uniquement dans une formule de comportement.You can use either function only within a behavior formula.

Dans le premier argument, indiquez le nom de l’écran à afficher.In the first argument, specify the name of the screen to display.

Dans le deuxième argument, indiquez comment effectuer la transition de l’ancien écran au nouvel écran :In the second argument, specify how the old screen changes to the new screen:

Argument de transitionTransition Argument DescriptionDescription CompagniesDemonstration
ScreenTransition.CoverScreenTransition.Cover Le nouvel écran diapositives s’affiche, en se déplaçant de droite à gauche pour couvrir l’écran actuel.The new screen slides into view, moving right to left, to cover the current screen. animation de couverture de transition d’écran
ScreenTransition.CoverRightScreenTransition.CoverRight Le nouvel écran diapositives s’affiche, en se déplaçant de gauche à droite, pour couvrir l’écran actuel.The new screen slides into view, moving left to right, to cover the current screen. animation de couverture droite de la transition d’écran
ScreenTransition.FadeScreenTransition.Fade L’écran actuel disparaît en fondu pour révéler le nouvel écran.The current screen fades away to reveal the new screen. animation fondu de transition d’écran
ScreenTransition. None (par défaut)ScreenTransition.None (Default) Le nouvel écran remplace rapidement l’écran actuel.The new screen quickly replaces the current screen. animation d’aucune transition d’écran
ScreenTransition.UnCoverScreenTransition.UnCover L’écran actuel disparaît, en le déplaçant de droite à gauche, pour découvrir le nouvel écran.The current screen slides out of view, moving right to left, to uncover the new screen. animation de la transition d’écran
ScreenTransition.UnCoverRightScreenTransition.UnCoverRight L’écran actuel disparaît, en le déplaçant de gauche à droite, pour découvrir le nouvel écran.The current screen slides out of view, moving left to right, to uncover the new screen. animation de la transition d’écran de droite

Vous pouvez utiliser Navigate pour créer ou mettre à jour les variables de contexte du nouvel écran.You can use Navigate to create or update context variables of the new screen. Comme troisième argument facultatif, transférez un enregistrement contenant le nom de la variable de contexte en tant que nom de colonne et la nouvelle valeur de la variable de contexte.As an optional third argument, pass a record that contains the context-variable name as a column name and the new value for the context variable. Cet enregistrement est le même que celui que vous utilisez avec la fonction UpdateContext .This record is the same as the record that you use with the UpdateContext function.

Définissez la propriété OnHidden de l’ancien écran et la propriété OnVisible du nouvel écran, ou les deux pour apporter des modifications supplémentaires pendant la transition.Set the OnHidden property of the old screen, the OnVisible property of the new screen, or both to make additional changes during the transition. La propriété App.ActiveScreen est mise à jour pour refléter ces modifications.The App.ActiveScreen property will be updated to reflect the change.

La méthode Navigate retourne normalement la valeur true , mais retourne la valeur false si une erreur est rencontrée.Navigate normally returns true but will return false if an error is encountered.

BackBack

La fonction Back retourne à l’écran qui a été affiché le plus récemment.The Back function returns to the screen that was most recently displayed.

Pour chaque appel de navigation , l’application effectue le suivi de l’écran qui s’est affiché et de la transition.For each Navigate call, the app tracks the screen that appeared and the transition. Vous pouvez utiliser des appels Back successifs pour revenir à l’écran qui s’est affiché lorsque l’utilisateur a démarré l’application.You can use successive Back calls to return all the way to the screen that appeared when the user started the app.

Lorsque la fonction Back est exécutée, la transition inverse est utilisée par défaut.When the Back function runs, the inverse transition is used by default. Par exemple, si un écran est apparu à travers la transition CoverRight , Back utilise Decover (qui se trouve à gauche) pour retourner.For example, if a screen appeared through the CoverRight transition, Back uses UnCover (which is to the left) to return. Les inversions ne sont pas les mêmes .Fade and None are their own inverses. Passez un argument facultatif à la valeur Back pour forcer une transition spécifique.Pass an optional argument to Back to force a specific transition.

Back retourne normalement la valeur true , mais retourne la valeur false si l’utilisateur n’a pas accédé à un autre écran depuis le démarrage de l’application.Back normally returns true but returns false if the user hasn't navigated to another screen since starting the app.

SyntaxeSyntax

Précédent([ transition ])Back( [ Transition ] )

  • Transition -facultatif.Transition - Optional. Transition visuelle à utiliser entre l’écran actuel et l’écran précédent.The visual transition to use between the current screen and the previous screen. Reportez-vous à la liste des valeurs valides pour cet argument précédemment dans cette rubrique.Refer to the list of valid values for this argument earlier in this topic. Par défaut, la transition à travers laquelle un écran retourne est l’inverse de la transition par laquelle il apparaît.By default, the transition through which a screen returns is the inverse of the transition through which it appeared.

Naviguer( écran [; transition [; UpdateContextRecord ]])Navigate( Screen [; Transition [; UpdateContextRecord ] ] )

  • Screen : requis.Screen - Required. Écran à afficher.The screen to display.
  • Transition -facultatif.Transition - Optional. Transition visuelle à utiliser entre l’écran actuel et l’écran suivant.The visual transition to use between the current screen and the next screen. Consultez la liste des valeurs valides pour cet argument telles que répertoriées précédemment dans cette rubrique.See the list of valid values for this argument earlier in this topic. La valeur par défaut est None.The default value is None.
  • UpdateContextRecord : facultatif.UpdateContextRecord - Optional. Enregistrement contenant le nom d’au moins une colonne et une valeur pour cette colonne.A record that contains the name of at least one column and a value for each column. Cet enregistrement met à jour les variables de contexte du nouvel écran comme si elles étaient transmises à la fonction UpdateContext .This record updates the context variables of the new screen as if passed to the UpdateContext function.

ExemplesExamples

FormuleFormula DescriptionDescription RésultatResult
Naviguer (détails)Navigate( Details ) Affiche l’écran Details sans transition ni changement de valeur d’une variable de contexte.Displays the Details screen with no transition or change in value for a context variable. L’écran Details apparaît rapidement.The Details screen appears quickly.
Navigate( Details; ScreenTransition.Fade )Navigate( Details; ScreenTransition.Fade ) Affiche l’écran Details avec une transition de type fondu.Displays the Details screen with a Fade transition. Aucune valeur de variable de contexte n’est modifiée.No value of a context variable is changed. L’écran actuel disparaît dans un effet de fondu pour révéler l’écran Details.The current screen fades away to show the Details screen.
Navigate( Details; ScreenTransition.Fade; { ID: 12 } )Navigate( Details; ScreenTransition.Fade; { ID: 12 } ) Affiche l’écran Details avec une transition de type fondu, puis met à jour l’identifiant de la variable de contexte en lui donnant pour valeur 12.Displays the Details screen with a Fade transition, and updates the value of the ID context variable to 12. L’écran actuel disparaît dans un effet de fondu pour révéler l’écran Details, et l’identifiant de la variable de contexte de cet écran est défini sur 12.The current screen fades away to show the Details screen, and the context variable ID on that screen is set to 12.
Navigate( Details; ScreenTransition.Fade; { ID: 12 ; Shade: Color.Red } )Navigate( Details; ScreenTransition.Fade; { ID: 12 ; Shade: Color.Red } ) Affiche l’écran Details avec une transition de type fondu.Displays the Details screen with a Fade transition. Met à jour la valeur de l’identifiant de la variable de contexte en lui donnant pour valeur 12, puis met à jour la valeur de la variable de contexte Shade en lui donnant pour valeur Color.Red.Updates the value of the ID context variable to 12, and updates the value of the Shade context variable to Color.Red. L’écran actuel disparaît dans un effet de fondu pour révéler l’écran Details.The current screen fades away to show the Details screen. L’identifiant de la variable de contexte de l’écran Details est défini sur 12, et la variable de contexte Shade est définie sur Color.Red.The context variable ID on the Details screen is set to 12, and the context variable Shade is set to Color.Red. Si vous définissez la propriété Fill d’un contrôle de l’écran Details sur Shade, ce contrôle s’affiche en rouge.If you set the Fill property of a control on the Details screen to Shade, that control would display as red.
Back()Back() Affiche l’écran précédent avec la transition de retour par défaut.Displays the previous screen with the default return transition. Affiche l’écran précédent à travers la transition inverse de la transition à travers laquelle l’écran actuel est apparu.Displays the previous screen through the inverse transition of the transition through which the current screen appeared.
Retour (ScreenTransition. Cover)Back( ScreenTransition.Cover ) Affiche l’écran précédent avec la transition de la couverture .Displays the previous screen with the Cover transition. Affiche l’écran précédent à travers la transition de couverture , quelle que soit la transition par laquelle l’écran actuel apparaissait.Displays the previous screen through the Cover transition, regardless of the transition through which the current screen appeared.

Étape par étapeStep-by-step

  1. Créez une application vide.Create a blank app.

  2. Ajoutez un deuxième écran.Add a second screen to it.

    L’application contient deux écrans vides : Screen1 et Screen2.The app contains two blank screens: Screen1 and Screen2.

  3. Affectez à la propriété Fill de Screen2 la valeur Gray.Set the Fill property of Screen2 to the value Gray.

  4. Sur Screen2, ajoutez un bouton, puis définissez sa propriété onselect sur la formule suivante :On Screen2, add a button, and set its OnSelect property to this formula:

    Navigate( Screen1; ScreenTransition.Cover )
    
  5. Tout en maintenant la touche ALT enfoncée, sélectionnez le bouton.While holding down the Alt key, select the button.

    Screen1 s’affiche avec un arrière-plan blanc via une transition qui recouvre à gauche.Screen1 appears with a white background through a transition that covers to the left.

  6. Sur screen1, ajoutez un bouton, puis définissez sa propriété onselect sur la formule suivante :On Screen1, add a button, and set its OnSelect property to this formula:

    Back()
    
  7. Tout en maintenant la touche ALT enfoncée, sélectionnez le bouton.While holding down the Alt key, select the button.

    Le deuxième écran apparaît avec un arrière-plan gris à travers une transition qui se dévoile à droite (l’inverse de la couverture).The second screen appears with a gray background through a transition that uncovers to the right (the inverse of Cover).

  8. Sélectionnez le bouton sur chaque écran à plusieurs reprises pour revenir en arrière et en sens inverse.Select the button on each screen repeatedly to bounce back and forth.

Autre exempleAnother example