# 自定义字体列表

- Human documentation: [https://docs.univer.ai/zh-CN/guides/boards/ui/fonts](https://docs.univer.ai/zh-CN/guides/boards/ui/fonts)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/boards/ui/fonts.md](https://docs.univer.ai/zh-CN/guides/boards/ui/fonts.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [boards/ui/fonts.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/boards/ui/fonts.zh-CN.mdx)

---

Boards 把字体选择保存在 Board 数据中。Board 主题可以通过 `fontScheme.heading` 和 `fontScheme.body` 定义标题与正文字体；单个文本元素可以通过 `textStyle` 覆盖字体族、字号和强调样式。

## 设置文本元素字体

```ts
const board = univerAPI.getActiveBoard()
if (!board) throw new Error('No active Board')

const label = board.insertText({
  text: 'Milestone',
  left: 120,
  top: 96,
  width: 240,
  height: 64,
  textStyle: {
    fontFamily: 'Inter',
    fontSize: 18,
    bold: true,
  },
})
if (!label) throw new Error('Cannot insert label')
```

Board 文本编辑使用通用 Docs UI 文本管线，它是 `@univerjs-pro/boards-ui` 的技术依赖。请在渲染 Board 前由主页面加载 Web 字体；否则浏览器会替换为可用字体，文本尺寸也可能变化。

通用应用主题请参阅[主题与暗黑模式](https://docs.univer.ai/zh-CN/guides/fundamentals/ui/themes.md)。Board 文档主题仍保存在 Board 快照中。