使用JavaScript将图片保存至本地

秒速五厘米 2024-02-19 18:53 74阅读 0赞

## 在最近的开发当中，我们需要为img标签以及canvas动态绘制的图像提供下载功能，下面是经过探索后我们得出的结果。 ##

## 一、Canvas 版本 ##

// 下载Canvas元素的图片
    function downloadCanvasIamge(selector, name) {
        // 通过选择器获取canvas元素
        var canvas = document.querySelector(selector)
        // 使用toDataURL方法将图像转换被base64编码的URL字符串
        var url = canvas.toDataURL('image/png')
        // 生成一个a元素
        var a = document.createElement('a')
        // 创建一个单击事件
        var event = new MouseEvent('click')
        
        // 将a的download属性设置为我们想要下载的图片名称，若name不存在则使用‘下载图片名称’作为默认名称
        a.download = name || '下载图片名称'
        // 将生成的URL设置为a.href属性
        a.href = url
        
        // 触发a的单击事件
        a.dispatchEvent(event)
    }
    
    // 调用方式
    // 参数一： 选择器，代表canvas
    // 参数二： 图片名称，可选
    downloadCanvasIamge('canvas', '图片名称')

## 二、img 标签版本 ##

// 下载
    function downloadIamge(selector, name) {
        // 通过选择器获取img元素
        var img = document.querySelector(selector)
        // 将图片的src属性作为URL地址
        var url = img.src
        var a = document.createElement('a')
        var event = new MouseEvent('click')
        
        a.download = name || '下载图片名称'
        a.href = url
        
        a.dispatchEvent(event)
    }
    
    // 调用方式
    // 参数一： 选择器，代表img标签
    // 参数二： 图片名称，可选
    downloadIamge('canvas', '图片名称')

## 改进版 ##

## 由于跨域会导致a标签在部分浏览器中会直接打开新标签页，所以改进如下 ##

function downloadIamge(selector, name) {
        var image = new Image()
        // 解决跨域 Canvas 污染问题
        image.setAttribute('crossOrigin', 'anonymous')
        image.onload = function () {
            var canvas = document.createElement('canvas')
            canvas.width = image.width
            canvas.height = image.height
    
            var context = canvas.getContext('2d')
            context.drawImage(image, 0, 0, image.width, image.height)
            var url = canvas.toDataURL('image/png')
    
            // 生成一个a元素
            var a = document.createElement('a')
            // 创建一个单击事件
            var event = new MouseEvent('click')
    
            // 将a的download属性设置为我们想要下载的图片名称，若name不存在则使用‘下载图片名称’作为默认名称
            a.download = name || '下载图片名称'
            // 将生成的URL设置为a.href属性
            a.href = url
    
            // 触发a的单击事件
            a.dispatchEvent(event)
        }
    
        image.src = document.querySelector(selector).src
    }
    
    // 调用方式
    // 参数一： 选择器，代表img标签
    // 参数二： 图片名称，可选
    downloadIamge('canvas', '图片名称')

## 三、总结 ##

## 我们主要使用的是a标签的download属性, 下面为MDN给出的说明： ##

> ## 此属性指示浏览器下载URL而不是导航到URL，因此将提示用户将其保存为本地文件。   如果属性有一个值，它将在保存提示中用作预先填写的文件名 (用户仍然可以根据需要更改文件名)。对允许的值没有限制，但是/和\\被转换为下划线。大多数文件系统限制文件名中的一些标点符号，浏览器会相应地调整建议的名称。 ##

## 需要注意的地方： ##

*  ## 此属性仅适用于同源 URLs。 ##
 *  ## 可以使用 blob: URLs 和 data: URLs 以方便用户下载 JavaScript 方式生成的内容（例如使用在线绘图的Web应用创建的照片）。 ##
 *  ## 如果HTTP头的Content-Disposition：存在，并且赋予了一个和这个属性不同的文件名，HTTP头优先于此属性。 ##
 *  ## 如果这个属性存在 Content-Disposition 被设置为 inline，火狐优先 Content-Disposition，像之前文件名的情况下，而Chrome则优先 download 属性。 ##

## 支持：google,IE9以上版本。 ##