# React에 통합하기

- Human documentation: [https://docs.univer.ai/ko-KR/guides/pdfs/getting-started/integrations/react](https://docs.univer.ai/ko-KR/guides/pdfs/getting-started/integrations/react)

- Agent Markdown: [https://docs.univer.ai/ko-KR/guides/pdfs/getting-started/integrations/react.md](https://docs.univer.ai/ko-KR/guides/pdfs/getting-started/integrations/react.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.0.4`

- Source: [pdfs/getting-started/integrations/react.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/getting-started/integrations/react.ko-KR.mdx)

---

먼저 [설치 및 기본 사용법](https://docs.univer.ai/ko-KR/guides/pdfs/getting-started/installation.md)을 읽으세요. 아래 예제는 React를 사용해 높이가 명시된 컨테이너에 Univer Pdfs를 마운트합니다.

### 통합 단계

1. `useEffect`에서 Univer를 초기화합니다.
2. `useEffect cleanup`에서 Univer를 해제합니다.

### 예제 코드

마운트마다 별도의 자식 컨테이너를 사용합니다. 바깥 React 정리가 끝난 뒤 마이크로태스크에서 인스턴스를 폐기하여 React 커밋 중 중첩 루트의 동기 언마운트를 방지합니다.

```tsx
import { useEffect, useRef } from 'react'
import { UniverLicensePlugin } from '@univerjs-pro/license'
import { UniverPdfsPlugin } from '@univerjs-pro/pdfs'
import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'
import PdfsUIkoKR from '@univerjs-pro/pdfs-ui/locale/ko-KR'
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'
import { FUniver } from '@univerjs/core/facade'
import DesignkoKR from '@univerjs/design/locale/ko-KR'
import { UniverUIPlugin } from '@univerjs/ui'
import UIkoKR from '@univerjs/ui/locale/ko-KR'

import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs-pro/pdfs-ui/lib/index.css'

import '@univerjs-pro/pdfs/facade'

export 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.KO_KR,
      locales: {
        [LocaleType.KO_KR]: mergeLocales(
          DesignkoKR,
          UIkoKR,
          PdfsUIkoKR,
        ),
      },
    })

    univer.registerPlugin(UniverLicensePlugin, {
      license: 'your license.txt',
    })
    univer.registerPlugin(UniverUIPlugin, { container })
    univer.registerPlugin(UniverPdfsPlugin)
    univer.registerPlugin(UniverPdfsUIPlugin)

    const univerAPI = FUniver.newAPI(univer)
    univerAPI.createPdf({ name: 'Untitled PDF' })

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

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