use-react-router
v1.0.7
Published
React Hook for pub-sub behavior using React Router.
Downloads
36,260
Readme
useReactRouter
useReactRouter
is a React Hook that provides pub-sub behavior for react-router
.
Unlike the withRouter
Higher-Order Component, useReactRouter
will re-render your component when the location changes!
useReactRouter()
returns an object that contains the history
, location
, and match
properties that would be passed as props by the HOC.
A tutorial covering the design and development of this package can be found on Medium: How to Convert withRouter to a React Hook.
Why Pub-Sub?
Pub-sub behavior is a common request (that's commonly rejected) for the react-router
package.
For users who adamently prefer pub-sub behavior over react-router
's suggested alternatives, this package offers a solution.
A non-pub-sub React Hook is anticipated to eventually be included in the react-router
package itself.
Install
You must be using react-router
and react-router-dom
v5.0.0 or greater.
npm install use-react-router
oryarn add use-react-router
Use
Import useReactRouter
and use it as a React Hook.
import useReactRouter from 'use-react-router';
const MyPath = () => {
const { history, location, match } = useReactRouter();
return (
<div>
My location is {location.pathname}!
</div>
);
};