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
- Initialiser Univer dans
onMounted. - Jetez-le en
onBeforeUnmount.
Configuration des préréglages
UniverDocsCorePreset
containerstring | 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/presetsavec pnpm, vous pouvez également avoir besoin d'installerreactetreact-domsé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
- Initialiser Univer dans
mounted. - 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 ?