use-back

React Router DOM hook for navigating back without leaving your website

Usage no npm install needed!

<script type="module">
  import useBack from 'https://cdn.skypack.dev/use-back';
</script>

README

Use Back icon

Use Back

React Router DOM hook for navigating back without leaving your website

npm version check status license: MIT

Description

A native ESModule React hook for navigating back one location using React Router DOM, defaulting to navigating home instead of leaving your web application.

Installation

npm install use-back

Note: This package is a native ESModule that requires React Router DOM v6 as a peer dependency.

Usage

import {useBack} from "use-back";

const BackButton = () => {
    const {hasBack, handleBack} = useBack();
    return (
        <button type="button" onClick={handleBack}>
            {hasBack ? "Go Back" : "Go Home"}
        </button>
    );
};

useBack([defaultPath])

Returns: {handleBack, hasBack} Object containing an event handler that navigates back, and a boolean that indicates whether the handler will navigate back or to the default path

Parameter Type Default Description
defaultPath string "/" Fallback path to navigate to for when there is not a previous history entry

License

Copyright Evelyn Hathaway, MIT License