Fork me on GitHub

方便快捷的实现图片裁剪

字数统计: 3.1k字   |   阅读时长≈ 14分

JavaScript image cropper

官网

1.5.12文档

CDN 地址

1
2
3
4
5
6
7
// 2.0
<link href="https://cdn.bootcdn.net/ajax/libs/cropperjs/2.0.0-alpha.1/cropper.min.css" rel="stylesheet">
<script src="https://cdn.bootcdn.net/ajax/libs/cropperjs/2.0.0-alpha.1/cropper.min.js"></script>

// 1.5.12
<link href="https://cdn.bootcdn.net/ajax/libs/cropperjs/1.5.12/cropper.min.css" rel="stylesheet">
<script src="https://cdn.bootcdn.net/ajax/libs/cropperjs/1.5.12/cropper.min.js"></script>

img

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# cropper - 裁剪图片 - IE9+

## 使用 cropperjs

import Cropper from 'cropperjs'
import 'cropperjs/dist/cropper.css'
this.myCropper = new Cropper('被裁剪对象', '配置对象') //返回一个cropper对象

this.myCropper.getCroppedCanvas().toDataURL('image/jpeg') //拿到裁剪后的base64的图片
this.myCropper.getCropBoxData();    //获取裁剪框数据
this.myCropper.setCropBoxData();    //设置裁剪框数据
this.myCropper.getCanvasData();      //获取图片数据
this.myCropper.setCanvasData();      //设置图片数据

示例：1.5.12 版本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
<link rel="stylesheet" href="/css/cropper.min.css">
<script src="/js/cropper.min.js"></script>
<style>
    .img-box {
        width: 100%;
        height: auto;
        display: flex;
    }
    .shear {
        width: 800px;
        height: 600px;
        border: 1px solid skyblue;
    }
    #previewBox,
    #previewBoxRound {
        width: 200px;
        height: 200px;
        box-sizing: border-box;
        border: 1px solid skyblue;
        overflow: hidden;
    }
    #previewBox {
        border-radius: 50%;
    }

</style>

<button class="layui-btn layui-btn-normal" id="btn-clip">裁剪</button>

<div class="img-box">
    <div id="previewBox"></div>
    <div id="previewBoxRound"></div>

    <div class="shear">
        <img id="testImg" src="/images/b2.png" alt="">
    </div>
</div>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
const cropper = new Cropper(image, {
    aspectRatio: 1 / 1, // 设置裁剪框为固定的宽高比
    minContainerWidth: 450,   //容器最小的宽度
    minContainerHeight: 250,  //容器最小的高度
    dragMode: 'move',         //设置裁剪框为可以移动
    viewMode: 1, // 
    // autoCrop: false,// 默认不剪切，双击图片开启剪切
    preview:[ 
        document.getElementById('previewBox'), //设置我们需要添加实时预览的地方
        document.getElementById('previewBoxRound')
    ],
    crop: function(e) {
        console.log(e.detail.x);
        console.log(e.detail.y);
        console.log(e.detail.width);
        console.log(e.detail.height);
        console.log(e.detail.rotate);
        console.log(e.detail.scaleX);
        console.log(e.detail.scaleY);
    }
});
// 裁剪
oBtnClip.addEventListener('click', function(e) {
    // 返回 base64位 格式图片
    let data = cropper.getCroppedCanvas().toDataURL('image/jpeg');
    console.log(data);
})

image-20220711113054232

文档

配置对象

https://github.com/fengyuanchen/cropperjs
注意：第一个值为默认值

  • 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 裁剪框缩放事件

图片插件拓展：

jquery-zoom

用于在触摸、单击或鼠标悬停时放大图像的插件。放大镜效果于原图缩放

codepen 示例

Property Default Description
url false The url of the large photo to be displayed. If no url is provided, zoom uses the src of the first child IMG element inside the element it is assigned to.
on ‘mouseover’ The type of event that triggers zooming. Choose from mouseover, grab, click, or toggle.
duration 120 The fadeIn/fadeOut speed of the large image.
target false A selector or DOM element that should be used as the parent container for the zoomed image.
touch true Enables interaction via touch events.
magnify 1 This value is multiplied against the full size of the zoomed image. The default value is 1, meaning the zoomed image should be at 100% of its natural width and height.
callback false A function to be called when the image has loaded. Inside the function, this references the image element.
onZoomIn false A function to be called when the image has zoomed in. Inside the function, this references the image element.
onZoomOut false A function to be called when the image has zoomed out. Inside the function, this references the image element.

Zooming

Zooming 是一款纯 javascript 图片缩放库，主要特点有：

  • 不依赖其他库，纯 JavaScript 实现，支持移动设备；
  • 流畅的动画；
  • 可缩放高清图像；
  • 易于集成和定制。

zoomify

弹出图片层展示图片，但是不能 缩放,要引入css,js

1
2
3
4
5
6
7
8
9
<link rel="stylesheet" href="/css/zoomify.css">

<img src="" id="algorithmPic" style="height:100% ;" >

<script src="/js/zoomify.js"></script>

<script>
	$('#algorithmPic').zoomify(); // Default settings
</script>

jquery 插件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
// BUP.js 
$.fn.BUP = function (brother,beishu) {
    var $element = this;
    var $className = $element.attr("class");
   	var $class1 //class ����
    // If the target element is not an image
    if (!$element.is("img")) {
      console.log("%c Blowup.js Error: " + "%cTarget element is not an image.",
        "background: #FCEBB6; color: #F07818; font-size: 17px; font-weight: bold;",
        "background: #FCEBB6; color: #F07818; font-size: 17px;");
      return;
    }

    // Constants
    //var $IMAGE_URL    = $element.attr("src").replace(/ /g,"%20");
    var $IMAGE_URL    = $element.attr("src").replace(/ /g,"%20").replace(/\(/g,"%28").replace(/\)/g,"%29");
    var $IMAGE_WIDTH  = $element.width();
    var $IMAGE_HEIGHT = $element.height();
    var NATIVE_IMG    = new Image();
    NATIVE_IMG.src    = $element.attr("src");

    var defaults = {
      round      : true,
      width      : 200,
      height     : 200,
      background : "#FFF",
      shadow     : "0 8px 17px 0 rgba(0, 0, 0, 1)",
      border     : "6px solid #FFF",
      cursor     : true,
      zIndex     : 999999999
    };

    // Update defaults with custom attributes
    var $options = defaults;

    // Modify target image
    $element.on('dragstart', function (e) { e.preventDefault(); });
    $element.css("cursor", $options.cursor ? "crosshair" : "none");

    // Create magnification lens element
    var lens = document.createElement("div");
    lens.id = ""+$className+"BlowupLens";

    // Attack the element to the body
    $("body").append(lens);

    // Updates styles
    $blowupLens = $("#"+lens.id);

    $blowupLens.css({
      "position"          : "absolute",
      "visibility"        : "hidden",
      "pointer-events"    : "none",
      "zIndex"            : $options.zIndex,
      "width"             : $options.width,
      "height"            : $options.height,
      "border"            : $options.border,
      "background"        : $options.background,
      "border-radius"     : $options.round ? "50%" : "none",
      "box-shadow"        : $options.shadow,
      "background-repeat" : "no-repeat",
    });

    // Show magnification lens
    $element.mouseenter(function () {
    	$class1 = $element.attr("class");
    	$blowupLens = $("#"+$class1+"BlowupLens");
        $blowupLens.css("visibility", "visible");
    });

    // Mouse motion on image
    $element.mousemove(function (e) {
      var lensX = e.pageX - $options.width / 2;
      var lensY = e.pageY - $options.height / 2;
      // Relative coordinates of image
      var relX = e.offsetX;
      var relY = e.offsetY;
      // Zoomed image coordinates
      var zoomX = -Math.floor(relX / $element.width() * NATIVE_IMG.width - $options.width / 2);
      var zoomY = -Math.floor(relY / $element.height() * NATIVE_IMG.height - $options.height / 2);
      var bgSize = NATIVE_IMG.width;

      if(NATIVE_IMG.width < $(brother).width()){//���ͼƬС������
        bgSize = $(brother).width();
        zoomX = -Math.floor(relX / $element.width() * $(brother).width() - $options.width / 2);
        zoomY = -Math.floor(relY / $element.height() * $(brother).height() - $options.height / 2);
      }

      // Apply styles to lens
      //console.log(zoomX,zoomY)
      $blowupLens.css({
        left                  : lensX,
        top                   : lensY,
        "background-image"    : "url(" + $IMAGE_URL + ")",
        // "background-position" : zoomX + " " + zoomY,
        "background-position" : zoomX + "px " + zoomY + "px",
        "background-size"  : bgSize
      });
    });

    // ����Ƴ�
    $element.mouseleave(function () {
      document.onmousewheel = null;
      $blowupLens.css("visibility", "hidden");
    })

  };

将图片挂载到指定容器

1
2
3
4
5
<div class="common-open-layer" style="display: flex;align-items: center;justify-content: center;">
     <img class="laftImg" style="max-height:100%;max-width:100%;display:block;" src="" />
</div>

$(".laftImg").BUP(".common-open-layer");

element-ui 自带预览组件封装

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

//vue图片预览组件
 
import Preview from "@/components/PreviewItem/preview.js";
Vue.use(Preview);
 
 
// 组件如下：
<template>
  <el-image-viewer
    v-if="showPreview"
    :urlList="previewImages"
    :on-close="closeViewer"
    :zIndex="99999"
  ></el-image-viewer>
</template>
<script>
// 可自行去对应目录查看该组件
import ElImageViewer from "element-ui/packages/image/src/image-viewer";
export default {
  data() {
    return {
      showPreview: false,
      previewImages: []
    };
  },
  components: {
    ElImageViewer
  },
  methods: {
    closeViewer() {
      this.showPreview = false;
      document.querySelector('body').classList.remove('el-popup-imageView--hidden')
    }
  }
};
</script>
 
 
 
// preview.js
 
import PreviewItem from "./preview.vue";
 
const Preview = {};
 
// 注册
Preview.install = function(Vue) {
  const PreviewConstructor = Vue.extend(PreviewItem);
  const instance = new PreviewConstructor();
  let div = document.createElement("div")
  div.style.position = 'absolute'
  div.style.zIndex = '999999'
  instance.$mount(document.createElement("div"));
  document.body.appendChild(instance.$el);
 
  /**
   * 挂载在vue原型上
   * @param {Array} imgs 需要预览的图片数组
   */
  Vue.prototype.$openPreview = function(imgs = []) {
    instance.showPreview = true;
    document.querySelector('body').classList.add('el-popup-imageView--hidden')
    instance.previewImages = imgs;
  };
};
 
export default Preview;

vue-cropper

用于 图片裁剪的 vue 插件，官网示例

扫一扫，分享到微信

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia-plus根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

侠客行
作者：李白
赵客缦胡缨，吴钩霜雪明。
银鞍照白马，飒沓如流星。
十步杀一人，千里不留行。
事了拂衣去，深藏身与名。
闲过信陵饮，脱剑膝前横。
将炙啖朱亥，持觞劝侯嬴。
三杯吐然诺，五岳倒为轻。
眼花耳热后，意气素霓生。
救赵挥金槌，邯郸先震惊。
千秋二壮士，烜赫大梁城。
纵死侠骨香，不惭世上英。
谁能书阁下，白首太玄经。