tinymce原装插件源码分析（一）-hr

tinymce简介

tinymce是一款能方便无限扩展的网页富文本编辑器。

tinymce原装插件已经十分丰富，对于文本编辑（blog等文章）是绰绰有余，但是应对一些复杂的应用，比如在上面开发html网页等，还是有些捉襟见肘。

鉴于，网上关于tinymce的文章都是基于简单使用，而关于插件编写等，一概搜不到。 本系列文章就tinymce一个较老的版本（4.2.8 (2015-xx-xx)）进行分析。js源码见: https://github.com/xunhanliu/static/tree/master/js/tinymce .

插件位于plugins目录下。关于plugin.js文件的加载。见: tinymce.js L:33446, 这两行就是如果找到了相应的plugin.min.js就加载plugin.js(原版是加载plugin.min.js，这里为了调试，让它加载了plugin.js)

注：注释或文中 tinymce.js L:20582或者  L:20582的形式都表示在tinymce.js的行号。

插件 hr

tinymce.PluginManager.add('hr', function(editor) {   //如果配置中plugins参数填有hr，就执行这句话，进行加载hr插件。
    editor.addCommand('InsertHorizontalRule', function() { //这里tinymce进行添加命令的解析。注 tinymce.js L:20582行已经有这个命令的解析，所以这个函数可加可不加
        editor.execCommand('mceInsertContent', false, '<hr />'); //这个函数是执行插入命令，在选择位置处插入'<hr />'并删除选择的内容，或者在光标位置进行插入。
    });

    editor.addButton('hr', {  //L31952: Adds a button that later gets created by the theme in the editors toolbars.
                            //也就是这里的配置在toolbars中展示的样子，及触发的命令
        icon: 'hr',
        tooltip: 'Horizontal line',
        cmd: 'InsertHorizontalRule'
    });

    editor.addMenuItem('hr', {//这里配置它在菜单中的样子及，它的位置载 insert子菜单下。
        icon: 'hr',
        text: 'Horizontal line',
        cmd: 'InsertHorizontalRule',
        context: 'insert'
    });
});

mceInsertContent命令简单解读

上文L:3中涉及到一个核心命令mceInsertContent（在光标处插入特定的内容）见L:20268。

这里省略了n行（这一部分都是关于代码健壮性判断）。。。

常识：selection是与用鼠标刷选字体（蓝底白字）有关。selection.isCollapsed() 只放置光标不选择，会返回true。

---

 

这里把hr和marker(span)组装起来，生成可跌迭代的树结构，类似于dom结构。

parser.parse 函数定义在 L; 12081位置处。其中核心部分：

此函数的第二个参数部分需要是包含内容的父标签。

1、serializer.serialize是parser.parse的逆运算
2、parser结构的遍历的一个例子：L20411~L20423

                node = fragment.lastChild;
                if (node.attr('id') == 'mce_marker') {
                    marker = node;

                    for (node = node.prev; node; node = node.walk(true)) {
                        if (node.type == 3 || !dom.isBlock(node.name)) {
                            if (editor.schema.isValidChild(node.parent.name, 'span')) {
                                node.parent.insert(marker, node, node.name === 'br');
                            }
                            break;
                        }
                    }
                }

---

这里为什么加了额外加一个’<span id="mce_marker" data-mce-type="bookmark">&#xFEFF;&#x200B;</span>‘  ？ 

　　是为了把视图滚动到当前的光标的位置。

涉及到的命令：

mceInsertContent、Delete (删除选择的部分)

涉及到的核心函数：

selection、editor.parser、new Serializer