剪贴板 API 和事件

dictionary ClipboardEventInit : EventInit {
    DataTransfer? clipboardData = null;
};

[Exposed=Window]
interface ClipboardEvent : Event {
    constructor(DOMString type, optional ClipboardEventInit eventInitDict = {});
    readonly attribute DataTransfer? clipboardData;
};

var pasteEvent = new ClipboardEvent('paste');
pasteEvent.clipboardData.items.add('My string', 'text/plain');
document.dispatchEvent(pasteEvent);

5.2.1.1. 触发 clipboardchange 事件

要在给定Document document时触发 clipboardchange 事件：

1. 如果 document 没有粘性激活，并且 document 没有 从剪贴板读取的权限，则返回。

2. 令 global 为 document 的相关全局对象。

3. 如果 document 具有系统焦点：

   1. 令 types 为强制数据类型列表，这些类型可用于系统 剪贴板。

   2. 令 changeId 为在给定 document 的情况下运行生成 changeId 的结果。

   3. 令 eventInit 为一个新的 ClipboardChangeEventInit 字典，其 types 成员设置为 types，并且其 changeId 成员设置为 changeId。

   4. 在 global 上触发一个事件，其名称为 clipboardchange， 使用 ClipboardChangeEvent， 并带有 eventInit。

4. 如果 document 没有系统焦点：

   1. 将 document 的 clipboardchange 待处理标志设置为 true。

5.2.1.2. 文档聚焦步骤

当Document document获得系统焦点时：

1. 如果 document 的clipboardchange 待处理标志为 true：

   1. 将 document 的clipboardchange 待处理标志 设置为 false。

   2. 令 types 为强制数据类型列表，这些类型可用于系统 剪贴板。

   3. 令 changeId 为在给定 document 的情况下运行生成 changeId的结果。

   4. 令 eventInit 为一个新的 ClipboardChangeEventInit 字典，其 types 成员设置为 types，并且其 changeId 成员设置为 changeId。

   5. 令 global 为 document 的相关全局对象。

   6. 触发一个事件，其名称为 clipboardchange， 目标为 global，使用 ClipboardChangeEvent， 并带有 eventInit。

dictionary ClipboardChangeEventInit : EventInit {
  sequence<DOMString> types = [];
  bigint changeId = 0;
};

[Exposed=Window]
interface ClipboardChangeEvent : Event {
  constructor(DOMString type, optional ClipboardChangeEventInit eventInitDict = {});
  readonly attribute FrozenArray<DOMString> types;
  readonly attribute bigint changeId;
};

5.2.1.3. ClipboardChangeEvent 构造步骤

ClipboardChangeEvent(type, eventInitDict) 的构造步骤如下：

1. 将this.types设为eventInitDict["types"]的克隆。

2. 将this.changeId设为eventInitDict["changeId"]。

要为一个 Document document 生成 changeId：

1. 令 globalChangeId 为一个用户代理特定的唯一标识符，表示系统剪贴板的当前 状态。每当系统 剪贴板被修改时，此标识符都会改变，并且会在用户代理重启时重置。

2. 令 storageKey 为在给定 document 的为非存储用途获取 存储键的相关设置对象的情况下运行结果。

3. 令 storageKeyBytes 为 storageKey 的某种用户代理特定的二进制表示。

4. 令 hashedValue 为将加密哈希函数（例如 SHA-256）应用于 globalChangeId（作为字节）和 storageKeyBytes 的拼接结果所得的结果。

5. 返回一个从 hashedValue 派生出的 128 位整数（例如，通过取哈希输出的前 128 位）。

// 对于具有多个窗口的应用，跟踪已处理的变更 ID 以避免重复
const processedChangeIds = new Set();

// 监听剪贴板变化
navigator.clipboard.addEventListener('clipboardchange', (e) => {
  // 使用 changeId 对多个窗口之间的事件去重
  if (processedChangeIds.has(e.changeId)) {
    return; // 此变更已经被处理过
  }
  processedChangeIds.add(e.changeId);

  // 检查剪贴板上有哪些可用的数据类型
  const hasText = e.types.includes('text/plain');
  const hasHTML = e.types.includes('text/html');
  const hasImage = e.types.includes('image/png');

  // 根据可用格式更新 UI
  document.getElementById('paste-text-btn').disabled = !hasText;
  document.getElementById('paste-html-btn').disabled = !hasHTML;
  document.getElementById('paste-image-btn').disabled = !hasImage;

  // 对于远程桌面应用，每次变更只将剪贴板同步到远程一次
  if (hasText || hasHTML || hasImage) {
    syncClipboardToRemote(e.changeId);
  }
});

// 或者，也可以使用 onclipboardchange 属性
// navigator.clipboard.onclipboardchange = (e) => { ... };

// 覆盖复制到剪贴板的内容。
document.addEventListener('copy', function(e) {
    // e.clipboardData 最初为空，但我们可以将其设置为
    // 我们希望复制到剪贴板的数据。
    e.clipboardData.setData('text/plain', 'Hello, world!');
    e.clipboardData.setData('text/html', '<b>Hello, world!</b>');

    // 这是防止将当前文档选择写入剪贴板所必需的。
    e.preventDefault();
});

// 覆盖复制到剪贴板的内容。
document.addEventListener('cut', function(e) {
    // e.clipboardData 最初为空，但我们可以将其设置为
    // 我们希望作为剪切操作的一部分复制到剪贴板的数据。
    // 写入我们希望复制到剪贴板的数据。
    e.clipboardData.setData('text/plain', 'Hello, world!');
    e.clipboardData.setData('text/html', '<b>Hello, world!</b>');

    // 由于我们将取消剪切操作，因此需要手动
    // 更新文档以删除当前选定的文本。
    deleteCurrentDocumentSelection();

    // 这是防止将文档选择写入剪贴板所必需的。
    e.preventDefault();
});

// 覆盖粘贴到剪贴板的内容。
document.addEventListener('paste', function(e) {
    // e.clipboardData 包含即将粘贴的数据。
    if (e.clipboardData.types.indexOf('text/html') > -1) {
    var oldData = e.clipboardData.getData('text/html');
    var newData = '<b>Ha Ha!</b> ' + oldData;

    // 由于我们正在取消粘贴操作，因此需要手动
    // 将数据粘贴到文档中。
    pasteClipboardData(newData);

    // 这是防止默认粘贴操作所必需的。
    e.preventDefault();
    }
});

partial interface Navigator {
    [SecureContext, SameObject] readonly attribute Clipboard clipboard;
};

typedef Promise<(DOMString or Blob)> ClipboardItemData;

[SecureContext, Exposed=Window]
interface ClipboardItem {
  constructor(record<DOMString, ClipboardItemData> items,
              optional ClipboardItemOptions options = {});

  readonly attribute PresentationStyle presentationStyle;
  readonly attribute FrozenArray<DOMString> types;

  Promise<Blob> getType(DOMString type);

  static boolean supports(DOMString type);
};

enum PresentationStyle { "unspecified", "inline", "attachment" };

dictionary ClipboardItemOptions {
  PresentationStyle presentationStyle = "unspecified";
};

typedef sequence<ClipboardItem> ClipboardItems;

[SecureContext, Exposed=Window]
interface Clipboard : EventTarget {
  Promise<ClipboardItems> read(optional ClipboardUnsanitizedFormats formats = {});
  Promise<DOMString> readText();
  Promise<undefined> write(ClipboardItems data);
  Promise<undefined> writeText(DOMString data);
};

dictionary ClipboardUnsanitizedFormats {
  sequence<DOMString> unsanitized;
};

// clipboard.read() 仅返回带有类型元数据的 ClipboardItem。
// 此时不会读取任何 OS 剪贴板数据。
const items = await navigator.clipboard.read();

// OS 剪贴板读取会在这里惰性发生，即调用 getType() 时。
const textBlob = await items[0].getType("text/plain");
const text = await (new Response(textBlob)).text();

navigator.clipboard.readText().then(function(data) {
    console.log("你的字符串: ", data);
});

var data = [new ClipboardItem({ "text/plain": Promise.resolve(new Blob(["文本数据"], { type: "text/plain" })) })];
navigator.clipboard.write(data).then(function() {
    console.log("已成功复制到剪贴板！");
}, function() {
    console.error("无法写入剪贴板。 :-(");
});

await navigator.clipboard.writeText("你好，伙伴！");

脚本可访问剪贴板 标志设置如下：

1. 如果操作是复制或剪切，并且脚本线程允许修改剪贴板，则

   1. 设置操作的脚本可访问剪贴板标志

2. 如果操作是粘贴，并且脚本线程允许从剪贴板读取，则

   1. 设置操作的脚本可访问剪贴板标志。

复制操作包括以下步骤：

1. 如果script-triggered 标志已设置，则

   1. 如果script-may-access-clipboard 标志未设置，则

      1. 从复制操作返回 false，终止本算法

2. 触发名为 copy 的剪贴板事件

3. 如果该事件未被取消，则

   1. 将选中的内容（如果有）复制到剪贴板。实现 应当 在网页内容被选中时，创建 text/html 和 text/plain 的剪贴板格式。

   2. 触发名为 clipboardchange 的剪贴板事件

4. 否则，如果该事件被取消，则

   1. 调用写内容到剪贴板算法，传入 DataTransferItemList 列表 items，clear-was-called 标志 和 types-to-clear 列表。

5. 从复制操作返回 true

剪切操作包括以下步骤：

1. 如果 script-triggered 标志已设置，则

   1. 如果 script-may-access-clipboard 标志未设置，则

      1. 从剪切操作返回 false，并终止该算法

2. 触发一个名为 cut 的剪贴板事件

3. 如果事件未被取消，则

   1. 如果在一个 可编辑上下文 中存在选择区域且允许剪切，则

      1. 将选中的内容（如果有）复制到剪贴板。实现 应当 在网页内容被选中时，创建 text/html 和 text/plain 的剪贴板格式。

      2. 从文档中移除选择的内容，并收起选区。

      3. 触发一个名为 clipboardchange 的剪贴板事件

      4. 排队任务以触发应因该修改而触发的任何事件，详情见 § 5.3 与其他脚本和事件的集成。

   2. 否则，如果没有选区或上下文不可编辑，则

      1. 返回 false

4. 否则，如果事件被取消，则

   1. 调用 写内容到剪贴板 算法， 传递 DataTransferItemList 列表 items， clear-was-called 标志 和 types-to-clear 列表。

   2. 触发一个名为 clipboardchange 的剪贴板事件

5. 从剪切操作返回 true

粘贴操作包括以下步骤：

1. 如果设置了脚本触发标志，则

   1. 如果未设置脚本可访问剪贴板，则

      1. 从粘贴操作返回 false，终止此算法

2. 触发一个名为 paste 的剪贴板事件

3. 如果事件未被取消，则

   1. 如果在启用了粘贴的可编辑上下文中存在选区或光标，则

      1. 将剪贴板上找到的最合适的内容（如有）插入到上下文中。

      2. 将由于修改而应触发的任何事件排队，有关详细信息，请参阅§ 5.3 与其他脚本和事件的集成。

   2. 否则

      1. 返回 false

4. 否则，如果事件被取消

   1. 返回 false

5. 从操作返回 true

9.1.1. 检查剪贴板读取权限

1. 如果相关全局对象的此对象具有瞬时激活，则令 hasGesture 为 true，否则为 false。

2. 如果 hasGesture 为 true，则：

   1. 如果当前脚本是由于用户与用户代理或操作系统创建的“粘贴”元素交互而运行的，则返回 true。

3. 返回 false。

9.2.1. 检查剪贴板写入权限

1. 令 writeWithoutGesture 为 { name: "clipboard-write", allowWithoutGesture: true } 权限的权限状态。

2. 如果 writeWithoutGesture 为 granted， 则返回 true。

3. 令hasGesture为 true ，如果相关全局对象的this 具有瞬时激活；否则为 false。

4. 如果 hasGesture 为 true，则：

   1. 如果当前脚本是由于用户与用户代理或操作系统创建的“剪切”或“复制”元素交互而运行的，则令 systemCopy 为 true。

   2. 如果 systemCopy 为 true，则返回 true。

   3. 返回请求使用权限 { name: "clipboard-write", allowWithoutGesture: false } 权限的结果。

      注意：用户代理可以选择请求一个更强的权限，该权限将隐式更新此权限。

5. 返回请求使用权限 { name: "clipboard-write", allowWithoutGesture: true } 权限的结果。

将内容写入剪贴板

输入

items，一个要写入的项目的 DataTransferItemList 列表

clear-was-called，一个布尔值

types-to-clear，一个列表

输出

无

1. 如果 items 列表不为空，则

   1. 清除剪贴板

   2. 对于列表中的每个部分，

      1. 如果数据类型是 text/plain，则

         1. 确保编码根据操作系统和区域设置约定是正确的

         2. 根据平台约定规范化行尾

         3. 使用适当的操作系统剪贴板格式描述将文本放置在剪贴板上

      2. 否则，如果数据类型是强制数据类型列表中列出的类型，则

         1. 使用适当的操作系统剪贴板格式描述将部分放置在剪贴板上

      3. 否则

         1. 这留给实现...

            将事情留给实现是不好的。这里应该发生什么？

            注意：由于操作系统剪贴板实现的限制，脚本不应假定自定义格式可用于系统上的其他应用程序。例如，在 Microsoft Windows 中可以注册的自定义剪贴板格式数量有限。虽然可以为 setData() 的 type 参数使用任何字符串，但强烈建议坚持使用强制数据类型。

2. 否则，items 列表为空。按照以下步骤确定是否清除剪贴板：

   1. 如果项目列表为空且 clear-was-called 标志为 true，则

      1. 如果 types-to-clear 列表为空，则

         1. 清除剪贴板

      2. 否则

         1. 以操作系统和实现特定的方式从剪贴板中删除 types-to-clear 列表中的类型

            “从剪贴板中删除特定类型”功能存在风险。它似乎并不那么重要，而且尚不清楚它是否可以在相关平台上轻松实现。

将 blobs 和 option 写入剪贴板

输入

items，一个 sequence<Blob>

presentationStyle，一个剪贴板项的呈现样式

输出

无

1. 令 webCustomFormats 为一个 sequence<Blob>。

2. 对于 items 中的每个 item：

   1. 令 formatString 为在给定 item 的 type 的情况下，运行OS 特定知名格式所得的结果。

   2. 如果 formatString 为空，则执行以下步骤：

      1. 令 webCustomFormatString 为 item 的 type。

      2. 令 webCustomFormat 为一个空的 type。

      3. 如果 webCustomFormatString 以 `"web "` 前缀开始，则 移除 `"web "` 前缀，并将剩余字符串存储在 webMimeTypeString 中。

      4. 令 webMimeType 为在给定 webMimeTypeString 的情况下解析 MIME 类型所得的结果。

      5. 如果 webMimeType 为 failure，则中止所有步骤。

      6. 令 webCustomFormat 的 type 的 essence 等于 webMimeType。

      7. 将 item 的 type 设置为 webCustomFormat。

      8. 将 webCustomFormat 追加到 webCustomFormats。

   3. 令 payload 为对 item 的底层字节 序列进行 UTF-8 解码所得的结果。

   4. 使用 formatString 作为原生剪贴板格式，将 payload 和 presentationStyle 插入到系统 剪贴板中。

   某些 OS 包含多个剪贴板（例如 Linux 的 "primary"、"secondary"、"selection"）。定义数据要写入其中哪一个。

3. 在给定 webCustomFormats 的情况下写入 Web 自定义格式。

特定于操作系统的已知格式

输入

mimeType，一个 type

输出

wellKnownFormat，一种平台特定的字符串类型。在 Mac 上是 NSPasteboardType，在 Windows 上是 LPCWSTR，在 Linux 上是 const char*。

Windows 参见 https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats 和 https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN Mac 参见 https://developer.apple.com/documentation/appkit/nspasteboardtype

1. 令 wellKnownFormat 为空字符串。

2. 如果 mimeType 的 essence 是 "text/plain"，则

   在 Windows 上，遵循如下所述的约定：

   1. 将 CF_UNICODETEXT 赋给 wellKnownFormat。

   在 MacOS 上，遵循如下所述的约定：

   1. 将 NSPasteboardTypeString 赋给 wellKnownFormat。

   在 Linux、ChromeOS 和 Android 上，遵循如下所述的约定：

   1. 将 "text/plain" 赋给 wellKnownFormat。

3. 否则，如果 mimeType 的 essence 是 "text/html"，则

   在 Windows 上，遵循如下所述的约定：

   1. 将 CF_HTML 赋给 wellKnownFormat。

   在 MacOS 上，遵循如下所述的约定：

   1. 将 NSPasteboardTypeHTML 赋给 wellKnownFormat。

   在 Linux、ChromeOS 和 Android 上，遵循如下所述的约定：

   1. 将 "text/html" 赋给 wellKnownFormat。

4. 否则，如果 mimeType 的 essence 是 "image/png"，则

   在 Windows 上，遵循如下所述的约定：

   1. 将 "PNG" 赋给 wellKnownFormat。

   在 MacOS 上，遵循如下所述的约定：

   1. 将 NSPasteboardTypePNG 赋给 wellKnownFormat。

   在 Linux、ChromeOS 和 Android 上，遵循如下所述的约定：

   1. 将 "image/png" 赋给 wellKnownFormat。

5. 否则，如果 mimeType 的 essence 是 "image/svg+xml"，则

   在 Windows 上，遵循如下所述的约定：

   1. 将 CFSTR_MIME_SVG_XML 赋给 wellKnownFormat。

   在 MacOS 上，遵循如下所述的约定：

   1. 将 UTTypeSVG 赋给 wellKnownFormat。

   在 Linux、ChromeOS 和 Android 上，遵循如下所述的约定：

   1. 将 "image/svg+xml" 赋给 wellKnownFormat。

6. 返回 wellKnownFormat。

从特定于操作系统的格式获取已知 MIME 类型

输入

osFormatName，一个平台特定的字符串类型。在 Mac 上是 NSPasteboardType，在 Windows 上是 LPCWSTR，在 Linux 上是 const char*。

输出

mimeType，一个 MIME 类型

对于 Windows，请参阅 https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats 和 https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN 对于 Mac，请参阅 https://developer.apple.com/documentation/appkit/nspasteboardtype

在 Windows 上，遵循以下描述的约定：

1. 如果 osFormatName 是 "UnicodeText"，则将 mimeTypeString 设置为 "text/plain"。

2. 否则，如果 osFormatName 是 "HTML Format"，则将 mimeTypeString 设置为 "text/html"。

3. 否则，如果 osFormatName 是 "PNG"，则将 mimeTypeString 设置为 "image/png"。

4. 否则，如果 osFormatName 是 CFSTR_MIME_SVG_XML，则将 mimeTypeString 设置为 "image/svg+xml"。

在 MacOS 上，遵循以下描述的约定：

1. 如果 osFormatName 是 NSPasteboardTypeString，则将 mimeTypeString 设置为 "text/plain"。

2. 否则，如果 osFormatName 是 NSPasteboardTypeHTML，则将 mimeTypeString 设置为 "text/html"。

3. 否则，如果 osFormatName 是 NSPasteboardTypePNG，则将 mimeTypeString 设置为 "image/png"。

4. 否则，如果 osFormatName 是 UTTypeSVG，则将 mimeTypeString 设置为 "image/svg+xml"。

在 Linux、ChromeOS 和 Android 上，遵循以下描述的约定：

1. 如果 osFormatName 是 "text/plain"，则将 mimeTypeString 设置为 "text/plain"。

2. 否则，如果 osFormatName 是 "text/html"，则将 mimeTypeString 设置为 "text/html"。

3. 否则，如果 osFormatName 是 "image/png"，则将 mimeTypeString 设置为 "image/png"。

4. 否则，如果 osFormatName 是 "image/svg+xml"，则将 mimeTypeString 设置为 "image/svg+xml"。

1. 令 mimeType 为解析 MIME 类型的结果，给定 mimeTypeString。

2. 返回 mimeType。

读取 Web 自定义格式

输入

item，一个剪贴板项

1. 令 webCustomFormatMap 为OS 特定 自定义映射名称。

2. 从系统剪贴板读取 webCustomFormatMap。

   更详细地指定 读取 webCustomFormatMap 的过程。

3. 如果 webCustomFormatMap 为空，则返回 item。

4. 令 webCustomFormatMapString 为从 webCustomFormatMap 反序列化得到的 JSON 字符串。

   注： 需要一个 JSON 读取器来反序列化 来自 webCustomFormatMap 的内容。

5. 对于 webCustomFormatMapString 中的每个（key，value）：

   1. 令 mimeType 为在给定 key 的情况下解析 MIME 类型所得的结果。

   2. 如果 mimeType 为 failure，则继续循环。

   3. 令 representation 为一个新的表示。

   4. 将 representation 的MIME 类型设置为 mimeType。

   5. 将 representation 的isCustom 标志设置为 true。

   6. 将 representation 的数据设置为一个 新的 promise。

      注： 此 Web 自定义格式的 OS 剪贴板数据不会被获取，直到作者在所得的 getType() 对象上调用 ClipboardItem 为止。

   7. 将 representation 追加到 item 的表示 列表。

写入 Web 自定义格式

输入

items，一个 sequence<Blob>

1. 令 idx 为初始化为 0 的数字。

2. 令 webCustomFormatMap 为OS 特定 自定义映射名称。

3. 令 webCustomFormatMapString 为空 JSON 字符串。

4. 对于 items 中的每个 item：

   1. 令 webCustomFormat 为OS 特定 自定义名称。

   2. 令 webCustomFormatIdx 为将 idx 追加到 webCustomFormat 后所得的结果。

   3. 使用 JSON 序列化器，将 item 的 type 作为键、将 webCustomFormatIdx 作为值插入 webCustomFormatMapString。

      注： 需要一个 JSON 写入器来 将内容序列化到 webCustomFormatMapString 中。

   4. 使用 webCustomFormatIdx 作为格式，将 item 插入系统剪贴板。

   5. 递增 idx。

   6. 如果 idx 大于 100，则跳出此循环。

5. 使用 webCustomFormatMap 作为格式，将 webCustomFormatMapString 插入系统剪贴板。

特定于操作系统的自定义映射名称

输出

webCustomFormatMap，一个字符串

在 Windows 上，遵循以下描述的约定：

1. 将 "Web Custom Format Map" 分配给 webCustomFormatMap。

2. 返回 webCustomFormatMap。

在 MacOS 上，遵循以下描述的约定：

1. 将 "org.w3.web-custom-format.map" 分配给 webCustomFormatMap。

2. 返回 webCustomFormatMap。

在 Linux、ChromeOS 和 Android 上，遵循以下描述的约定：

1. 将 "application/web;type=\"custom/formatmap\"" 分配给 webCustomFormatMap。

2. 返回 webCustomFormatMap。

特定于操作系统的自定义名称

输出

webCustomFormat，一个字符串

在 Windows 上，遵循以下描述的约定：

1. 将 "Web Custom Format" 分配给 webCustomFormat。

2. 返回 webCustomFormat。

在 MacOS 上，遵循以下描述的约定：

1. 将 "org.w3.web-custom-format.type-" 分配给 webCustomFormat。

2. 返回 webCustomFormat。

在 Linux、ChromeOS 和 Android 上，遵循以下描述的约定：

1. 将 "application/web;type="custom/format" 分配给 webCustomFormat。

2. 返回 webCustomFormat。

触发剪贴板事件

输入

e，要触发的 ClipboardEvent

输出

无

1. 令 clear-was-called 为 false

2. 令 types-to-clear 为一个空列表

3. 令 clipboard-event-data 为一个新的 DataTransfer 对象，其 items 列表为空。

4. 令 clipboard-entry 为当前剪贴板内容的序列号，如果操作系统剪贴板不支持序列号，则为 null

5. 如果事件由用户代理生成，则令 trusted 为 true，否则为 false

6. 按如下方式设置 target：

   1. 如果上下文是可编辑的，则

      1. 将 target 设置为包含文档顺序中可见选区或光标开头的元素，如果没有可见选区或光标，则设置为body 元素。

   2. 否则，如果上下文不可编辑，则

      1. 将 target 设置为焦点节点，如果没有节点具有焦点，则设置为body 元素。

7. 按如下方式处理事件：

   1. 如果 e 是 "paste"，则

      1. 将 clipboard-event-data 的内部拖放数据存储模式标志设置为只读。

      2. 如果 trusted 为 true，或者实现配置为授予脚本生成的事件对操作系统剪贴板的读取权限

         1. 对于操作系统剪贴板上的每个 clipboard-part，执行以下步骤：

            1. 如果 clipboard-part 包含纯文本，则

               1. 确保文本使用脚本引擎内部使用的编码

               2. 令 new-data 为一个新的 DataTransferItem， 其拖放数据项种类设置为 string，拖放数据项类型字符串设置为 text/plain。

               3. 将 new-data 的数据设置为纯文本。

               4. 将 new-data 添加到 clipboard-event-data 的 items 中

            2. 如果 clipboard-part 表示文件引用，则对于每个文件引用：

               1. 确定引用文件的 MIME 类型

               2. 令 new-data 为一个新的 DataTransferItem， 其拖放数据项种类设置为 file，拖放数据项类型字符串设置为相应的 MIME 类型，如果文件类型未知，则设置为 application/octet-stream。

               3. 将 new-data 的数据设置为文件引用数据。

               4. 将 new-data 添加到 clipboard-event-data 的 items 中

            3. 如果 clipboard-part 包含 HTML 或 XHTML 格式的文本（根据操作系统描述此类剪贴板格式的约定），则

               1. 如果实现支持粘贴 HTML，则实现必须通过使用 clipboard-part 和 clipboard-event-data 调用处理 html 粘贴事件来处理标记。

            4. 如果 clipboard-part 包含其他受支持的二进制或基于文本的格式的数据（请参阅强制数据类型），则

               1. 确定数据的 MIME 类型

               2. 令 new-data 为一个新的 DataTransferItem， 其拖放数据项种类设置为 file，拖放数据项类型字符串设置为相应的 MIME 类型

               3. 将 new-data 的数据设置为二进制或基于文本的数据。

               4. 将 new-data 添加到 clipboard-event-data 的 items 中

      3. 更新 clipboard-event-data 的 files 属性以匹配 clipboard-event-data 的 items 中的条目。

      4. 更新 clipboard-event-data 的 types 属性以匹配 clipboard-event-data 的 items 中的条目。

   2. 如果 e 是 "copy" 或 "cut"，则

      1. 将关联的 DataTransfer 对象的内部拖放数据存储模式标志设置为读/写

8. 将 e 的 clipboardData 设置为 clipboard-event-data。

9. 将 e 的 isTrusted 设置为 trusted。

10. 将 e 的 composed 设置为 true。

11. 在 target 处分派事件 e，该事件冒泡且可取消，并使用 ClipboardEvent 接口。

    事件分派期间数据访问的实现要求在[HTML]中定义。下面给出了一些额外的剪贴板事件特定处理规则：

    为什么在这里？为什么不在 HTML 规范中？

    1. 如果脚本调用 clearData() 或 clear() 并且 DataTransfer 对象的内部拖放数据存储模式标志是读/写，则

       1. 将 clear-was-called 标志设置为 true。如果给定了参数，则将该参数添加到 types-to-clear 列表中。

    2. 如果脚本调用 setData() 或修改项目并且 clear-was-called 标志为 true，则

       1. 如果 types-to-clear 列表为空，则

          1. 将 clear-was-called 标志设置为 false，则

       2. 否则，如果 setData() 的 type 参数或新项目的拖放数据项类型字符串在 types-to-clear 列表中找到，则

          1. 将其从列表中删除。如果列表现在为空，则将 clear-was-called 标志设置为 false。

    3. 如果脚本调用 getData() 或访问 DataTransferItemList 中的项目并且设置了 clipboard-entry，则

       1. 检查剪贴板数据的序列号是否与 clipboard-entry 匹配。如果剪贴板不再包含相同的条目，则将 DataTransferItemList 对象的内部拖放数据存储模式设置为受保护。

    警告！监听粘贴事件的恶意脚本可能会设置一个无限循环，以便读取用户将来放置在剪贴板上的内容。在无法使用剪贴板序列号的平台上，应实施其他限制。

处理 HTML 粘贴事件

输入

clipboard-part，要处理的剪贴板部分

clipboard-event-data，此事件的 DataTransfer 对象

输出

无

1. 令 new-data 为一个新的 DataTransferItem， 其拖放数据项种类设置为纯 Unicode 字符串，拖放数据项类型字符串相应地设置为 text/html 或 application/xhtml+xml。

2. 从 clipboard-part 中提取标记，并使用相关的解析器构建 DOM 树。

3. 如果标记的源 URL 已知，则使用源 URL 作为基础 URL 解析 HREF 和 SRC 属性中的所有相对 URL，并将相应的属性设置为解析后的绝对 URL。

4. 如果标记的来源是本地应用程序，则检查是否存在对本地文件和/或操作系统剪贴板内容的其他部分的引用。如果找到此类引用，则对子部分的引用必须使用 cid: URL 方案 [RFC2392] 替换为内容 ID 引用。为此，请按照以下步骤处理每个引用本地文件或剪贴板部分的属性：

   这些步骤是必要的吗？我们是否了解支持具有内部引用的多个部分的本机（平台）剪贴板实现？

   此功能存在风险，因为尚不清楚是否需要它，并且难以进行跨平台测试。

   1. 如果 clipboard-event-data 的 items 已经包含对引用的文件或剪贴板部分的条目，则

      1. 将 itemNumber 设置为现有条目的索引。

   2. 否则，

      1. 令 new-file-data 为一个新的 DataTransferItem， 其拖放数据项种类设置为 "file"，拖放数据项类型字符串设置为文件或剪贴板部分的 MIME 类型（如果已知），如果文件类型未知，则设置为 application/octet-stream。

      2. 令 file-info 为一个新的 File 对象，其 name 设置为 HTML 属性内容的名称部分，lastModified 设置为引用文件的时间戳，如果条目引用剪贴板部分，则设置为 0。

      3. 将 new-file-data 的内部 File 对象设置为 file-info。

      4. 将 new-file-data 添加到 clipboard-event-data 的 items 中，并令 itemNumber 为此条目在 DataTransferItemList 中的索引。

   3. 更新引用本地文件或剪贴板部分的 DOM 属性，使其包含字符串 'cid:' 后跟 itemNumber。

5. 序列化处理后的 DOM 并使用生成的 HTML 代码更新 new-data。

6. 将 new-data 添加到 clipboard-event-data 的 items 中。