富文本编辑器(wangEditor)

时间 2019-11-19

标签文本编辑器 wangeditor 繁體版

原文原文链接

　近期在产品的开发工做中遇到要使用富文本编辑器的地方。因而对比了几款编辑器，最后选择了wangEditor。 javascript

　　优势：轻量、简洁、界面美观、文档齐全。 缺点: 相较于百度ueditor等编辑器功能较少。文档地址：https://www.kancloud.cn/wangfupeng/wangeditor3/332599html

　　使用方式：java

　　1. 建立一个容器：ajax

  <div id="editor">  </div>

　　2.引入js文件后端

<script src="~/Editor/wangEditor.js"></script>

　　3.初始化服务器

  // 富文本编辑器
    var E = window.wangEditor;
    var editor = new E("#editor")
　　 editor.create()

　　4.上传图片网络

　　支持网络图片与本地上传编辑器

　　网络图片直接输入地址便可。函数

　　本地上传默认是关闭的。分为Base64与上传至服务器。post

　　 4.1 Base64格式

　　　　开启本地上传Base64

 // 启用"上传图片"tab base64格式
    editor.customConfig.uploadImgShowBase64 = true;

　　　　开启以后直接拖拽或手动选择上传便可。

　　　　Base64码

　　　　4.2 上传至服务器

　　　　配置上传接口,可是不能与Base64同时配置。

editor.customConfig.uploadImgServer = '/Storage/Upload'

　　　　js上传配置：用的官方文档的默认配置。详情能够参考官网文档：https://www.kancloud.cn/wangfupeng/wangeditor3/335782

　　　　注：全部的配置代码都须要放在 editor.create() 以前。

 editor.customConfig.uploadImgHooks = {
        before: function (xhr, editor, files) {
            // 图片上传以前触发
            // xhr 是 XMLHttpRequst 对象，editor 是编辑器对象，files 是选择的图片文件

            // 若是返回的结果是 {prevent: true, msg: 'xxxx'} 则表示用户放弃上传
            // return {
            //     prevent: true,
            //     msg: '放弃上传'
            // }
        },
        success: function (xhr, editor, result) {
            // 图片上传并返回结果，图片插入成功以后触发
            // xhr 是 XMLHttpRequst 对象，editor 是编辑器对象，result 是服务器端返回的结果
        },
        fail: function (xhr, editor, result) {
            console.log(result)
            // 图片上传并返回结果，但图片插入错误时触发
            // xhr 是 XMLHttpRequst 对象，editor 是编辑器对象，result 是服务器端返回的结果
        },
        error: function (xhr, editor) {
            // 图片上传出错时触发
            // xhr 是 XMLHttpRequst 对象，editor 是编辑器对象
        },
        timeout: function (xhr, editor) {
            // 图片上传超时时触发
            // xhr 是 XMLHttpRequst 对象，editor 是编辑器对象
        },

        // 若是服务器端返回的不是 {errno:0, data: [...]} 这种格式，可以使用该配置
        // （可是，服务器端返回的必须是一个 JSON 格式字符串！！！不然会报错）
        customInsert: function (insertImg, result, editor) {
            // 图片上传并返回结果，自定义插入图片的事件（而不是编辑器自动插入图片！！！）
            // insertImg 是插入图片的函数，editor 是编辑器对象，result 是服务器端返回的结果

            // 举例：假如上传图片成功后，服务器端返回的是 {url:'....'} 这种格式，便可这样插入图片：
            var url = result.Url
            insertImg(url)

            // result 必须是一个 JSON 格式字符串！！！不然报错
        }
    }

　　　　4.3 后端接口

　　　　　　只需将文件的最终存储路径按指定的格式/或自定义格式放回便可。

　　　　5.将编辑器内的数据传递给后台方法

　　　　　我这里是先将编辑器内的数据赋值给 textarea ，而后使用ajax的方式提交textarea的数据。

　　　　 5.1 建立textarea 并隐藏

<textarea id="text1" style="width:100%; height:200px;display:none;"></texta

　　　　 5.2 在js中配置

        // 隐藏的文本域
       var $text1 = $('#text1')
       // 监听编辑器内容的变化,html为变化后的数据
       editor.customConfig.onchange = function (html) {
        // 监控变化，同步更新到 textarea
        $text1.val(html)
    }

　　　　 5.3 提交数据并在后台保存

　　　　添加一个按钮

<button id="btnSubmit2">保存 </button>

　　　　ajax提交

 $("#btnSubmit2").click(function () {
        // 文本域的内容
        var text1 = $('#text1').val();
        $.ajax({
            type: "post",
            data: {
                "editorHtml": text1
            },
            url: "/Editor/Save",
            success: function (data) {
               console.log(data)
        });
    })

　　　　　　6.其余配置及功能请直接访问文档：

　　　　　　https://www.kancloud.cn/wangfupeng/wangeditor3/335782