1.0.3 • Published 7 months ago
react-image-crop-drag v1.0.3
react-image-crop-drag
A React component for creating draggable image views with automatic scaling and positioning. Perfect for concert posters, event banners, and profile headers.
Features
- Vertical drag adjustment for perfect image positioning
- Automatic image scaling while maintaining aspect ratio
- Smooth animations and transitions
- Touch device support for mobile interactions
- Center positioning with smart constraints
- No image overflow
- Zero dependencies (except React)
Installation
npm install react-image-crop-drag
Example
import { useState } from 'react';
import ImageCropView from 'react-image-crop-drag';
function App() {
const [isEditing, setIsEditing] = useState(false);
const handleSave = (cropData) => {
setIsEditing(false);
};
return (
<ImageCropView
src="/path/to/concert-poster.jpg"
containerWidth={800}
containerHeight={400}
isEditing={isEditing}
onSave={handleSave}
/>
);
}
Props
Prop | Type | Required | Default | Description |
---|---|---|---|---|
src | string | Yes | - | Image source URL |
containerWidth | number | No | 800 | Width of the container |
containerHeight | number | No | 400 | Height of the container |
isEditing | boolean | No | false | Enable/disable drag mode |
onSave | function | No | - | Callback with crop data |
Example Use Cases
- Concert posters and event banners
- Profile header images
- Cover photos for social media
- Featured image sections
- Banner advertisements
Development
# Install dependencies
npm install
# Build package
npm run build
License
MIT