Intégrer dans Next.js
Lisez d'abord l'installation et l'utilisation de base. L'exemple ci-dessous utilise le routeur d'application Next.js et monte Univer Docs dans un conteneur à hauteur explicite.
Chargez l'éditeur à partir d'un élément client avec ssr: false1. La directive use client ne désactive pas à elle seule le prérendement, alors suivez le guide Next.js pour sauter SSR.
Étapes d’intégration
- Initialisez Univer dans
useEffect. - Détruisez-le dans la fonction de nettoyage retournée par
useEffect.
Configuration des préréglages
UniverDocsCorePreset
containerstring | HTMLElementValeur par défaut:'app'Élément DOM de montage de l’éditeur ou son identifiant.
Exemple de code
Chaque montage crée son propre conteneur enfant. L'élimination se déroule dans une microtâche après le nettoyage React environnant, de sorte qu'une racine React imbriquée n'est jamais démontée synchronement lors d'un commit React.
'use client'import { UniverDocsCorePreset } from '@univerjs/preset-docs-core'import UniverPresetDocsCoreEnUS from '@univerjs/preset-docs-core/locales/en-US'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'import { useEffect, useRef } from 'react'import '@univerjs/preset-docs-core/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, univerAPI } = createUniver({ locale: LocaleType.EN_US, locales: { [LocaleType.EN_US]: mergeLocales( UniverPresetDocsCoreEnUS, ), }, presets: [ UniverDocsCorePreset({ container, }), ], }) univerAPI.createDocument({}) 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 ?