node -- 使用UEditor富文本编辑器

时间:2022-12-25 18:23:49

最近在做一个微信素材编辑器的小项目,使用到了UEditor编辑器,使用中出现了许多问题。

1.介绍

UEditor是由百度web前端研发部开发所见即所得富文本web编辑器, 具有轻量,可定制,注重用户体验等特点,开源基于MIT协议,允许*使用和修改代码...

2.下载

下载地址 :http://ueditor.baidu.com/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
node -- 使用UEditor富文本编辑器

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');
}
}));

修改完成重启一下服务就好了,
node -- 使用UEditor富文本编辑器
node -- 使用UEditor富文本编辑器
node -- 使用UEditor富文本编辑器

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);
自动保存成功!!

取消自动保存

启用自动保存的时候会发现一直提示,是不是很烦,反正我是不能忍,怎么办呢?
node -- 使用UEditor富文本编辑器

设置一下自动保存间隔时间,把它设长一点就好了。
//启用自动保存
,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.添加音乐

添加音乐好坑啊, node -- 使用UEditor富文本编辑器
这是什么鬼node -- 使用UEditor富文本编辑器node -- 使用UEditor富文本编辑器node -- 使用UEditor富文本编辑器node -- 使用UEditor富文本编辑器node -- 使用UEditor富文本编辑器node -- 使用UEditor富文本编辑器,我要的是这样的效果好么。 node -- 使用UEditor富文本编辑器

要不然你就这样也好
node -- 使用UEditor富文本编辑器

有会的老司机请指导指导!

7.解决图片过大超出编辑器

有时候图片宽度超出了编辑器的宽度,我们会想让他等比缩放 在配置里面找了下,没找到这个配置。 不过编辑器提供了一个iframe.css让我们写自己的配置 node -- 使用UEditor富文本编辑器
我们可以在里面设置:
img {
max-width: 100%; /*图片自适应宽度*/
}
这样图片再怎么拉伸宽度都超不过边界。别看很简单,但是花了不少时间研究。