Add querystring docs.

Author: STRML

CHANGELOG.md

@@ -1,5 +1,20 @@
 # CHANGELOG
 
+## 0.26.0
+  - Support querystrings.
+    * Querystrings are not matched - they are stripped before matching patterns.
+    * Querystrings, if present, are parsed and passed as the `_query` prop.
+    * See the [querystring docs](http://strml.viewdocs.io/react-router-component/querystring).
+
+## 0.25.4
+  - More ES6 fixes.
+
+## 0.25.3
+  - Hotfix: adjust API for url-pattern to fit ES6 modules.
+
+## 0.25.2
+  - Allow overriding url-pattern's compiler.
+
 ## 0.25.1
   - Remove bad ReactComponent typecheck on Route/Location.
 

README.md

@@ -56,7 +56,7 @@ React router component can dispatch based on `location.pathname` or
 
 Furthermore it provides advanced features like support for [regex matching][regex],
 [full page server side rendering][server-side], [multiple routers][multiple] on the same page,
-[contextual routers][contextual] and support for [async components][async].
+[querystring parsing][querystring], [contextual routers][contextual] and support for [async components][async].
 
 Its functionality is tested using [Saucelabs][] on all modern browsers (IE >= 9,
 Chrome >= 27, Firefox >= 25, Safari >= 6 and Mobile Safari on iPhone and iPad >=
@@ -81,6 +81,7 @@ See [docs][] for the usage.
 [server-side]: http://strml.viewdocs.io/react-router-component/server-side
 [multiple]: http://strml.viewdocs.io/react-router-component/multiple
 [contextual]: http://strml.viewdocs.io/react-router-component/contextual
+[querystring]: http://strml.viewdocs.io/react-router-component/querystring
 [a-elements]: http://strml.viewdocs.io/react-router-component/a-elements
 [rec-custom-link]: http://strml.viewdocs.io/react-router-component/recipes/custom-link
 [rec-custom-router]: http://strml.viewdocs.io/react-router-component/recipes/custom-router

docs/index.md

@@ -46,6 +46,7 @@ React router component can dispatch based on `location.pathname` or
 
 Furthermore it provides advanced features like support for [full page server
 side rendering][server-side], [multiple routers][multiple] on the same page,
+[querystring parsing][querystring],
 [contextual routers][contextual], support for [async components][async] and
 [optional handling of normal `<a>` elements][a-elements].
 
@@ -214,6 +215,7 @@ These are the examples of what you can do with React Router component:
 [rec-es6-custom-router]: recipes/rec-es6-custom-router
 
 [hash-routing]: hash-routing
+[querystring]: querystring
 [server-side]: server-side
 [multiple]: multiple
 [contextual]: contextual

docs/querystring.md

@@ -0,0 +1,42 @@
+# Querystring parsing
+
+React-router-component, as of 0.26.0, understands querystrings.
+
+Querystrings are not matched as part of a route. It is not possible to switch routes
+based on a querystring.
+
+The route `/foo/:bar` will match both `/foo/biff` and `/foo/baz?biff=baz&num=1`.
+
+For example:
+
+    var App = React.createClass({
+
+      render: function() {
+        return (<Locations path={this.props.path)}
+              onBeforeNavigation={this.showProgressBar}
+              onNavigation={this.hideProgressBar}>
+            <Location path="/foo/:bar" handler={QueryPage} />
+          </Locations>
+        );
+      }
+    });
+
+    var QueryPage = React.createClass({
+      propTypes: {
+        bar: React.PropTypes.string,
+        _query: React.PropTypes.object
+      },
+
+      render: function() {
+        return (
+          <div>
+            Hello, this is main page of the application!
+            This component was passed the values:
+            Foo: <b>{this.props.foo}</b>
+            Query: <b>{JSON.stringify(this.props._query)}</b>
+          </div>
+        )
+      }
+    })
+
+    React.render(<App path="/foo/bar?baz=biff&num=1&react=isAwesome");