copper.js api

- viewMode 视图控制

    - 0 无限制

    - 1 限制裁剪框不能超出图片的范围

    - 2 限制裁剪框不能超出图片的范围 且图片填充模式为 cover 最长边填充

    - 3 限制裁剪框不能超出图片的范围 且图片填充模式为 contain 最短边填充- dragMode 拖拽图片模式

    - crop 形成新的裁剪框

    - move 图片可移动

    - none 什么也没有- initialAspectRatio 裁剪框宽高比的初始值 默认与图片宽高比相同 只有在aspectRatio没有设置的情况下可用- aspectRatio 设置裁剪框为固定的宽高比- data 之前存储的裁剪后的数据 在初始化时会自动设置 只有在autoCrop设置为true时可用- preview 预览 设置一个区域容器预览裁剪后的结果

    - Element, Array (elements), NodeList or String (selector)

- responsive 在窗口尺寸调整后 进行响应式的重渲染 默认true- restore 在窗口尺寸调整后 恢复被裁剪的区域 默认true

- checkCrossOrigin 检查图片是否跨域 默认true 如果是 会在被复制的图片元素上加上属性crossOrigin 并且在src上加上一个时间戳 避免重加载图片时因为浏览器缓存而加载错误

- checkOrientation 检查图片的方向信息(仅JPEG图片有)默认true 在旋转图片时会对图片方向值做一些处理 以解决IOS设备上的一些问题

- modal 是否显示图片和裁剪框之间的黑色蒙版 默认true

- guides 是否显示裁剪框的虚线 默认true

- center 是否显示裁剪框中间的 ‘+’ 指示器 默认true

- highlight 是否显示裁剪框上面的白色蒙版 (很淡)默认true

- background 是否在容器内显示网格状的背景 默认true

- autoCrop 允许初始化时自动的裁剪图片 配合 data 使用 默认true

- autoCropArea 设置裁剪区域占图片的大小 值为 0-1 默认 0.8 表示 80%的区域

- movable 是否可以移动图片 默认true

- rotatable 是否可以旋转图片 默认true

- scalable 是否可以缩放图片(可以改变长宽) 默认true

- zoomable 是否可以缩放图片(改变焦距) 默认true

- zoomOnTouch 是否可以通过拖拽触摸缩放图片 默认true

- zoomOnWheel 是否可以通过鼠标滚轮缩放图片 默认true

- wheelZoomRatio 设置鼠标滚轮缩放的灵敏度 默认 0.1

- cropBoxMovable 是否可以拖拽裁剪框 默认true- cropBoxResizable 是否可以改变裁剪框的尺寸 默认true

- toggleDragModeOnDblclick 是否可以通过双击切换拖拽图片模式(move和crop)默认true 当拖拽图片模式为none时不可切换 该设置必须浏览器支持双击事件

- minContainerWidth(200)、minContainerHeight(100)、minCanvasWidth(0)、minCanvasHeight(0)、minCropBoxWidth(0)、minCropBoxHeight(0) 容器、图片、裁剪框的 最小宽高 括号内为默认值 注意 裁剪框的最小高宽是相对与页面而言的 并非相对图片

## 方法

__注意:如果方法没有被设置返回任何值,那么它会返回一个cropper的实例 因此多个方法可以使用链式写法__

- crop() 手动显示裁剪框

- reset() 重置图片和裁剪框为初始状态

- replace(url[, hasSameSize]) 替换图片路径并且重建裁剪框

    - url 新路径

    - hasSameSize 默认值false 设置为true表示新老图片尺寸一样 只需要更换路径无需重建裁剪框

- enable() 解冻 裁剪框

- disable() 冻结 裁剪框

- destroy() 摧毁裁剪框并且移除cropper实例

- move(offsetX[, offsetY]) 移动图片指定距离 一个参数代表横纵向移动距离一样

- moveTo(x[, y]) 移动图片到一个指定的点 一个参数代表横纵向移动距离一样

- zoom(ratio) 缩放 ratio大于零是放大 小于零缩小

- zoomTo(ratio[, pivot]) 缩放并设置中心点的位置

- rotate(degree) 旋转 类似css- rotateTo(degree) 旋转到绝对角度

- scale(scaleX[, scaleY])、scaleX(scaleX)、scaleY(scaleY) 缩放 一个参数代表横纵向缩放值一样

- getData([rounded]) 返回裁剪区域基于原图片!原尺寸!的位置和尺寸 rounded默认为false 表示是否显示四舍五入后的数据 有了这些数据可以直接在原图上进行裁剪显示

- setData(data) 改变裁剪区域基于原图的位置和尺寸 仅当viewMode 不为0时有效

- getContainerData()、getImageData()、getCanvasData()、setCanvasData(data)、getCropBoxData()、setCropBoxData(data) 容器、图片容器(画布)、图片、裁剪区域相对容器的数据设置和获取

- getCroppedCanvas([options]) 得到被裁剪图片的一个canvas对象 options设置这个canvas的一些数据- width、height、minWidth、minHeight、maxWidth、maxHeight、fillColor、imageSmoothingEnabled(图片是否是光滑的 默认true)、imageSmoothingQuality(图片的质量 默认low 还有medium、high)

- setAspectRatio(aspectRatio) 改变裁剪区域的宽高比

- setDragMode([mode]) 设置拖拽图片模式

## 事件- ready 渲染前(图片已经被加载、cropper实例已经准备完毕)的准备工作事件

 - cropstart、cropmove、cropend、crop 开始画裁剪框(或画布)、画裁剪框(或画布)的中途、裁剪框(或画布)画完、进行裁剪事件 event.detail.originalEvent、event.detail.action

    - 当autoCrop为true crop事件会在ready之前触发- zoom 裁剪框缩放事件

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 198,082评论 5 464
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,231评论 2 375
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 145,047评论 0 327
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,977评论 1 268
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,893评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 47,014评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,976评论 3 388
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,605评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,888评论 1 293
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,906评论 2 314
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,732评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,513评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,980评论 3 301
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,132评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,447评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,027评论 2 343
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,232评论 2 339

推荐阅读更多精彩内容