DIV CSS 佈局教程網

clipboardData 物件用法:以指令操作剪貼簿的剪切與貼上
編輯:關於JavaScript     

在瀏覽器還沒有非同步剪貼簿 API 的年代,網頁要讀寫剪貼簿只能靠 clipboardData 物件。它提供對預定義剪貼簿格式的存取能力,讓開發者在編輯類操作(cut、copy、paste)中插入自訂邏輯。

成員一覽

  • clearData:透過 dataTransfer 或 clipboardData 物件,從剪貼簿中刪除一或多種格式的資料。
  • getData:從剪貼簿取得指定格式的資料。
  • setData:以指定格式把資料寫入 dataTransfer 或 clipboardData 物件。

完整範例:自製剪切與貼上

以下範例示範如何用 setData 與 getData,配合 oncut/onpaste 事件完成一組剪切貼上流程。

<SCRIPT>
var bResult;

// 選中要剪切的文字
function fnLoad() {
  var r = document.body.createTextRange();
  r.findText(oSource.innerText);
  r.select();
}

// 啟用剪切選單項目,該項目在 DIV 上預設無效
function fnBeforeCut() {
  event.returnValue = false;
}

// 以文字格式寫入 window.clipboardData,並把 setData 的布林結果顯示出來
function fnCut() {
  event.returnValue = false;
  bResult = window.clipboardData.setData("Text", oSource.innerText);
  oSource.innerText = "";
  tText.innerText += bResult;
}

// 啟用貼上選單項目
function fnBeforePaste() {
  event.returnValue = false;
}

// 從剪貼簿取出文字並寫入目標區
function fnPaste() {
  event.returnValue = false;
  oTarget.innerText = window.clipboardData.getData("Text");
}
</SCRIPT>

<BODY onload="fnLoad()">
<DIV ID="oSource" onbeforecut="fnBeforeCut()" oncut="fnCut()">選中並剪切此文本</DIV>
<DIV ID="oTarget" onbeforepaste="fnBeforePaste()" onpaste="fnPaste()">將文本粘貼在這裡</DIV>
<SPAN>setData 結果:</SPAN>
<INPUT ID="tText" TYPE="text" READONLY VALUE="" SIZE="6">
</BODY>

關鍵細節

整個範例的樞紐在於兩個事件:oncut 與 onpaste。前者在使用者觸發剪切時攔截預設行為,改由我們自己把選取內容塞進剪貼簿;後者則攔截貼上,改以 getData 取回資料寫入目標元素。而 onbeforecut 與 onbeforepaste 的作用是「把選單項目由灰色變成可點擊」——透過 event.returnValue = false 取消預設的禁用結果,否則右鍵選單中的剪切、貼上都會是無法使用的狀態。

今日觀點

需要注意的是,clipboardData 屬於 IE 專屬實作,且基於安全理由限制重重。現代開發應改用非同步剪貼簿 API(navigator.clipboard.writeText/readText),它跨瀏覽器支援、以 Promise 為基礎,並透過使用者授權與安全上下文(HTTPS)來把關。上面這段程式仍有閱讀價值,因為它清楚示範了「事件攔截 + 手動資料流」的思維,而這套思維在自訂編輯器與富文字功能中依然通用。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved