Contribute to this guide

指南拖放

拖放功能允许您在编辑器内拖放文本和内容块(例如段落、表格或列表)。这使您可以选择整个块或多个块,并在其他块之前或之后移动它们。您还可以从编辑器外部拖放 HTML 和纯文本内容,并使用它来上传图像。

# 演示

下面的演示允许您将联系人从列表中拖放到编辑器中。联系人被插入到编辑器中,作为代表h-card 微格式的自定义小部件。您还可以选择和拖动编辑器内现有的内容。

联系人列表

    虚构人物年度会议

    公告

    我们很高兴地宣布,今年会议的主题是“电子墨水技术和经典童话故事”。与往年一样,活动将由 爱丽丝 +20 4345 234 235梦幻岛举办,从明天格林威治时间 8:00 开始。

    演讲者和议程

    待定。

    地点

    有关详细信息,请联系 哈克贝利·费恩 +48 1345 234 235

    住宿

    非常感谢 鲁滨逊·克鲁索 +45 2345 234 235 为年度会议的客人提供他的岛屿。


    小红帽 +45 2345 234 235

    照片:维基百科.org

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

    上述代码段的源代码可在以下位置获得:drag-drop.jsdrag-drop.html。您可以在此处找到演示中使用的编辑器的配置:build-drag-drop-source.js。处理 h-card 的自定义插件代码可在以下位置获得:hcard.js

    # 通过拖放上传文件

    CKBox 文件管理器 在您的 CKEditor 5 集成中启用时,您可以使用拖放机制上传文件和图像。您可以在CKBox 演示中测试此解决方案。

    # 内容块的拖放

    默认情况下,拖放插件完全支持在编辑器内拖动内容块(例如段落、表格或列表)。这使您可以选择整个块或多个块,并在其他块之前或之后移动它们。

    拖放功能包括

    • 选择文本、元素、多个块,并将它们移动到其他位置。
    • 将块放置在其他块内,例如表格、块引用等。
    • 气球块编辑器 中,盲文点面板图标 拖动指示器 现在用作拖动句柄。

    # 经典编辑器演示

    选择一个或多个块,并将它们拖动到文档中的其他位置。您可以在其他块(例如表格和块引用)内放置块。

    香浓托斯卡纳聚会

    欢迎信

    尊敬的来宾:

    我们很高兴欢迎您参加年度香浓托斯卡纳聚会。我们希望您能享受节目以及在 Bilancino 酒店 的住宿。

    Bilancino Hotel
    Bilancino 酒店

    请查看以下活动完整时间表。

    7 月 14 日,星期六
    上午 9:30 - 上午 11:30

    美式咖啡与煮咖啡 - “了解您的咖啡”: 

    • Giulia Orlanda
    • Stefano Garau
    • Giuseppe Russo
    下午 1:00 - 下午 3:00

    托斯卡纳地区的美味佳肴 - 现场烹饪

    加入最新鲜的食材 
    Rita Fresco

    下午 5:00 - 下午 8:00 一览托斯卡纳葡萄园 - 品酒 
    Frederico Riscoli

    年度香浓托斯卡纳聚会总是充满了美食发现。您可以在该地区顶级酒店之一的密集的一日游中尽情享受托斯卡纳风味。所有课程都由热衷于自己专业的顶级厨师主导。我建议您将此日期记在您的日历中!

    Angelina Calvino,美食记者

    请在 Bilancino 酒店 的接待处 至少提前半小时 抵达,以确保注册过程顺利进行。

    我们期待在活动中欢迎您的到来。

    Victoria Valc signature

    Victoria Valc

    活动经理

    Bilancino 酒店

    # 气球块编辑器演示

    在气球块编辑器中,您也可以使用拖动句柄拖动内容块。选择或聚焦块,然后使用盲文点面板图标 拖动指示器 拖动块。

    香浓托斯卡纳聚会

    欢迎信

    尊敬的来宾:

    我们很高兴欢迎您参加年度香浓托斯卡纳聚会。我们希望您能享受节目以及在 Bilancino 酒店 的住宿。

    Bilancino Hotel
    Bilancino 酒店

    请查看以下活动完整时间表。

    7 月 14 日,星期六
    上午 9:30 - 上午 11:30

    美式咖啡与煮咖啡 - “了解您的咖啡”: 

    • Giulia Orlanda
    • Stefano Garau
    • Giuseppe Russo
    下午 1:00 - 下午 3:00

    托斯卡纳地区的美味佳肴 - 现场烹饪

    加入最新鲜的食材 
    Rita Fresco

    下午 5:00 - 下午 8:00 一览托斯卡纳葡萄园 - 品酒 
    Frederico Riscoli

    年度香浓托斯卡纳聚会总是充满了美食发现。您可以在该地区顶级酒店之一的密集的一日游中尽情享受托斯卡纳风味。所有课程都由热衷于自己专业的顶级厨师主导。我建议您将此日期记在您的日历中!

    Angelina Calvino,美食记者

    请在 Bilancino 酒店 的接待处 至少提前半小时 抵达,以确保注册过程顺利进行。

    我们期待在活动中欢迎您的到来。

    Victoria Valc signature

    Victoria Valc

    活动经理

    Bilancino 酒店

    # 安装

    ⚠️ 新的导入路径

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

    安装编辑器 后,将功能添加到插件列表和工具栏配置中

    import { ClassicEditor, Clipboard } from 'ckeditor5';
    
    ClassicEditor
        .create( document.querySelector( '#editor' ), {
            plugins: [ Clipboard, Bold, /* ... */ ],
        })
        .then( /* ... */ )
        .catch( /* ... */ );
    

    DragDrop 插件将与剪贴板插件一起激活。

    # 样式化拖放

    拖放目标线的颜色由 CSS 变量 (--ck-clipboard-drop-target-color) 管理。您可以使用以下代码段更改线的颜色

    :root {
        --ck-clipboard-drop-target-color: green;
    }
    
    • CKEditor 5 支持从文件系统中拖放图像,这得益于 图像上传 功能。

    # 贡献

    该功能的源代码在 GitHub 上的 https://github.com/ckeditor/ckeditor5/tree/master/packages/ckeditor5-clipboard 中提供。