Giter VIP home page Giter VIP logo

react-editable's Introduction

React Editable

typescript Node.js CI dependencies Status codecov

A component that wraps around a form component to provide an editing state that it maintains. Works with promises returned by the Editable methods.

React Editable can accept anything as its value, making it a generic wrapper for any controlled component that needs a temporary editing state.

Why Use It?

React Editable factors out the concerns of temporary state and whether to maintain it in a global store like Redux, or in your own component. It passes through its current state so you can render your component differently depending on whether it's inactive, editing, or waiting on a promise.

Demo & Examples

Live demo: https://dcwither.github.io/react-editable/

npm install
npm start

Then open localhost:6006 in a browser

Usage

import React from "react";
import { Editable, useEditableContext } from "@dcwither/react-editable";

function Input() {
  const { value, onCommit, onChange, status } = useEditableContext();
  handleCommit = () => {
    onCommit("SUBMIT");
  };

  handleChange = evt => {
    onChange(evt.target.value);
  };

  return (
    <div>
      <input
        className="input"
        disabled={status === EditableStatus.COMMITTING}
        onChange={handleChange}
        value={value}
      />
      <button onClick={handleCommit}>Submit</button>
    </div>
  );
}

// Either wrap in the Editable Component with render props
<Editable onCommit={handleCommit}>
  <Input />
</Editable>;

// Or control the flow of your editable props directly with:
const { value, onChange, onCommit } = useEditable({
  value,
  onChange,
  onCommit
});

State Transitions

State Transitions

Arguments

Editable, useEditable

Property Type Required Description
onCancel func(value) No Callback for when editing is canceled
onCommit func(message, value) No Callback for commit changes
value child.propTypes.value No Unedited value to be passed through to child while presenting

useEditableContext, EditableContextConsumer

None

return value

Editable

None

useEditable, useEditableContext, EditableContextConsumer

Property Type Description
onStart func Callback that triggers start of editing
onCancel func Callback that triggers cancel editing and clears edited value
onChange func(nextValue) Callback that triggers change in edited value
onCommit func(message) Callback that triggers a commit
status 'PRESENTING', 'EDITING', or 'COMMITTING' Current status of ReactEditable
value any The value passed into Editable if PRESENTING or the edited value if EDITING or COMMITING

Commit Event Handler (onCommit)

This will be called when the matching callback passed through to the render prop child is called. If it returns a promise, ReactEditable will remain in a COMITTING state until the promise resolves. If ReactEditable unmounts before the promise resolves, it will cancel its promise, and avoid a setState.

react-editable's People

Contributors

dcwither avatar dependabot-preview[bot] avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.