vue2中使用wangeditor富文本编辑器

在开发的时候,我们可能会使用到富文本编辑器,因为它看着比较美观,相比于其他的输入框,富文本编辑器的功能更多,给用户的体验更好。下面我们进行vue中整合富文本编辑器。

首先是下载wangeditor

  

npm i wangeditor --save

 其次在使用界面进行引入并进行初始化配置。

引入wangeditor

import E from 'wangeditor'

初始化

<script>
import E from 'wangeditor'
export default {
  data() {
    return {
      form: {},
      editor: null,
      viewData: null,
      editFormVisible: false,
    }
  },
  methods: {
    //添加
    add(){
    
      this.form = {};
        //进行新增数据时,我们给wangeditor容器赋值为空
      this.initWangEditor('');
      this.dialogFormVisible = true;
    },
    save(){
      this.form.description = this.editor.txt.html()
        //进行添加或修改的操作
    },
    edit(row){
      this.form = row
        //进行修改的操作时,我们将参数赋值为对应的参数
      this.initWangEditor(this.form.description || '');
      this.dialogFormVisible = true;
    },
    //查看详情
    viewEditor(description){
      this.viewData = description;
      this.editFormVisible = true;
    },
    //富文本编辑器初始化
    initWangEditor(content){
      setTimeout(()=>{
        if (!this.editor){
          //创建wangeditor对象
          this.editor = new E(document.getElementById('div1'));
          this.editor.config.placeholder = '请输入内容';
            //设置文件上传的后端路径          
          this.editor.config.uploadImgServer = '/api/files/wang/upload';
             //设置文件上传的参数名
          this.editor.config.uploadFileName = 'file'
            //设置文件上传的请求头
          this.editor.config.uploadImgHeaders={
            token: this.user.token
          }
           //自定义设置文件上传成功的回调
          /*this.editor.config.uploadImgHooks = {
            // 例如服务器端返回的不是 { errno: 0, data: [...] } 这种格式,可使用 customInsert
            customInsert: function(insertImgFn, result) {
              // result 即服务端返回的接口
              console.log('customInsert', result)

              // insertImgFn 可把图片插入到编辑器,传入图片 src ,执行函数即可
              insertImgFn(result.data[0].url)
            }
          }*/
            //创建wangeditor对象
          this.editor.create();
        }
        //给wangeditor中设置内容
        this.editor.txt.html(content)
      },100)
    }
  }
}
</script>

 上面是前端的请求配置,其中主要的是设置请求的路径,请求的参数名以及请求的请求头中的内容,还有上传文件成功后的回调。一般只要按照如下的方式返回响应的结果的话,我们就不用设置成功后的回调。

{
    接口返回的数据局类型是:
    // errno 即错误代码,0 表示没有错误。
    //       如果有错误,errno != 0,可通过下文中的监听函数 fail 拿到该错误码进行自定义处理
    "errno": 0,

    // data 是一个数组,返回图片Object,Object中包含需要包含url、alt和href三个属性,它们分别代表图片地址、图片文字说明和跳转链接,alt和href属性是可选的,可以不设置或设置为空字符串,需要注意的是url是一定要填的。
    "data": [
        {
            url: "图片地址",
            alt: "图片文字说明",
            href: "跳转链接"
        },
        {
            url: "图片地址1",
            alt: "图片文字说明1",
            href: "跳转链接1"
        },
        "……"
    ]
  }

其他详细的配置我们可以参考相应的官方文档:Introduction · wangEditor 用户文档icon-default.png?t=N7T8https://www.wangeditor.com/v4/

后端对应的设置

    @PostMapping("/wang/upload")
    public Dict wangUpload(MultipartFile file) throws Exception {
        Dict dict = Dict.create();
        Map<String,Object> map = new HashMap<>();
        //把文件存储到本地磁盘上
        String originalFilename = file.getOriginalFilename();
        String filename = UUID.randomUUID() +originalFilename.substring(originalFilename.lastIndexOf("."));
        String url = AliOssUtil.uploadFile(filename, file.getInputStream());
        dict.set("errno",0).set("data", CollUtil.newArrayList(Dict.create().set("url",url)));
//        map.put("errno",0);
//        map.put("data",url);
        log.info("上传路径:{}",url);
        return dict;
    }

通过以上的方式即可完成wangeditor的使用,并进行上传等操作。

注意

1.当我们在初始化wangeditor时,可能会遇到如下的错误:

这个是因为我们已经创建过一次容器了,不能再次创建了。所以我们在初始化容器的时候加了if判断,从而进行保证if只初始化一次。

如下:

2.遇到如下错误:'无效的节点选择器:#div1'

这种情况是我们在初始化wangeditor的时候,需要将方法放到methods中,否则的话不生效(在vue中是这样的)。

结束

我们在整合富文本编辑器的时候可能会遇到各种各样的问题,一般来说,只要写到方法体中,出错的概率不会很大。好了,今天就到这里了,如果对您有用的话,请务必要点个关注,谢谢!!!

<think>好的,我现在需要帮助用户了解如何在Vue2项目中集成和使用WangEditor富文本编辑器。首先,我需要回忆一下WangEditor的相关知识,特别是针对Vue2的集成步骤。根据用户提供的引用内容,引文[1]、[2]、[3]都提到了相关的安装和使用方法,特别是引用[3]专门提到了Vue2Vue3的实现步骤,所以这部分是关键。 首先,我需要确定安装依赖的正确方式。Vue2Vue3在引入组件时可能有所不同。根据引用[3],用户需要安装@wangeditor/editor和@wangeditor/editor-for-vue。不过需要注意的是,可能需要确认这两个包是否兼容Vue2。根据经验,可能有些版本差异,需要用户安装特定版本。比如,可能需要指定版本号,如@wangeditor/editor-for-vue@next或者某个旧版本,但用户提供的引用中没有提到版本问题,所以可能默认使用最新版本,但需要确认是否支持Vue2。 接下来,在Vue组件中引入编辑器的步骤。根据引用[2],在Vue3中需要引入CSS样式,创建编辑器实例,使用shallowRef等。但Vue2的响应式系统与Vue3不同,Vue2使用data属性而不是ref或shallowRef。因此,在Vue2中可能需要使用不同的方法来管理编辑器实例。例如,在data中定义editor实例,并在mounted生命周期钩子中初始化编辑器。 然后,创建编辑器实例和工具栏。引用[3]提到需要处理图片上传功能,这可能涉及到配置editorConfig中的自定义上传方法。这部分需要详细说明如何配置,包括处理上传成功的回调和失败的情况。 另外,组件销毁时需要手动销毁编辑器实例,避免内存泄漏。在Vue2中,这应该在beforeDestroy生命周期钩子中进行,而Vue3中使用onBeforeUnmount,但用户的问题是关于Vue2的,所以需要调整这部分内容。 还要考虑如何将编辑器内容与父组件的数据绑定。在Vue2中,可以通过v-model或者自定义事件来实现。例如,当编辑器内容变化时,触发input事件,更新父组件中的v-model值。 此外,用户可能需要示例代码,所以在回答中需要提供一个具体的Vue2组件示例,展示如何引入编辑器、配置工具栏、处理数据绑定和图片上传等。 最后,生成相关问题需要考虑用户可能遇到的后续问题,比如如何处理图片上传、如何自定义工具栏、兼容性问题和数据保存等。这样可以帮助用户更全面地应用WangEditor。 现在需要确保所有步骤符合Vue2的语法,比如使用data而不是ref,使用生命周期钩子如mounted和beforeDestroy,以及正确的事件处理。同时,要检查LaTeX格式是否符合要求,但用户的问题不涉及数学公式,所以可能不需要使用,但系统级指令要求行内数学表达式用$...$,所以如果有相关内容需要注意,但这里可能不适用。 总结步骤: 1. 安装依赖:npm安装正确的包。 2. 在组件中引入CSS和编辑器模块。 3. 在Vue2组件的data中初始化编辑器实例和相关数据。 4. 在mounted钩子中创建编辑器和工具栏。 5. 配置editorConfig,特别是图片上传部分。 6. 在beforeDestroy钩子中销毁编辑器。 7. 使用v-model或事件来同步内容。 8. 提供示例代码和相关问题。</think>### 在 Vue2 中集成与使用 WangEditor 富文本编辑器的步骤 #### 1. 安装依赖 安装核心包和 Vue2 适配包: ```bash npm install @wangeditor/editor @wangeditor/editor-for-vue@^5 --save ``` > 注意:`@wangeditor/editor-for-vue@^5` 是兼容 Vue2 的版本[^3]。 --- #### 2. 创建 Vue2 组件 在组件中引入编辑器和样式: ```javascript <template> <div> <!-- 工具栏 --> <div ref="toolbarRef"></div> <!-- 编辑器容器 --> <div ref="editorRef"></div> </div> </template> <script> import '@wangeditor/editor/dist/css/style.css'; import { Editor, Toolbar } from '@wangeditor/editor-for-vue'; export default { data() { return { editor: null, content: '', // 绑定编辑器内容 }; }, mounted() { this.initEditor(); }, beforeDestroy() { this.destroyEditor(); }, methods: { initEditor() { const editor = new Editor({ selector: this.$refs.editorRef, config: { placeholder: '输入内容...', MENU_CONF: { uploadImage: { // 自定义图片上传(示例) async customUpload(file, insertFn) { const formData = new FormData(); formData.append('image', file); // 调用上传接口 const res = await axios.post('/upload', formData); insertFn(res.url); // 插入图片链接 }, }, }, }, }); // 初始化工具栏 const toolbar = new Toolbar({ editor, selector: this.$refs.toolbarRef, }); this.editor = editor; // 监听内容变化 editor.on('change', () => { this.content = editor.getHtml(); this.$emit('input', this.content); // 支持 v-model }); }, destroyEditor() { if (this.editor) { this.editor.destroy(); this.editor = null; } }, }, }; </script> ``` --- #### 3. 在父组件中使用 通过 `v-model` 绑定内容: ```javascript <template> <div> <WangEditor v-model="htmlContent" /> </div> </template> <script> import WangEditor from '@/components/WangEditor.vue'; export default { components: { WangEditor }, data() { return { htmlContent: '', }; }, }; </script> ``` --- #### 4. 关键配置说明 1. **自定义图片上传**:通过 `MENU_CONF.uploadImage.customUpload` 配置自定义上传逻辑。 2. **工具栏过滤**:默认显示全部功能,可通过 `Toolbar.registerModule` 调整。 3. **内容同步**:通过 `editor.on('change')` 事件实时更新数据。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值