最近在做一个微信素材编辑器的小项目,使用到了UEditor编辑器,使用中出现了许多问题。
1.介绍
UEditor是由百度web前端研发部开发所见即所得富文本web编辑器, 具有轻量,可定制,注重用户体验等特点,开源基于MIT协议,允许自由使用和修改代码...2.下载
下载地址 :/website/download.html#ueditor. 选择开发版 ,因为我们使用node ,所以随便下一个版本,这里下载1.4.3.3 jsp 版本 下载完成解压。3.创建项目
使用express生成器生成一个项目,并安装好依赖模块$express ue-test -ejs$cd ue-test && npm install
把刚刚压缩好的文件重命名为ueditor 放入ue-test/pubilc 中
修改index.ejs页面:
<!DOCTYPE html><html><head><title><%= title %></title> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/><script type="text/javascript" charset="utf-8" src="../ueditor/ueditor.config.js"></script><script type="text/javascript" charset="utf-8" src="../ueditor/ueditor.all.min.js"> </script><!--建议手动加在语言,避免在ie下有时因为加载语言失败导致编辑器加载失败--><!--这里加载的语言文件会覆盖你在配置项目里添加的语言类型,比如你在配置项目里配置的是英文,这里加载的中文,那最后就是中文--><script type="text/javascript" charset="utf-8" src="../ueditor/lang/zh-cn/zh-cn.js"></script></head><body><script id="editor" type="text/plain" style="width:1024px;height:500px;"></script></body><script type="text/javascript">//实例化编辑器//建议使用工厂方法getEditor创建和引用编辑器实例,如果在某个闭包下引用该编辑器,直接调用UE.getEditor('editor')就能拿到相关的实例var ue = UE.getEditor('editor');</script></html>
然后启动项目,编辑器初始化成功!(注意引入文件路径的问题,如果初始化失败可以f12查看报错进行调试)
我们这里为什么要这样引入路径 可以看这里(API)
4.后端配置
仅仅这样是不能进行上传的 我们需要要配置后端文件。 修改ueditor.config.js 文件//找到这一行代码 修改成这样,这里的url为请求的路径// 服务器统一请求接口路径,serverUrl: URL + "ue"
接下来我们安装ueditor 模块
$npm install ueditor --save
ueditor模块有一个示例,照着修改就好了
修改app.js:
//加载ueditor 模块var ueditor = require("ueditor");//使用模块app.use("/ueditor/ue", ueditor(path.join(__dirname, 'public'), function (req, res, next) {// ueditor 客户发起上传图片请求if (req.query.action === 'uploadimage') {var foo = req.ueditor;var imgname = req.ueditor.filename;var img_url = '/images/ueditor/';res.ue_up(img_url); //你只要输入要保存的地址 。保存操作交给ueditor来做res.setHeader('Content-Type', 'text/html');//IE8下载需要设置返回头尾text/html 不然json返回文件会被直接下载打开}// 客户端发起图片列表请求else if (req.query.action === 'listimage') {var dir_url = '/images/ueditor/';res.ue_list(dir_url); // 客户端会列出 dir_url 目录下的所有图片}// 客户端发起其它请求else {// console.log('config.json')res.setHeader('Content-Type', 'application/json');res.redirect('/ueditor/jsp/config.json');}}));
修改完成重启一下服务就好了,
5.其他配置
自动保存
<pre name="code" class="javascript">//启用自动保存,enableAutoSave: true//自动保存间隔时间, 单位ms,saveInterval: 500
发现这样启用自动保存没有成功,不知道为什么。 另一个方法是在实例编辑器之后调用
//实例化编辑器//建议使用工厂方法getEditor创建和引用编辑器实例,如果在某个闭包下引用该编辑器,直接调用UE.getEditor('editor')就能拿到相关的实例var ue = UE.getEditor('editor');//注意一定要延时。要等这玩意载入成功。setTimeout(function () {ue.execCommand('drafts');}, 500);
自动保存成功!!
取消自动保存
启用自动保存的时候会发现一直提示,是不是很烦,反正我是不能忍,怎么办呢?设置一下自动保存间隔时间,把它设长一点就好了。
//启用自动保存,enableAutoSave: true//自动保存间隔时间, 单位ms,saveInterval: 500 * 60 *60
这样烦人的自动保存提示就不会出来了。
只取消提示上面我取消自动保存之后会发现使用起来不舒服,每次刷新页面,上次编辑的就没有了。 我们能不能只取消提示,而保留自动保存功能呢。 我在网上找了下,并没有发现。
那我们就自己写一个简单的保存吧。 我们可以使用html5的localStorage 本地存储功能, 当我们离开当前页面时候,把编辑器内容存储到本地, 进入页面时候提取数据。 上代码:
//实例化编辑器var ue = UE.getEditor('editor');$(function() {//初始化数据,读localstroage var allData = {};if (localStorage.getItem('ueditor_content')!=null && localStorage.getItem('ueditor_content')!="") {allData =JSON.parse(localStorage.getItem('ueditor_content')); } //延时加载数据 要等编辑器加载成功,反正我不延时的时候没有成功。setTimeout(function () {ue.setContent (allData)}, 500); //离开页面或者刷新页面触发方法window.onbeforeunload = function() {localStorage.setItem("ueditor_content", JSON.stringify(ue.getContent()));} })
6.添加音乐
添加音乐好坑啊,这是什么鬼,我要的是这样的效果好么。
要不然你就这样也好
有会的老司机请指导指导!
7.解决图片过大超出编辑器
有时候图片宽度超出了编辑器的宽度,我们会想让他等比缩放 在配置里面找了下,没找到这个配置。 不过编辑器提供了一个iframe.css让我们写自己的配置我们可以在里面设置:
img {max-width: 100%; /*图片自适应宽度*/}
这样图片再怎么拉伸宽度都超不过边界。 别看很简单,但是花了不少时间研究。