react-photo-editor

React component and hook for image editing with options to set brightness, contrast, saturation, and grayscale. Also with features to rotate, flip, pan, draw and zoom the photo.

📋 Table of Contents

• ✨ Features
• 📦 Installation
• 🚀 Quick Start
• 📱 Live Demo
• ⚠️ Migration Guide
• 🛠️ Configuration Options
• 🧰 Advanced Usage: Custom Component with usePhotoEditor Hook
• 🤝 Contributing
• 📄 License

✨ Features

• 🎨 Color adjustments: Brightness, contrast, saturation, and grayscale
• 🔄 Image manipulation: Rotate and flip (horizontal/vertical)
• 🔍 Interactive control: Pan and zoom functionality
• ✏️ Drawing tools: Draw directly on canvas
• 🧩 Flexible integration: Use as a component or with the usePhotoEditor hook
• 🎯 Highly customizable: Configurable UI, labels, and functionality

📦 Installation

Choose your preferred package manager:

# Using npm
npm install react-photo-editor

# Using yarn
yarn add react-photo-editor

🚀 Quick Start

import { useState } from 'react';
import { ReactPhotoEditor } from 'react-photo-editor';

function App() {
  const [file, setFile] = useState();
  const [showModal, setShowModal] = useState(false);

  // Show modal if file is selected
  const showModalHandler = () => {
    if (file) {
      setShowModal(true);
    }
  };

  // Hide modal
  const hideModal = () => {
    setShowModal(false);
  };

  // Save edited image
  const handleSaveImage = (editedFile) => {
    setFile(editedFile);
    // Do something with the edited file
  };

  const setFileData = (e) => {
    if (e?.target?.files && e.target.files.length > 0) {
      setFile(e.target.files[0]);
    }
  };

  return (
    <>
      <input type='file' onChange={(e) => setFileData(e)} multiple={false} />

      <button onClick={showModalHandler}>Edit Photo</button>

      <ReactPhotoEditor
        open={showModal}
        onClose={hideModal}
        file={file}
        onSaveImage={handleSaveImage}
      />
    </>
  );
}

export default App;

📱 Live Demo

See it in action on Stackblitz

⚠️ Migration Guide

Migrating from v2.x to v3.0.0

Breaking Changes

• CSS Import Removed: The CSS file import (import 'react-photo-editor/dist/style.css') is no longer required
• Tailwind CSS Configuration: No longer need to add './node_modules/react-photo-editor/dist/*.js' to your Tailwind config
• Changed canvas class name and id: The class name and id for the canvas element have been changed from canvas to rpe-canvas for better consistency with the rest of the project. Make sure to update your usage accordingly.

🛠️ Configuration Options

The ReactPhotoEditor component accepts the following props:

🧰 Advanced Usage: Custom Component with usePhotoEditor Hook

For more control over the UI and functionality, you can use the usePhotoEditor hook to build your own custom editor component.

For full examples, see the example folder.

import { usePhotoEditor } from 'react-photo-editor';

function CustomPhotoEditor({ file }) {
  const {
    canvasRef,
    brightness,
    contrast,
    saturate,
    grayscale,
    setBrightness,
    setContrast,
    setSaturate,
    setGrayscale,
    handleZoomIn,
    handleZoomOut,
    generateEditedFile,
    resetFilters,
  } = usePhotoEditor({
    file,
    defaultBrightness: 100,
    defaultContrast: 100,
    defaultSaturate: 100,
    defaultGrayscale: 0,
  });

  const handleSave = async () => {
    const editedFile = await generateEditedFile();
    // Do something with the edited file
  };

  return (
    <div>
      <canvas ref={canvasRef} />

      <div>
        <label>Brightness: {brightness}</label>
        <input
          type='range'
          min='0'
          max='200'
          value={brightness}
          onChange={(e) => setBrightness(Number(e.target.value))}
        />
      </div>

      {/* Add more controls for other parameters */}

      <button onClick={handleZoomIn}>Zoom In</button>
      <button onClick={handleZoomOut}>Zoom Out</button>
      <button onClick={resetFilters}>Reset</button>
      <button onClick={handleSave}>Save</button>
    </div>
  );
}

Hook Parameters

Return Values

The hook returns the following values and functions:

🖼 Canvas & Image

🎛 State Values & Setters

🛠 Utility Functions

🖱 Event Handlers

🤝 Contributing

Contributions to react-photo-editor are welcome! If you have any issues, feature requests, or improvements, please open an issue or submit a pull request on the GitHub repository.

How to Contribute

1. Fork the repository
2. Create your feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add some amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a pull request

Reporting Issues

When reporting issues, please provide:

• A clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Screenshots if applicable
• Environment details (browser, OS, etc.)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.