UEditor是由百度web前端研发部开发所见即所得富文本web编辑器,具有轻量,可定制,注重用户体验等特点,开源基于BSD协议,允许自由使用和修改代码。
最近在项目中需要用到在线编辑器,查找了相关资料,决定使用UEditor,整理了一下在项目中加入UEditor的步骤。
步骤如下:
一、官网上下载完整源码包,解压到任意目录
_examples:编辑器完整版的示例页面
_demos:编辑器的各种使用案例
dialogs:弹出对话框对应的资源和JS文件
themes:样式图片和样式文件
third-party:第三方插件
editor_all.js:_src目录下所有文件的打包文件
editor_all_min.js:editor_all.js文件的压缩版,建议在正式部署时才采用
editor_config.js:编辑器的配置文件,建议和编辑器实例化页面置于同一目录
二、部署UEditor到实际项目(UETest)中的步骤:
第一步:在项目的任一文件夹中建立一个用于存放UEditor相关资源和文件的目录,此处在项目根目录下建立,起名为ueditor。
第二步:拷贝源码包中的dialogs、themes、third-party、editor_all.js和editor_config.js到ueditor文夹中。
第三步:为简单起见,此处将以根目录下的index.jsp页面作为编辑器的实例化页面,用来展示UEditor的完整版效果。在index.jsp文件中,首先导入编辑器需要的三个入口文件,示例代码如下:
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>编辑器完整版实例</title>
<script type="text/javascript" src="ueditor/editor_config.js"></script>
<script type="text/javascript" src="ueditor/editor_all.js"></script>
<link rel="stylesheet" href="ueditor/themes/default/ueditor.css">
第四步:然后在index.php文件中创建编辑器实例及其DOM容器。具体代码示例如下:
<div id="myEditor"></div>
<script language="javascript" type="text/javascript">
var option = {
initialContent : '',//初始化编辑器的内容
minFrameHeight : 400,//设置高度
textarea : 'content'//设置提交时编辑器内容的名字,之前我们用的名字是默认的editorValue
};
var editor = new baidu.editor.ui.Editor(option);
editor.render("myEditor");
</script>
最后一步: 在/UETest/ueditor/ editor_config.js中查找URL变量配置编辑器在你项目中的路径。
//强烈推荐以这种方式进行绝对路径配置
URL=window.UEDITOR_HOME_URL||"/UETest/ueditor/";
至此,一个完整的编辑器实例就已经部署到咱们的项目中了!在浏览器中输入http://localhost:8080/UETest 运行下试试UE强大的功能吧!