Liste de polices personnalisée

Structure d’une police

Dans Univer, l'interface IFontConfig décrit une police :

PropriétéTypeDescription
valuestringL'identificateur unique de la police, généralement la première entrée dans une famille de polices CSS.
labelstringClé de traduction. Si la clé n'a pas de traduction lorsque l'instance Univer est créée, la valeur fournie est affichée inchangée.
categoryFontCategoryCatégorie de police, qui regroupe les polices dans l'interface utilisateur. Facultatif.

Univer n'empêche pas les utilisateurs de sélectionner une police qui n'est pas installée. Si le client n'a pas la police, le navigateur remplace sa police par défaut.

Utiliser des polices personnalisées

Le paramètre customFontFamily sur UniverUIPlugin contrôle les options que le menu déroulant offre.

UniverUIPlugin

  • container
    string | HTMLElement
    L'élément à monter ou l'ID DOM de cet élément.
  • customFontFamily
    IFontConfig[] | object
    Ajoute ces polices à la liste déroulante.
    • list
      IFontConfig[]
      Ajoute ces polices à la liste déroulante.
      • value
        string
        Nom de la police utilisé en CSS.
      • label
        string
        Nom affiché ou clé de traduction.
      • category
        FontCategory
        Catégorie parmi sans-serif, serif, monospace, display ou handwriting.
    • override
      booleanValeur par défaut: false
      Remplace les polices intégrées par la liste fournie.
TypeScript
import { FontCategory, UniverUIPlugin } from '@univerjs/ui'univer.registerPlugin(UniverUIPlugin, {  container: 'app',  customFontFamily: {    list: [      {        value: 'PingFang SC',        label: '苹方(简)',        category: FontCategory.SANS_SERIF,      },      {        value: 'Helvetica Neue',        label: 'Helvetica Neue',        category: FontCategory.SANS_SERIF,      },    ],    // Whether to override the default font list, defaults to false    override: true,  },})

Facade API

Les polices n'ont pas à être connues au démarrage. Le Facade API peut ajouter de nouvelles polices à l'exécution, ce qui est nécessaire lorsque les ressources de police chargent asynchronement.

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

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.