react-redirect-side-effect
v2.0.2
Published
A declarative, nested, stateful window.location for React
Downloads
415
Maintainers
Readme
React Redirect Side Effect
Fork of react-redirect working with last React version (>=15.4.0).
Provides a declarative way to specify window.location
in a single-page app.
This component can be used on server side as well.
Built with React Side Effect.
====================
Installation
npm install --save react-redirect
Dependencies: React >= 15.5.0
Features
- Like a normal React compoment, can use its parent's
props
andstate
; - Can be defined in many places throughout the application;
- Supports arbitrary levels of nesting, so you can define app-wide and page-specific titles;
- Works just as well with isomorphic apps.
Example
Assuming you use something like react-router:
var App = React.createClass({
render: function () {
// Redirect to "www.driftt.com" if no child overrides this
return (
<ReactRedirect location='www.driftt.com'>
<this.props.activeRouteHandler />
</ReactRedirect>
);
}
});
var HomePageRedirect = React.createClass({
render: function () {
// redirect to "www.driftt.com" while this component is mounted
return (
<ReactRedirect location='www.driftt.com'>
</ReactRedirect>
);
}
});
var NewArticlePage = React.createClass({
mixins: [LinkStateMixin],
render: function () {
// Redirect using value from state when this component is mounted
return (
<ReactRedirect location={this.state.redirect || ''}>
<div>
Redirecting...
</div>
</ReactRedirect>
);
}
});
Server Usage
If you use it on server, call ReactRedirect.rewind()
after rendering components to string to retrieve the redirect location given to the innermost ReactRedirect
. You can then embed this title into HTML page template.
Because this component keeps track of mounted instances, you have to make sure to call rewind
on server, or you'll get a memory leak.
Example assuming you use express for your server
var middleWare = function(req, res) {
var html = React.renderToString(React.createElement(component));
var redirect = ReactRedirect.rewind();
if (redirect) {
res.redirect(302, redirect);
} else {
res.end(html);
}
}