https://github.com/bymi15/react-edit-text
Simple 'click to edit' editable text component for React
https://github.com/bymi15/react-edit-text
click-to-edit edit editable editable-text editable-textbox react react-edit-text simple text textbox
Last synced: 4 months ago
JSON representation
Simple 'click to edit' editable text component for React
- Host: GitHub
- URL: https://github.com/bymi15/react-edit-text
- Owner: bymi15
- License: mit
- Created: 2020-10-13T18:08:26.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-07-19T07:09:28.000Z (almost 3 years ago)
- Last Synced: 2025-09-06T06:59:46.236Z (9 months ago)
- Topics: click-to-edit, edit, editable, editable-text, editable-textbox, react, react-edit-text, simple, text, textbox
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/react-edit-text
- Size: 8.53 MB
- Stars: 54
- Watchers: 1
- Forks: 11
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
React Edit Text
This is an easy-to-use editable text component for React. Simply click on the textbox to edit!
Made with ❤️ by Brian Min
## Demo
Please visit https://brianmin.com/react-edit-text/ for a live demo and various examples.
## Install
```bash
npm install react-edit-text --save
```
## Type definitions
```bash
npm install @types/react-edit-text --save-dev
```
## Usage
Make sure to import the CSS stylesheet before using the component.
```jsx
import React from 'react';
import { EditText, EditTextarea } from 'react-edit-text';
import 'react-edit-text/dist/index.css';
export default function Example() {
return (
);
}
```
## Props
### Shared props
| Prop | Type | Required | Default | Description |
| ----------------- | -------- | -------- | -------- | --------------------------------------------------------------------- |
| id | string | No | | HTML DOM id attribute |
| name | string | No | | HTML input name attribute |
| className | string | No | | HTML class attribute for the display component |
| inputClassName | string | No | | HTML class attribute for the input component |
| value | string | No | | Value of the component |
| defaultValue | string | No | | Default value of the component |
| placeholder | string | No | '' | Placeholder value |
| formatDisplayText | function | No | (x) => x | Callback function applied on the value to display the formatted value |
| onSave | function | No | | Callback function triggered when input is saved |
| onChange | function | No | | Callback function triggered when input is changed |
| onEditMode | function | No | | Callback function triggered when component is clicked |
| onBlur | function | No | | Callback function triggered when input is blurred |
| style | object | No | | Sets CSS style of input and view component |
| readonly | bool | No | false | Disables the input and only displays the view component |
### EditText props
| Prop | Type | Required | Default | Description |
| ----------------- | ------ | -------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| type | string | No | 'text' | HTML DOM input text type |
| inline | bool | No | false | Sets inline display |
| showEditButton | bool | No | false | Displays an edit button that can be pressed to enable edit mode |
| editButtonContent | node | No | 
| Sets the content for the edit button. This can be any valid element |
| editButtonProps | object | No | {} | Sets the props passed to the edit button. This can be any valid DOM attribute |
### EditTextarea props
| Prop | Type | Required | Default | Description |
| ---- | ---------------- | -------- | ------- | ---------------------- |
| rows | number \| 'auto' | No | 3 | Number of visible rows |
## Contributing
Contributions are very much appreciated and welcome.
Please refer to the [contributing guidelines](https://github.com/bymi15/react-edit-text/blob/main/CONTRIBUTING.md) for more details.
## License
MIT © [Brian Min](https://github.com/bymi15)