vue-image-crop：基於Vue的移動端圖片裁剪組件

代碼地址：https://github.com/jczzq/vue-...

vue-image-crop

基於Vue的移動端圖片裁剪組件

組件使用 URL.createObjectURL()等新特性，使用前注意兼容問題。IE >= 10

功能預覽

快速開始

安裝Node >= 8.9.0（推薦LTS = 8.11.0）

# 安裝 vue-cli 3.x
npm install -g @vue/cli

cd vue-image-crop
npm install
npm run dev

啓動開發模式便可定製功能

構建

npm run build

build以後會從新生成lib文件夾

API

props

屬性名	類型	默認值	說明
value	Object	{}	裁剪後的圖片對象；必傳；可以使用v-model綁定
proportion	Object	{ w: 2, h: 1 }	圖片寬高比例對象；非必傳；用於動態計算寬高比例，因此w和h兩個屬性沒有固定值
quality	Number	0.92	清晰度；非必傳；HTMLCanvasElement.toDataURL()的第二個參數
hasRemove	Boolean	false	是否顯示移除按鈕；非必傳；列表中使用時可能會用到
skipCrop	Boolean	false	是否直接上傳；非必傳；設置爲true的時候圖片將不會裁剪直接返回
config	Object	{ size: 1200, isSlice: true, path: null }	配置對象；此對象不傳有默認值，若傳時對象裏的每一個屬性都必須傳；size:圖片最大寬度（px），isSlice:是否須要裁剪，path:顯示圖片時的路徑，path參數將直接與圖片id拼接(path + id)

events

事件名	說明	回調參數
remove	移除按鈕被點擊時觸發	-
change	改變選中圖片時觸發	event.target.files[0]，新文件
submit	圖片操做完成時觸發	當前裁剪後的圖片對象
cancel	圖片操做取消時觸發	-

示例代碼

<template>
    <div class="ctnr">
        <p>常規用法</p>
        <m-image-crop class="mic mic1"
                      v-model="img"></m-image-crop>

        <p>調整比例</p>
        <m-image-crop class="mic mic2"
                      v-model="img2"
                      :proportion="{ w: 100, h: 35 }"></m-image-crop>

        <p>列表</p>
        <div class="list">
            <div class="item"
                 v-for="(item, index) in imgList"
                 :key="item.id">
                <m-image-crop class="mic"
                              has-remove
                              :value="item"
                              :proportion="{ w: 1, h: 1 }"
                              @remove="removeHandle(index)"></m-image-crop>
            </div>
            <div class="item add"
                 @click="addHandle">添加圖片</div>
        </div>

    </div>
</template>

<script>
export default {
    data() {
        return {
            img: {},
            img2: {},
            imgList: []
        };
    },
    methods: {
        addHandle() {
            this.imgList.push({});
        },
        removeHandle(index) {
            this.imgList.splice(index, 1);
        }
    }
};
</script>

<style lang="less">
html,
body {
    margin: 0;
}
.ctnr {
    height: 100vh;
    .mic {
        border: 1px dotted #4fc08d;
    }
    .mic1 {
        width: 200px;
        height: 100px;
    }
    .mic2 {
        width: 100vw;
        height: 35vw;
    }
    .list {
        font-size: 0;
        .item {
            box-sizing: border-box;
            font-size: 14px;
            vertical-align: middle;
            display: inline-block;
            border: 1px dotted #4fc08d;
            width: 33.33vw;
            height: 33.33vw;
        }
        .add {
            text-align: center;
            line-height: 33.33vw;
        }
    }
}
</style>