TODO: Need proofread https://github.com/rackt/react-router/blob/master/docs/API.md

组件

组件的配置

Route 组件

Mixins

Utilities

React Router 的重要组件。它能保持 UI 和 URL 的同步。

一个或多个的 Route 或 PlainRoute。当 history 改变时， 会匹配出 Route 的一个分支，并且渲染这个分支中配置的组件，渲染时保持父 route 组件嵌套子 route 组件。

children 的别名。

Router 监听的 history 对象，由 history 包提供。

当 route 准备渲染 route 组件的一个分支时，就会用这个函数来创建 element。当你使用某种形式的数据进行抽象时，你可以想要获取创建 element 的控制权，例如在这里设置组件监听 store 的变化，或者使用 props 为每个组件传入一些应用模块。

一个用于把 Link 或调用 transitionTo 函数的对象转化成 URL query 字符串的函数。

一个用于把 query 字符串转化成对象，并传递给 route 组件 props 的函数。

当路由匹配到时，也有可能会抛出错误，此时你就可以捕获和处理这些错误。通常，它们会来自那些异步的特性，如 route.getComponents，route.getIndexRoute，和 route.getChildRoutes。

当 URL 改变时，需要更新路由的 state 时会被调用。

请看仓库中的示例目录 examples/，这些例子都广泛使用了 Router。

允许用户浏览应用的主要方式。 以适当的 href 去渲染一个可访问的锚标签。

可以知道哪个 route 的链接是激活状态的，并可以自动为该链接添加 activeClassName 或 activeStyle。

跳转链接的路径，如 /users/123。

已经转化成字符串的键值对的对象。

URL 的 hash 值，如 #a-hash。

注意：React Router 目前还不能管理滚动条的位置，并且不会自动滚动到 hash 对应的元素上。如果需要管理滚动条位置，可以使用 scroll-behavior 这个库。

保存在 location 中的 state。

当某个 route 是激活状态时， 可以接收传入的 className。失活状态下是默认的 class。

当某个 route 是激活状态时，可以将样式添加到链接元素上。

自定义点击事件的处理方法。如处理 标签一样 - 调用 e.preventDefault() 来防止过度的点击，同时 e.stopPropagation() 可以阻止冒泡的事件。

你也可以在 标签上传入一些你想要的 props，如 title，id，className 等等。

如 这样的 route：

敬请期待！

在 context 中给定路由的 state、设置 history 对象和当前的 location， 就会去渲染组件树。

Route 是用于声明路由映射到应用程序的组件层。

URL 中的路径。

它会组合父 route 的路径，除非它是从 / 开始的， 将它变成一个绝对路径。

注意：在动态路由中，绝对路径可能不适用于 route 配置中。

如果它是 undefined，路由会去匹配子 route。

当匹配到 URL 时，单个的组件会被渲染。它可以 被父 route 组件的 this.props.children 渲染。

Route 可以定义一个或多个已命名的组件，当路径匹配到 URL 时， 它们作为 name:component 对的一个对象去渲染。它们可以被 父 route 组件的 this.props[name] 渲染。

与 component 一样，但是是异步的，对于 code-splitting 很有用。

cb(err, component)

与 component 一样，但是是异步的，对于 code-splitting 很有用。

cb(err, components)

Route 可以被嵌套，this.props.children 包含了从子 route 组件创建的元素。由于这是路由设计中非常重要的部分，请参考 Route 配置。

当 route 即将进入时调用。它提供了下一个路由的 state，一个函数重定向到另一个路径。this 会触发钩子去创建 route 实例。

当 callback 作为函数的第三个参数传入时，这个钩子将是异步执行的，并且跳转会阻塞直到 callback 被调用。

当 route 即将退出时调用。

route 定义的一个普通的 JavaScript 对象。 Router 把 JSX 的 转化到这个对象中，如果你喜欢，你可以直接使用它们。 所有的 props 都和 的 props 一样，除了那些列在这里的。

子 route 的一个数组，与在 JSX route 配置中的 children 一样。

与 childRoutes 一样，但是是异步的，并且可以接收 location。对于 code-splitting 和动态路由匹配很有用（给定一些 state 或 session 数据会返回不同的子 route）。

cb(err, routesArray)

index route。这与在使用 JSX route 配置时指定一个 子集一样。

与 indexRoute 一样，但是是异步的，并且可以接收 location。与 getChildRoutes 一样，对于 code-splitting 和动态路由匹配很有用

cb(err, route)

在应用中 可以设置重定向到其他 route 而不改变旧的 URL。

你想由哪个路径进行重定向，包括动态段。

你想重定向的路径。

默认情况下，query 的参数只会经过，但如果你需要你可以指定它们。

注意，在 route 层 可以被放在任何地方，尽管正常的优先 规则仍适用。如果你喜欢将下一个重定向到它各自的 route 上，from 的路径会匹配到一个与 path 一样的正常路径。

当用户在父 route 的 URL 时， Index Routes 允许你为父 route 提供一个默认的 "child"， 并且为使 能用提供了约定。

请看 Index Routes 指南。

与 Route 的 props 一样，除了 path。

Index Redirects 允许你从一个父 route 的 URL 重定向到其他 route。 它们被用于允许子 route 作为父 route 的默认 route， 同时保持着不同的 URL。

请看 Index Routes 指南。

与 Redirect 的 props 一样，除了 from。

当 route 匹配到 URL 时会渲染一个 route 的组件。路由会在渲染时将以下属性注入组件中：

Router 的 history history。

对于跳转很有用的 this.props.history.pushState(state, path, query)

当前的 location。

URL 的动态段。

渲染组件的 route。

this.props.params 是直接在组件中指定 route 的一个子集。例如，如果 route 的路径是 users/:userId 而 URL 是 /users/123/portfolios/345，那么 this.props.routeParams 会是 {userId: '123'}，并且 this.props.params 会是 {userId: '123', portfolioId: 345}。

匹配到子 route 的元素将被渲染。如果 route 有已命名的组件，那么此属性会是 undefined，并且可用的组件会被直接替换到 this.props 上。

当一个 route 有一个或多个已命名的组件时，其子元素的可用性是通过 this.props 命名的。因此 this.props.children 将会是 undefined。那么所有的 route 组件都可以参与嵌套。

在组件中添加一个钩子，当路由要从 route 组件的配置中跳转出来时被调用，并且有机会去取消这次跳转。主要用于表单的部分填写。

在常规的跳转中， routerWillLeave 会接收到一个单一的参数：我们正要跳转的 location。去取消此次跳转，返回 false。

提示用户确认，返回一个提示信息（字符串）。在 web 浏览器 beforeunload 事件发生时，routerWillLeave 不会接收到一个 location 的对象（假设你正在使用 useBeforeUnload history 的增强方法）。在此之上，我们是不可能知道要跳转的 location，因此 routerWillLeave 必须在用户关闭标签之前返回一个提示信息。

当路由尝试从一个 route 跳转到另一个并且渲染这个组件时被调用。

在组件中添加路由的 history 对象。

注意：你的 route components 不需要这个 mixin，它在 this.props.history 中已经是可用的了。这是为了组件更深次的渲染树中需要访问路由的 history 对象。

跳转至一个新的 URL。

在不影响 history 长度的情况下（如一个重定向），用新的 URL 替换当前这个。

在 history 中使用 n 或 -n 进行前进或后退

在 history 中后退。

在 history 中前进。

使用路由配置，将 query 字符串化加到路径名中。

使用路由配置，创建一个 URL。例如，它会在 pathname 的前面加上 #/ 给 hash history。

根据当前路径是否激活返回 true 或 false。通过 pathname 匹配到 route 分支下的每个 route 将会是 true（子 route 是激活的情况下，父 route 也是激活的），除非 indexOnly 已经指定了，在这种情况下，它只会匹配到具体的路径。

假设你正在使用 bootstrap，并且在 Tab 中想让那些 li 获得 active：

注意难道我们没有告诉你要使用 ES6 的 Classes？:)

https://twitter.com/soprano/status/610867662797807617

在应用中少数组件由于 History mixin 的缘故而用得不爽，此时有以下几个选项：

RouteContext mixin 提供了一个将 route 组件设置到 context 中的便捷方法。这对于 route 渲染元素并且希望用 生命周期 mixin 来阻止跳转是很有必要的。

简单地将 this.context.route 添加到组件中。

返回一个新的 createHistory 函数，它可以用来创建读取 route 的 history 对象。

这个函数被用于服务端渲染。它在渲染之前会匹配一组 route 到一个 location，并且在完成时调用 callback(error, redirectLocation, renderProps)。

传给回调函数去 match 的三个参数如下：

如果这三个参数都是 undefined，这就意味着在给定的 location 中没有 route 被匹配到。

注意：你可能不想在浏览器中用它，除非你做的是异步 route 的服务端渲染。

创建并返回一个从给定对象 route 的数组，它可能是 JSX 的 route，一个普通对象的 route，或是其他的数组。

一个或多个的 Route 或 PlainRoute。

敬请期待！