富文本编辑器UEditor自定义工具栏（三、自定义工具栏功能按钮图标及工具栏样式简单修改）

 

 导读

富文本编辑器UEditor提供丰富了定制配置项，如果想设置个性化的工具栏按钮图标有无办法呢？答案是肯定的！前两篇博文简要介绍了通过将原工具栏隐藏，在自定义的外部按钮上，调用UEditor各命令实现与原按钮相同的功能。本篇将介绍更为简单粗暴的方式。

传送门

1.富文本编辑器UEditor自定义工具栏（一、基础配置与字体、背景色、行间距、超链接实现）

2.富文本编辑器UEditor自定义工具栏（二、插入图片、音频、视频个性化功能按钮和弹层及自定义分页符）

 一、效果图

自定义工具栏功能按钮图标效果如下

 

二、自定义工具栏按钮图标实现

1.增加自定义按钮

(1)打开文件 ueditor/themes/default/css/ueditor.css，添加样式 .edui-for-customimage

 

/*增加自定义图片图标*/
.edui-default .edui-for-customimage .edui-icon {
background-image: url('../images/customicons/ne_toolsicon17.png') !important;
background-repeat:no-repeat;
}

 其中 background-image 属性，图片路径如下图，customicons文件夹下为功能按钮的图标，建议图标大小为20*20px，ne_toolsicon17.png 为自定义按钮的图标。

 

（2）ueditor.config.js文件中的toolbars数组，增加一个“customimage”配置

, toolbars: [[
            ......,print', 'preview', 'searchreplace', 'help'
            //, 'drafts' 从草稿箱加载
            //新增自定义按钮
            ,'customimage'
        ]]

//自定义按钮鼠标移入提示
        ,labelMap:{
            'customimage':'插入图片'
        }

（3）绑定按钮点击事件

(a)打开ueditor.all.js文件或新建js文件
仿照 首行缩进 脚本绑定点击事件；

/**
 * 缩进
 * @command indent
 * @method execCommand
 * @param { String } cmd 命令字符串
 * @example
 * ```javascript
 * editor.execCommand( 'indent' );
 * ```
 */
UE.commands['indent'] = {
    execCommand : function() {
         var me = this,value = me.queryCommandState("indent") ? "0em" : (me.options.indentValue || '2em');
         me.execCommand('Paragraph','p',{style:'text-indent:'+ value});
    },
    queryCommandState : function() {
        var pN = domUtils.filterNodeList(this.selection.getStartElementPath(),'p h1 h2 h3 h4 h5 h6');
        return pN && pN.style.textIndent && parseInt(pN.style.textIndent) ?  1 : 0;
    }

};

(b)js脚本执行
也可以在编辑器初始化页面，ueditor ready事件下，为此按钮绑定事件；

$("#edui74").on("click",function () {
           ///todo:脚本
})

其中edui74为按钮元素的id

 

 2、修改原功能按钮图标为新图标

（1）打开themes/default/css/ueditor.css,在原样式下修改

以撤销功能按钮为例，行号大约535处，将如下样式修改成目标样式。

修改前：

.edui-default .edui-for-undo .edui-icon {
    background-position: -160px 0;
 }

修改后：

.edui-default .edui-for-undo .edui-icon {
    /*background-position: -160px 0;*/
    background-image: url("../images/customicons/ne_toolsicon2.png") !important;
    background-repeat: no-repeat;
}

 

（2）按钮样式默认显示为B（加粗）的问题解决

.edui-default .edui-for-customimage .edui-icon {

}

添加自定义按钮customimage默认为B（加粗）样式，路径下themes/default/images/icons.png有一张图片，打开此图就会明白，工具栏所有按钮图标均在此图中。每个按钮通过偏移量来定位按钮图标，增加新的按钮建议通过 background-image 属性定义样式。

添加了background-image属性发现有些情况下还是有问题，可以在background-image 属性添加 !important 来解决图标无效果，仍旧显示B（加粗）图标样式的问题。

三、其他一些样式微调

1.修改图标间距

.edui-default .edui-toolbar .edui-combox {
    margin: 1px;/*图标间距不满意可以调整 */
}

2.修改正文与工具栏的距离

 ue.addListener("ready", function () {
        $("#ueditor_0").contents().find("body").css({ "padding-top": "5px" });//正文与工具栏间距
    })

其中ue为实例化出来的UEditor变量

总结

本文简单介绍了通过更改UEditor源码来增加或修改功能按钮图标样式及编辑器一些样式微调的方法，有疏漏之处或有更好方法者，请不吝赐教。