开发文档
快速开始

快速开始

Umo-Editor 是一个基于 Vue3 的文档编辑器。 您可以访问https://demo.umodoc.com/editor,体验和测试 Umo-Editor 的部分功能。

安装

使用 NPM 安装

npm install --save @umoteam/editor
⚠️

注意:自 v3.0 版本开始,Umo Editor 取消了对 UMD 版本的支持。

使用

以下使用方式任选一种即可:

全局安装

main.js
import { createApp } from 'vue';
import { useUmoEditor } from '@umoteam/editor';
 
const app = createApp(App);
app.use(useUmoEditor, {
  // 配置项
  // ...
});
app.mount('#app');

直接引入

以下组合式 API 和选项式 API 的 JS 示例任选一种使用。

component.vue
<template>
  <umo-editor v-bind="options" />
  <!-- 或者 -->
  <!-- 
  <umo-editor 
    :editor-key="options.editorKey" 
    ... 
  /> -->
</template>
 
// 使用组合式 API
<script setup>
  import { ref } from 'vue'
  import { UmoEditor } from '@umoteam/editor';
 
  const options = ref({
    // 配置项
    // ...
  });
</script>
 
// 或使用选项式 API
<script>
  import { UmoEditor } from '@umoteam/editor';
 
  export default {
    components: {
      UmoEditor
    },
    data() {
      return {
        options: {
          // 配置项
          // ...
        }
      }
    }
  }
</script>

在 Nuxt3 中使用

Umo Editor 暂不支持 SSR,在 Nuxt3 中 SSR 模式下,可以使用 <client-only> 组件来保证 Umo Editor 在客户端渲染和使用。

component.vue
<template>
  <client-only>
    <umo-editor v-bind="options" />
  </client-only>
</template>
 
<script setup>
  import { UmoEditor } from '@umoteam/editor';
 
  const options = ref({
    // 配置项
    // ...
  });
</script>

配置

配置项