カスタムフォントリスト

Slides のテキストエディターは、フォントファミリーのドロップダウンに Univer の共有フォントリストを使います。このアプリケーションレベルのリストは UniverUIPlugin で設定します。

フォントの選択肢を設定する

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

value はテキストランのフォントファミリーとして書き込まれます。label は表示文字列または i18n キー、category は任意のグループです。

ブラウザーフォントは @font-face やスタイルシートで別途読み込んでください。リストに名前を追加してもフォントファイルはダウンロードされず、利用できない場合はブラウザーの代替フォントが使われます。

Facade API

UI Facade の読み込み後は、addFonts で実行時に選択肢を追加できます。

TypeScript
import { FontCategory } from '@univerjs/ui'univerAPI.addFonts([  {    value: 'Inter',    label: 'Inter',    category: FontCategory.SANS_SERIF,  },])

共有ドロップダウンはすぐに更新されますが、対応するフォントバイトは読み込まれません。

このガイドはいかがですか?

© 2026 DreamNum Co., Ltd.