Intégrer dans React

Lisez d'abord l'installation et l'utilisation de base. Le composant React ci-dessous monte Univer Pdfs dans un conteneur dont la hauteur est définie explicitement.

Étapes d’intégration

  1. Créez l'instance Univer dans useEffect.
  2. Libérez l’instance dans la fonction de nettoyage de useEffect.

Configuration des plugins

UniverUIPlugin

  • container
    string | HTMLElement
    Élément DOM de montage de l’éditeur ou son identifiant.

UniverLicensePlugin

  • license
    string
    Contenu du fichier de licence côté client.

Exemple de code

Chaque support reçoit son propre conteneur enfant. L'instance est éliminée dans une microtâche, après le nettoyage React environnant a terminé, de sorte que les racines de React imbriquées ne sont jamais démontées synchronement lors d'un commit React.

TSX
import { useEffect, useRef } from 'react'import { UniverLicensePlugin } from '@univerjs-pro/license'import { UniverPdfsPlugin } from '@univerjs-pro/pdfs'import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'import PdfsUIfrFR from '@univerjs-pro/pdfs-ui/locale/fr-FR'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import { FUniver } from '@univerjs/core/facade'import DesignfrFR from '@univerjs/design/locale/fr-FR'import { UniverUIPlugin } from '@univerjs/ui'import UIfrFR from '@univerjs/ui/locale/fr-FR'import '@univerjs/design/lib/index.css'import '@univerjs/ui/lib/index.css'import '@univerjs-pro/pdfs-ui/lib/index.css'import '@univerjs-pro/pdfs/facade'export function UniverEditor() {  const containerRef = useRef<HTMLDivElement>(null)  useEffect(() => {    const host = containerRef.current    if (!host) return    const container = document.createElement('div')    container.style.height = '100%'    host.append(container)    const univer = new Univer({      locale: LocaleType.FR_FR,      locales: {        [LocaleType.FR_FR]: mergeLocales(          DesignfrFR,          UIfrFR,          PdfsUIfrFR,        ),      },    })    univer.registerPlugin(UniverLicensePlugin, {      license: 'your license.txt',    })    univer.registerPlugin(UniverUIPlugin, { container })    univer.registerPlugin(UniverPdfsPlugin)    univer.registerPlugin(UniverPdfsUIPlugin)    const univerAPI = FUniver.newAPI(univer)    univerAPI.createPdf({ name: 'Untitled PDF' })    return () => {      queueMicrotask(() => {        univer.dispose()        container.remove()      })    }  }, [])  return <div ref={containerRef} style={{ height: 600 }} />}

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.