这是干什么的?
Cropper.js 是一个用于网页的 JavaScript 图片裁剪库:把它嵌入页面后,用户就可以直接在浏览器里交互式地裁剪图片。
它是一个做好的裁剪应用,还是一个用来二次开发的库?
它是一个前端库,不是独立应用——你要把它引入自己的网页,围绕它搭建自己的界面,在网站里实现裁剪功能。
怎么把它加到我的项目里?
从 npm 安装 cropperjs 包(npm install cropperjs),然后在代码里引入即可;README 里有项目官网链接,完整文档都在那里。
它会带进来一大堆依赖吗?
不会——这个包没有任何运行时依赖,不会给你的打包文件拖进多余的东西。
我看到提到 v1 和 v2——我装的到底是哪个?
注意大版本号:这个分支是 v2.x 系列,API 是自己的一套;旧的 v1.x 单独放在 v1 分支上,所以针对一个版本的教程可能和另一个对不上。
这是给最终用户安装的,还是给开发者用的?
它是给网页开发者用的——你把它集成到自己的应用里,最终用户只会看到你页面里的裁剪界面。
能在 React、Vue 或 Angular 里用吗?
核心本身不依赖任何框架,但 README 里链接了社区封装,包括 cropperjs-react-wrapper(兼容 v2)、react-cropper、vue-cropperjs、angular-cropperjs、ember-cropperjs 和 blazor-cropperjs。
在商业项目里用要收费吗?
不用——它采用 MIT 许可证,只要保留版权声明,商业使用完全没有问题。
和我的 TypeScript 环境配合得好吗?
这个库本身就是用 TypeScript 写的——GitHub 上它列为主要语言——所以你直接使用带类型的 API,不用事后补类型。
What are similar projects?
squoosh, smartcrop.js, sharp, marked, fingerprintjs, sweetalert, markdown-it, react-dnd
Which topics is it in?
image-editing, image-processing, browser, web-development, npm, frontend, library, typescript, javascript, web, mit, open-source