使用react-router实现单页面应用路由
同步博客原文链接:http://www.chardlau.com/2017/05/02/usage-of-react-router/
上一篇文章讲述了如何搭建单页面应用的开发环境。本文接着介绍如何实现单页面应用。
实际上,单页面应用利用js实现了页面的动态化,用户使用时基本感知不到网页是如何实现的,开发也不应该让用户感知到。为了实现这一步,react提供了一个官方的路由组件react-router,让你的单页面应用支持页面的跳转以及动态渲染。
使用react-router的前端实现
安装react-router
npm install --save react-router-dom
我使用的是最新版本4.1.1,这个版本的react-router针对浏览器、原生应用等环境已经做了区分。我做的是基于web的单页面应用,因此安装的时候我使用的是react-router-dom这个依赖。
使用react-router
还是基于上一篇文章搭建的开发环境,我们使用官方示例简单入门对react-router的使用方法。
回顾一下上一篇文章的开发环境:
这里主要需要修改index.js,其内容改为官方示例代码:
import React from 'react'; import ReactDOM from 'react-dom'; import { BrowserRouter as Router, Route, Link } from 'react-router-dom'; const BasicExample = () => ( <Router> <div> <ul> <li><Link to="/">Home</Link></li> <li><Link to="/about">About</Link></li> <li><Link to="/topics">Topics</Link></li> </ul> <hr/> <Route exact path="/" component={Home}/> <Route path="/about" component={About}/> <Route path="/topics" component={Topics}/> </div> </Router> ) const Home = () => ( <div> <h2>Home</h2> </div> ) const About = () => ( <div> <h2>About</h2> </div> ) const Topics = ({ match }) => ( <div> <h2>Topics</h2> <ul> <li> <Link to={`${match.url}/rendering`}> Rendering with React </Link> </li> <li> <Link to={`${match.url}/components`}> Components </Link> </li> <li> <Link to={`${match.url}/props-v-state`}> Props v. State </Link> </li> </ul> <Route path={`${match.url}/:topicId`} component={Topic}/> <Route exact path={match.url} render={() => ( <h3>Please select a topic.</h3> )}/> </div> ) const Topic = ({ match }) => ( <div> <h3>{match.params.topicId}</h3> </div> ) ReactDOM.render(<BasicExample/>, document.getElementById('main'));
注意到上面的代码引入了react-router的BrowserRouter(重命名为Router),Route,Link三个组件。新版本的react-router提出了一切都以Component实现的原则,因此这些组件实际上都是React.Component的实现。
BrowserRouter是一个容器Component,其内部实现了路由跳转的逻辑。旧版本直接使用Router就可以,新版本根据环境不同有不同的实现,Web环境使用BrowserRouter。
Route也是一个Component,配置了页面路径以及当用户输入的路径命中时需要渲染的组件。
Link用于跳转,有点像HTML的a标签。不一样的是Link是需要在后端进行编译,最终可能以a标签的形式呈现给用户。
验证react-router
使用下面命令编译并运行应用:
npm run build npm start
访问http://localhost:2000 可以看到页面已经可以正常访问,且点击可以实现页面跳转。
如果你细心一点,你会发现刚刚访问的页面链接是使用a标签出发了页面的跳转。但是跳转后页面并没有向后端发送页面请求。事实上,这就是单页面应用为了解耦前后端实现的目标之一。
我在index.js中使用Link组件,编译后在浏览器上以a标签呈现给用户。而react-router连接了这些a标签的事件处理,动态的实现组件的渲染和浏览器地址栏内容的修改。因此这个过程不需要重新加载内容也不会向后端发出网络请求。
使用react-router的后端实现
单页面是为了实现前后端的业务解耦,但绝对的解耦是不存在的。有两个方面佐证这个观点。首先是api协议的约定,这必须要前端与后端的同时支持;其次就是本文的主要内容——路由实现。
缺少后端支持的问题
通过上面内容我们知道单页面应用的路由是通过js实现的,相对于传统网站而言是”伪跳转。那么如果用户直接在浏览器上输入http://localhost:2000/about 然后回车会有什么效果。
使用我的demo环境,会看到下图:
果断的404响应。因为我的服务器根本没有/about这个目录或者文件。
增加后端支持
为了解决这个问题,我需要增加这样一个依赖:
npm install --save connect-history-api-fallback
并且在项目根目录的index.js(注意不是public目录的index.js,这里应该重新命名一下的,当前将就一下)。
内容改为:
var express = require('express'); var app = express(); app.use('/', require('connect-history-api-fallback')()); // Add app.use('/', express.static('public')); var server = app.listen(2000, function() { var port = server.address().port; console.log('Open http://localhost:%s', port); });
另外需要修改一下public目录下的index.html文件的内容。这是使用相对路径获取js文件,属于上次留下来的bug,不改的话会存在问题。内容如下:
<html> <head> </head> <body> <p>Hello world</p> <div id='main'></div> <script src="/out.js"></script><!-- 改动行 --> </body> </html>
这样就可以解决问题了。重新在浏览器输入http://localhost:2000/about 可以看到页面显示正常了。
需要注意增加的代码必须放在express.static行的上方。这涉及的express框架的原理,不在这里深究,只要知道connect-history-api-fallback组件根据配置,帮我们把public目录下的index.html作为所有不存在的路径的请求的响应返回给浏览器。