Skip to content

A simple React component for switching between a text label and a text input

License

Notifications You must be signed in to change notification settings

markbiek/react-editable-label

Repository files navigation

EditableLabel

A simple React component for switching between a text label and a text input.

Clicking on the text label switches the label to a text input. A loss of focus on the text input will switch back to the text label and save the text changes.

An ESC key press will switch from text input back to label and discard any changes made to the text in the input.

An ENTER key press will switch from text input back to label and save any changes made.

When a save is triggered, the save function passed in as a prop is called with the current value of the input.

Label view

Input view

Table of Contents

Installation

$ npm install react-editable-label $ yarn add react-editable-label

Usage

The EditableLabel object requires two props:

  • initialValue which is the initial text to display
  • save which is the function called when the text is updated.

Optional props:

  • labelClass which is added to the className of the label <span> tag.
  • inputClass which is added to the className of the text <input> tag.
  • inputName which is used for the name attribute of the text <input> tag.
  • inputId which is used for the id attribute of the text <input> tag.
  • disableKeys which disables the keyPress handler.

Example:

import React from 'react';
import {render} from 'react-dom';

import EditableLabel from 'react-editable-label';

const App = () => {
    return (
        <>
            <p>Hello!</p>
            <EditableLabel
                initialValue={'World'}
                save={value => {
                    console.log(`Saving '${value}'`);
                }}
            />
        </>
    );
}

let app = document.getElementById('app');

if (app) {
    render(<App/>, app);
}

About

A simple React component for switching between a text label and a text input

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published