Intégrer dans Next.js

Cette page commence à partir de l'installation et l'utilisation de base. L'exemple ci-dessous monte Univer Bases dans un conteneur avec une hauteur explicite, en utilisant le routeur d'application Next.js App.

Chargez l'éditeur depuis un composant client avec ssr: false1. Une directive use client seule ne désactive pas le prérendement; voir la Docs Next.js .

Placez le contenu de la licence client à la place de YOUR_CLIENT_LICENSE. Passez le texte de la licence plutôt qu'un chemin de fichier. Consultez Configuration de la licence pour plus de détails.

Étapes d’intégration

  1. Initialisez Univer dans useEffect.
  2. Libérez Univer dans useEffect cleanup.

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 montage crée son propre conteneur enfant. L’instance est libérée dans une microtâche après le nettoyage du composant React englobant. Les racines React imbriquées ne sont donc pas démontées de façon synchrone pendant un commit.

TSX
'use client'import { useEffect, useRef } from 'react'import { UniverBasesPlugin } from '@univerjs-pro/bases'import { UniverBasesUIPlugin } from '@univerjs-pro/bases-ui'import BasesUIfrFR from '@univerjs-pro/bases-ui/locale/fr-FR'import BasesfrFR from '@univerjs-pro/bases/locale/fr-FR'import { UniverProFormulaEnginePlugin } from '@univerjs-pro/engine-formula'import { UniverLicensePlugin } from '@univerjs-pro/license'import { LocaleType, mergeLocales, Univer, UniverInstanceType } from '@univerjs/core'import DesignfrFR from '@univerjs/design/locale/fr-FR'import { UniverRenderEnginePlugin } from '@univerjs/engine-render'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/bases-ui/lib/index.css'export default 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,          BasesfrFR,          BasesUIfrFR,        ),      },    })    univer.registerPlugin(UniverLicensePlugin, {      license: 'YOUR_CLIENT_LICENSE',    })    univer.registerPlugin(UniverRenderEnginePlugin)    univer.registerPlugin(UniverUIPlugin, { container })    univer.registerPlugin(UniverProFormulaEnginePlugin)    univer.registerPlugin(UniverBasesPlugin)    univer.registerPlugin(UniverBasesUIPlugin)    univer.createUnit(UniverInstanceType.UNIVER_BASE, {})    return () => {      queueMicrotask(() => {        univer.dispose()        container.remove()      })    }  }, [])  return <div ref={containerRef} style={{ height: 600 }} />}
TSX
'use client'import dynamic from 'next/dynamic'const UniverEditor = dynamic(() => import('./univer-editor'), { ssr: false })export default function Page() {  return <UniverEditor />}

Footnotes

  1. Le rendu côté serveur (SSR) exécute le code de rendu avant le chargement de la page dans le navigateur, sans window ni DOM. Un Client Component peut aussi être prérendu : il faut désactiver le SSR pour le composant de l’éditeur. ↩

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.