摘要:
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
import React from 'react'
import { render } from 'react-dom'
import { Router, Route, IndexRoute, Link, IndexLink } from 'react-router'
import { createHistory, useBasename } from 'history' import App from '../component/app.js'
import Mall from '../component/routers/mall/mall.js'
import Circle from '../component/routers/circle/circle.js'
import CircleType from '../component/routers/circle/circleType.js'
import My from '../component/routers/my/my.js'
import MyNav from '../component/routers/my/myNav.js'
import MyUserCenter from '../component/routers/my/userCenter.js'
import MemberClub from '../component/routers/my/memberClub.js'
import Index from '../component/routers/index/index.js'
import Type from '../component/routers/index/type.js'
import CircleTip from '../component/routers/circle/circleTip.js'
import CircleSay from '../component/routers/circle/circleSay.js' const history = useBasename(createHistory)({
basename: '/React-Router'
}); {/** {this.props.children} 非常重要**/}
{/** 思考:首页也有其他分路由,怎么配**/ }
render((
<Router>
<Route path="/" component={App}>
<IndexRoute component={Index} /> <Route path="/type/:typeName" component={Type} /> <Route path="/mall" component={Mall}>
<Route path="type/:typeName" component={Type} />
</Route> <Route path="/my" component={My}>
<IndexRoute component={MyNav} />
<Route path="userCenter" component={MyUserCenter} />
<Route path="memberClub" component={MemberClub} />
</Route> <Route path="/circle" component={Circle}>
<IndexRoute component={CircleType} />
<Route path="tip/:tipName" component={CircleTip} />
<Route path="say" component={CircleSay} />
</Route> </Route>
</Router>
), 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
const Footer = React.createClass({ render: function() { return (
<div className="bui_avg_sm_4 bui_ta_c bui_bgc_lgray bui_ptb_6" >
{/**使用IndexLink,可以让首页的链接不会一直处于激活状态**/}
<IndexLink to="/" styles={styles.link} activeStyle={styles.activeLink}>教程</IndexLink >
<Link to="/circle" styles={styles.link} activeStyle={styles.activeLink}>烘培圈</Link>
<Link to="/mall" styles={styles.link} activeStyle={styles.activeLink}>商城</Link>
<Link to="/my" styles={styles.link} activeStyle={styles.activeLink}>我的</Link>
</div>
); }
})
这里通过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
备注:再次强调一下,我的这个实战目录结构不好,如需拿去项目中使用,记得把项目结构建好一点。另外,有误指出,欢迎指出。多多交流