cropperjs

fengyuanchenMIT活跃维护

纯 JavaScript 的图片裁剪库,支持拖拽缩放、旋转翻转和自定义裁剪框,无需依赖其他库即可在网页里实现头像上传、图片编辑等裁剪功能。

JavaScript image cropper.

v2.3.1发布于 2026-10-16 12:47 UTC13,913star +2 / 7 天2,426fork同步于 2026-11-10 23:28 UTC

怎么上手

由 README 提炼,执行前请确认
npm install cropperjs
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

纯 JavaScript 图片裁剪库,在浏览器里给图片做可交互的裁剪框

纯 JavaScript 的图片裁剪库,支持拖拽缩放、旋转翻转和自定义裁剪框,无需依赖其他库即可在网页里实现头像上传、图片编辑等裁剪功能。

核心能力

  • 用 JavaScript 实现浏览器端图片裁剪交互
  • 提供 v2.x 分支,v1.x 保留在 v1 分支
  • 遵循语义化版本管理
  • 有 React、Vue、Angular 等社区封装

容易踩的坑

当前 README 是 v2.x 分支,v1.x 用法需切到 v1 分支查看;README 未给出引入与初始化示例,需参考官网文档

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v2.3.1
  1. v2.3.1最新正式版2026-10-16 · 2026-10-16 12:47 UTC

    See CHANGELOG.md for details.

  2. v2.3.02026-10-07 · 2026-10-07 08:16 UTC
    查看更新说明

    See CHANGELOG.md for details.

  3. v1.7.02026-10-07 · 2026-10-07 07:26 UTC
    查看更新说明

    See CHANGELOG.md for details.

  4. v2.2.02026-08-23 · 2026-08-23 12:09 UTC
    查看更新说明

    See CHANGELOG.md for details.

  5. v1.6.32026-08-23 · 2026-08-23 09:44 UTC
    查看更新说明

    See CHANGELOG.md for details.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Cropper.js

    Coverage Status Downloads Version Gzip Size

    JavaScript image cropper. This is the branch for v2.x. For v1.x, check out the v1 branch.

    Versioning

    Maintained under the Semantic Versioning guidelines.

    Commit Message Guidelines

    Git commits message follows the Conventional Commits guidelines.

    License

    MIT © Chen Fengyuan

    Related projects