現代 Web 應用常支援直接貼上截圖上傳(如 SegmentFault 評論區)。本文詳細解析此功能的實現原理,並提供完整可執行的 PHP + JavaScript 代碼範例。
paste 事件clipboardData.items[0].type.indexOf('image') > -1)FileReader 讀取圖片檔案為 Base64 格式<?php
header("Access-Control-Allow-Origin: *");
$url = 'https://' . $_SERVER['HTTP_HOST'];
$file = isset($_POST["file"]) ? $_POST["file"] : '';
if ($file) {
// 移除 Data URI 前綴並解碼
$data = base64_decode(str_replace('data:image/png;base64,', '', $file));
// 產生唯一檔名(MD5 + 時間戳)
$name = md5(time()) . '.png';
// 儲存檔案
file_put_contents($name, $data);
// 回傳完整 URL
echo $url . '/' . $name;
exit;
}
?>
<div id="box" style="width:400px;height:400px;border:1px solid;" contenteditable>
</div>
<input type="hidden" name="img" value="" id="img_puth"/>
<script>
document.querySelector('#box').addEventListener('paste', function(e) {
// 判斷是否為圖片貼上
if (e.clipboardData && e.clipboardData.items[0].type.indexOf('image') > -1) {
var that = this;
var reader = new FileReader();
var file = e.clipboardData.items[0].getAsFile();
// 讀取完成後上傳
reader.onload = function(e) {
var xhr = new XMLHttpRequest();
var fd = new FormData();
xhr.open('POST', '', true);
xhr.onload = function() {
var img = new Image();
img.src = xhr.responseText;
// 顯示於編輯區
that.innerHTML = '<img src="' + img.src + '" alt=""/>';
// 同步至隱藏欄位供表單提交
document.getElementById("img_puth").value = img.src;
};
// 即時預覽
that.innerHTML = '<img src="' + this.result + '" alt=""/>';
fd.append('file', this.result);
xhr.send(fd);
};
reader.readAsDataURL(file);
}
}, false);
</script>
| 技術點 | 說明 |
|---|---|
| Clipboard API | 使用 e.clipboardData.items 存取剪貼簿資料,支援多種 MIME 類型檢測 |
| FileReader | 非同步讀取 Blob/File 物件,readAsDataURL 產生 Base64 Data URI |
| FormData | 構建模擬表單提交資料,自動處理 multipart/form-data 編碼 |
| CORS 標頭 | PHP 設定 Access-Control-Allow-Origin: * 允許跨域請求 |
$_SERVER['CONTENT_LENGTH'] 或 Nginx/Apache 設定限制上傳大小此方案支援所有現代瀏覽器(Chrome 66+、Firefox 63+、Safari 13.1+、Edge 79+)。IE 不支援 Clipboard API,需改用 Flash 或其他替代方案。
完整代碼已可直接部署測試,開發者可根據專案需求調整儲存路徑、命名規則與前端 UI 交互邏輯。