Intégrer dans Next.js
Lisez d'abord l'installation et l'utilisation de base. Cet exemple monte les panneaux Univer d'un composant client Routeur App Next.js dans un conteneur à hauteur explicite.
Chargez l'éditeur à partir d'un élément client avec ssr: false1. L'ajout de use client ne désactive pas seul la prérendue. Voir sauter SSR dans Next.js.
Remplacer YOUR_CLIENT_LICENSE par le contenu de la licence client, pas par un chemin de fichier. Voir Configuration de la licence.
Étapes d’intégration
- Initialisez Univer dans
useEffect. - Libérez Univer dans
useEffect cleanup.
Configuration des plugins
UniverUIPlugin
containerstring | HTMLElementÉlément DOM de montage de l’éditeur ou son identifiant.
UniverLicensePlugin
licensestringContenu 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.
'use client'import { useEffect, useRef } from 'react'import { UniverBoardsPlugin } from '@univerjs-pro/boards'import { UniverBoardsUIPlugin } from '@univerjs-pro/boards-ui'import BoardsUIfrFR from '@univerjs-pro/boards-ui/locale/fr-FR'import { UniverInkUIPlugin } from '@univerjs-pro/ink-ui'import InkUIfrFR from '@univerjs-pro/ink-ui/locale/fr-FR'import { UniverLicensePlugin } from '@univerjs-pro/license'import { LocaleType, mergeLocales, Univer, UniverInstanceType } from '@univerjs/core'import DesignfrFR from '@univerjs/design/locale/fr-FR'import { UniverDocsPlugin } from '@univerjs/docs'import { UniverDocsUIPlugin } from '@univerjs/docs-ui'import DocsUIfrFR from '@univerjs/docs-ui/locale/fr-FR'import { UniverDrawingPlugin } from '@univerjs/drawing'import { UniverDrawingUIPlugin } from '@univerjs/drawing-ui'import DrawingUIfrFR from '@univerjs/drawing-ui/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/docs-ui/lib/index.css'import '@univerjs/drawing-ui/lib/index.css'import '@univerjs-pro/ink-ui/lib/index.css'import '@univerjs-pro/boards-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, DocsUIfrFR, DrawingUIfrFR, InkUIfrFR, BoardsUIfrFR, ), }, }) univer.registerPlugin(UniverLicensePlugin, { license: 'YOUR_CLIENT_LICENSE', }) univer.registerPlugin(UniverRenderEnginePlugin) univer.registerPlugin(UniverUIPlugin, { container }) univer.registerPlugin(UniverDocsPlugin) univer.registerPlugin(UniverDocsUIPlugin) univer.registerPlugin(UniverDrawingPlugin) univer.registerPlugin(UniverDrawingUIPlugin) univer.registerPlugin(UniverInkUIPlugin) univer.registerPlugin(UniverBoardsPlugin) univer.registerPlugin(UniverBoardsUIPlugin) univer.createUnit(UniverInstanceType.UNIVER_BOARD, {}) return () => { queueMicrotask(() => { univer.dispose() container.remove() }) } }, []) return <div ref={containerRef} style={{ height: 600 }} />}'use client'import dynamic from 'next/dynamic'const UniverEditor = dynamic(() => import('./univer-editor'), { ssr: false })export default function Page() { return <UniverEditor />}Footnotes
-
Le rendu côté serveur (SSR) exécute le code de rendu avant le chargement de la page dans le navigateur, sans
windowni 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 ?