# 權限

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

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

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.2.0`

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

---

Slides 權限透過命令更新，可以套用於簡報、單張投影片或單一元素。子層級編輯權限不能覆寫唯讀的父層級。

## 簡報權限

```ts
import { UnitAction } from '@univerjs/protocol'

const presentation = univerAPI.getActivePresentation()

if (!presentation) {
  throw new Error('No active presentation')
}

const permission = presentation.getPermission()

await permission.setPoint(UnitAction.Export, false)
await permission.setPoint(UnitAction.Print, true)

console.log(permission.getPoint(UnitAction.Print))
```

簡報層級支援 Edit、Copy、Print、Export 和 Comment。`setReadOnly()` 會關閉整個簡報的編輯權限，`setEditable()` 會重新啟用編輯。

## 投影片與元素權限

```ts
const slide = presentation.getSlideByIndex(0)
const element = slide?.getElements()[0]

if (slide && element) {
  await slide.getPermission().setEditable(false)
  await slide.getElementPermission(element.getId()).setEditable(true)

  console.log(slide.getElementPermission(element.getId()).canEdit())
}
```

最終 `canEdit()` 會同時套用簡報、投影片和元素的權限上限。權限需要隨快照持久化時，請保持投影片與元素 ID 穩定。
