ARTICLE · 1387458
前端多图叠加合成、下载与 HTML 转图实战封装
前端多图叠加合成、下载与 HTML 转图实战封装在日常前端开发中,我们经常会遇到动态生成分享海报的需求。下面整理了一些常用的处理改需求需要用到的方法。 1. mergeImage多图叠加合成 可应用于给图片加水印,将背景图、用户头像、二维码合为一张分享图等 2. downloadPage 导出图片 直接使用 3. htmlToImage dom导出为图片 借助html2canvas库,将DOM直接导出为图片。
<a download> 下载跨域的网络图片时,部分浏览器会直接打开预览而非触发下载。先将图片转为同源的 DataURL 再触发下载,可以完美规避这一问题:import html2canvas from 'html2canvas'const loadImage = (url) => {return new Promise((resolve, reject) => {const img = new Image();img.crossOrigin = "anonymous";img.onload = () => resolve(img);img.onerror = (err) => {console.log(err)reject(new Error("图片加载失败"))};img.src = url;});};/*** 合成图片* @param {*} imgInfoList 图片信息列表,每个元素为{* url: 图片url,* width: 图片宽度,默认图片宽度* height: 图片高度,默认图片高度* x: 图片合成位置x轴,默认0* y: 图片合成位置y轴,默认0* }* 图片按照从底部到顶部的顺序合成**/export const mergeImage = async (imgInfoList) => {const items = await Promise.all(imgInfoList.map(async (imgInfo) => {const img = await loadImage(imgInfo.url);return {...imgInfo,img: img,x: imgInfo.x || 0,y: imgInfo.y || 0,width: imgInfo.width || img.width,height: imgInfo.height || img.height,}}));let canvas = document.createElement("canvas");canvas.width = Math.ceil(Math.max(...items.map(item => item.x + item.width)));canvas.height = Math.ceil(Math.max(...items.map(item => item.y + item.height)));if (!canvas.width || !canvas.height) {throw new Error("画布尺寸为空,请检查图片列表和尺寸");}let ctx = canvas.getContext("2d");if (!ctx) {throw new Error("画布上下文为空,请检查浏览器是否支持2d渲染");}try {items.forEach(item => {ctx.drawImage(item.img, item.x, item.y, item.width, item.height);})return canvas.toDataURL("image/png");} catch (err) {throw new Error("图片合成失败,请检查图片列表和尺寸");} finally {canvas.width = 0;canvas.height = 0;canvas.remove();canvas = null;ctx = null;}};/*** 下载图片* @param {*} dataURL 图片dataURL* @param {*} fileName 图片文件名**/export const downloadImage = async (dataURL, fileName) => {if (!isDataURL(dataURL)) {// 转换图片为dataURLconst newDataURL = await convertToDataURL(dataURL);downloadImageByDataURL(newDataURL, fileName);}downloadImageByDataURL(dataURL, fileName);};/*** 转换图片为dataURL* @param {*} img 图片url* @returns 图片dataURL**/const convertToDataURL = async (img) => {const image = await loadImage(img);const canvas = document.createElement("canvas");const ctx = canvas.getContext("2d");ctx.drawImage(image, 0, 0, image.width, image.height);return canvas.toDataURL("image/png");}/*** 下载图片* @param {*} dataURL 图片dataURL* @param {*} fileName 图片文件名**/const downloadImageByDataURL = (dataURL, fileName) => {if (!isDataURL(dataURL)) {return;}// 使用dataURL下载图片, 可避免跨域问题let a = document.createElement("a");a.href = dataURL;a.download = fileName;a.click();a.remove();a = null;}/*** 转换html为图片* @param {*} dom html元素* @returns 图片dataURL**/export const htmlToImage = (dom) => {return new Promise((resolve, reject) => {html2canvas(dom, {useCORS: true, // 开启CORS,解决跨域问题scale: 2,// 用于渲染的比例尺。默认为浏览器设备像素比率。默认值是1,手机端设置成2dpi: 192, // 将分辨率提高到特定的dpi,默认值为96backgroundColor: null, // 背景颜色,默认值为null}).then((canvas) => {resolve(canvas.toDataURL("image/png"));}).catch((err) => {reject(err);});})}/*** 判断是否为dataURL* @param {*} value 字符串* @returns 是否为dataURL**/const isDataURL = (value) => {return typeof value === 'string' &&/^data:image\/[\w.+-]+;base64,/i.test(value)}















































































