假設一個應用場景:由於某些特殊原因從服務端請求到圖片路徑,要求通過該路徑獲取對應圖片的 base64 dataURL。在這個場景中,我們首先推斷該圖片路徑是可訪問的,同時還需要一種將圖片轉換到 dataURL 的方法。我們如何實現它呢?
dataURL
先大致回顧下正統的 dataURL 的語法,這有助於我們檢驗轉換後的內容是否正確。一個完整的 dataURI 應該是這樣的:
data:[<mediatype>][;base64],<data>
其中mediatype聲明瞭文件類型,遵循MIME規則,如“image/png”、“text/plain”;之後是編碼類型,這裏我們只涉及 base64;緊接着就是文件編碼後的內容了。我們常常在 HTML 裏看到img標籤的src會這樣寫:
src="data:image/gif;base64,R0lGODdhMAAwAPAAAAAAAP///ywAAAAAMAAwAAAC8IyPqcvt3wCcDkiLc7C0qwyGHhSWpjQu5yqmCYsapyuvUUlvONmOZtfzgFzByTB10QgxOR0TqBQejhRNzOfkVJ+5YiUqrXF5Y5lKh/DeuNcP5yLWGsEbtLiOSpa/TPg7JpJHxyendzWTBfX0cxOnKPjgBzi4diinWGdkF8kjdfnycQZXZeYGejmJlZeGl9i2icVqaNVailT6F5iJ90m6mvuTS4OK05M0vDk0Q4XUtwvKOzrcd3iq9uisF81M1OIcR7lEewwcLp7tuNNkM3uNna3F2JQFo97Vriy/Xl4/f1cf5VWzXyym7PHhhx4dbgYKAAA7"
這個img引用的就是以 base64 編碼的 dataURL 了,只要瀏覽器支持,就可以被解碼成 gif 圖片並渲染出來。
.toDataURL()
FileReader
對象也有類似的方法,比如.readAsDataURL()
,然而它只接受file
或blob
類型,而這兩種類型一般只能通過<input[type=file]>
元素的files屬性獲取,或者用Blob()
構造函數手工創建一個新的對象。尷尬的是我們當前只有圖片路徑,受制於瀏覽器的安全策略,<input[type=file]>
的files屬性是隻讀的,而Blob()
構造函數只接受文件內容,兩種方式都無法通過圖片路徑直接獲取。上文中假設的應用場景迫使我們必先考慮如何通過路徑獲取到圖片內容。<img>
是可以的,並且可以被繪製到<canvas>
中,而<canvas>
正巧擁有.toDataURL()
方法。
萬事具備,我們只需要把<img>
獲取到的圖片放到<canvas>
裏再通過.toDataURL()
方法轉化下,就可以得到以 base64
編碼的 dataURL
。來看這個方法的語法:
canvas.toDataURL([type, encoderOptions]);
canvas
是DOM元素<canvas>
對象;參數type
指定圖片類型,如果指定的類型不被支持則以默認值image/png
替代;encoderOptions
可以爲image/jpeg
或image/webp
類型的圖片設置圖片質量,取值0-1,超出則以默認值0.92替代。
需要注意的是,在轉換成 dataURL
前必須先確保圖片成功加載到,於是.toDataURL()
方法應該寫在<img>
的onload
異步事件中。現在就來實現一個功能函數:
function getBase64(url){
//通過構造函數來創建的 img 實例,在賦予 src 值後就會立刻下載圖片,相比 createElement() 創建 <img> 省去了 append(),也就避免了文檔冗餘和污染
var Img = new Image(),
dataURL='';
Img.src=url;
Img.οnlοad=function(){ //要先確保圖片完整獲取到,這是個異步事件
var canvas = document.createElement("canvas"), //創建canvas元素
width=Img.width, //確保canvas的尺寸和圖片一樣
height=Img.height;
canvas.width=width;
canvas.height=height;
canvas.getContext("2d").drawImage(Img,0,0,width,height); //將圖片繪製到canvas中
dataURL=canvas.toDataURL('image/jpeg'); //轉換圖片爲dataURL
};
}
一個可供隨時調用的轉換函數完成了,它會在圖片被加載後返回一整個 dataURL 字符串。
完善
onload
事件確保了轉換任務在加載後執行,這是必須的。這又帶來了新問題,dataURL
只有在圖片加載完成後纔會返回,我們無法確定圖片什麼時候完成加載。如果後續要對 dataURL
做相關處理(比如傳遞到其他服務器)的話,添加一個回調是必要的,這能確保後續處理任務在成功得到 dataURL
之後執行,我們需要修改getBase64()
:
function getBase64(url,callback){ //添加一個回調參數
...
Img.οnlοad=function(){
...
canvas.getContext("2d").drawImage(Img,0,0,width,height);
dataURL=canvas.toDataURL('image/jpeg');
callback?callback(dataURL):null; //調用回調函數
};
}
在執行時添加回調:
getBase64('//upload.jianshu.io/users/upload_avatars/555630/fdd1b798e6b0.jpg',(dataURL)=>{
console.log(dataURL);
});
就是這樣,如果不考慮兼容性的話,或許我們可以用 promise 和 generator 來實現,再添加一些錯誤處理就更完美了。