ueditor使用心得

UEditor使用手册

  1. 配置jdk 1.6+
  2. Apache Tomcat6.0+
  3. Ueditor官网下载

部署

  1. 安装好jdk和apache后,我们开始部署代码
  2. 我们在apache的安装目录下,找到webapps的这个文件夹,如下图1-1所示,然后我们将官网上下载的ueditor放到webapps下,官网上下载的代码可能是外面包了文件夹,我们只保留最底层的文件夹,例如图1-2

 

图1-1

 

图1-2

  1. 然后我们在utf8-jsp这个文件夹里建一个新的文件夹WEB-INF,如图1-3所示,它里面包括lib文件夹,同时将jsp文件夹下的lib文件夹下的所有jar包复制到我们自己新建的WEB-INF下的lib里,如图1-4所示。

 

图1-3

 

图1-4

  1. 到这里我们基本就部署完毕了,这个时候启动tomcat,就是bin文件夹下的startup.bat,这里需注意我们的nginx是否启动,如果启动一定要关掉,不然tomcat会报错。
  2. 如果你不想采用这种方式来配置,那我们可以用nginx代理来搞这件事,比如我找到了一个域名,以cmpwriter.jd.com为例,我配置了相关信息如下图1-5所示。同时在host文件中添加127.0.0.1。

 

图1-5

 

  1. 初始化

我们在页面引入相关文件,然后利用工厂模式初始化编辑器。

 

  1. 配置项更改

Ueditor.config.js中,可以对工具栏想要选择的按钮进行自行选择,同时文件中还有其他配置项可以自行配置,注释很清楚,例如主题配置项,自动保存开启等等,配置的参数一般为默认值,及时注释也会按照默认值来配置。

 

也可以通过实例化时传入参数,这种更好些,例子如下

 

  1. 自定义配置按钮

首先我们将按钮图片放在themes下的images下,然后可以选择在源码中修改,但不建议这种修改方式,此处不过多介绍。可以重新写一个js用做编辑器的配置。如下

 

Showproductwin是对这个按钮进行各种操作的一个函数,我这里是对编辑器内容增加,在这个函数里,必须存在的是参数fn,以及对fn的执行,看到红线框部分的内容其实是一个字符串。他会执行按钮注册时的方法,将这个字符串通过inserthtml插入到编辑器中,这是最常用的方式没有之一。

UEditor提供了registerUI这个接口,可以动态的注入扩展的内容。

uiname,是你为新添加的UI起的名字,这里可以是1个或者多个,“uiname”后者是“uiname1 uiname2 uiname3”。function,是实际你要做的事情,这里提供两个参数,editor是编辑器实例,如果你有多个编辑器实例,那每个编辑器实例化后,都会调用这个function,并且把editor传进来

uiname,你为ui起的名字,如果前边你添加的是多个的化,这里function会被调用多次,并且将每一个ui名字传递进来.

如果函数返回了一个UI 实例,那这个UI实例就会被默认加到工具栏上。当然也可以不返回任何UI。比如希望监控selectionchange事件,在某些场景下弹出浮层,这时就不需要返回任何UI.

index,是你想放到toolbar的那个位置,默认是放到最后editorId,当你的页面上有多个编辑器实例时,你想将这个ui扩展到那个编辑器实例上,这里的editorId是给你编辑器初始化时,传入的id,默认是每个实例都会加入你的扩展

  1. 二次开发组件化

比如我们在编辑器内插入一段商品详情,我们会发现在删除的时候,并不能直接删除这一块商品详情,因为ueditor将这一部分的内容转换成了html,所以我们需要给这一部分的内容加上如下属性:

tabindex=“-1”

contenteditable=“false”

ondrag=“return false”

ondragstart=“return false”

然后再是一下你会发现页面元素并没有加上,这是因为ueditor对自定义属性标签做了限制,所以我们去找到ueditor.config.js里找到whitList,找到你想要设置的标签,在后面加上这些属性即可

同时要将阻止div标签变成p标签,UEditor对于进入编辑器中的数据进行的过滤处理。在UEditor中表示段落的标签是p标签,很多的编辑操作都是基于p标签进行的处理。allowDivTransToP: false即可

  1. 图片上传路径配置

 

经常会发现已启动的时候疯狂报错,什么后端配置项不正确,图片上传成功但显示不出来,不要怕,很正常。打开上述文件,会发现很多配置项,如下图所示:

 

这里可以一顿配置,imageUrlPrefix的意思就是图片访问路径前缀,如果图片显示不出来就是这个玩意没配对。

 

猜你喜欢

转载自www.cnblogs.com/yuqing-o605/p/9548720.html