免费开源百度编辑器(UEditor)使用方法

免费开源百度编辑器(UEditor)使用方法_第1张图片
UEditor效果图

一、简介

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

官方网站:
http://ueditor.baidu.com/

二、下载地址

官方下载:
http://ueditor.baidu.com/website/download.html

官网上下载完整源码包,解压到任意目录,解压后的源码目录结构如下所示:
    _examples:编辑器完整版的示例页面
    dialogs:弹出对话框对应的资源和JS文件
    themes:样式图片和样式文件
    php/jsp/.net:涉及到服务器端操作的后台文件,根据你选择的不同后台版本,这里也会不同,这里应该是jsp,php,.net
    third-party:第三方插件(包括代码高亮,源码编辑等组件)
    editor_all.js:_src目录下所有文件的打包文件
    editor_all_min.js:editor_all.js文件的压缩版,建议在正式部署时才采用
    editor_config.js:编辑器的配置文件,建议和编辑器实例化页面置于同一目录

或者网上搜索别人配置好的实例,这样自己就不用折腾了。我自己弄的,结果折腾了好久,差点想放弃了!

我下载的是开发版 [1.2.5.1 .Net 版本]  2013年4月27日,最新版本。

三、部署方法

免费开源百度编辑器(UEditor)使用方法_第2张图片

代码结构图

第一步:在项目的任一文件夹中建立一个用于存放UEditor相关资源和文件的目录,此处在项目根目录下建立,起名为ueditor(自己喜欢)。
第二步:拷贝源码包中的dialogs、themes、third-party、editor_all.js和editor_config.js到ueditor文夹中。其中,除了ueditor目录之外的其余文件均为具体项目文件,此处所列仅供示例。
第三步:为简单起见,此处将以根目录下的index.php页面作为编辑器的实例化页面,用来展示UEditor的完整版效果。在index.php文件中,首先导入编辑器需要的三个入口文件,示例代码如下:

复制代码 代码如下:


编辑器完整版实例


第四步:然后在index.php文件中创建编辑器实例及其DOM容器。具体代码示例如下:

复制代码 代码如下:





最后一步: 在/UETest/ueditor/ editor_config.js中查找URL变量配置编辑器在你项目中的路

复制代码 代码如下:

//强烈推荐以这种方式进行绝对路径配置(注意:下面的UETest是虚拟目录名称)
URL= window.UEDITOR_HOME_URL||"/UETest/ueditor/";

至此,一个完整的编辑器实例就已经部署到咱们的项目中了!在浏览器中输入http://localhost/UETest 运行下试试UE强大的功能吧!

四、注意事项

1.在引用editor_config.js时,最好先于editor_all.js加载,否则特定情况下可能会出现报错。
2.如果想编辑器赋初始值,请参考_examples文件的一些例子代码,或者阅读官方给出的文档说明。
3. 需要注意的是编辑器资源文件根路径。它所表示的含义是:以编辑器实例化页面为当前路径,指向编辑器资源文件(即dialog等文件夹)的路径。鉴于很多同学在使用编辑器的时候出现的种种路径问题,此处强烈建议大家使用"相对于网站根目录的相对路径"进行配置。"相对于网站根目录的相对路径"也就是以斜杠开头的形如"/UETest/ueditor/"这样的路径。

此外如果你使用的是相对路径,例如"ueditor/"(相对于图表1路径结构),如果站点中有多个不在同一层级的页面需要实例化编辑器,且引用了同一UEditor的时候,可能不适用于每个页面的编辑器。因此,UEditor提供了针对不同页面的编辑器可单独配置的根路径,具体来说,在需要实例化编辑器的页面最顶部写上如下代码即可。
当然,需要令此处的URL等于对应的配置。window.UEDITOR_HOME_URL ="/xxxx/xxxx/";
例如:根据图表1的目录结构

如果你在index.aspx里使用编辑器,那么在editor_config.js里最上边的var URL就改成 var URL = "/UETest/ueditor/"

五、常见问题

1.乱码
如果运行成功了,而出现乱码的话,请检查你的编码方式。UEditor引用的脚本带有编码方式和meta标签。我下载的是utf-8版,运行起来就出现了乱码,我把引用的脚本中的charset="utf-8" 去掉就没有问题了。

2.上传图片出错
如果上传图片出现红色的叉叉,或者上传到一半没有反应。把net文件夹(PHP语言对应的是php,而JSP语言对应的是jsp)下面的web.config删除,原因是它里面使用.net 4.0的配置,而3.5和以下的版本就会有问题,删除不会有影响。

六、最后,附上我的代码

复制代码 代码如下:

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Test2.aspx.cs" Inherits="Test2" %>



    UEditor测试
   
   


   

   

       
       
   

   



你可能感兴趣的:(免费开源百度编辑器(UEditor)使用方法)