# 複製貼上

- Human documentation: [https://docs.univer.ai/zh-TW/guides/sheets/features/core/clipboard](https://docs.univer.ai/zh-TW/guides/sheets/features/core/clipboard)

- Agent Markdown: [https://docs.univer.ai/zh-TW/guides/sheets/features/core/clipboard.md](https://docs.univer.ai/zh-TW/guides/sheets/features/core/clipboard.md)

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.2.0`

- Source: [sheets/features/core/clipboard.zh-TW.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/sheets/features/core/clipboard.zh-TW.mdx)

---

> [!WARNING: Firefox 相容性說明]
> Firefox 尚不支援 `clipboard.readText()`，詳見 [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard/readText)，在這種情況下，Univer 只能從貼上事件中獲取剪貼簿內容，因此只能支援快捷鍵貼上。

Univer 使用 Clipboard API 實現了複製貼上功能，支援從外部應用複製貼上到 Univer、從 Univer 複製到外部應用以及 Univer Sheets 之間的複製貼上。

> [!WARNING: 安全上下文要求]
> 受限於現代瀏覽器的安全策略，Clipboard API 僅可在安全上下文（如 HTTPS 協議）中使用。

Univer 支援的複製貼上操作有：

* 從外部應用複製貼上到 Univer
* 從 Univer 複製到外部應用
* Univer Sheets 之間的複製貼上

並支援如下選擇性貼上能力：

* 僅貼上值
* 僅貼上格式
* 僅貼上列寬
* 僅貼上邊框之外的內容
* 僅貼上公式

桌面版 Ribbon 在復原、重做旁提供**貼上**下拉選單，包含一般貼上、僅貼上值、格式、欄寬及框線以外的內容。其選單 ID 為 `sheet.menu.paste`；右鍵選單中的**選擇性貼上**使用 `sheet.menu.paste-special`。編輯圖形文字時，Ribbon 的貼上下拉選單會隱藏。

## 禁用複製

Univer 允許開發者透過 **權限控制（permission control）** 來禁止使用者在工作簿或特定的工作表中使用複製功能。

例如，以下程式碼將禁止使用者在當前工作簿中使用複製功能：

```typescript
const workbookPermission = univerAPI.getActiveWorkbook()?.getWorkbookPermission()
const WorkbookCopyPermission = univerAPI.Enum.WorkbookPermissionPoint.CopyContent

if (workbookPermission) {
  workbookPermission.setPoint(WorkbookCopyPermission, false)
}
```

關於權限控制的更多資訊，請參閱[權限控制](https://docs.univer.ai/zh-TW/guides/sheets/features/core/permission.md)文件。