@cropper/element-shade

@cropper/element-shade

A custom shade element for the Cropper.

Main npm package files

dist/
├── element-shade.js         (UMD, bundled)
├── element-shade.min.js     (UMD, bundled, compressed)
├── element-shade.raw.js     (UMD, unbundled, default)
├── element-shade.esm.js     (ECMAScript Module, bundled)
├── element-shade.esm.min.js (ECMAScript Module, bundled, compressed)
├── element-shade.esm.raw.js (ECMAScript Module, unbundled)
└── element-shade-shade.d.ts       (TypeScript Declaration File)

Getting started

Installation

npm install @cropper/element-shade

Usage

import CropperShade from '@cropper/element-shade';

CropperShade.$define();

<cropper-shade></cropper-shade>

Versioning

Maintained under the Semantic Versioning guidelines.

License

MIT

Changelog

<small>2.0.1 (2025-07-25)</small>

• build: add missing /dist paths (42dba8b)
• build: release v2.0.1 (b9c9420)
• fix: correct require.node.default export and explicitly export package.json (#1259) (97f8787), closes #1259
• fix: set crossorigin attribute on cropper image element (#1253) (f11026c), closes #1253
• fix(cropper-selection): improve selection movement logic for better user experience (e7e3510)
• fix(cropperjs): fix container query issue when in a custom element (4fea6fd)
• fix(cropperjs): inherit additional attributes from HTMLImageElement (cb5a341)
• fix(element-image): add missing attributes (type declarations) (2e46715), closes #1233
• fix(element-shade): get data from event.detail when the selection is dynamic (f6b2847)
• fix(element-shade): get data from event.detail when there are multiple selections (09fd9ca)
• fix(element-shade): prevent shade from "glitching" when pulling selection too far (#1242) (2dab6ff), closes #1242 #1078
• fix(element-viewer): fix selection query issue when in a custom element (aecee79), closes #1245
• fix(element-viewer): transform the image by the selection offset after the next DOM update cycle (04a2c8b), closes #1258
• test(cropper): remove support for HTMLCanvasElement and improve container handling in tests (91d5ab3)
• test(cropperjs): add container option to getCropperSelections test (69a0ab6)
• refactor(element-shade): rename selection event handler for better readability (c960217)
• docs: explain that jQuery Cropper only available for Cropper.js 1.0 now (3df9b20)