同学们问的较多的一些配置项进行简单的讲解,其余配置请同学们自行查看editor_config.js文件中的对应注释即可。
A.提交表单的域名
将编辑器的容器置于一个form表单之中,后台如何获取编辑器中的内容呢?UEditor内部做了自动处理,无需用户诸如再创建一个隐藏表单来放置编辑内容等操作,只需要在配置项中设置textarea : 'editorValue'即可,后台则可以直接通过
$_POST['editorValue']或者request.getParameter(\等方式来获取编辑器中的内容。 B.图片相对路径
在1.1.7版本之前(包括1.1.7版),进入编辑器内的图片地址没有经过特殊处理,造成不同的浏览器中呈现出不一样的地址结果(绝对和相对),从而对后期的程序移植造成了一定程度的影响。1.1.7.3版开始可以通过开启本配置项来强制项目中所有的相对路径都以相对于根目录的相对路径来展示,方便了同学们的后期移植。 C.黑白名单
UEditor提供了功能强大的黑白名单过滤机制,简单的几个配置就可以拦截任何不安全因素于编辑器之外。黑白名单可以同时使用,也可以单独分开使用。黑名单中的标签将会被编辑器完整地过滤掉,包括标签本身以及标签之内的任何内容。而不在白名单之中的那些标签则仅被过滤了标签本身,其内容会继续走过滤流程。
具体的黑白名单配置示例如下所示,其中$表示元素的属性: serialize : function(){ return {
//黑名单,表示不允许任何style、script、link、object、applet和input标签 blackList: {style:1,script:1,link:1,object:1,applet:1,input:1}, //白名单 whiteList: {
//表示允许div标签,且其可包含p、span和br标签,style、class属性 div: {p:1,span:1,br:1,$:{style:1,class:1}},
//表示允许img标签,且只能包含href、title和alt属性 img: {$:{href:1,title:1,alt:1}}
} } }()
D.表情本地化
鉴于有些内网用户不能访问外网而导致的编辑器表情功能不可用,从1.1.7正式版开始,UEditor提供了表情本地化功能。更改配置emotionLocalization:true 即可开启本地表情功能。当然,本地表情功能必须要确保dialogs/emotion/目录下存在官方提供的images文件夹及所有表情文件。表情本地化之后,大家更换起表情文件来也就相当方便了! E.自动清除编辑器初始化内容
1.3前后端数据整合
1) Editor实例下的API介绍
UEditor目前向外部提供了不包括构造函数在内的12个方法,具体的类图如下:
每个方法的使用方法和示例将会在API列表中给出,点此下载。 2) 前后端数据交互
前后端的数据交互主要可分为数据提交和数据获取(从服务器)两种类型。
对于数据提交,UEditor为了优化用户的部署体验,特别针对数据提交做了特殊处理,用户不需要创建隐藏表单之类的元素来暂存编辑器值,而只需要在编辑器容器外围套上一层FORM标签,然后在配置项中设定一个名为textarea(名字有点撮!历史原因,大家将就下吧)的值即可。具体代码示例如下:
? ? ? ? ? ? ? ? ? ? ? ?
第二种方式是使用编辑器提供的方法setContent(str)来赋值,示例代码如下:
相关推荐: