React是個技術棧,單單使用React很難構建複雜的Web應用程序,不少狀況下咱們須要引入其餘相關的技術html
React Router是React的路由庫,保持相關頁面部件與URL間的同步react
下面就來簡單介紹其基礎使用,更全面的可參考 指南git
在頁面文件中github
在外部腳本文件中npm
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';
因瀏覽器目前還不能支持import與export命令,且babel工具不會將require命令編譯,因此咱們還得須要如Webpack等構建工具編譯引入
庫引入以後,在ReactDOM的render方法中,就可使用相關的組件了
最基本的,經過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
有三種:
而後,在容器中使用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'));
除了基本的Route以外,IndexRoute、Redirect、IndexRedirect、Link、IndexLink等,顧名思義
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') );
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') );
path定義的路由的路徑,在hashHistory中,它的主頁路徑是#/
自定義Route路由經過與父Route的path進行合併,在與主頁路徑合併,獲得最終的路徑
<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也能夠看到組件的相關數據
在路由的跳轉中,咱們可能須要在進入頁面或離開頁面的時候作一些特殊操做,Route 經過 onEnter 與 onLeave 定義了這兩個行爲
<Route path="first" component={First} onEnter={(nextState, replace) => { console.log(nextState); alert('onEnter'); // replace('second'); }} onLeave={() => { alert('onLeave'); }}/>
如上,帶兩個參數,經過 replace 能夠更新路徑,把註釋去掉後,進入"/first"時立馬跳轉值"/second",這在檢測登陸時應該比較有用
更多的使用參見 指南