CKEditor 生态系统文档
Search
Contribute to this guide
首页/CKEditor 5/功能

指南从 Google Docs 粘贴内容

从 Google Docs 粘贴功能允许您从 Google Docs 粘贴内容，并保留其原始结构和格式。

从 Office 粘贴插件仅保留 CKEditor 5 设置中包含的内容格式和结构。这意味着您可能需要添加缺少的功能，例如字体颜色或文本对齐。在下面的自动内容过滤部分中阅读更多内容。

# 演示

要测试从 Google Docs 粘贴，请打开示例 Google Docs 文档。然后复制其内容并将其粘贴到下面的编辑器中。

此演示提供了一组有限的功能。访问功能丰富的编辑器示例以查看更多实际操作。

# 其他功能信息

借助从 Google Docs 粘贴功能，您可以将 Google Docs 文档复制粘贴到 CKEditor 5 中，并保留基本文本样式、标题级别、链接、列表、表格和图像。

启用该插件后，它会自动检测 Google Docs 内容，并将其结构和格式转换为干净的 HTML，然后由编辑器将其转换为语义内容。

PasteFromOffice插件还允许您从 Microsoft Word 粘贴内容。查看从 Microsoft Office 粘贴内容指南以了解更多信息。

# 自动内容过滤

使用 CKEditor 5，您无需担心从 Google Docs（或任何其他可能的来源）粘贴凌乱的内容。感谢 CKEditor 5 自定义数据模型，仅加载的富文本编辑器功能专门处理的内容将被保留。

这意味着，如果您没有启用例如字体系列和字体大小功能，当您从 Google Docs 和其他来源（如其他网站）粘贴内容时，此类格式将被自动剥离。

# 安装

⚠️ 新的导入路径

从版本 42.0.0开始，我们更改了导入路径的格式。本指南使用新的、更短的格式。如果您使用的是旧版本的 CKEditor 5，请参考旧版设置中的包指南。

在安装编辑器后，将该功能添加到您的插件列表和工具栏配置中

import { ClassicEditor, PasteFromOffice } from 'ckeditor5';

ClassicEditor
    .create( document.querySelector( '#editor' ), {
        plugins: [ PasteFromOffice, /* ... */ ]
    } )
    .then( /* ... */ )
    .catch( /* ... */ );

# 对其他应用程序的支持

在当前阶段，@ckeditor/ckeditor5-paste-from-office包的重点是支持来自Microsoft Word和 Google Docs 的内容。但是，这并不意味着不支持从其他类似应用程序（如 Microsoft Excel）粘贴。

默认情况下，CKEditor 5 将支持从这些应用程序粘贴富文本内容，但是，某些样式和格式可能会丢失，具体取决于源应用程序。此外，还可能出现其他轻微错误。

您可以在此票证中找到有关与其他应用程序兼容性的更多信息。

如果您认为任何应用程序的支持需要改进，请在以下问题中添加 👍 和评论

您也可以随意为其他类似的应用程序打开一个 新的功能请求！

CKEditor 5 支持更广泛的粘贴功能，包括

  • 粘贴纯文本 – 粘贴不带格式的文本，它将继承粘贴到其中的内容的样式。
  • 从 Office 粘贴 – 从 Microsoft Word 粘贴内容并保留原始结构和格式。
  • 从 Office 粘贴增强 – 从 Office 粘贴增强是该插件的高级版本，提供了更强大的功能。
  • 从 Word 导入 – 将 Word 文件直接转换为 HTML 内容。
  • 粘贴 Markdown – 将 Markdown 格式的内容直接粘贴到编辑器中。

# 贡献

该功能的源代码可在 GitHub 上获取：https://github.com/ckeditor/ckeditor5/tree/master/packages/ckeditor5-paste-from-office。