React Reference > Navigator Component

<Navigator />

This component is responsible for page transitioning and managing the pages of your OnsenUI application. In order to manage to display the pages, the navigator needs to define the renderPage method, that takes an route and a navigator and converts it to an page.

Usage 

<Navigator
    renderPage={(route, navigator) =>
     <MyPage
       title={route.title}
       onPop={() => navigator.popPage()}
       />
    }
    initialRoute={{
        title: 'First Page'
    }} />
   }
 }

Props

[improve this]
Name Type Description
renderPage func This function takes the current route object as a parameter and returns a React component. Required.
initialRouteStack array

This array contains the initial routes from the Navigator, which will be used to render the initial pages in the renderPage method.

Optional.
initialRoute object

This array contains the initial route of the navigator, which will be used to render the initial pages in the renderPage method.

Optional.
onPrePush func
() => null 		Called just before a page is pushed. It gets an event object with route information. Optional.
onPostPush func
() => null 		Called just after a page is pushed. It gets an event object with route information. Optional.
onPrePop func
() => null 		Called just before a page is popped. It gets an event object with route information. Optional.
onPostPop func
() => null 		Called just after a page is popped. It gets an event object with route information. Optional.
animation string

Animation name. Available animations are "slide", "lift", "fade" and "none". These are platform based animations. For fixed animations, add "-ios" or "-md" suffix to the animation name. E.g. "lift-ios", "lift-md". Defaults values are "slide-ios" and "fade-md".

Optional.
animationOptions object Specify the animation’s duration, delay and timing. E.g. {duration: 0.2, delay: 0.4, timing: 'ease-in'}. Optional.
swipeable union Enables swipe-to-pop functionality for iOS. Optional.
swipePop func Optional function called on swipe-to-pop. If provided, must perform a popPage with the given options object. Optional.
onDeviceBackButton func Custom handler for device back button. Optional.

Need Help?

If you have any questions, use our Community Forum or talk to us on Discord chat. The Onsen UI team and your peers in the community will work together to help solve your issues.

For bug reports and feature requests use our GitHub Issues page.