Navigator: clipboard 屬性

Baseline 已廣泛支援

此功能已經成熟，並可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 3 月⁩起，它已在各瀏覽器中推出。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

Navigator 介面的只讀屬性 clipboard 返回一個 Clipboard 物件，用於讀取和寫入剪貼簿的內容。

這是 Clipboard API 的入口點，可用於在 Web 應用程式中實現剪下、複製和貼上功能。

值

用於訪問系統剪貼簿的 Clipboard 物件。

以下程式碼使用 navigator.clipboard 訪問系統剪貼簿，以讀取剪貼簿中的文字內容。

navigator.clipboard
  .readText()
  .then(
    (clipText) => (document.querySelector(".clip-text").innerText = clipText),
  );

此程式碼片段會將類名為 "clip-text" 的元素的內容替換為剪貼簿中的文字內容。也許這段程式碼正在被一個顯示當前剪貼簿內容的瀏覽器擴充套件程式使用，並自動定期更新或在特定事件觸發時更新。

如果剪貼簿為空或不包含文字，則會清除 "clip-text" 元素的內容。這是因為 readText() 在剪貼簿為空或不包含文字時會返回一個空字串。

規範
Clipboard API 和事件 # navigator-clipboard

此頁面最後修改於 2024年10月16日，由 MDN 貢獻者修改。