草案
此页面不完整。

ClipboardItem() constructor of the Clipboard API creates a new ClipboardItem object which represents data to be stored or retrieved via the Clipboard API , that is clipboard.write() and clipboard.read() 分别。

注意 : Image format support varies by browser. See the browser compatibility table for the Clipboard 接口。

句法

var ClipboardItem = new ClipboardItem(ClipboardItemData);
					

参数

ClipboardItemData
对象 采用 MIME 类型 as the key and Blob as the value.

注意 : To work with text see the Clipboard.readText() and Clipboard.writeText() methods of the Clipboard 接口。

范例

The below example requests a png image using the 抓取 API , and in turn, the responses' blob() method, to create a new ClipboardItem and write it to the clipboard, using the Clipboard API .

注意 : You can only pass in one clipboard item at a time.

async function writeClipImg() {
  try {
    const imgURL = '/myimage.png';
    const data = await fetch(imgURL);
    const blob = await data.blob();
    await navigator.clipboard.write([
      new ClipboardItem({
        [blob.type]: blob
      })
    ]);
    console.log('Fetched image copied.');
  } catch(err) {
    console.error(err.name, err.message);
  }
}
					

规范

规范 状态 注释
Clipboard API and events
The definition of 'ClipboardItem' in that specification.
工作草案 初始定义。

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
ClipboardItem() 构造函数 Chrome 66 Edge ≤79 Firefox No IE No Opera Yes Safari No WebView Android 66 Chrome Android 66 Firefox Android No Opera Android Yes Safari iOS No Samsung Internet Android Yes

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

另请参阅

元数据

  • 最后修改: