# Next.js への統合

- Human documentation: [https://docs.univer.ai/ja-JP/guides/boards/getting-started/integrations/nextjs](https://docs.univer.ai/ja-JP/guides/boards/getting-started/integrations/nextjs)

- Agent Markdown: [https://docs.univer.ai/ja-JP/guides/boards/getting-started/integrations/nextjs.md](https://docs.univer.ai/ja-JP/guides/boards/getting-started/integrations/nextjs.md)

- Requested language: `ja-JP`

- Content language: `ja-JP`

- Documentation version: `1.2.0`

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

---

まず[インストールと基本的な使い方](https://docs.univer.ai/ja-JP/guides/boards/getting-started/installation.md)を参照してください。以下は Next.js App Router を使い、高さを明示したコンテナーに Univer Boards をマウントする例です。

Client Component で `ssr: false`[^ssr] を指定して動的に読み込みます。`use client` だけでは事前レンダリングは無効になりません。 [Next.js](https://nextjs.org/docs/app/guides/lazy-loading#skipping-ssr).

`YOUR_CLIENT_LICENSE` をクライアントライセンスの内容に置き換えてください。ファイルパスではありません。 [ライセンス設定](https://docs.univer.ai/ja-JP/server/license.md).

### 統合手順

1. `useEffect` で Univer を初期化します。
2. `useEffect cleanup` で Univer を破棄します。

### サンプルコード

マウントごとに専用の子コンテナを使用します。外側の React のクリーンアップ後にマイクロタスクで破棄し、コミット中のネストした React root の同期アンマウントを避けます。

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

import { useEffect, useRef } from 'react'
import { UniverBoardsPlugin } from '@univerjs-pro/boards'
import { UniverBoardsUIPlugin } from '@univerjs-pro/boards-ui'
import BoardsUIjaJP from '@univerjs-pro/boards-ui/locale/ja-JP'
import { UniverInkUIPlugin } from '@univerjs-pro/ink-ui'
import InkUIjaJP from '@univerjs-pro/ink-ui/locale/ja-JP'
import { UniverLicensePlugin } from '@univerjs-pro/license'
import { LocaleType, mergeLocales, Univer, UniverInstanceType } from '@univerjs/core'
import DesignjaJP from '@univerjs/design/locale/ja-JP'
import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIjaJP from '@univerjs/docs-ui/locale/ja-JP'
import { UniverDrawingPlugin } from '@univerjs/drawing'
import { UniverDrawingUIPlugin } from '@univerjs/drawing-ui'
import DrawingUIjaJP from '@univerjs/drawing-ui/locale/ja-JP'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
import { UniverUIPlugin } from '@univerjs/ui'
import UIjaJP from '@univerjs/ui/locale/ja-JP'

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.JA_JP,
      locales: {
        [LocaleType.JA_JP]: mergeLocales(
          DesignjaJP,
          UIjaJP,
          DocsUIjaJP,
          DrawingUIjaJP,
          InkUIjaJP,
          BoardsUIjaJP,
        ),
      },
    })

    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 }} />
}
```

```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 を個別に無効化します。