Intégrer dans Vue

Pour utiliser les composants Vue comme composants personnalisés, consultez composants personnalisés.

Avant d'ajouter Univer à un projet Vue, lisez l'installation et l'utilisation de base et assurez-vous de comprendre comment fonctionnent les composants Vue ainsi que les crochets de cycle de vie.

Vue 3.x

Remarques avant l’intégration

  • N'enroulez pas les instances Univer et FUnivers dans un proxy. Les procurations peuvent causer des erreurs imprévisibles et des problèmes de performance.

Étapes d’intégration

  1. Initialiser Univer dans onMounted.
  2. Jetez-le en onBeforeUnmount.

Configuration des préréglages

UniverDocsCorePreset

  • container
    string | HTMLElementValeur par défaut: 'app'
    Élément DOM de montage de l’éditeur ou son identifiant.

Exemple

Vue
<script lang="ts" setup>import type { Univer } from '@univerjs/presets'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 { onBeforeUnmount, onMounted, ref } from 'vue'import '@univerjs/preset-docs-core/lib/index.css'const container = ref<HTMLElement | null>(null)let univerInstance: Univer | null = nullonMounted(() => {  const { univer, univerAPI } = createUniver({    locale: LocaleType.EN_US,    locales: {      [LocaleType.EN_US]: mergeLocales(        UniverPresetDocsCoreEnUS,      ),    },    presets: [      UniverDocsCorePreset({        container: container.value as HTMLElement,      }),    ],  })  univerAPI.createDocument({})  univerInstance = univer})onBeforeUnmount(() => {  univerInstance?.dispose()  univerInstance = null})</script><template>  <div ref="container" style="height: 600px" /></template>

Vue 2.x

Remarques avant l’intégration

  • Lorsque vous installez @univerjs/presets avec pnpm, vous pouvez également avoir besoin d'installer react et react-dom séparément.
  • Si un avertissement "ResizeObserver loop limit surpassed" apparaît pendant le développement, il peut être ignoré ou supprimé avec l'extrait ci-dessous:
TypeScript
if (process.env.NODE_ENV === 'development') {  const _ResizeObserver = window.ResizeObserver  function debounce(fn, delay) {    let timer = null    return function () {      if (timer) {        clearTimeout(timer)      }      timer = setTimeout(() => {        fn.apply(this, arguments)      }, delay)    }  }  window.ResizeObserver = class ResizeObserver extends _ResizeObserver {    constructor(callback) {      callback = debounce(callback, 50)      super(callback)    }  }}

Étapes d’intégration

  1. Initialiser Univer dans mounted.
  2. Jetez-le en beforeDestroy.

Exemple

Vue
<script>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 '@univerjs/preset-docs-core/lib/index.css'export default {  mounted() {    const { univer, univerAPI } = createUniver({      locale: LocaleType.EN_US,      locales: {        [LocaleType.EN_US]: mergeLocales(          UniverPresetDocsCoreEnUS,        ),      },      presets: [        UniverDocsCorePreset({          container: this.$refs.container,        }),      ],    })    univerAPI.createDocument({})    this.univerInstance = univer  },  beforeDestroy() {    this.univerInstance?.dispose()    this.univerInstance = null  },}</script><template>  <div ref="container" style="height: 600px" /></template>

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.