# Facade API

> 瞭解如何在 Univer Bases 應用程式中使用 Facade API。

- Human documentation: [https://docs.univer.ai/zh-TW/guides/bases/getting-started/facade](https://docs.univer.ai/zh-TW/guides/bases/getting-started/facade)

- Agent Markdown: [https://docs.univer.ai/zh-TW/guides/bases/getting-started/facade.md](https://docs.univer.ai/zh-TW/guides/bases/getting-started/facade.md)

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.2.0`

- Source: [bases/getting-started/facade.zh-TW.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/getting-started/facade.zh-TW.mdx)

---

Facade API 在 Bases 模型之上提供應用程式導向的介面層，可用於建立 Base、資料表、欄位、記錄、檢視、篩選、排序、群組與選取範圍，以及操作 UI 導覽等常見工作。

> [!WARNING: 注意]
> Base 模型變更是同步的；UI 啟用方法會回傳 Promise，需要使用 `await`。

## 啟用 Facade 進入點

請為應用程式使用的每項 Bases 功能匯入對應的 Facade 進入點：

```ts
import { FUniver } from '@univerjs/core/facade'
import '@univerjs-pro/bases/facade'
import '@univerjs-pro/bases-ui/facade'
```

註冊 Univer 執行個體與必要的外掛程式後，再建立 API 物件：

```ts
const univerAPI = FUniver.newAPI(univer)
```

## 後續閱讀

Facade 擴充功能現已啟用。接下來可以閱讀：

* [通用 API](https://docs.univer.ai/zh-TW/guides/bases/features/core/general-api.md)：瞭解共用的命令、事件、復原與重做、UI 擴充、網路、列舉和工具方法。
* [Univer Bases API](https://docs.univer.ai/zh-TW/guides/bases/features/core/bases-api.md)：瞭解如何建立和讀取 Base，以及操作資料模型和 UI 狀態。
* [Bases facade 參考文件](https://docs.univer.ai/zh-TW/reference/facade/base.md)：查看完整方法說明。