Nodeschool Public Materials

    react-router-legacy

    1.0.5 • Public • Published

    !! This is a fork of v1.0.3 to support the latest React breaking changes !!

    Travis npm package Coveralls Discord

    A complete routing library for React

    React Router keeps your UI in sync with the URL. It has a simple API with powerful features like lazy code loading, dynamic route matching, and location transition handling built right in. Make the URL your first thought, not an after-thought.

    Docs & Help

    Note: If you are still using React Router 0.13.x the docs can be found on the 0.13.x branch. Upgrade information is available on the change log.

    For questions and support, please visit our channel on Reactiflux or Stack Overflow. The issue tracker is exclusively for bug reports and feature requests.

    Browser Support

    We support all browsers and environments where React runs.

    Installation

    Using npm:

    $ npm install history react-router-legacy@latest
    

    Note that you need to also install the history package since it is a peer dependency of React Router and won't automatically be installed for you in npm 3+.

    Then with a module bundler like webpack that supports either CommonJS or ES2015 modules, use as you would anything else:

    // using an ES6 transpiler, like babel
    import { Router, Route, Link } from 'react-router-legacy'
     
    // not using an ES6 transpiler
    var Router = require('react-router-legacy').Router
    var Route = require('react-router-legacy').Route
    var Link = require('react-router-legacy').Link

    The UMD build is also available on npmcdn:

    <script src="https://npmcdn.com/react-router-legacy/umd/ReactRouter.min.js"></script>

    You can find the library on window.ReactRouter.

    What's it look like?

    import React from 'react'
    import { render } from 'react-dom'
    import { Router, Route, Link } from 'react-router-legacy'
     
    const App = React.createClass({/*...*/})
    const About = React.createClass({/*...*/})
    // etc.
     
    const Users = React.createClass({
      render() {
        return (
          <div>
            <h1>Users</h1>
            <div className="master">
              <ul>
                {/* use Link to route around the app */}
                {this.state.users.map(user => (
                  <li key={user.id}><Link to={`/user/${user.id}`}>{user.name}</Link></li>
                ))}
              </ul>
            </div>
            <div className="detail">
              {this.props.children}
            </div>
          </div>
        )
      }
    })
     
    const User = React.createClass({
      componentDidMount() {
        this.setState({
          // route components are rendered with useful information, like URL params
          user: findUserById(this.props.params.userId)
        })
      },
     
      render() {
        return (
          <div>
            <h2>{this.state.user.name}</h2>
            {/* etc. */}
          </div>
        )
      }
    })
     
    // Declarative route configuration (could also load this config lazily
    // instead, all you really need is a single root route, you don't need to
    // colocate the entire config).
    render((
      <Router>
        <Route path="/" component={App}>
          <Route path="about" component={About}/>
          <Route path="users" component={Users}>
            <Route path="/user/:userId" component={User}/>
          </Route>
          <Route path="*" component={NoMatch}/>
        </Route>
      </Router>
    ), document.body)

    See more in the Introduction, Advanced Usage, and Examples.

    Thanks

    Thanks to our sponsors for supporting the development of React Router.

    React Router was initially inspired by Ember's fantastic router. Many thanks to the Ember team.

    Also, thanks to BrowserStack for providing the infrastructure that allows us to run our build in real browsers.

    Install

    npm i react-router-legacy

    DownloadsWeekly Downloads

    3

    Version

    1.0.5

    License

    MIT

    Last publish

    Collaborators

    • exilz