# Facade API

> 了解如何在 Univer Bases 应用中使用 Facade API。

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

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

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [bases/getting-started/facade.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/getting-started/facade.zh-CN.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-CN/guides/bases/features/core/general-api.md)：了解共享的命令、事件、撤销与重做、UI 扩展、网络、枚举和工具方法。
* [Univer Bases API](https://docs.univer.ai/zh-CN/guides/bases/features/core/bases-api.md)：了解如何创建和读取 Base，以及操作数据模型和 UI 状态。
* [Bases facade 参考](https://docs.univer.ai/zh-CN/reference/facade/bases.md)：查看完整方法说明。