---
title: "剪贴板和文件"
description: "剪贴板和文件扩展负责处理粘贴或拖入编辑器的内容，包括文件以及从 Microsoft Word、Excel 和 Google Docs 复制的内容。"
canonical_url: "https://tiptap.zhcndoc.com/editor/extensions/clipboard-and-files"
---

# 剪贴板和文件

剪贴板和文件扩展负责处理粘贴或拖入编辑器的内容，包括文件以及从 Microsoft Word、Excel 和 Google Docs 复制的内容。

## 使用场景

- **图片和其他文件。** File Handler 会在用户拖放或粘贴文件时调用你的代码，例如将文件插入为图片。
- **来自办公应用的内容。** Paste Handler 会清理从 Microsoft Excel、Word 和 Google Docs 粘贴的内容，并移除源内容中的格式残留。

## 工作原理

- **文件上传由你负责。** File Handler 的 `onPaste` 和 `onDrop` 回调会接收文件。它不会显示或上传文件；你需要插入节点并将文件上传到自己的服务器。`allowedMimeTypes` 可限制接受的文件类型。
- **Paste Handler 无需配置。** 将它添加到编辑器后，它会转换粘贴的 HTML。如果转换失败，则会使用原始 HTML。
- **Paste Handler 需要 Team 计划。** 它来自 `@tiptap-pro/extension-paste-handler` 软件包。
- **需要手动添加。** 这两个扩展都不包含在 [StarterKit](https://tiptap.zhcndoc.com/editor/extensions/functionality/starterkit.md) 中。

## 相关内容

- [媒体和嵌入内容](https://tiptap.zhcndoc.com/editor/extensions/media.md)介绍用于显示已上传图片的 Image 节点。
- [写作辅助](https://tiptap.zhcndoc.com/editor/extensions/writing-helpers.md)介绍可在写作过程中提供帮助的扩展。
