Router for React Native based on new React Native Navigation API.
- Mini-Tutorial
- API and Configuration
- Available Imports
- Router API
- Scene API
- Detailed Example
- Reactive/Redux/Flux
- Other Info
- Modals
- Tabbar
- Custom navbar
- Switch
- Splitting Scenes
- Drawer (side-menu)
- Sub-Scenes
- Changelog
- Migrating from 2.x
react-native-router-flux
is a routing package that allows you to:
- Define scene transitions in one central location
- Without having to pass navigator objects around, and allow you to
- Call transitions anywhere in your code with a simple syntax (e.g.
Actions.login({username, password})
orActions.profile({profile})
or evenActions.profile(123)
- all params will be part ofthis.props
for given Scene component).
-
Highly Customizable Navigation Bar - Show/hide the navbar depending on Scene or even the state of a Scene (e.g. Edit/Save navbar for edit mode).
-
Tab Bar Support using react-native-tabs (see Example app).
-
Nested Navigators (e.g. Each tab can have its own navigator, nested in a root navigator).
-
Custom Scene Renderers for action sheet, native TabBarIOS or anything else. See built-in
Modal
renderer (to display popups) for example. Call for PRs! let's build some custom renderers for ActionSheet, Drawer, etc. Let's make an awesome library! Currently, if you want to use Action Sheets you'll need to use a 3rd party module. -
Dynamic Routing allows you to choose which scene to render depending on application state (see the
Switch
renderer, useful for authentication). -
Bring Your Own Reducer for navigation state.
-
Reset History Stack - The new
reset
Action for clearing the history stack and eliminates the navbar back button. -
More Powerful State Control - Support for having different states while on the same screen. For example, "View My Account" could allow in-place editing of fields and "Save", "Cancel" navigation bar buttons should appear.
Check out the mini-tutorial for a quick walkthrough of the routing system.
Before instaling please refer to the following table for supported react native series
React Native - Series | React Native Router Flux - Series | Notes |
---|---|---|
v0.22.x | v3.22.x | |
v0.23.x, v0.24.x & v0.25.x | Not supported | Please refer to #636 |
v0.26.x | v3.26.x | |
v0.27.x | Work in progress, currently not supported | Please refer to #786 |
v0.28.x Release Candidate | currently not supported |
npm i react-native-router-flux --save
In your top-level index.js
, define your scenes using the Scene
component and pass it into the Router
as children:
import {Scene, Router} from 'react-native-router-flux';
class App extends React.Component {
render() {
return <Router>
<Scene key="root">
<Scene key="login" component={Login} title="Login"/>
<Scene key="register" component={Register} title="Register"/>
<Scene key="home" component={Home}/>
</Scene>
</Router>
}
}
Alternatively, you could define all of your scenes during compile time and use it later within Router
:
import {Actions, Scene, Router} from 'react-native-router-flux';
const scenes = Actions.create(
<Scene key="root">
<Scene key="login" component={Login} title="Login"/>
<Scene key="register" component={Register} title="Register"/>
<Scene key="home" component={Home}/>
</Scene>
);
/* ... */
class App extends React.Component {
render() {
return <Router scenes={scenes}/>
}
}
On any Scene, you can also call the following functions by first importing the Actions
object:
import {Actions} from 'react-native-router-flux'
And then:
Actions.ACTION_NAME(PARAMS)
will call the appropriate action and params will be passed to the scene.Actions.pop()
will pop the current screen.Actions.refresh(PARAMS)
will update the properties of the current screen.
- GuavaPass.com (iOS, Android) - offers convenient access to top classes at boutique fitness studios across Asia.
- Epic Fail Videos (iOS, Android) - The best Fail Videos Collection, never miss a laugh with your friends!
Thanks to all who submitted PRs to 2.x release. If you like the component and want to support it, feel free to donate any amount or help with issues.