摘要:
react-router相对于flux和redux来说,比较好容易理解一点和容易入门一点。这个是根据我之前的一个项目,然后我用react+react-router+webpack重新写的。
不过没有全部写完。只写了一部分。不过用来实战已经足够了。
不过由于这个项目我主要是用来学习react-router,所有有些地方没必要用路由的我还是用了。所以如果要拿去用,这点要注意。
还有就是这个demo不是很完善,需要自己去完善一下。尤其是一些目录结构,由于当时没考虑好。所以可以稍加完善
注意点:此demo是根据react-router 1.0版本来写的。之前版本的用法我没有学过,是直接就学这个版本的。所以如果语法上跟各位的有区别的话,那应该是版本不同所导致的。
当然,大家学习的话应该最好也以1.0版本来学,因为1.0版本相对来说是比较新和稳定的。而且抛弃了很多以前旧的语法,所以和以前版本的语法是有点区别的。目前好像正在出2.0了。技术的更新真的不是一般的快啊
为什么要用路由?
个人理解的话,就前端而言,路由还是因为单页面应用时代的带来而衍生出来的。当url发生变化时,路由相应的做出一些相应,从而来保证目前的url和要展示的界面一一对应好。
效果图如下:类似于微商城的一个网页。点击页脚的不同位置,可以切换不同的页面。
demo地址:https://github.com/xianyulaodi/React-router
入口文件: render/app.js
1 import React from 'react' 2 import { render } from 'react-dom' 3 import { Router, Route, IndexRoute, Link, IndexLink } from 'react-router' 4 import { createHistory, useBasename } from 'history' 5 6 7 import App from '../component/app.js' 8 import Mall from '../component/routers/mall/mall.js' 9 import Circle from '../component/routers/circle/circle.js' 10 import CircleType from '../component/routers/circle/circleType.js' 11 import My from '../component/routers/my/my.js' 12 import MyNav from '../component/routers/my/myNav.js' 13 import MyUserCenter from '../component/routers/my/userCenter.js' 14 import MemberClub from '../component/routers/my/memberClub.js' 15 import Index from '../component/routers/index/index.js' 16 import Type from '../component/routers/index/type.js' 17 import CircleTip from '../component/routers/circle/circleTip.js' 18 import CircleSay from '../component/routers/circle/circleSay.js' 19 20 const history = useBasename(createHistory)({ 21 basename: '/React-Router' 22 }); 23 24 {/** {this.props.children} 非常重要**/} 25 {/** 思考:首页也有其他分路由,怎么配**/ } 26 render(( 27 <Router> 28 <Route path="/" component={App}> 29 <IndexRoute component={Index} /> 30 31 <Route path="/type/:typeName" component={Type} /> 32 33 <Route path="/mall" component={Mall}> 34 <Route path="type/:typeName" component={Type} /> 35 </Route> 36 37 <Route path="/my" component={My}> 38 <IndexRoute component={MyNav} /> 39 <Route path="userCenter" component={MyUserCenter} /> 40 <Route path="memberClub" component={MemberClub} /> 41 </Route> 42 43 <Route path="/circle" component={Circle}> 44 <IndexRoute component={CircleType} /> 45 <Route path="tip/:tipName" component={CircleTip} /> 46 <Route path="say" component={CircleSay} /> 47 </Route> 48 49 </Route> 50 </Router> 51 ), document.getElementById('index'))
基本上所有的文件都集中在这里了。所以这个文件是入口文件,通过不同的hash值来调用不同的组件,从而让url的变化和界面的变化相对应。
这里将一个个的介绍react-router属性的作用。这里的介绍花的篇幅可能会比较多,因为搞懂了这里,也就基本搞懂react-router了。
1、<Route path="/" component={App}>
这一句是所有路由的父集,也就是最高级的位置。路由里面的东西为什么可以换来换去呢。就是在这个组件里面来切换的;
这个app里面的核心代码如下: .. /component/app.js //这里是./component/app 和 ./render/app.js是两个不同的文件来的 !!!
return ( <div className="mp_wrap bui_wrap"> {/**主屏幕**/} <div className="mp_pagebox_home"> {/**这里面的内容会被子路由给代替**/} {this.props.children} {/**公共页脚**/} <div className="mp_page_footer"> <Footer /> </div> {/**公共页脚**/} </div> {/**主屏幕**/} </div> )
里面的 {this.props.children} 这句话是核心。它告诉页面,它的子集都在这里展示。所以,每次我们点击切换不同的url,看到不同内容的变化,
其实是这里面一直替换来替换去而已。没有替换掉的就是那个Footer组件,因为那个是页脚用来导航的:
里面的代码如下:(代码被简化,具体看源码)
./component/router/publicComponent/footer.js
1 const Footer = React.createClass({ 2 3 render: function() { 4 5 return ( 6 <div className="bui_avg_sm_4 bui_ta_c bui_bgc_lgray bui_ptb_6" > 7 {/**使用IndexLink,可以让首页的链接不会一直处于激活状态**/} 8 <IndexLink to="/" styles={styles.link} activeStyle={styles.activeLink}>教程</IndexLink > 9 <Link to="/circle" styles={styles.link} activeStyle={styles.activeLink}>烘培圈</Link> 10 <Link to="/mall" styles={styles.link} activeStyle={styles.activeLink}>商城</Link> 11 <Link to="/my" styles={styles.link} activeStyle={styles.activeLink}>我的</Link> 12 </div> 13 ); 14 15 } 16 })
这里通过reac-router提供的Link来进行路径的跳转。
这里有个注意点:IndexLink,就是默认显示哪个链接高亮,不然的话默认的首页的链接状态就一直处于高亮状态。通过style,以及activeStyle来切换高亮时的样式
2、IndexRoute的作用
想象一下当 URL 为 /
时,我们想渲染一个在 App
中的组件。不过在此时,App
的 render
中的this.props.children
还是 undefined,也就是说里面是空的。
所以我们要让它默认显示首页的信息
。这种情况我们可以使用 IndexRoute
来设置一个默认页面。
看什么的29行代码:
<Route path="/" component={App}>
<IndexRoute component={Index} />
可以看看这里的代码,让url没有链接到其他路由时,默认显示Index这个组件里面的内容
3、路由匹配原理 :
嵌套关系:
中文网的解释:React Router 使用路由嵌套的概念来让你定义 view 的嵌套集合,当一个给定的 URL 被调用时,整个集合中(命中的部分)都会被渲染。
嵌套路由被描述成一种树形结构。React Router 会深度优先遍历整个理由配置来寻找一个与给定的 URL 相匹配的路由。
什么意思呢。上面的入口文件中,可以看到,其他路由都是最外层那个app(也就是这个<Route path="/" component={App}>)的子路由,其他路由都是嵌套在这里面。
当url变化是,它里面的{this.props.children}都会替换,也就是所谓的整个集合的命中部分都会被渲染。
路径语法:
中文网原文:
路由路径是匹配一个(或一部分)URL 的 一个字符串模式。大部分的路由路径都可以直接按照字面量理解,除了以下几个特殊的符号:
:paramName
– 匹配一段位于/
、?
或#
之后的 URL。 命中的部分将被作为一个参数()
– 在它内部的内容被认为是可选的*
– 匹配任意字符(非贪婪的)直到命中下一个字符或者整个 URL 的末尾,并创建一个splat
参数
<Route path="/hello/:name"> // 匹配 /hello/michael 和 /hello/ryan
<Route path="/hello(/:name)"> // 匹配 /hello, /hello/michael 和 /hello/ryan
<Route path="/files/*.*"> // 匹配 /files/hello.jpg 和 /files/path/to/hello.jpg
如果一个路由使用了相对路径
,那么完整的路径将由它的所有祖先节点的路径
和自身指定的相对路径
拼接而成。使用绝对路径
可以使路由匹配行为忽略嵌套关系。
听起来比较头晕,可以这样理解,就是正常的url匹配模式就是一条 斜线+路劲名。比如跳到个人中心 <Route path="/my" component={My}>,如果要传值:就类似这样 <Route path="tip/:tipName" component={CircleTip} />
其实就这样理解就行了。不然会把自己搞的很晕。
继续前面的入口文件 render/app.js
通过前面的了解,我们的页面在最开始的url的时候有了一个默认的组件 index,当我们要跳转的时候,我们可以通过url的不同来调用不同的组件。
比如个人中心,<Route path="/my" component={My}>,当识别到你的url是/my 时,就调用My这个组件。
可以看下图:方框内,不同路由就把对应的里面的内容给替换掉。
子路由下还有子路由的情况
如果在my这个路径下,我还有子路由怎么办呢?就像点击我的页面,点击头像,可以跳转到个人中心那种。方法如下:
<Route path="/my" component={My}> <IndexRoute component={MyNav} /> <Route path="userCenter" component={MyUserCenter} /> <Route path="memberClub" component={MemberClub} /> </Route>
在my这个路径下,我还有userCenter,memberClub。比如你点击头像,就会跳转到这样的url http://localhost:3200/#/my/userCenter?_k=t18l2p
{My} 这个组件的内容如下:
var Content= React.createClass({ render(){ return ( <div> {this.props.children} </div> ) } }) module.exports= Content
里面的{this,props.children}也是注意点。用来替换它子组件的内容。可以这么理解,只要你是父组件,都有一个 {this.props.children}来装载替换子组件的内容
注意点:
因为/my是父路由,所以它的写法跟最外层的app那个路由时类似的,所以也要设置一个默认显示的页面,也就是IndexRouter。
这里我就默认显示MyNav这个组件,不然里面是什么都没有的。这点初学时会经常忘记。切记切记!!!
路由之间参数的传参:
为了演示参数的传递,我将一个tab的切换弄成了路由之前的传值,实际应用中没有必要。只是为了演示而已,在./render/app.js的第31行
<Route path="/type/:typeName" component={Type} />
跳转到了/type/:typeName这里,并调用对应的{Type}组件,为它传了一个typeName的值,所以我们在传值时可以这样
在跳转到type时,后面着一个你要传递的值。
<Link to="/type/饼干"> <p className="icon icon1"></p> <p className="bui_ta_c bui_tc_gray">饼干</p> </Link>
那我要获取到传递的值怎样做呢,可以这样,在{Type}组件中。
const { typeName } = this.props.params
其中params就是参数的意思。这样我们就可以在需要使用参数的地方来使用我们的参数了。
暂时就介绍到这里了。主要是搞懂了./render/app.js里面的内容和相对应的一些知识,也就基本搞懂路由了。其他地方的用法都是类似的。
参考链接:
react-router中文网:http://react-guide.github.io/react-router-cn/docs/guides/basics/RouteMatching.html
备注:再次强调一下,我的这个实战目录结构不好,如需拿去项目中使用,记得把项目结构建好一点。另外,有误指出,欢迎指出。多多交流