@cropper/element-viewer

@cropper/element-viewer

A custom viewer element for the Cropper.

Main npm package files

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

Getting started

Installation

npm install @cropper/element-viewer

Usage

import CropperViewer from '@cropper/element-viewer';

CropperViewer.$define();

<cropper-viewer></cropper-viewer>

Versioning

Maintained under the Semantic Versioning guidelines.

License

MIT

Changelog

2.1.0 (2025-10-19)

• docs: fix value of free aspect ratio (5b4e96f), closes #1274
• refactor(element-shade): use selection itself when default prevented (0673f15)
• fix(element-image): ensure the image is fully rendered (5afd8f3), closes #1168
• fix(element-selection): get correct event target in shadow DOM (#1276) (e64d6c3), closes #1276
• fix(element-shade): fix shade size when selection changes (98c101c)
• fix(element): call attachShadow only if shadowRoot does not exist (75cabcf), closes #1217
• feat(cropperjs): add destroy method (6a933e3), closes #1271