# 在 Next.js 中整合

- Human documentation: [https://docs.univer.ai/zh-TW/guides/sheets/getting-started/integrations/nextjs](https://docs.univer.ai/zh-TW/guides/sheets/getting-started/integrations/nextjs)

- Agent Markdown: [https://docs.univer.ai/zh-TW/guides/sheets/getting-started/integrations/nextjs.md](https://docs.univer.ai/zh-TW/guides/sheets/getting-started/integrations/nextjs.md)

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.2.0`

- Source: [sheets/getting-started/integrations/nextjs.zh-TW.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/sheets/getting-started/integrations/nextjs.zh-TW.mdx)

---

請先閱讀[安裝與基本使用](https://docs.univer.ai/zh-TW/guides/sheets/getting-started/installation.md)。以下範例透過 Next.js App Router 將 Univer Sheets 掛載到具有明確高度的容器中。

在用戶端元件中透過 `ssr: false`[^ssr] 動態載入編輯器。只宣告 `use client` 不會關閉預先渲染。 [Next.js](https://nextjs.org/docs/app/guides/lazy-loading#skipping-ssr).

### 整合步驟

1. 在 `useEffect` 中初始化 Univer
2. 在 `useEffect` 的清理函式中銷毀 Univer

### 範例程式碼

每次掛載使用獨立的子容器，並在外層 React 清理完成後的微任務中銷毀實例，避免在 React 提交期間同步卸載巢狀 React root。

```tsx title="univer-editor.tsx"
'use client'

import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
import UniverPresetSheetsCoreZhTW from '@univerjs/preset-sheets-core/locales/zh-TW'
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
import { useEffect, useRef } from 'react'

import '@univerjs/preset-sheets-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.ZH_TW,
      locales: {
        [LocaleType.ZH_TW]: mergeLocales(
          UniverPresetSheetsCoreZhTW,
        ),
      },
      presets: [
        UniverSheetsCorePreset({
          container,
        }),
      ],
    })

    univerAPI.createWorkbook({})

    return () => {
      queueMicrotask(() => {
        univer.dispose()
        container.remove()
      })
    }
  }, [])

  return (
    <div ref={containerRef} style={{ height: 600 }} />
  )
}
```

```tsx title="page.tsx"
'use client'

import dynamic from 'next/dynamic'

const UniverEditor = dynamic(() => import('./univer-editor'), { ssr: false })

export default function Page() {
  return <UniverEditor />
}
```

[^ssr]: 伺服器端渲染（SSR）會在瀏覽器載入頁面前執行渲染程式，此時沒有瀏覽器的 `window` 與 DOM。Client Component 仍可能被預先渲染，因此需單獨停用編輯器元件的 SSR。