3.6.6.1 接口及参数说明
在您有调用编辑器的页面中,加入如下的方法,就可以响应相应的事件了。当编辑器中作了某些操作或处理时,会主动触发这个方法。
接口方法原型:
<script type="text/javascript"> function EWEBEDITOR_EVENT(ev){ //响应事件处理代码 } </script> |
或者如下,在创建编辑器实例时,传入回调事件方法接口:
<script type="text/javascript"> function MyEventCallBack(ev){ //响应事件处理代码 }
// 创建编辑器实例,MyEventCallBack是自己的事件处理方法 EWEBEDITOR.Create("content1", {style:"coolblue",on:MyEventCallBack}, "<p>初始值</p>"); </script> |
传入参数:
ev : 对象型。传入事件相关的参数数据。不同的事件,会有不同的参数传入。
ev 对象固有属性:
固有属性 |
说明 |
ev.id |
字符型。编辑器实例化id,当一页有多个编辑器时,可以用来判断是哪个编辑器触发的事件。也可以通过此id来获取实例化对象,从而访问API接口方法。 |
ev.flag |
字符型。事件标志,用于判断是什么事件。不同的事件,会有更多不同的属性。 |
系统提供的ev.flag 值列表:
ev.flag |
说明 |
LoadComplete |
当编辑器加载完成时,会触发此事件。只有在此事件后,才可以调用此实例的Javascript API方法。当使用Javascript作自动赋值时,可以此事件中处理。 |
Remove |
编辑器实例被删除时,会触发此事件。 |
AfterImportWord |
Word导入或粘贴后,触发此事件。您可以在此事件中,对导入的Word文档,执行一键排版处理等。 附加的事件属性: ev.action : 动作类型。 "import" : 表示导入操作 "paste" : 表示粘贴操作 |
AfterImportExcel |
Excel导入或粘贴后,触发此事件。 附加的事件属性: ev.action : 动作类型。 "import" : 表示导入操作 "paste" : 表示粘贴操作 |
AfterImportPPT |
PPT导入后,触发此事件。 |
AfterLocalUpload |
本地上传后,触发此事件。 |
AfterRemoteUpload |
远程上传后,触发此事件。 |
AfterIUpload |
输入框调用上传文件对话框,上传后,触发此事件。 附加的事件属性有: ev.filecount : 上传的文件数 ev.savepathfilename : 保存的路径文件名,多个以“|”隔开 ev.savefilename : 保存的文件名,多个以“|”隔开 ev.originalfilename : 原文件名,多个以“|”隔开 |
AfterUploadOne |
每上传一个文件后,触发此事件。一个对话框,一个操作,可能多次触发此事件,如批量上传或导入等,在一个对话框里,就可能会上传多个文件。在编辑器里,通过任意方式上传文件,都会触发此事件。 附加的事件属性有: ev.savepathfilename : 保存的路径文件名 ev.savefilename : 保存的文件名 ev.originalfilename : 原文件名 |
AfterQuickFormat |
一键排版处理后,触发此事件。 |
SetTitleImage |
当点击“设为标题图片”按钮时,触发此事件。使用此事件,用户可以直接右键点编辑器中的某个图片,把指定的图片设为标题图片。 附加的事件属性有: ev.src : 图片路径 ev.obj : 图片对象 |
DialogClose |
对话框关闭时会触发此事件。(V10.0增加) 附加的事件属性有: ev.ok : (true)表示点确定按钮关闭窗口,(false)表示点了取消按钮关闭窗口 |
Change |
内容发生改变时触发此事件。(V11.0增加) 注:不能用此事件来确切的完全判断编辑器的值是否有改变。如要判断确切的是否有改变,要在初始事件时先取一次值,后面需要时再取值,通过判断两次的值是否一样,来判断值是否有改变。 |
Paste |
当内容粘贴进编辑器时触发此事件。(V11.5增加) 注:AfterImportWord, AfterImportExcel事件的paste动作也会触发此事件。 附加的事件属性有: ev.type : 粘贴数据类型,值为:(text)表示纯文本粘贴, (html)表示HTML格式粘贴, (word)表示从Word软件粘贴, (excel)表示从Excel软件粘贴贴, (wps)表示从WPS文字粘贴, (et)表示从WPS表格粘贴, (image)表示剪贴板图片粘贴, (file)表示拷贝文件的粘贴 |