React Router基础教程

React是个技术栈,单单使用React很难构建复杂的Web应用程序,不少状况下咱们须要引入其余相关的技术html

React Router是React的路由库,保持相关页面部件与URL间的同步react

 

下面就来简单介绍其基础使用,更全面的可参考 指南git

 

1. 它看起来像是这样

在页面文件中github

在外部脚本文件中npm

 

2. 库的引入

React Router库的引入,有两种方式浏览器

2.1 浏览器直接引入服务器

能够引用 这里 的浏览器版本,或者下载以后引入babel

而后就能够直接使用 ReactRouter 这个对象了,咱们可能会使用到其中的几个属性react-router

let {Router, Route, IndexRoute, Redirect, IndexRedirect, Link, IndexLink, hashHistory, browserHistory} = ReactRouter;

2.2 npm 安装,经过构建工具编译引入ide

npm install --save react-router

安装好路由库以后,在脚本文件中引入相关属性

import {Router, Route, IndexRoute, Redirect, IndexRedirect, Link, IndexLink, hashHistory, browserHistory} from 'react-router';

因浏览器目前还不能支持importexport命令,且babel工具不会将require命令编译,因此咱们还得须要如Webpack等构建工具编译引入

 

库引入以后,在ReactDOM的render方法中,就可使用相关的组件了

 

3. 路由简单使用

最基本的,经过URL判断进入哪一个页面(组件部件)

class First extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return <p>First</p>
    }
}

class Second extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return <p>Second</p>
    }
}

class App extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return <div></div>
    }
}
render((
    <Router history={hashHistory}>
        <Route path="/" component={App} />
        <Route path="first" component={First} />
        <Route path="second" component={Second} />
    </Router>
    ),
    document.getElementById('box')
);

首先,Router是一个容器,history属性定义了是用何种方式处理页面的URL

有三种

  • browserHistory:经过URL的变化改变路由,是推荐的一种方式,可是须要在服务器端须要作一些配置(窝目前还不知怎么配)
  • hashHistory:经过#/ ,其实就像是单页面应用中常见的hashbang方式,example.com/#/path/path.. (使用简单,这里暂且就用这种方式)
  • createMemoryHistory:Memory history 并不会从地址栏中操做或是读取,它可以帮助咱们完成服务器端的渲染,咱们得手动建立history对象

而后,在容器中使用Route组件定义各个路由,经过path指定路径(能够看到,是不区分大小写的),经过component指定该路径使用的组件

也能够直接在Router容器上直接用routes属性定义各个路由,如

let routes =
    <div>
        <Route path="/" component={App} />
        <Route path="first" component={First} />
        <Route path="second" component={Second} />
    </div>;

render(<Router routes={routes} history={hashHistory}></Router>, document.getElementById('box'));

须要注意的是{routes}中只能有一个父级,因此这里加了<div>标签

 

另外,路由Route也能够嵌套,在上面的例子中,嵌套起来可能更符合实际状况

须要注意的是,这里的App在父级,为了获取子级的First与Second组件,须要在App组件中添加 this.props.children 获取

class App extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return <div>{this.props.children}</div>
    }
}

render((
    <Router history={hashHistory}>
        <Route path="/" component={App}>
            <Route path="first" component={First} />
            <Route path="second" component={Second} />
        </Route>
    </Router>
    ),
    document.getElementById('box')
);

一样的,能够直接在Router中用routes属性定义路由

let routes =
        <Route path="/" component={App}>
            <Route path="first" component={First} />
            <Route path="second" component={Second} />
        </Route>;

render(<Router routes={routes} history={hashHistory}></Router>, document.getElementById('box'));

 

4. 路由的其余组件

除了基本的Route以外,IndexRoute、Redirect、IndexRedirect、Link、IndexLink等,顾名思义

  • IndexRoute: 在主页面会用到,如上个例子中,在路径"/"下咱们看到的是空白页面,能够添加默认的页面组件用于导航
  • Link: 能够认为它是<a>标签在React中的实现,使用to属性定义路径,还能够经过activeClassactiveStyle定义active的样式
  • IndexLink: 相似Link,推荐用来定义指向主页面的连接,固然也能够随意定义

class First extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return (
            <p>First
                <IndexLink to="/" activeStyle={{color: 'red'}}>Basic</IndexLink>
            </p>
        )
    }
}

class Second extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return <p>Second</p>
    }
}

class Basic extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return (
            <ul role="nav">
                <li><IndexLink to="/" activeStyle={{color: 'red'}}>Basic</IndexLink></li>
                <li><Link to="/first" activeStyle={{color: 'red'}}>First</Link></li>
                <li><Link to="/Second" activeClass="active">Second</Link></li>
            </ul>
        )
    }
}

class App extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return <div>
            {this.props.children}
        </div>
    }
}


render((
    <Router history={hashHistory}>
        <Route path="/" component={App}>
            <IndexRoute component={Basic} />
            <Route path="first" component={First} />
            <Route path="second" component={Second} />
        </Route>
    </Router>
    ),
    document.getElementById('box')
);
  • Redirect: 从from路径重定向到to路径
  • IndexRedirect: 在主页面,直接重定向到to路径

render((
    <Router history={hashHistory}>
        <Route path="/" component={App}>
            <IndexRoute component={Basic} />
            <IndexRedirect to="first" />
            <Redirect from="second" to="first" />
            <Route path="first" component={First} />
            <Route path="second" component={Second} />
        </Route>
    </Router>
    ),
    document.getElementById('box')
);

 

5. 路由的path规则

path定义的路由的路径,在hashHistory中,它的主页路径是#/ 

自定义Route路由经过与父Route的path进行合并,在与主页路径合并,获得最终的路径

path的语法

  • :paramName 匹配 URL 的一个部分,直到遇到下一个/、?、#
  • () 表示URL的这个部分是可选的
  • * 匹配任意字符(非贪婪模式),直到模式里面的下一个字符为止
  • ** 匹配任意字符(贪婪模式),直到下一个/、?、#为止
<Route path="/hello/:name">         // 匹配 /hello/michael 和 /hello/ryan
<Route path="/hello(/:name)">       // 匹配 /hello, /hello/michael, 和 /hello/ryan
<Route path="/files/*.*">           // 匹配 /files/hello.jpg 和 /files/hello.html
<Route path="/**/*.jpg">            // 匹配 /files/hello.jpg 和 /files/path/to/file.jpg

而:name能够经过 this.props.params 中取到

class First extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return (
            <p>First {this.props.params.name}
                <IndexLink to="/" activeStyle={{color: 'red'}}>Basic</IndexLink>
            </p>
        )
    }
}

.
.

<Route path="/:name" component={First} />

经过React Dev Tool也能够看到组件的相关数据

 

6. 路由的onEnter、onLeave钩子

在路由的跳转中,咱们可能须要在进入页面或离开页面的时候作一些特殊操做,Route 经过 onEnter 与 onLeave 定义了这两个行为

      <Route path="first" component={First} onEnter={(nextState, replace) => {
                console.log(nextState);
                alert('onEnter');
                // replace('second');
            }} onLeave={() => {
                alert('onLeave');
            }}/>

如上,带两个参数,经过 replace 能够更新路径,把注释去掉后,进入"/first"时立马跳转值"/second",这在检测登陆时应该比较有用

 

更多的使用参见 指南

相关文章
相关标签/搜索