自定义字体列表

Slides 文本编辑器的字体下拉框使用 Univer 共享字体列表。请在 UniverUIPlugin 上配置这项应用级列表。

配置字体选项

TypeScript
import { UniverUIPlugin } from '@univerjs/ui'univer.registerPlugin(UniverUIPlugin, {  container: 'app',  customFontFamily: {    list: [      {        value: 'Inter',        label: 'Inter',        category: 'sans-serif',      },      {        value: 'Noto Serif',        label: 'Noto Serif',        category: 'serif',      },    ],    override: false,  },})

value 会作为文本片段的字体族写入;label 是显示文本或国际化键;category 可用于对选项分组。

请通过 @font-face 或样式表自行加载浏览器字体。向列表添加名称不会下载字体文件;字体族不可用时,浏览器会使用回退字体。

Facade API

加载 UI Facade 后,可以用 addFonts 在运行时追加字体选项:

TypeScript
univerAPI.addFonts([  {    value: 'Inter',    label: 'Inter',    category: 'sans-serif',  },])

此方法会立即更新共享下拉框,但不会加载对应的字体二进制。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.