常用功能开关如下:
,elementPathEnabled : false  //是否启用元素路径,默认是true显示
,wordCount:false          //是否开启字数统计
,autoHeightEnabled:false  // 编辑器内容,是否自动长高,默认true
,fullscreen : false //是否开启初始化时即全屏,默认关闭
//,zIndex : 900     //编辑器层级的基数,默认是900(一般不要开启,会对项目层级有影响)
  • UEditor 的配置项分为两类:前端配置项 和 后端配置项

后端配置项具体看这个文档L:后端配置项说明open in new window

  • 如何通过设置前端配置项,定制编辑器的特性,配置方法主要通过修改ueditor.config.js,另外在编辑器实例化的时候也可以传入配置参数
var ue = UE.getEditor('container', {
    toolbars: [
        ['fullscreen', 'source', 'undo', 'redo', 'bold']
    ],
    autoHeightEnabled: true,
    autoFloatEnabled: true
});

读取配置项

读取配置项可以通过getOpt方法读取

var lang = ue.getOpt('lang'); //默认返回:zh-cn

前端配置项说明

以下的"URL"是ueditor.config.js文件所在目录

  • UEDITOR_HOME_URL {Path String} [默认值:根据config文件路径自动获取] // 为编辑器实例添加一个路径,这个不能被注释

  • serverUrl {Path String} [默认值:URL + "php/controller.php"] // 服务器统一请求接口路径

  • toolbars {2d Array} //工具栏上的所有的功能按钮和下拉框,可以在new编辑器的实例时选择自己需要的从新定义

  • labelMap {Object} [默认:从lang包的labelMap项获取] //参数格式是键值对,键名对应toolbar参数的项:{"bold": "加粗"} ],当鼠标放在工具栏上时显示的tooltip提示,留空支持自动多语言配置,否则以配置值为准

  • lang {String} [默认值:"zh-cn"] //lang值也可以通过自动获取 (navigator.language||navigator.browserLanguage ||navigator.userLanguage).toLowerCase(),语言配置项,默认是zh-cn。有需要的话也可以使用如下这样的方式来自动多语言切换,当然,前提条件是lang文件夹下存在对应的语言文件:

  • langPath {Path String} [默认值:URL +"lang/"] //语言包文件存放目录

  • theme {String} [默认值:'default'] //主题配置项,默认是default。有需要的话也可以使用如下这样的方式来自动多主题切换,当然,前提条件是themes文件夹下存在对应的主题文件:

  • themePath {Path String} [默认值:URL +"themes/"] //现有如下皮肤:default

  • zIndex {Number} [默认值:900] //编辑器在页面上的z-index层级的基数,默认是900

  • charset {String} [默认值:"utf-8"] //针对getAllHtml方法,会在对应的head标签中增加该编码设置。

  • customDomain {Boolean} [默认值:false] //若实例化编辑器的页面手动修改的domain,此处需要设置为true

  • isShow {Boolean} [默认值:true] //默认显示编辑器

  • textarea {String} [默认值:'editorValue'] // 提交表单时,服务器获取编辑器提交内容的所用的参数,多实例时可以给容器name属性,会将name给定的值最为每个实例的键值,不用每次实例化的时候都设置这个值

  • initialContent {String} [默认值:'欢迎使用ueditor!'] //初始化编辑器的内容,也可以通过textarea/script给值,看官网例子

  • autoClearinitialContent {Boolean} [默认值:true] //是否自动清除编辑器初始内容,注意:如果focus属性设置为true,这个也为真,那么编辑器一上来就会触发导致初始化的内容看不到了

  • focus {Boolean} [默认值:false] //初始化时,是否让编辑器获得焦点true或false

  • initialStyle {String} [默认值:'p{line-height:1em}']//编辑器层级的基数,可以用来改变字体等 //如果自定义,最好给p标签如下的行高,要不输入中文时,会有跳动感

  • iframeCssUrl {Path String} [默认值:URL + '/themes/iframe.css'] //给编辑器内部引入一个css文件

  • indentValue {String} [默认值:'2em'] //首行缩进距离,默认是2em

  • initialFrameWidth {Number} [默认值:1000] //初始化编辑器宽度,默认1000

  • initialFrameHeight {Number} [默认值:320] //初始化编辑器高度,默认320

  • readonly {Boolean} [默认值:false] //编辑器初始化结束后,编辑区域是否是只读的,默认是false

  • autoClearEmptyNode {Boolean} [默认值:true] //getContent时,是否删除空的inlineElement节点(包括嵌套的情况)

  • enableAutoSave {Boolean} [默认值:true] //启用自动保存

  • saveInterval {Number} [默认值:500] //自动保存间隔时间,单位ms

  • imageScaleEnabled {Boolean} [默认值:true] //启用图片拉伸缩放

  • fullscreen {Boolean} [默认值:false] //是否开启初始化时即全屏,默认关闭

  • imagePopup {Boolean} [默认值:true] //图片操作的浮层开关,默认打开

  • autoSyncData {Boolean} [默认值:true] //自动同步编辑器要提交的数据

  • emotionLocalization {Boolean} [默认值:false] //是否开启表情本地化,默认关闭。若要开启请确保emotion文件夹下包含官网提供的images表情文件夹

  • retainOnlyLabelPasted {Boolean} [默认值:false] //粘贴只保留标签,去除标签所有属性

  • pasteplain {Boolean} [默认值:false] //是否默认为纯文本粘贴。false为不使用纯文本粘贴,true为使用纯文本粘贴

  • filterTxtRules {Object} //纯文本粘贴模式下的过滤规则

    //默认值:
    function() {
        function transP(node) {
            node.tagName = 'p';
            node.setStyle();
        }
        return {
            //直接删除及其字节点内容
            '-': 'script style object iframe embed input select',
            'p': {
                $: {}
            },
            'br': {
                $: {}
            },
            'div': {
                '$': {}
            },
            'li': {
                '$': {}
            },
            'caption': transP,
            'th': transP,
            'tr': transP,
            'h1': transP,
            'h2': transP,
            'h3': transP,
            'h4': transP,
            'h5': transP,
            'h6': transP,
            'td': function(node) {
                //没有内容的td直接删掉
                var txt = !! node.innerText();
                if (txt) {
                    node.parentNode.insertAfter(UE.uNode.createText('    '), node);
                }
                node.parentNode.removeChild(node, node.innerText())
            }
        }
    }()
    
  • allHtmlEnabled [默认值:false] //提交到后台的数据是否包含整个html字符串

  • insertorderedlist //有序列表的下拉配置,值留空时支持多语言自动识别,若配置值,则以此值为准

    //默认值:
    {
    //自定的样式
    'num': '1,2,3...',
    'num1': '1),2),3)...',
    'num2': '(1),(2),(3)...',
    'cn': '一,二,三....',
    'cn1': '一),二),三)....',
    'cn2': '(一),(二),(三)....',
    //系统自带
    'decimal': '' , '1,2,3...'
    'lower-alpha': '' , // 'a,b,c...'
    'lower-roman': '' , //'i,ii,iii...'
    'upper-alpha': '' , //'A,B,C'
    'upper-roman': '' //'I,II,III...'
    }
    
  • insertunorderedlist //无序列表的下拉配置,值留空时支持多语言自动识别,若配置值,则以此值为准

    { //自定的样式
        'dash': '— 破折号', //-破折号
        'dot': ' 。 小圆圈', //系统自带
        'circle': '', // '○ 小圆圈'
        'disc': '', // '● 小圆点'
        'square': '' //'■ 小方块'
    }]
    

    `

  • listDefaultPaddingLeft [默认值:'30'//默认的左边缩进的基数倍

  • listiconpath [默认值:'http://bs.baidu.com/listicon/']//自定义标号的路径

  • maxListLevel [默认值:3] //限制可以tab的级数, 设置-1为不限制

  • autoTransWordToList [默认值:false] //禁止word中粘贴进来的列表自动变成列表标签

  • fontfamily //字体设置 label留空支持多语言自动切换,若配置,则以配置值为准

    //默认值:
    [{
        label: '',
        name: 'songti',
        val: '宋体,SimSun'
    }, {
        label: '',
        name: 'kaiti',
        val: '楷体,楷体_GB2312, SimKai'
    }, {
        label: '',
        name: 'yahei',
        val: '微软雅黑,Microsoft YaHei'
    }, {
        label: '',
        name: 'heiti',
        val: '黑体, SimHei'
    }, {
        label: '',
        name: 'lishu',
        val: '隶书, SimLi'
    }, {
        label: '',
        name: 'andaleMono',
        val: 'andale mono'
    }, {
        label: '',
        name: 'arial',
        val: 'arial, helvetica,sans-serif'
    }, {
        label: '',
        name: 'arialBlack',
        val: 'arial black,avant garde'
    }, {
        label: '',
        name: 'comicSansMs',
        val: 'comic sans ms'
    }, {
        label: '',
        name: 'impact',
        val: 'impact,chicago'
    }, {
        label: '',
        name: 'timesNewRoman',
        val: 'times new roman'
    }]
    
  • fontsize {Array} //字号

    //默认值:
    [10, 11, 12, 14, 16, 18, 20, 24, 36]
    
  • paragraph {Object} //段落格式 值留空时支持多语言自动识别,若配置,则以配置值为准

    //默认值:
    {
        'p': '',
        'h1': '',
        'h2': '',
        'h3': '',
        'h4': '',
        'h5': '',
        'h6': ''
    }
    
  • rowspacingtop {Array} //段间距 值和显示的名字相同

    //默认值:
    ['5', '10', '15', '20', '25']
    
  • rowspacingbottom //段间距 值和显示的名字相同

    //默认值:
    ['5', '10', '15', '20', '25']
    
  • lineheight [默认值:['1', '1.5','1.75','2', '3', '4', '5'] ] //行内间距 值和显示的名字相同

  • customstyle [Array] //自定义样式,不支持国际化,此处配置值即可最后显示值block的元素是依据设置段落的逻辑设置的,inline的元素依据BIU的逻辑设置,尽量使用一些常用的标签

    //默认值:
    [{
            tag: 'h1', //tag 使用的标签名字
            name: 'tc', //
            label: '', //label 显示的名字也是用来标识不同类型的标识符,注意这个值每个要不同
            style: 'border-bottom:#ccc 2px solid;padding:0 4px 0 0;text-align:center;margin:0 0 20px 0;' //style 添加的样式
        }, //每一个对象就是一个自定义的样式
        {
            tag: 'h1',
            name: 'tl',
            label: '',
            style: 'border-bottom:#ccc 2px solid;padding:0 4px 0 0;margin:0 0 10px 0;'
        }, {
            tag: 'span',
            name: 'im',
            label: '',
            style: 'font-style:italic;font-weight:bold'
        }, {
            tag: 'span',
            name: 'hi',
            label: '',
            style: 'font-style:italic;font-weight:bold;color:rgb(51, 153, 204)'
        }
    ]
    
  • enableContextMenu {Boolean} [默认值:true] //打开右键菜单功能

  • contextMenu {Object} //右键菜单的内容,可以参考plugins/contextmenu.js里边的默认菜单的例子,label留空支持国际化,否则以此配置为准

    //默认值:
    [{
        label: '', //显示的名称
        cmdName: 'selectall', //执行的command命令,当点击这个右键菜单时
        exec: function() { //exec可选,有了exec就会在点击时执行这个function,优先级高于cmdName
            //this是当前编辑器的实例
            //this.ui._dialogs['inserttableDialog'].open();
        }
    }]
    
  • shortcutMenu {Array} //快捷菜单

    //默认值
    ["fontfamily", "fontsize", "bold", "italic", "underline", "forecolor", "backcolor", "insertorderedlist", "insertunorderedlist"]
    
  • elementPathEnabled {Boolean} [默认值:true] //是否启用元素路径,默认是显示

  • wordCount {Boolean} [默认值:true] //是否开启字数统计

  • maximumWords {Number} [默认值:10000] //允许的最大字符数

  • wordCountMsg

    {String} [默认值:] //当前已输入 {#count} 个字符,您还可以输入{#leave} 个字符,字数统计提示,{#count}代表当前字数,{#leave}代表还可以输入多少字符数,留空支持多语言自动切换,否则按此配置显示

    \\默认值:
    '当前已输入{#count}个字符, 您还可以输入{#leave}个字符。 '
    
  • wordOverFlowMsg {String} [默认值:] //超出字数限制提示 留空支持多语言自动切换,否则按此配置显示

    \\默认值:
    '<span style="color:red;">你输入的字符个数已经超出最大允许值,服务器可能会拒绝保存!</span>'
    
  • tabSize {Number} [默认值:4] //点击tab键时移动的距离,tabSize倍数,tabNode什么字符做为单位

  • tabNode {String} [默认值:' ']

  • removeFormatTags //清除格式时可以删除的标签和属性

    //默认值:
    'b,big,code,del,dfn,em,font,i,ins,kbd,q,samp,small,span,strike,strong,sub,sup,tt,u,var'
    
  • removeFormatAttributes [默认值:'class,style,lang,width,height,align,hspace,valign'

  • maxUndoCount {Number} [默认值:20] //undo操作,可以最多回退的次数,默认20

  • maxInputCount {Number} [默认值:1] //undo操作,当输入的字符数超过该值时,保存一次现场

  • autoHeightEnabled {Boolean} [默认值:true] //是否自动长高,默认true

  • scaleEnabled {Boolean} [默认值:false] //是否可以拉伸长高,默认true(当开启时,自动长高失效)

  • minFrameWidth {Number} [默认值:800] //编辑器拖动时最小宽度,默认800

  • minFrameHeight {Number} [默认值:220] //编辑器拖动时最小高度,默认220

  • autoFloatEnabled [默认值:true] //是否保持toolbar的位置不动,默认true

  • topOffset [默认值:30] //浮动时工具栏距离浏览器顶部的高度,用于某些具有固定头部的页面

  • toolbarTopOffset [默认值:400] //编辑器底部距离工具栏高度(如果参数大于等于编辑器高度,则设置无效)

  • pageBreakTag [默认值:'ueditorpagebreaktag*'] //分页标识符,默认是ueditorpagebreaktag*

  • autotypeset {Object} //自动排版参数 默认值:

    {
        mergeEmptyline: true, //合并空行
        removeClass: true, //去掉冗余的class
        removeEmptyline: false, //去掉空行
        textAlign: "left", //段落的排版方式,可以是 left,right,center,justify 去掉这个属性表示不执行排版
        imageBlockLine: 'center', //图片的浮动方式,独占一行剧中,左右浮动,默认: center,left,right,none 去掉这个属性表示不执行排版
        pasteFilter: false, //根据规则过滤没事粘贴进来的内容
        clearFontSize: false, //去掉所有的内嵌字号,使用编辑器默认的字号
        clearFontFamily: false, //去掉所有的内嵌字体,使用编辑器默认的字体
        removeEmptyNode: false, // 去掉空节点
        //可以去掉的标签
        removeTagNames: {标签名字: 1
        },
        indent: false, // 行首缩进
        indentValue: '2em', //行首缩进的大小
        bdc2sb: false,
        tobdc: false
    }
    
  • tableDragable {Boolean} [默认值:true] //表格是否可以拖拽

  • disabledTableInTable {Boolean} [默认值:true] //禁止表格嵌套

  • sourceEditor {String} [默认值:"codemirror"] //源码的查看方式,codemirror是代码高亮,textarea是文本框,默认是codemirror,注意默认codemirror只能在ie8+和非ie中使用

  • codeMirrorJsUrl {Path String} [默认值:URL + "third-party/codemirror/codemirror.js"] //如果sourceEditor是codemirror需要配置这项,codeMirror js加载的路径

  • codeMirrorCssUrl {Path String} [默认值:URL + "third-party/codemirror/codemirror.css"] //如果sourceEditor是codemirror需要配置这项,codeMirror css加载的路径

  • sourceEditorFirst {String} [默认值:false] //编辑器初始化完成后是否进入源码模式,默认为否。

  • iframeUrlMap {Object} //dialog内容的路径 ~会被替换成URL,垓属性一旦打开,将覆盖所有的dialog的默认路径

    //默认值:
    {
        'anchor': '~/dialogs/anchor/anchor.html',
    }
    
  • allowDivTransToP {Boolean} 默认会将外部进入的html数据中的Div标签转换成P标签,外部进入的数据包括粘贴和调用setContent接口进入编辑器的数据。如果设置成false将不在做这个转换。