https://cn.redux.js.org/docs/advanced/UsageWithReactRouter.html

搭配 React Router

现在你想在你的 Redux 应用中使用路由功能，可以搭配使用 React Router 来实现。 Redux 和 React Router 将分别成为你数据和 URL 的事实来源（the source of truth）。 在大多数情况下， 最好 将他们分开，除非你需要时光旅行和回放 action 来触发 URL 改变。

安装 React Router

可以使用 npm 来安装 react-router-dom。本教程基于 react-router-dom@^4.1.1 。

1
npm install --save react-router-dom

配置后备(fallback) URL

在集成 React Router 之前，我们需要配置一下我们的开发服务器。 显然，我们的开发服务器无法感知配置在 React Router 中的 route。 比如：你想访问并刷新 /todos，由于是一个单页面应用，你的开发服务器需要生成并返回 index.html。 这里，我们将演示如何在流行的开发服务器上启用这项功能。

使用 Create React App 须知

如果你是使用 Create React App （你可以点击这里了解更多，译者注）工具来生成项目，会自动为你配置好后备(fallback) URL。

配置 Express

如果你使用的是 Express 来返回你的 index.html 页面，可以增加以下代码到你的项目中：

1
2
3
app.get('/*', (req, res) => {
  res.sendfile(path.join(__dirname, 'index.html'))
})

配置 WebpackDevServer

如果你正在使用 WebpackDevServer 来返回你的 index.html 页面， 你可以增加如下配置到 webpack.config.dev.js：

1
2
3
devServer: {
  historyApiFallback: true,
}

连接 React Router 和 Redux 应用

在这一章，我们将使用 Todos 作为例子。我们建议你在阅读本章的时候，先将仓库克隆下来。

首先，我们需要从 React Router 中导入 <Router /> 和 <Route />。代码如下：

1
import { BrowserRouter as Router, Route } from 'react-router-dom'

在 React 应用中，通常你会用 <Router /> 包裹 <Route />。 如此，当 URL 变化的时候，<Router /> 将会匹配到指定的路由，然后渲染路由绑定的组件。 <Route /> 用来显式地把路由映射到应用的组件结构上。 用 path 指定 URL，用 component 指定路由命中 URL 后需要渲染的那个组件。

1
2
3
4
5
const Root = () => (
  <Router>
    <Route path="/" component={App} />
  </Router>
)

另外，在我们的 Redux 应用中，我们仍将使用 <Provider />。 <Provider /> 是由 React Redux 提供的高阶组件，用来让你将 Redux 绑定到 React （详见 搭配 React）。

然后，我们从 React Redux 导入 <Provider />：

1
import { Provider } from 'react-redux'

我们将用 <Provider /> 包裹 <Router />，以便于路由处理器可以访问 store。

1
2
3
4
5
6
7
const Root = ({ store }) => (
  <Provider store={store}>
    <Router>
      <Route path="/" component={App} />
    </Router>
  </Provider>
)

现在，如果 URL 匹配到 ‘/‘，将会渲染 <App /> 组件。此外，我们将在 ‘/‘ 后面增加参数 :filter?, 以便以后我们从 URL 中读取参数 :filter。

1
<Route path="/:filter?" component={App} />

也许你想将 ‘#’ 从 URL 中移除（例如：http://localhost:3000/#/?_k=4sbb0i）。 你需要从 React Router 导入 browserHistory 来实现：

1
import { Router, Route, browserHistory } from 'react-router'

components/Root.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import React from 'react'
import PropTypes from 'prop-types'
import { Provider } from 'react-redux'
import { BrowserRouter as Router, Route } from 'react-router-dom'
import App from './App'
const Root = ({ store }) => (
  <Provider store={store}>
    <Router>
      <Route path="/:filter?" component={App} />
    </Router>
  </Provider>
)
Root.propTypes = {
  store: PropTypes.object.isRequired
}
export default Root

我们需要重构 index.js 来把 <Root /> 组件渲染到 DOM 上。

index.js

1
2
3
4
5
6
7
8
9
import React from 'react'
import { render } from 'react-dom'
import { createStore } from 'redux'
import todoApp from './reducers'
import Root from './components/Root'

const store = createStore(todoApp)

render(<Root store={store} />, document.getElementById('root'))

通过 React Router 导航

React Router 提供了 `` 来实现导航功能。 如果你需要自定义样式，react-router-dom 提供了另一个可以自定义样式的特殊 <Link /> 叫做 ``。 例如你可以通过 activeStyle 属性来指定激活状态的样式。

在我们的示例中，我们可以在一个新的容器组件 <FilterLink/> 中 使用 <NavLink/> ，以便动态地更改 URL。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import React from 'react'
import { NavLink } from 'react-router-dom'
const FilterLink = ({ filter, children }) => (
  <NavLink
    to={filter === 'SHOW_ALL' ? '/' : `/${filter}`}
    activeStyle={{
      textDecoration: 'none',
      color: 'black'
    }}
  >
    {children}
  </NavLink>
)
export default FilterLink
1
2
3
4
5
6
7
8
9
10
11
12
13
import React from 'react'
import FilterLink from '../containers/FilterLink'
import { VisibilityFilters } from '../actions'
const Footer = () => (
  <p>
    Show: <FilterLink filter={VisibilityFilters.SHOW_ALL}>All</FilterLink>
    {', '}
    <FilterLink filter={VisibilityFilters.SHOW_ACTIVE}>Active</FilterLink>
    {', '}
    <FilterLink filter={VisibilityFilters.SHOW_COMPLETED}>Completed</FilterLink>
  </p>
)
export default Footer

这时，如果你点击 <FilterLink />，你将看到你的 URL 在 '/SHOW_COMPLETED'，'/SHOW_ACTIVE'，'/' 间切换。 甚至还支持浏览的回退功能，可以从历史记录中找到之前的 URL 并回退。

从 URL 中读取数据

现在，即使 URL 改变，todo 列表也不会被过滤。 这是因为我们是在 <VisibleTodoList /> 的 mapStateToProps() 函数中过滤的。 这个目前仍然是和 state 绑定，而不是和 URL 绑定。 mapStateToProps 的第二可选参数 ownProps，这个是一个传递给 <VisibleTodoList /> 所有属性的对象。

containers/VisibleTodoList.js

1
2
3
4
5
const mapStateToProps = (state, ownProps) => {
  return {
    todos: getVisibleTodos(state.todos, ownProps.filter) // 以前是 getVisibleTodos(state.todos, state.visibilityFilter)
  }
}

目前我们还没有传递任何参数给 <App />，所以 ownProps 依然是一个空对象。 为了能够根据 URL 来过滤我们的 todo 列表，我们需要向 <VisibleTodoList /> 传递 URL 参数。

之前我们写过：<Route path="/:filter?" component={App} />，这使得可以在 App 中获取 params 的属性。

params 是一个包含 url 中所有指定参数的对象。 例如：如果我们访问 localhost:3000/SHOW_COMPLETED，那么 match.params 将等价于 { filter: 'SHOW_COMPLETED' }。 现在，我们可以在 <App /> 中读取 URL 参数了。

注意，我们将使用 ES6 的解构赋值来对 params 进行赋值，以此传递给 <VisibleTodoList />。

components/App.js

1
2
3
4
5
6
7
8
9
const App = ({ match: { params } }) => {
  return (
    <div>
      <AddTodo />
      <VisibleTodoList filter={params.filter || 'SHOW_ALL'} />
      <Footer />
    </div>
  )
}