ueditor.config.js 12.7 KB
/**
 * ueditor完整配置项
 * 可以在这里配置整个编辑器的特性
 */
/**************************提示********************************
 * 所有被注释的配置项均为UEditor默认值。
 * 修改默认配置请首先确保已经完全明确该参数的真实用途。
 * 主要有两种修改方案,一种是取消此处注释,然后修改成对应参数;另一种是在实例化编辑器时传入对应参数。
 * 当升级编辑器时,可直接使用旧版配置文件替换新版配置文件,不用担心旧版配置文件中因缺少新功能所需的参数而导致脚本报错。
 **************************提示********************************/

(function () {

    /**
     * 编辑器资源文件根路径。它所表示的含义是:以编辑器实例化页面为当前路径,指向编辑器资源文件(即dialog等文件夹)的路径。
     * 鉴于很多同学在使用编辑器的时候出现的种种路径问题,此处强烈建议大家使用"相对于网站根目录的相对路径"进行配置。
     * "相对于网站根目录的相对路径"也就是以斜杠开头的形如"/myProject/ueditor/"这样的路径。
     * 如果站点中有多个不在同一层级的页面需要实例化编辑器,且引用了同一UEditor的时候,此处的URL可能不适用于每个页面的编辑器。
     * 因此,UEditor提供了针对不同页面的编辑器可单独配置的根路径,具体来说,在需要实例化编辑器的页面最顶部写上如下代码即可。当然,需要令此处的URL等于对应的配置。
     * window.UEDITOR_HOME_URL = "/xxxx/xxxx/";
     */
    var URL = window.UEDITOR_HOME_URL || getUEBasePath();

    /**
     * 配置项主体。注意,此处所有涉及到路径的配置别遗漏URL变量。
     */
    window.UEDITOR_CONFIG = {

        //为编辑器实例添加一个路径,这个不能被注释
        UEDITOR_HOME_URL: URL

        // 服务器统一请求接口路径
        , serverUrl: "/common/uploadUmeditor"

        //工具栏上的所有的功能按钮和下拉框,可以在new编辑器的实例时选择自己需要的从新定义
        
        , toolbars: [["bold","italic","underline","strikethrough","justifyleft","justifycenter","justifyright","|","forecolor","backcolor","fontfamily","fontsize","unlink","link","emotion","simpleupload","insertimage"]]
        //当鼠标放在工具栏上时显示的tooltip提示,留空支持自动多语言配置,否则以配置值为准
        //,labelMap:{
        //    'anchor':'', 'undo':''
        //}

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

        //主题配置项,默认是default。有需要的话也可以使用如下这样的方式来自动多主题切换,当然,前提条件是themes文件夹下存在对应的主题文件:
        //现有如下皮肤:default
        //,theme:'default'
        //,themePath:URL +"themes/"

        //,zIndex : 900     //编辑器层级的基数,默认是900

        //针对getAllHtml方法,会在对应的head标签中增加该编码设置。
        //,charset:"utf-8"

        //若实例化编辑器的页面手动修改的domain,此处需要设置为true
        //,customDomain:false

        //常用配置项目
        //,isShow : true    //默认显示编辑器

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

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

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

        //,focus:false //初始化时,是否让编辑器获得焦点true或false

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

        //,iframeCssUrl: URL + '/themes/iframe.css' //给编辑器内部引入一个css文件

        //,initialFrameWidth:1000  //初始化编辑器宽度,默认1000
        ,initialFrameHeight:480  //初始化编辑器高度,默认320

        //,readonly : false //编辑器初始化结束后,编辑区域是否是只读的,默认是false

        //,autoClearEmptyNode : true //getContent时,是否删除空的inlineElement节点(包括嵌套的情况)

        //,imagePopup:false      //图片操作的浮层开关,默认打开

        //,autoSyncData:true //自动同步编辑器要提交的数据

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

        //粘贴只保留标签,去除标签所有属性
        //,retainOnlyLabelPasted: false

        ,pasteplain:true  //是否默认为纯文本粘贴。false为不使用纯文本粘贴,true为使用纯文本粘贴


        //,allHtmlEnabled:false //提交到后台的数据是否包含整个html字符串

        //,autoTransWordToList:false  //禁止word中粘贴进来的列表自动变成列表标签

        //fontfamily
        //字体设置 label留空支持多语言自动切换,若配置,则以配置值为准
        ,'fontfamily':[
            { 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
        //字号
        ,'fontsize':[10, 11, 12, 14, 16, 18, 20, 24, 36]

        //快捷菜单
        ,shortcutMenu:["fontfamily", "fontsize", "bold", "italic", "underline", "forecolor", "backcolor", "insertorderedlist", "insertunorderedlist"]

        //elementPathEnabled
        //是否启用元素路径,默认是显示
        ,elementPathEnabled : false

        //wordCount
        ,wordCount:false          //是否开启字数统计
        //,maximumWords:10000       //允许的最大字符数
        //字数统计提示,{#count}代表当前字数,{#leave}代表还可以输入多少字符数,留空支持多语言自动切换,否则按此配置显示
        //,wordCountMsg:''   //当前已输入 {#count} 个字符,您还可以输入{#leave} 个字符
        //超出字数限制提示  留空支持多语言自动切换,否则按此配置显示
        //,wordOverFlowMsg:''    //<span style="color:red;">你输入的字符个数已经超出最大允许值,服务器可能会拒绝保存!</span>

        //tab
        //点击tab键时移动的距离,tabSize倍数,tabNode什么字符做为单位
        //,tabSize:4
        //,tabNode:'&nbsp;'

        //scaleEnabled
        //是否可以拉伸长高,默认true(当开启时,自动长高失效)
        //,scaleEnabled:false
        //,minFrameWidth:800    //编辑器拖动时最小宽度,默认800
        //,minFrameHeight:220  //编辑器拖动时最小高度,默认220

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

        //填写过滤规则
        //, filterRules: {
        //    p: {$: {}},
        //    div: function (node) {
        //        node.tagName = 'p';
        //        node.setAttr();
        //    },
        //    //$:{}表示不保留任何属性
        //    br: {$: {}},
        //    a: function (node) {
        //        node.tagName = 'span';
        //        node.setAttr();
        //    },
        //    span: {$: {}},
        //    strong: {$: {}},
        //    b: {$: {}},
        //    i: {$: {}},
        //    em: {$: {}},
        //    img: function (node) {
        //        node.parentNode.removeChild(node);
        //    },
        //    ol: {$: {}},
        //    ul: {$: {}},
        //    dl: {$: {}},
        //    dt: {$: {}},
        //    dd: {$: {}},
        //    li: {$: {}},
        //    table: {$: {}},
        //    tbody: {$: {}},
        //    caption: {$: {}},
        //    th: {$: {}},
        //    td: {$: {valign: 1, align: 1, rowspan: 1, colspan: 1, width: 1, height: 1}},
        //    tr: {$: {valign: 1, align: 1, rowspan: 1, colspan: 1, width: 1, height: 1}},
        //    h3: {$: {}},
        //    h2: {$: {}},
        //    //黑名单,以下标签及其子节点都会被过滤掉
        //    '-': 'script style meta iframe embed object'
        //}

        ////纯文本粘贴模式下的过滤规则
        , 'filterTxtRules'
    :
    function () {
        function transP(node) {
            node.tagName = 'p';
            node.setStyle();
            node.setAttr();
        }

        function transSPan(node) {
            node.tagName = 'span';
            node.setStyle();
            node.setAttr();
        }

        return {
            p: {$: {}},
            div: transP,
            //$:{}表示不保留任何属性
            br: {$: {}},
            a: transSPan,
            span: {$: {}},
            strong: {$: {}},
            b: {$: {}},
            i: {$: {}},
            em: {$: {}},
            img: function (node) {
                node.parentNode.removeChild(node);
            },
            ol: {$: {}},
            ul: {$: {}},
            dl: {$: {}},
            dt: {$: {}},
            dd: {$: {}},
            li: {$: {}},
            table: {$: {}},
            tbody: {$: {}},
            th: {$: {}},
            td: {$: {valign: 1, align: 1, rowspan: 1, colspan: 1, width: 1, height: 1}},
            tr: {$: {valign: 1, align: 1, rowspan: 1, colspan: 1, width: 1, height: 1}},
            'h1': transP, 'h2': transP, 'h3': transP, 'h4': transP, 'h5': transP, 'h6': transP,
            'caption': transP,
            //'th': transP,
            //'tr': transP,
            //'td': function (node) {
            //    //没有内容的td直接删掉
            //    var txt = !!node.innerText();
            //    if (txt) {
            //        node.parentNode.insertAfter(UE.uNode.createText(' &nbsp; &nbsp;'), node);
            //    }
            //    node.parentNode.removeChild(node, node.innerText())
            //},
            //黑名单,以下标签及其子节点都会被过滤掉
            '-': 'script style meta iframe embed object'
            //直接删除及其字节点内容
        }

    }()
    };

    function getUEBasePath(docUrl, confUrl) {

        return getBasePath(docUrl || self.document.URL || self.location.href, confUrl || getConfigFilePath());

    }

    function getConfigFilePath() {

        var configPath = document.getElementsByTagName('script');

        return configPath[ configPath.length - 1 ].src;

    }

    function getBasePath(docUrl, confUrl) {

        var basePath = confUrl;


        if (/^(\/|\\\\)/.test(confUrl)) {

            basePath = /^.+?\w(\/|\\\\)/.exec(docUrl)[0] + confUrl.replace(/^(\/|\\\\)/, '');

        } else if (!/^[a-z]+:/i.test(confUrl)) {

            docUrl = docUrl.split("#")[0].split("?")[0].replace(/[^\\\/]+$/, '');

            basePath = docUrl + "" + confUrl;

        }

        return optimizationPath(basePath);

    }

    function optimizationPath(path) {

        var protocol = /^[a-z]+:\/\//.exec(path)[ 0 ],
            tmp = null,
            res = [];

        path = path.replace(protocol, "").split("?")[0].split("#")[0];

        path = path.replace(/\\/g, '/').split(/\//);

        path[ path.length - 1 ] = "";

        while (path.length) {

            if (( tmp = path.shift() ) === "..") {
                res.pop();
            } else if (tmp !== ".") {
                res.push(tmp);
            }

        }

        return protocol + res.join("/");

    }

    window.UE = {
        getUEBasePath: getUEBasePath
    };
    
})();