Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

react-undo-redo

Package Overview
Dependencies
Maintainers
1
Versions
6
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

react-undo-redo

A library to add undo-redo to any reducer

  • 3.0.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
0
Maintainers
1
Weekly downloads
 
Created
Source

react-undo-redo

A utility to add undo and redo functionality to any state managed through a reducer. This library does not require redux. If you're looking for something that adds undo and redo to a state that is managed through redux you might be in the wrong place.

Installation

Through yarn.

yarn add react-undo-redo

Through npm

npm install --save react-undo-redo

Usage

In order to create the provider and hooks to manage undo and redo you call createUndoRedo and pass the reducer you'd like to enhance. This method returns a provider component and hooks to work with your state. The reducer you pass does not need any knowledge about this feature.

import { createUndoRedo } from "react-undo-redo"

const { UndoRedoProvider, usePast, usePresent, useFuture, useUndoRedo } =
  createUndoRedo(reducer)

createUndoRedo also accepts an options object as a second parameter. Currently available options:

  • track - function with signature (action) => boolean. It is invoked on every dispatch and defines whether the new state is avaiable for undo/redo. If function returns false, the state won't affect the change history. It is useful in situations, when the change is not reflected in the UI or the user cannot control over.
import { createUndoRedo } from "react-undo-redo"

const { UndoRedoProvider, usePast, usePresent, useFuture, useUndoRedo } =
  createUndoRedo(reducer, {track: (action) => action.type !== 'GET_NEW_TODOS'})

UndoRedoProvider

PropRequiredDescription
initialState✔️The initial state that your reducer needs. This does not need any notion of past, present, or future.
pastIf you like to restore a prior session you can pass an earlier version of past states here.
futureIf you like to restore a prior session you can pass an earlier version of future states here.
function Component() {
  return (
    <UndoRedoProvider initialState={0}>
      <Counter />
    </UndoRedoProvider>
  )
}

usePresent => [state, dispatch]

The return value of this hook mimics the useReducer hook. You get access to the current present state. Use the dispatch method to dispatch any of your actions.

function Component() {
  const [count, dispatch] = usePresent()

  return (
    <>
      <div>count: {count}</div>

      <button onClick={() => dispatch({ type: "increment" })}>Add 1</button>
    </>
  )
}

useUndoRedo => [undo, redo]

Returns a tuple that contains methods to signal undo or redo. If you call the two methods react-undo-redo updates the current present state.

Important: You can also call undo or redo when there is nothing to undo or redo. However, you can check whether there is anything to undo or redo by checking the isPossible prop that is present on both methods.

function Component() {
  const [undo, redo] = useUndoRedo()

  return (
    <>
      <button disabled={!undo.isPossible} onClick={() => undo()}>
        Undo
      </button>

      <button disabled={!redo.isPossible} onClick={() => redo()}>
        Redo
      </button>
    </>
  )
}

usePast => [...state]

Returns all current past states (i.e. state snapshots when actions are dispatched). You probably don't need to use this.

useFuture => [...state]

Returns all current future states (i.e. states that have been undone). You probably don't need to use this.

FAQs

Package last updated on 26 Sep 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc