onnavigating event

A page navigation event that occurs after onbeforenavigate and before onnavigated. This event can be used to perform other actions during navigation.


WinJS.Navigation.addEventListener("navigating", listenerName);
WinJS.Application.onnavigating = listenerName;

Event information

Synchronous No
Bubbles Yes
Cancelable Yes

Event handler parameters

  • eventInfo
    Type: CustomEvent**

    An object that contains information about the event. The detail property of this object contains the following sub-properties:

    • location: The URI to navigate to.
    • state: One or more user-defined key-value pairs.
    • delta: The number of pages traversed forward or backward in the navigation stack. This value is typically +1, -1, or the value of distance specified in back or forward.


Minimum WinJS version

WinJS 1.0



See also

For developers

WinJS.Navigation Namespace

WinJS.UI.Hub object

WinJS.UI.AppBar object

WinJS.UI.NavBar object

WinJS.UI.BackButton object

Your first app - Part 3: PageControl objects and navigation

Navigating between pages

Adding app bars

Quickstart: Using single-page navigation

Quickstart: Adding a nav bar (NavBar)

Quickstart: Using a hub control for layout and navigation

HTML Hub control sample

HTML AppBar control sample

HTML NavBar control sample

Navigation and navigation history sample

For designers

Navigation patterns

Command patterns



Bottom app bar

Top app bar

Back button

Guidelines for the hub control

Guidelines for app bars

Making the app bar accessible