首页 > 其他 > 详细

React Router

时间:2017-01-24 01:34:38      阅读:367      评论:0      收藏:0      [点我收藏+]

一、安装

安装命令如下:

$ npm install -S react-router

使用时,路由器Router就是React的一个组件。

 

二、基本用法

Router组件本身只是一个容器,真正的路由要通过Route组件定义。

import { Router, Route, hashHistory } from ‘react-router‘;
import React from "react"

React.render((
  <Router history={hashHistory}>
    <Route path="/" component={App}/>
  </Router>
), document.getElementById(‘app‘));

上面代码中,用户访问根路由/(比如http://www.example.com/),组件APP就会加载到document.getElementById(‘app‘)

你可能还注意到,Router组件有一个参数history,它的值hashHistory表示,路由的切换由URL的hash变化决定,即URL的#部分发生变化。举例来说,用户访问http://www.example.com/,实际会看到的是http://www.example.com/#/

Route组件定义了URL路径与组件的对应关系。你可以同时使用多个Route组件。

<Router history={hashHistory}>
  <Route path="/" component={App}/>
  <Route path="/repos" component={Repos}/>
  <Route path="/about" component={About}/>
</Router>

上面代码中,用户访问/repos(比如http://localhost:8080/#/repos)时,加载Repos组件;访问/abouthttp://localhost:8080/#/about)时,加载About组件。

 

三、嵌套路由

 你的UI界面可能是这个样子的:

             +-------------------------------------+
             | Home Repos About                    | <- App
             +------+------------------------------+
              |         |                          |
Repos->       | repo    |  Repo 1                  |
              |         |                          |
              | repo    |  Boxes inside boxes      |
              |         |  inside boxes ...        | <- Repo
              | repo    |                          |
              |         |                          |
              | repo    |                          |
              |         |                          |
             +------+------------------------------+

我们可以把about和repos组件嵌套进app,因此我们可以在app中所有页面共享导航。我们需要分两步来实现

首先将Repo和About的Route嵌套进APP中

<Router history={hashHistory}>
  <Route path="/" component={App}>
    <Route path="/repos" component={Repos}/>
    <Route path="/about" component={About}/>
  </Route>
</Router>

 

然后在APP组件中render进子节点

render() {
    return (
      <div>
        <h1>React Router Tutorial</h1>
        <ul role="nav">
          <li><Link to="/about">About</Link></li>
          <li><Link to="/repos">Repos</Link></li>
        </ul>

        {/* add this */}
        {this.props.children}

      </div>
    )
  }

上面代码中,App组件的this.props.children属性就是子组件。

子路由也可以不写在Router组件里面,单独传入Router组件的routes属性。

let routes = <Route path="/" component={App}>
  <Route path="/repos" component={Repos}/>
  <Route path="/about" component={About}/>
</Route>;

<Router routes={routes} history={browserHistory}/>

上面代码中,用户访问/repos时,会先加载App组件,然后在它的内部再加载Repos组件。

<App>
  <Repos/>
</App>

 

四、path属性

Route组件的path属性指定路由的匹配规则。这个属性是可以省略的,这样的话,不管路径是否匹配,总是会加载指定组件。

请看下面的例子。

<Route path="inbox" component={Inbox}>
   <Route path="messages/:id" component={Message} />
</Route>

上面代码中,当用户访问/inbox/messages/:id时,会加载下面的组件。

<Inbox>
  <Message/>
</Inbox>

如果省略外层Routepath参数,写成下面的样子

<Route component={Inbox}>
  <Route path="inbox/messages/:id" component={Message} />
</Route>

现在用户访问/inbox/messages/:id时,外层的Inbox组件不管路径是否匹配都会加载出来,因此组件加载还是原来的样子。

<Inbox>
  <Message/>
</Inbox>

 

五、通配符

<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="/files/*">
// 匹配 /files/ 
// 匹配 /files/a
// 匹配 /files/a/b

<Route path="/**/*.jpg">
// 匹配 /files/hello.jpg
// 匹配 /files/path/to/file.jpg

匹配规则如下:

(1):paramName

:paramName匹配URL的一个部分,直到遇到下一个/?#为止。这个路径参数可以通过this.props.params.paramName取出。

(2)()

()表示URL的这个部分是可选的。

(3)*

*匹配任意字符,直到模式里面的下一个字符为止。匹配方式是非贪婪模式。

(4) **

** 匹配任意字符,直到下一个/?#为止。匹配方式是贪婪模式。

 

path属性也可以使用相对路径(不以/开头),匹配时就会相对于父组件的路径,可以参考上一节的例子。嵌套路由如果想摆脱这个规则,可以使用绝对路由。

路由匹配规则是从上到下执行,一旦发现匹配,就不再其余的规则了。设置路径参数时,需要特别小心这一点。

<Router>
  <Route path="/:userName/:id" component={UserPage}/>
  <Route path="/about/me" component={About}/>
</Router>

上面代码中,用户访问/about/me时,不会触发第二个路由规则,因为它会匹配/:userName/:id这个规则。因此,带参数的路径一般要写在路由规则的底部。

此外,URL的查询字符串/foo?bar=baz,可以用this.props.location.query.bar获取。

 

六、IndexRoute

当运行下面这个例子时

<Router>
  <Route path="/" component={App}>
    <Route path="accounts" component={Accounts}/>
    <Route path="statements" component={Statements}/>
  </Route>
</Router>

 

我们直接访问根路径/,不会加载任何子组件。也就是说,App组件的this.props.children,这时是undefined。因此我们想要创建一个Home页,当访问根路径时加载。

使用IndexRoute解决这个问题,显式指定Home是根路由的子组件,即指定默认情况下加载的子组件。你可以把IndexRoute想象成某个路径的index.html

<Router>
  <Route path="/" component={App}>
    <IndexRoute component={Home}/>
    <Route path="accounts" component={Accounts}/>
    <Route path="statements" component={Statements}/>
  </Route>
</Router>

现在,用户访问/的时候,加载的组件结构如下。

<App>
  <Home/>
</App>

这种组件结构就很清晰了:App只包含下级组件的共有元素,本身的展示内容则由Home组件定义。这样有利于代码分离,也有利于使用React Router提供的各种API。

注意,IndexRoute组件没有路径参数path。

 

七、Link

 Link组件用于取代<a>元素,生成一个链接,允许用户点击后跳转到另一个路由。它基本上就是<a>元素的React 版本,可以接收Router的状态。

Link和a标签的不同之处在与Link知道它连接到的路径是否处于激活状态,这样你就可以给激活的链接添加不同的样式

render() {
  return <div>
    <ul role="nav">
      <li><Link to="/about">About</Link></li>
      <li><Link to="/repos">Repos</Link></li>
    </ul>
  </div>
}

如果希望当前的路由与其他路由有不同样式,这时可以使用Link组件的activeStyle属性。

<Link to="/about" activeStyle={{color: ‘red‘}}>About</Link>
<Link to="/repos" activeStyle={{color: ‘red‘}}>Repos</Link>

上面代码中,当前页面的链接会红色显示。

另一种做法是,使用activeClassName指定当前路由的Class

<Link to="/about" activeClassName="active">About</Link>
<Link to="/repos" activeClassName="active">Repos</Link>

 

封装Link

你的站点的大多数链接不需要知道他们是否处于激活状态,通常只有主导航需要知道。因此将它封装起来是很有用的。

import React from ‘react‘
import { Link } from ‘react-router‘

export default React.createClass({
  render() {
    return <Link {...this.props} activeClassName="active"/>
  }
})

这样你不需要管理随处都有的activeClassName和activeStyle.

需要使用时可以直接引入上面的组件,

<li><NavLink to="/about">About</NavLink></li>
<li><NavLink to="/repos">Repos</NavLink></li>

 

八、IndexLink

如果我们想要在链接到根路由/时,处于Active状态,如果我们这样使用

// APP.js
<li><NavLink to="/">Home</NavLink></li>

 

你会发现很奇怪的事情,Home链接一直都是active状态,因为当子组件的路径处于激活状态时,父组件也会处于激活状态,而/是所有组件的父组件,因此它会一直处于active状态。如果希望只在indexRoute激活时处于active状态,有两种方法:

1. IndexLink

<IndexLink to="/" activeClassName="active">
  Home
</IndexLink>

上面代码中,根路由只会在精确匹配时,才具有activeClassName

2. 使用Link组件的onlyActiveOnIndex属性

<Link to="/" activeClassName="active" onlyActiveOnIndex={true}>
  Home
</Link>

 

 

因此也可以这样使用

<li><NavLink to="/" onlyActiveOnIndex={true}>Home</NavLink></li>

 

因为我们把所有的属性都传递给了NavLink组件,因此可以这样来实现。

 

九、history属性

 

React Router

原文:http://www.cnblogs.com/YangqinCao/p/6345211.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!