Vue3 中引入wangeditor富文本编辑器

本文介绍了如何在Vue3项目中集成wangeditor富文本编辑器,包括npm安装、编辑器呈现、内容获取和工具栏配置等步骤,帮助开发者在网页上实现文章编辑功能。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

文章目录

  • 前言
  • 一、引入
  • 二、呈现到页面
    • 1.原型
    • 2.可视化界面
    • 3.获取内容
    • 4.配置工具栏
  • 总结


前言

我花一些时间做了一个博客, 需要一个引入编辑器, 让我好在网页上就能编辑文章.

这里中没有配置图片的上传功能, 如有需要请自行配置.


一、引入

npm下载:

npm i wangeditor -S

之后在你要引入的页面:

//这里名字无所谓, 就是待会new的时候要用这个名字new
import EWangEditor from "wangeditor";

二、呈现到页面

这一步主要在Mounted周期进行

export default {
  name: "Publish",
  setup() {
    let data = reactive({});
    onMounted(() => {
    //主要在这里
    })
  }

1.原型

先new一个wangeditor出来, 我们之后针对wangeditor的配置都要以editor.xxx的格式.
然后你一定要.create()一下, 不然是什么都没有的.

onMounted(() => {
  let editor = new EWangEditor("#editor");
  editor.create()
});

//这里的"#editor"对应要渲染为编辑器的html元素的id, 就像以前的querySelector()

2.可视化界面

去html部分建立一个div(建不建都行), 然后在里面放入一个和new wangeditor对象的时候使用相同id的div, 它将被渲染为wangeditor的样子:

<!-- id要为new wangeditor对象时候使用的id -->
<div class="publish_content">
    <div name="editor" id="editor" ref="editor"></div>
</div>

这样我们的编辑器就已经有个雏形了, 上面的工具栏可能略有不同, 这个可以手动配, 待会再说.
在这里插入图片描述
我们先要能拿到内容, 实现基本编辑功能.


3.获取内容

我们要去实现获取输入的内容, 设定内容更新频率
你在wangeditor内写入的字符会被wangeditor自动转为HTML, 我们设定的更新频率, 即它每隔多久将你的文字提取并转换为HTML一次.

onMounted(() => {
  let editor = new EWangEditor("#editor");
  editor.config.onchangeTimeout = 400; 
  /* 配置检测字符变化的最短时间间隔,默认为 200ms */

editor.config.customAlert = (err) => {  //如果检测到错误的话就打印.
  console.log(err);
};

editor.customConfig = editor.customConfig ? editor.customConfig : editor.config;
//设置customConfig属性

//设置customConfig对编辑器内文字的变化的处理方法
editor.customConfig.onchange = (html) => {  //参数html即已经转化HTML格式的文本
  data.editorContent = html;
  //在data中提前声明editorContent来存储
  console.log(html);  //实时输出更新的html格式
};

editor.create()
}

在这里插入图片描述
也可以在旁边做一个能解析html的区域, 实时显示文章成品的样子, 用新的html不断覆盖旧的html就可以.

4.配置工具栏

menuItem中每个属性对应一个工具选项, editor.config.xxx对应的数组表示这个工具的可选项, 就拿字体来说:

let menuItem = [
        "fontName",
]
editor.config.fontNames = [
        "黑体",
        "仿宋",
        "楷体",
        "标楷体",
        "华文仿宋",
        "华文楷体",
        "宋体",
        "微软雅黑",
      ];

在这里插入图片描述

那我们来做吧, 下面是onMounted中的所有代码了.

onMounted(() => {
  let editor = new EWangEditor("#editor");
  editor.config.uploadImgShowBase64 = true;
  editor.config.onchangeTimeout = 400; 
      
  editor.config.customAlert = (err) => {
    console.log(err);
  };
      
  editor.customConfig = editor.customConfig
    ? editor.customConfig
    : editor.config;

  editor.customConfig.onchange = (html) => {
    data.editorContent = html;
    console.log(html);
  };
//以下为新增
  const menuItem = [  //工具栏里有哪些工具
    "head",
    "bold",
    "fontSize",
    "fontName",
    "italic",
    "underline",
    "indent",
    "lineHeight",
    "foreColor",
    "backColor",
    "link",
    "list",
    "justify",
    "image",
    "video",
  ];

editor.config.menus = [...menuItem]; /* 应用设置好的工具栏 */
     
editor.config.colors = ["#000000", "#eeece0", "#1c487f", "#4d80bf"];  /* 文字颜色、背景色可以选择哪些颜色? */
      
editor.config.fontNames = [ /* 字体工具提供哪些字体? */ 
  "黑体",
  "仿宋",
  "楷体",
  "标楷体",
  "华文仿宋",
  "华文楷体",
  "宋体",
  "微软雅黑",
];

editor.config.height = 500;  //你可能发现这个编辑器是没法用样式调高度的?
//新增至此
editor.create();
});

总结

如果这篇文章帮到了你, 我很荣幸.

<think>好的,我现在需要在Vue3中集成和使用WangEditor富文本编辑器。让我仔细想想该怎么操作。首先,我应该查看用户提供的引用内容,看看有没有相关的指导。引用1提到在Vue2中封装成组件,引用3则是关于Vue3中使用WangEditor的。所以用户可能已经有一些线索,但需要更详细的步骤。 首先,我需要确认在Vue3中的集成步骤是否与Vue2不同。根据引用3Vue3中使用WangEditor需要安装依赖,可能使用Composition API。所以第一步是安装wangEditor包,然后创建组件。 接下来,创建组件时需要注意Vue3的setup语法和生命周期钩子的使用。比如,在onMounted中初始化编辑器,并在onBeforeUnmount时销毁实例,防止内存泄漏。同时,可能需要使用ref来引用DOM元素,这在Vue3中是通过template里的ref属性实现的。 然后,初始化编辑器的时候,要调用WangEditor的create方法,传入配置项。可能需要配置上传图片的功能,这部分用户可能会需要,所以需要示例代码。此外,获取编辑器内容的方法是通过editor.txt.html(),这应该在保存内容时使用。 还需要考虑组件间的通信,比如通过props接收初始内容,通过emit事件将内容传递给父组件。例如,在保存内容时,触发一个update:content事件,让父组件处理数据保存。 另外,样式问题也不能忽视,需要引入编辑器的CSS文件,确保样式正确显示。可能还需要调整工具栏的配置,根据项目需求自定义功能按钮。 用户可能遇到的问题包括编辑器未正确初始化、无法获取内容、图片上传配置错误等。所以,在示例代码中要详细展示这些部分,并给出注意事项,比如生命周期钩子的清理工作,避免内存泄漏。 最后,生成相关问题时要围绕Vue3WangEditor的集成,可能涉及配置优化、数据绑定、第三方库兼容性等。</think>### 在 Vue3 中集成和使用 WangEditor 的步骤 1. **安装依赖** ```bash npm install wangeditor --save ``` 2. **创建组件** 在组件文件(如 `WangEditor.vue`)中: ```vue <template> <div> <div ref="editorRef" class="editor"></div> <button @click="saveContent">保存内容</button> </div> </template> <script setup> import { ref, onMounted, onBeforeUnmount } from &#39;vue&#39;; import WangEditor from &#39;wangeditor&#39;; const props = defineProps({ initialContent: String // 接收初始内容 }); const emit = defineEmits([&#39;update:content&#39;]); const editorRef = ref(null); let editor = null; onMounted(() => { editor = new WangEditor(editorRef.value); // 配置图片上传(示例) editor.config.uploadImgServer = &#39;/api/upload-image&#39;; editor.config.uploadFileName = &#39;file&#39;; editor.config.onchange = (html) => { emit(&#39;update:content&#39;, html); // 实时内容更新 }; editor.create(); if (props.initialContent) { editor.txt.html(props.initialContent); // 初始化内容 } }); onBeforeUnmount(() => { editor.destroy(); // 清理编辑器实例 }); const saveContent = () => { const content = editor.txt.html(); // 调用API保存内容(示例) console.log(&#39;保存内容:&#39;, content); }; </script> <style scoped> .editor { border: 1px solid #ddd; margin: 10px 0; } </style> ``` 3. **父组件调用** ```vue <template> <WangEditor v-model:content="htmlContent" /> </template> <script setup> import { ref } from &#39;vue&#39;; import WangEditor from &#39;@/components/WangEditor.vue&#39;; const htmlContent = ref(&#39;<p>初始内容</p>&#39;); </script> ``` --- ### 关键配置说明 1. **图片上传** 需配置 `uploadImgServer` 和 `uploadFileName`,后端需支持文件上传接口[^3]。 2. **双向绑定** 通过 `v-model:content` 实现内容同步,依赖 `emit(&#39;update:content&#39;)`。 3. **销毁实例** 在 `onBeforeUnmount` 生命周期中调用 `editor.destroy()`,避免内存泄漏。 --- ### 常见问题 - **样式缺失**:需手动引入 WangEditor 的 CSS(可选): ```javascript import &#39;wangeditor/dist/css/style.css&#39;; ``` - **工具栏定制**:通过 `editor.config.toolbar` 配置,例如: ```javascript editor.config.toolbar = [ &#39;bold&#39;, &#39;italic&#39;, &#39;|&#39;, &#39;uploadImage&#39; ]; ``` ---
评论 8
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值