剪贴板 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);

// 覆盖复制到剪贴板的内容。
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;
};

const items = await navigator.clipboard.read();
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. 如果设置了脚本触发标志，则

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

      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. 如果设置了脚本触发标志，则

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

      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，否则为 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 列表中的类型

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

将 blob 和选项写入剪贴板

输入

items，一个 序列<Blob>

presentationStyle，一个剪贴板项目的表示样式

输出

无

1. 令 webCustomFormats 为一个 序列<Blob>。

2. 对于 items 中的每个 item：

   1. 令 formatString 为运行特定于操作系统的已知格式的结果，给定 item 的 type。

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

      1. 令 webCustomFormatString 为 item 的 type。

      2. 令 webCustomFormat 为一个空的 type。

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

      4. 令 webMimeType 为解析 MIME 类型的结果，给定 webMimeTypeString。

      5. 如果 webMimeType 失败，则中止所有步骤。

      6. 令 webCustomFormat 的 type 的 本质等于 webMimeType。

      7. 将 item 的 type 设置为 webCustomFormat。

      8. 将 webCustomFormat 附加到 webCustomFormats。

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

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

   某些操作系统包含多个剪贴板（例如 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 的本质是 "text/plain"，则

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

   1. 将 CF_UNICODETEXT 分配给 wellKnownFormat。

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

   1. 将 NSPasteboardTypeString 分配给 wellKnownFormat。

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

   1. 将 "text/plain" 分配给 wellKnownFormat。

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

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

   1. 将 CF_HTML 分配给 wellKnownFormat。

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

   1. 将 NSPasteboardTypeHTML 分配给 wellKnownFormat。

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

   1. 将 "text/html" 分配给 wellKnownFormat。

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

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

   1. 将 "PNG" 分配给 wellKnownFormat。

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

   1. 将 NSPasteboardTypePNG 分配给 wellKnownFormat。

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

   1. 将 "image/png" 分配给 wellKnownFormat。

5. Else, if mimeType’s essence is "image/svg+xml", then

   在 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 为特定于操作系统的自定义映射名称。

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

   更详细地说明读取 webCustomFormatMap 的过程。

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

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

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

5. 对于 webCustomFormatMapString 中的每个 (key, value)：

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

   2. 如果 mimeType 解析失败，则继续循环。

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

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

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

   6. 给定 value，从系统剪贴板读取 webCustomFormat。

   7. 如果读取成功，则将 representation 的数据设置为从系统剪贴板获取的数据，否则继续循环。

   8. 将 representation 附加到 item 的表示列表。

写入 Web 自定义格式

输入

items，一个 序列<Blob>

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

2. 令 webCustomFormatMap 为特定于操作系统的自定义映射名称。

3. 令 webCustomFormatMapString 为一个空的 JSON 字符串。

4. 对于 items 中的每个 item：

   1. 令 webCustomFormat 为特定于操作系统的自定义名称。

   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 中。