1. 引言
wangEditor——一款轻量级html富文本编辑器（开源软件）
- 网站：http://www.wangeditor.com/
- demo演示：http://www.wangeditor.com/wangEditor/demo.html
- 下载（github）：https://github.com/wangfupeng1988/wangEditor
- QQ群：164999061
从我发布wangEditor到现在，大概有七八个月了，随着近期增加的插入视频，表情，地图这三个功能，目前为止基本的功能已经大体完善了。这期间也修改了几个bug，都是各位网友反映的。至于程序是不是已经很稳定了，我不敢说。毕竟应用的人不是特别多，目前只有几十个关注wangEditor的人在应用。他们会偶尔提出一些bug，不过只要告诉我，我会第一时间解决，至少大家对我修改bug增加功能的速度和态度，还是比较认可的。
根据github记载，目前有105个commits，即我已经提交了105次代码更新，这个数量也会继续增加。大家有bug，有需求可以通过QQ群向我提交。
2. 介绍源码结构
wangEditor.js源码目前2200多行，用书写文字书写博客的方式介绍它的结构，还真不是一件简单的事儿。所以，这里我就长话短说，尽量简单的介绍一下重点，不要搞的太罗嗦，否则大家最后会不耐烦的。
如果让我自己对这个源码的设计和架构做一个评价的话，我会打70分。它并不是完美的，但是它已经满足了我基本的需求。比方说，我最近新增的几个功能（插入视频，地图，表情）都是通过修改其中的配置项增加上去的，而没有改动源码中的核心部分。开放封闭原则——对扩展开放，对修改封闭，我想我已经基本做到了这一点。
最后，我分享wangEditor源码设计的目的，为的是让大家给一些意见。提出一些疑问，一些建议，或者我目前还没有意识到的一些问题。总之，我是希望这个软件越做越好。
3. 一个jQuery插件
wangEditor是一款jQuery插件，也是基于jquery开发的（不理解jquery插件的同学，请自行补课，本文不讲）。定义一个jquery插件其实很简单，wangEditor.js源码的最后几十行定义了。
//------------------------------------生成jquery插件------------------------------------
$.fn.extend({
/*
* options: {
* $initContent: $elem, //配置要初始化内容
* menuConfig: [...], //配置要显示的菜单（menuConfig会覆盖掉hideMenuConfig）
* onchange: function(){...}, //配置onchange事件，
* uploadUrl: ‘string‘ //图片上传的地址
* }
*/
‘wangEditor‘: function(options){
if(this[0].nodeName !== ‘TEXTAREA‘){
//只支持textarea
alert(‘wangEditor提示：请使用textarea扩展富文本框。详情可参见作者的demo.html‘);
return;
}
var options = options || {},
menuConfig = options.menuConfig,
$initContent = options.$initContent || $(‘<p><br/></p>‘),
onchange = options.onchange,
uploadUrl = options.uploadUrl;
//获取editor对象
var editor = $E(this, $initContent, menuConfig, onchange, uploadUrl);
//渲染editor，并隐藏textarea
this.before(editor.$editorContainer);
this.hide();
//页面刚加载时，初始化selection
editor.initSelection();
return editor;
}
});
以上代码其实都很简单，就是接受一些配置项然后调用一个 $E 函数，返回一个 editor 对象，最后渲染到页面上。最关键的就是 $E 函数这一句话。
//获取editor对象 var editor = $E(this, $initContent, menuConfig, onchange, uploadUrl);
大家看这种方式是不是有点 var $div = $(‘div‘); 的意思？——对了，这的设计我就是模仿着jquery来的。
4. 仿jQuery的对象化设计
上文中提到的 $E 函数是这样定义的。
//全局的构造函数
$E = function($textarea, $initContent, menuConfig, onchange, uploadUrl){
return new $E.fn.init($textarea, $initContent, menuConfig, onchange, uploadUrl);
};
如上代码，其实构造函数是 $E.fn.init 。$E 只不过是一个入口，返回这个构造函数 new 出来的一个对象。
那么 $E.fn 是什么呢？ ——它是 $E.prototype 的简写而已——好多js系统都喜欢这么干，我也就随着高大上一些啦！
//prototype简写为fn
$E.fn = $E.prototype;
既然 $E.fn.init 是构造函数，那么它 new 出来的对象（即上文中的 editor）的原型要指向：$E.fn.init.prototype ，这样岂不是太长？不如来个简单一些的，将原型指向 $E.fn 吧。
$E.fn.init.prototype = $E.fn;
到了这里，没有看过jquery设计或者源码的人，一定觉得绕晕了——那是很正常的。我一开始接触jquery时，也是绕不过来。不过后来看多了，再后来自己用起来，还真觉得挺简单易用。大家在做自己的js代码时候，也不放试一试！
5. 工具函数 & 对象函数
其实这里也是仿照jquery来设计的。在jquery中，函数都是 $ 的属性，例如 $.trim() ，对象函数都是 $.fn 的属性，例如 $(‘div‘).html() 的 html 方法就是 $.fn.html 定义的。
在wangEditor.js也一样。有许多工具函数（例如log输出，引号转译，url安全性检查等）都是 $E 的属性；许多对象函数（例如text，append，change等）都是 $E.fn 的属性。
为什么把函数定义在 $E.fn 上即可成为对象函数呢？——因为构造函数是 $E.fn.init ，而 $E.fn.init.prototype = $E.fn; 不知道大家明白了没有？
6. menu配置项
wangEditor目前有28个功能菜单，不可能为每一个菜单都写一遍执行代码。因为我们是面向对象的编程，我们是遵循“开放封闭原则”的设计。
还别说，在第一个版本中，我还真就是一个菜单写一遍执行代码，后来发现那样根本无法扩展。现在我的宗旨是：写一个菜单处理引擎（包括菜单初始化，页面弹出关闭，命令执行），菜单的扩展通过配置项实现。这个菜单处理引擎今天就不在本文讲解了，那块挺麻烦的，有时间再通过视频的方式跟大家分享吧。
首先，我们需要把所有的菜单归归类，否则如何确定配置项啊？我把所有的菜单分为4类：
- command类型：点击按钮即可执行命令，如“粗体”，“下划线”
- dropMenu类型：点击按钮弹出下拉menu，再选择命令。如“字体”，“字号”
- dropPanel类型：点击按钮弹出panel，再选择命令。如“背景色”，“表情”
- modal类型：点击按钮弹出对话框，需要填写内容，再执行命令。如“插入图片”，“插入地图位置”
下面是一个菜单按钮配置时的说明：
‘menuId-1‘: {
‘title‘: （字符串，必须）标题,
‘type‘:（字符串，必须）类型，可以是 btn / dropMenu / dropPanel / modal,
‘txt‘: （字符串，必须）fontAwesome字体样式，例如 ‘fa fa-head‘,
‘style‘: （字符串，可选）设置btn的样式
‘hotKey‘:（字符串，可选）快捷键，如‘ctrl + b‘, ‘ctrl,shift + i‘, ‘alt,meta + y‘等，支持 ctrl, shift, alt, meta 四个功能键（只有type===btn才有效）
‘command‘:（字符串）document.execCommand的命令名，如‘fontName‘；也可以是自定义的命令名，如“撤销”、“插入表格”按钮（type===modal时，command无效）,
‘dropMenu‘: （$ul，可选）type===dropMenu时，要返回一个$ul，作为下拉菜单,
‘dropPanel‘:（$div，可选）type===dropPanel是，要返回一个$div，作为弹出框
‘modal‘:（$div，可选）type===modal是，要返回一个$div，作为弹出框,
‘callback‘:（函数，可选）回调函数,
},
再配置一个菜单时，必须要遵守这个规则，否则解析引擎无法正确解析配置项。在此，为每个类型的菜单按钮，粘贴几个简单的配置项：
‘fontFamily‘: {
‘title‘: ‘字体‘,
‘type‘: ‘dropMenu‘,
‘txt‘: ‘icon-wangEditor-font‘,
‘command‘: ‘fontName ‘,
‘dropMenu‘: function(){
var arr = [],
//注意，此处commandValue必填项，否则程序不会跟踪
temp = ‘<li><a href="#" commandValue="${value}" style="font-family:${family};">${txt}</a></li>‘,
$ul;
$.each($E.styleConfig.fontFamilyOptions, function(key, value){
arr.push(
temp.replace(‘${value}‘, value)
.replace(‘${family}‘, value)
.replace(‘${txt}‘, value)
);
});
$ul = $( $E.htmlTemplates.dropMenu.replace(‘{content}‘, arr.join(‘‘)) );
return $ul;
},
‘callback‘: function(editor){
//console.log(editor);
}
},
‘bold‘: {
‘title‘: ‘加粗‘,
‘type‘: ‘btn‘,
‘hotKey‘: ‘ctrl + b‘,
‘txt‘:‘icon-wangEditor-bold‘,
‘command‘: ‘bold‘,
‘callback‘: function(editor){
//console.log(editor);
}
},
‘foreColor‘: {
‘title‘: ‘前景色‘,
‘type‘: ‘dropPanel‘,
‘txt‘: ‘icon-wangEditor-pencil‘, //如果要颜色： ‘txt‘: ‘fa fa-pencil|color:#4a7db1‘
‘style‘: ‘color:blue;‘,
‘command‘: ‘foreColor‘,
‘dropPanel‘: function(){
var arr = [],
//注意，此处commandValue必填项，否则程序不会跟踪
temp = ‘<a href="#" commandValue="${value}" style="background-color:${color};" title="${txt}" class="forColorItem"> </a>‘,
$panel;
$.each($E.styleConfig.colorOptions, function(key, value){
var floatItem = temp.replace(‘${value}‘, key)
.replace(‘${color}‘, key)
.replace(‘${txt}‘, value);
arr.push(
$E.htmlTemplates.dropPanel_floatItem.replace(‘{content}‘, floatItem)
);
});
$panel = $(
$E.htmlTemplates.dropPanel.replace(‘{content}‘, arr.join(‘‘))
);
return $panel;
}
},
‘createLink‘: {
‘title‘: ‘插入链接‘,
‘type‘: ‘modal‘,
‘txt‘: ‘icon-wangEditor-link‘,
‘modal‘: function (editor) {
var urlTxtId = $E.getUniqeId(),
titleTxtId = $E.getUniqeId(),
blankCheckId = $E.getUniqeId(),
btnId = $E.getUniqeId();
content = ‘链接：<input id="‘ + urlTxtId + ‘" type="text" style="width:300px;"/><br />‘ +
‘标题：<input id="‘ + titleTxtId + ‘" type="text" style="width:300px;"/><br />‘ +
‘新窗口：<input id="‘ + blankCheckId + ‘" type="checkbox" checked="checked"/><br />‘ +
‘<button id="‘ + btnId + ‘" type="button" class="wangEditor-modal-btn">插入链接</button>‘,
$link_modal = $(
$E.htmlTemplates.modalSmall.replace(‘{content}‘, content)
);
$link_modal.find(‘#‘ + btnId).click(function(e){
//注意，该方法中的 $link_modal 不要跟其他modal中的变量名重复！！否则程序会混淆
//具体原因还未查证？？？
var url = $.trim($(‘#‘ + urlTxtId).val()),
title = $.trim($(‘#‘ + titleTxtId).val()),
isBlank = $(‘#‘ + blankCheckId).is(‘:checked‘),
link_callback = function(){
//create link callback
$(‘#‘ + urlTxtId).val(‘‘);
$(‘#‘ + titleTxtId).val(‘‘);
};
if(url !== ‘‘){
//xss过滤
if($E.filterXSSForUrl(url) === false){
alert(‘您的输入内容有不安全字符，请重新输入！‘)
return;
}
if(title === ‘‘ && !isBlank){
editor.command(e, ‘createLink‘, url, link_callback);
}else{
editor.command(e, ‘customCreateLink‘, {‘url‘:url, ‘title‘:title, ‘isBlank‘:isBlank}, link_callback);
}
}
});
return $link_modal;
}
}
7. 总结
以上只是一些重点部分，其他的还有很多。例如富文本编辑器的核心技术：execCommand，如何支持IE6的fontIcon，菜单按钮如何解析，以及表情，地图是如何实现的。时间有限，就不一一说明了，大家有兴趣可以去看源码。
最后还是欢迎大家多多指正！
- 网站：http://www.wangeditor.com/
- demo演示：http://www.wangeditor.com/wangEditor/demo.html
- 下载（github）：https://github.com/wangfupeng1988/wangEditor
- QQ群：164999061
-------------------------------------------------------------------------------------------------------------
欢迎关注我的教程：《从设计到模式》《深入理解javascript原型和闭包系列》《css知多少》《微软petshop4.0源码解读视频》《json2.js源码解读视频》
也欢迎关注我的开源项目——wangEditor，轻量化web富文本编辑器
-------------------------------------------------------------------------------------------------------------