ueditor.config.js 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474
  1. /**
  2. * ueditor完整配置项
  3. * 可以在这里配置整个编辑器的特性
  4. */
  5. /** ************************提示********************************
  6. * 所有被注释的配置项均为UEditor默认值。
  7. * 修改默认配置请首先确保已经完全明确该参数的真实用途。
  8. * 主要有两种修改方案,一种是取消此处注释,然后修改成对应参数;另一种是在实例化编辑器时传入对应参数。
  9. * 当升级编辑器时,可直接使用旧版配置文件替换新版配置文件,不用担心旧版配置文件中因缺少新功能所需的参数而导致脚本报错。
  10. **************************提示********************************/
  11. (function () {
  12. /**
  13. * 编辑器资源文件根路径。它所表示的含义是:以编辑器实例化页面为当前路径,指向编辑器资源文件(即dialog等文件夹)的路径。
  14. * 鉴于很多同学在使用编辑器的时候出现的种种路径问题,此处强烈建议大家使用"相对于网站根目录的相对路径"进行配置。
  15. * "相对于网站根目录的相对路径"也就是以斜杠开头的形如"/myProject/ueditor/"这样的路径。
  16. * 如果站点中有多个不在同一层级的页面需要实例化编辑器,且引用了同一UEditor的时候,此处的URL可能不适用于每个页面的编辑器。
  17. * 因此,UEditor提供了针对不同页面的编辑器可单独配置的根路径,具体来说,在需要实例化编辑器的页面最顶部写上如下代码即可。当然,需要令此处的URL等于对应的配置。
  18. * window.UEDITOR_HOME_URL = "/xxxx/xxxx/";
  19. */
  20. window.UEDITOR_HOME_URL = '/UEditor/';
  21. var URL = window.UEDITOR_HOME_URL || getUEBasePath();
  22. /**
  23. * 配置项主体。注意,此处所有涉及到路径的配置别遗漏URL变量。
  24. */
  25. window.UEDITOR_CONFIG = {
  26. // 为编辑器实例添加一个路径,这个不能被注释
  27. UEDITOR_HOME_URL: URL,
  28. // 服务器统一请求接口路径
  29. serverUrl: URL + 'php/controller.php',
  30. // 工具栏上的所有的功能按钮和下拉框,可以在new编辑器的实例时选择自己需要的重新定义
  31. toolbars: [[
  32. 'previewmobile', 'source', '|', 'undo', 'redo', '|',
  33. 'bold', 'italic', 'underline', 'strikethrough', '|', 'superscript', 'subscript', '|', 'forecolor', 'backcolor', '|',
  34. 'removeformat', '|', 'insertorderedlist', 'insertunorderedlist', '|', 'selectall', 'cleardoc', 'paragraph', '|',
  35. 'fontfamily', 'fontsize', '|', 'justifyleft', 'justifycenter', 'justifyright', 'justifyjustify', '|',
  36. '|', 'horizontal', 'print', 'drafts', 'formula'
  37. // 'preview',
  38. ]],
  39. // 当鼠标放在工具栏上时显示的tooltip提示,留空支持自动多语言配置,否则以配置值为准
  40. labelMap:{
  41. 'previewmobile':'手机预览'
  42. },
  43. // 语言配置项,默认是zh-cn。有需要的话也可以使用如下这样的方式来自动多语言切换,当然,前提条件是lang文件夹下存在对应的语言文件:
  44. // lang值也可以通过自动获取 (navigator.language||navigator.browserLanguage ||navigator.userLanguage).toLowerCase()
  45. //, lang:"zh-cn"
  46. //, langPath:URL +"lang/"
  47. // 主题配置项,默认是default。有需要的话也可以使用如下这样的方式来自动多主题切换,当然,前提条件是themes文件夹下存在对应的主题文件:
  48. // 现有如下皮肤:default
  49. //, theme:'default'
  50. //, themePath:URL +"themes/"
  51. //, zIndex : 900 //编辑器层级的基数,默认是900
  52. // 针对getAllHtml方法,会在对应的head标签中增加该编码设置。
  53. //, charset:"utf-8"
  54. // 若实例化编辑器的页面手动修改的domain,此处需要设置为true
  55. //, customDomain:false
  56. // 常用配置项目
  57. //, isShow : true //默认显示编辑器
  58. //, textarea:'editorValue' // 提交表单时,服务器获取编辑器提交内容的所用的参数,多实例时可以给容器name属性,会将name给定的值最为每个实例的键值,不用每次实例化的时候都设置这个值
  59. //, initialContent:'欢迎使用ueditor!' //初始化编辑器的内容,也可以通过textarea/script给值,看官网例子
  60. //, autoClearinitialContent:true //是否自动清除编辑器初始内容,注意:如果focus属性设置为true,这个也为真,那么编辑器一上来就会触发导致初始化的内容看不到了
  61. //, focus:false //初始化时,是否让编辑器获得焦点true或false
  62. // 如果自定义,最好给p标签如下的行高,要不输入中文时,会有跳动感
  63. //, initialStyle:'p{line-height:1em}'//编辑器层级的基数,可以用来改变字体等
  64. //, iframeCssUrl: URL + '/themes/iframe.css' //给编辑区域的iframe引入一个css文件
  65. // indentValue
  66. // 首行缩进距离,默认是2em
  67. //, indentValue:'2em'
  68. //, initialFrameWidth:1000 //初始化编辑器宽度,默认1000
  69. //, initialFrameHeight:320 //初始化编辑器高度,默认320
  70. //, readonly : false //编辑器初始化结束后,编辑区域是否是只读的,默认是false
  71. //, autoClearEmptyNode : true //getContent时,是否删除空的inlineElement节点(包括嵌套的情况)
  72. // 启用自动保存
  73. //, enableAutoSave: true
  74. // 自动保存间隔时间, 单位ms
  75. //, saveInterval: 500
  76. //, fullscreen : false //是否开启初始化时即全屏,默认关闭
  77. //, imagePopup:true //图片操作的浮层开关,默认打开
  78. //, autoSyncData:true //自动同步编辑器要提交的数据
  79. //, emotionLocalization:false //是否开启表情本地化,默认关闭。若要开启请确保emotion文件夹下包含官网提供的images表情文件夹
  80. // 粘贴只保留标签,去除标签所有属性
  81. //, retainOnlyLabelPasted: false
  82. //, pasteplain:false //是否默认为纯文本粘贴。false为不使用纯文本粘贴,true为使用纯文本粘贴
  83. // 纯文本粘贴模式下的过滤规则
  84. // 'filterTxtRules' : function(){
  85. // function transP(node){
  86. // node.tagName = 'p';
  87. // node.setStyle();
  88. // }
  89. // return {
  90. // //直接删除及其字节点内容
  91. // '-' : 'script style object iframe embed input select',
  92. // 'p': {$:{}},
  93. // 'br':{$:{}},
  94. // 'div':{'$':{}},
  95. // 'li':{'$':{}},
  96. // 'caption':transP,
  97. // 'th':transP,
  98. // 'tr':transP,
  99. // 'h1':transP,'h2':transP,'h3':transP,'h4':transP,'h5':transP,'h6':transP,
  100. // 'td':function(node){
  101. // //没有内容的td直接删掉
  102. // var txt = !!node.innerText();
  103. // if(txt){
  104. // node.parentNode.insertAfter(UE.uNode.createText('    '),node);
  105. // }
  106. // node.parentNode.removeChild(node,node.innerText())
  107. // }
  108. // }
  109. // }()
  110. //, allHtmlEnabled:false //提交到后台的数据是否包含整个html字符串
  111. // insertorderedlist
  112. // 有序列表的下拉配置,值留空时支持多语言自动识别,若配置值,则以此值为准
  113. //, 'insertorderedlist':{
  114. // //自定的样式
  115. // 'num':'1,2,3...',
  116. // 'num1':'1),2),3)...',
  117. // 'num2':'(1),(2),(3)...',
  118. // 'cn':'一,二,三....',
  119. // 'cn1':'一),二),三)....',
  120. // 'cn2':'(一),(二),(三)....',
  121. // //系统自带
  122. // 'decimal' : '' , //'1,2,3...'
  123. // 'lower-alpha' : '' , // 'a,b,c...'
  124. // 'lower-roman' : '' , //'i,ii,iii...'
  125. // 'upper-alpha' : '' , lang //'A,B,C'
  126. // 'upper-roman' : '' //'I,II,III...'
  127. // }
  128. // insertunorderedlist
  129. // 无序列表的下拉配置,值留空时支持多语言自动识别,若配置值,则以此值为准
  130. //, insertunorderedlist : { //自定的样式
  131. // 'dash' :'— 破折号', //-破折号
  132. // 'dot':' 。 小圆圈', //系统自带
  133. // 'circle' : '', // '○ 小圆圈'
  134. // 'disc' : '', // '● 小圆点'
  135. // 'square' : '' //'■ 小方块'
  136. // }
  137. //, listDefaultPaddingLeft : '30'//默认的左边缩进的基数倍
  138. //, listiconpath : 'http://bs.baidu.com/listicon/'//自定义标号的路径
  139. //, maxListLevel : 3 //限制可以tab的级数, 设置-1为不限制
  140. //, autoTransWordToList:false //禁止word中粘贴进来的列表自动变成列表标签
  141. // fontfamily
  142. // 字体设置 label留空支持多语言自动切换,若配置,则以配置值为准
  143. //, 'fontfamily':[
  144. // { label:'',name:'songti',val:'宋体,SimSun'},
  145. // { label:'',name:'kaiti',val:'楷体,楷体_GB2312, SimKai'},
  146. // { label:'',name:'yahei',val:'微软雅黑,Microsoft YaHei'},
  147. // { label:'',name:'heiti',val:'黑体, SimHei'},
  148. // { label:'',name:'lishu',val:'隶书, SimLi'},
  149. // { label:'',name:'andaleMono',val:'andale mono'},
  150. // { label:'',name:'arial',val:'arial, helvetica,sans-serif'},
  151. // { label:'',name:'arialBlack',val:'arial black,avant garde'},
  152. // { label:'',name:'comicSansMs',val:'comic sans ms'},
  153. // { label:'',name:'impact',val:'impact,chicago'},
  154. // { label:'',name:'timesNewRoman',val:'times new roman'}
  155. // ]
  156. // fontsize
  157. // 字号
  158. //, 'fontsize':[10, 11, 12, 14, 16, 18, 20, 24, 36]
  159. // paragraph
  160. // 段落格式 值留空时支持多语言自动识别,若配置,则以配置值为准
  161. //, 'paragraph':{'p':'', 'h1':'', 'h2':'', 'h3':'', 'h4':'', 'h5':'', 'h6':''}
  162. // rowspacingtop
  163. // 段间距 值和显示的名字相同
  164. //, 'rowspacingtop':['5', '10', '15', '20', '25']
  165. // rowspacingBottom
  166. // 段间距 值和显示的名字相同
  167. //, 'rowspacingbottom':['5', '10', '15', '20', '25']
  168. // lineheight
  169. // 行内间距 值和显示的名字相同
  170. //, 'lineheight':['1', '1.5','1.75','2', '3', '4', '5']
  171. // customstyle
  172. // 自定义样式,不支持国际化,此处配置值即可最后显示值
  173. // block的元素是依据设置段落的逻辑设置的,inline的元素依据BIU的逻辑设置
  174. // 尽量使用一些常用的标签
  175. // 参数说明
  176. // tag 使用的标签名字
  177. // label 显示的名字也是用来标识不同类型的标识符,注意这个值每个要不同,
  178. // style 添加的样式
  179. // 每一个对象就是一个自定义的样式
  180. //, 'customstyle':[
  181. // {tag:'h1', name:'tc', label:'', style:'border-bottom:#ccc 2px solid;padding:0 4px 0 0;text-align:center;margin:0 0 20px 0;'},
  182. // {tag:'h1', name:'tl',label:'', style:'border-bottom:#ccc 2px solid;padding:0 4px 0 0;margin:0 0 10px 0;'},
  183. // {tag:'span',name:'im', label:'', style:'font-style:italic;font-weight:bold'},
  184. // {tag:'span',name:'hi', label:'', style:'font-style:italic;font-weight:bold;color:rgb(51, 153, 204)'}
  185. // ]
  186. // 打开右键菜单功能
  187. //, enableContextMenu: true
  188. // 右键菜单的内容,可以参考plugins/contextmenu.js里边的默认菜单的例子,label留空支持国际化,否则以此配置为准
  189. //, contextMenu:[
  190. // {
  191. // label:'', //显示的名称
  192. // cmdName:'selectall',//执行的command命令,当点击这个右键菜单时
  193. // //exec可选,有了exec就会在点击时执行这个function,优先级高于cmdName
  194. // exec:function () {
  195. // //this是当前编辑器的实例
  196. // //this.ui._dialogs['inserttableDialog'].open();
  197. // }
  198. // }
  199. // ]
  200. // 快捷菜单
  201. //, shortcutMenu:["fontfamily", "fontsize", "bold", "italic", "underline", "forecolor", "backcolor", "insertorderedlist", "insertunorderedlist"]
  202. // elementPathEnabled
  203. // 是否启用元素路径,默认是显示
  204. //, elementPathEnabled : true
  205. // wordCount
  206. //, wordCount:true //是否开启字数统计
  207. //, maximumWords:10000 //允许的最大字符数
  208. // 字数统计提示,{#count}代表当前字数,{#leave}代表还可以输入多少字符数,留空支持多语言自动切换,否则按此配置显示
  209. //, wordCountMsg:'' //当前已输入 {#count} 个字符,您还可以输入{#leave} 个字符
  210. // 超出字数限制提示 留空支持多语言自动切换,否则按此配置显示
  211. //, wordOverFlowMsg:'' //<span style="color:red;">你输入的字符个数已经超出最大允许值,服务器可能会拒绝保存!</span>
  212. // tab
  213. // 点击tab键时移动的距离,tabSize倍数,tabNode什么字符做为单位
  214. //, tabSize:4
  215. //, tabNode:'&nbsp;'
  216. // removeFormat
  217. // 清除格式时可以删除的标签和属性
  218. // removeForamtTags标签
  219. //, removeFormatTags:'b,big,code,del,dfn,em,font,i,ins,kbd,q,samp,small,span,strike,strong,sub,sup,tt,u,var'
  220. // removeFormatAttributes属性
  221. //, removeFormatAttributes:'class,style,lang,width,height,align,hspace,valign'
  222. // undo
  223. // 可以最多回退的次数,默认20
  224. //, maxUndoCount:20
  225. // 当输入的字符数超过该值时,保存一次现场
  226. //, maxInputCount:1
  227. // autoHeightEnabled
  228. // 是否自动长高,默认true
  229. //, autoHeightEnabled:true
  230. // scaleEnabled
  231. // 是否可以拉伸长高,默认true(当开启时,自动长高失效)
  232. //, scaleEnabled:false
  233. //, minFrameWidth:800 //编辑器拖动时最小宽度,默认800
  234. //, minFrameHeight:220 //编辑器拖动时最小高度,默认220
  235. // autoFloatEnabled
  236. // 是否保持toolbar的位置不动,默认true
  237. //, autoFloatEnabled:true
  238. // 浮动时工具栏距离浏览器顶部的高度,用于某些具有固定头部的页面
  239. //, topOffset:30
  240. // 编辑器底部距离工具栏高度(如果参数大于等于编辑器高度,则设置无效)
  241. //, toolbarTopOffset:400
  242. // 设置远程图片是否抓取到本地保存
  243. //, catchRemoteImageEnable: true //设置是否抓取远程图片
  244. // pageBreakTag
  245. // 分页标识符,默认是_ueditor_page_break_tag_
  246. //, pageBreakTag:'_ueditor_page_break_tag_'
  247. // autotypeset
  248. // 自动排版参数
  249. //, autotypeset: {
  250. // mergeEmptyline: true, //合并空行
  251. // removeClass: true, //去掉冗余的class
  252. // removeEmptyline: false, //去掉空行
  253. // textAlign:"left", //段落的排版方式,可以是 left,right,center,justify 去掉这个属性表示不执行排版
  254. // imageBlockLine: 'center', //图片的浮动方式,独占一行剧中,左右浮动,默认: center,left,right,none 去掉这个属性表示不执行排版
  255. // pasteFilter: false, //根据规则过滤没事粘贴进来的内容
  256. // clearFontSize: false, //去掉所有的内嵌字号,使用编辑器默认的字号
  257. // clearFontFamily: false, //去掉所有的内嵌字体,使用编辑器默认的字体
  258. // removeEmptyNode: false, // 去掉空节点
  259. // //可以去掉的标签
  260. // removeTagNames: {标签名字:1},
  261. // indent: false, // 行首缩进
  262. // indentValue : '2em', //行首缩进的大小
  263. // bdc2sb: false,
  264. // tobdc: false
  265. // }
  266. // tableDragable
  267. // 表格是否可以拖拽
  268. //, tableDragable: true
  269. // sourceEditor
  270. // 源码的查看方式,codemirror 是代码高亮,textarea是文本框,默认是codemirror
  271. // 注意默认codemirror只能在ie8+和非ie中使用
  272. //, sourceEditor:"codemirror"
  273. // 如果sourceEditor是codemirror,还用配置一下两个参数
  274. // codeMirrorJsUrl js加载的路径,默认是 URL + "third-party/codemirror/codemirror.js"
  275. //, codeMirrorJsUrl:URL + "third-party/codemirror/codemirror.js"
  276. // codeMirrorCssUrl css加载的路径,默认是 URL + "third-party/codemirror/codemirror.css"
  277. //, codeMirrorCssUrl:URL + "third-party/codemirror/codemirror.css"
  278. // 编辑器初始化完成后是否进入源码模式,默认为否。
  279. //, sourceEditorFirst:false
  280. // iframeUrlMap
  281. // dialog内容的路径 ~会被替换成URL,垓属性一旦打开,将覆盖所有的dialog的默认路径
  282. //, iframeUrlMap:{
  283. // 'anchor':'~/dialogs/anchor/anchor.html',
  284. // }
  285. // allowLinkProtocol 允许的链接地址,有这些前缀的链接地址不会自动添加http
  286. //, allowLinkProtocols: ['http:', 'https:', '#', '/', 'ftp:', 'mailto:', 'tel:', 'git:', 'svn:']
  287. // webAppKey 百度应用的APIkey,每个站长必须首先去百度官网注册一个key后方能正常使用app功能,注册介绍,http://app.baidu.com/static/cms/getapikey.html
  288. //, webAppKey: ""
  289. // 默认过滤规则相关配置项目
  290. //, disabledTableInTable:true //禁止表格嵌套
  291. //, allowDivTransToP:true //允许进入编辑器的div标签自动变成p标签
  292. //, rgb2Hex:true //默认产出的数据中的color自动从rgb格式变成16进制格式
  293. // xss 过滤是否开启,inserthtml等操作
  294. xssFilterRules: true,
  295. // input xss过滤
  296. inputXssFilter: true,
  297. // output xss过滤
  298. outputXssFilter: true,
  299. // xss过滤白名单 名单来源: https://raw.githubusercontent.com/leizongmin/js-xss/master/lib/default.js
  300. whiteList: {
  301. a: ['target', 'href', 'title', 'class', 'style'],
  302. abbr: ['title', 'class', 'style'],
  303. address: ['class', 'style'],
  304. area: ['shape', 'coords', 'href', 'alt'],
  305. article: [],
  306. aside: [],
  307. audio: ['autoplay', 'controls', 'loop', 'preload', 'src', 'class', 'style'],
  308. b: ['class', 'style'],
  309. bdi: ['dir'],
  310. bdo: ['dir'],
  311. big: [],
  312. blockquote: ['cite', 'class', 'style'],
  313. br: [],
  314. caption: ['class', 'style'],
  315. center: [],
  316. cite: [],
  317. code: ['class', 'style'],
  318. col: ['align', 'valign', 'span', 'width', 'class', 'style'],
  319. colgroup: ['align', 'valign', 'span', 'width', 'class', 'style'],
  320. dd: ['class', 'style'],
  321. del: ['datetime'],
  322. details: ['open'],
  323. div: ['class', 'style'],
  324. dl: ['class', 'style'],
  325. dt: ['class', 'style'],
  326. em: ['class', 'style'],
  327. font: ['color', 'size', 'face'],
  328. footer: [],
  329. h1: ['class', 'style'],
  330. h2: ['class', 'style'],
  331. h3: ['class', 'style'],
  332. h4: ['class', 'style'],
  333. h5: ['class', 'style'],
  334. h6: ['class', 'style'],
  335. header: [],
  336. hr: [],
  337. i: ['class', 'style'],
  338. img: ['src', 'alt', 'title', 'width', 'height', 'id', '_src', 'loadingclass', 'class', 'data-latex'],
  339. ins: ['datetime'],
  340. li: ['class', 'style'],
  341. mark: [],
  342. nav: [],
  343. ol: ['class', 'style'],
  344. p: ['class', 'style'],
  345. pre: ['class', 'style'],
  346. s: [],
  347. section: [],
  348. small: [],
  349. span: ['class', 'style'],
  350. sub: ['class', 'style'],
  351. sup: ['class', 'style'],
  352. strong: ['class', 'style'],
  353. table: ['width', 'border', 'align', 'valign', 'class', 'style'],
  354. tbody: ['align', 'valign', 'class', 'style'],
  355. td: ['width', 'rowspan', 'colspan', 'align', 'valign', 'class', 'style'],
  356. tfoot: ['align', 'valign', 'class', 'style'],
  357. th: ['width', 'rowspan', 'colspan', 'align', 'valign', 'class', 'style'],
  358. thead: ['align', 'valign', 'class', 'style'],
  359. tr: ['rowspan', 'align', 'valign', 'class', 'style'],
  360. tt: [],
  361. u: [],
  362. ul: ['class', 'style'],
  363. video: ['autoplay', 'controls', 'loop', 'preload', 'src', 'height', 'width', 'class', 'style']
  364. }
  365. };
  366. function getUEBasePath (docUrl, confUrl) {
  367. return getBasePath(docUrl || self.document.URL || self.location.href, confUrl || getConfigFilePath());
  368. }
  369. function getConfigFilePath () {
  370. var configPath = document.getElementsByTagName('script');
  371. return configPath[ configPath.length - 1 ].src;
  372. }
  373. function getBasePath (docUrl, confUrl) {
  374. var basePath = confUrl;
  375. if (/^(\/|\\\\)/.test(confUrl)) {
  376. basePath = /^.+?\w(\/|\\\\)/.exec(docUrl)[0] + confUrl.replace(/^(\/|\\\\)/, '');
  377. } else if (!/^[a-z]+:/i.test(confUrl)) {
  378. docUrl = docUrl.split('#')[0].split('?')[0].replace(/[^\\\/]+$/, '');
  379. basePath = docUrl + '' + confUrl;
  380. }
  381. return optimizationPath(basePath);
  382. }
  383. function optimizationPath (path) {
  384. let protocol = /^[a-z]+:\/\//.exec(path)[ 0 ],
  385. tmp = null,
  386. res = [];
  387. path = path.replace(protocol, '').split('?')[0].split('#')[0];
  388. path = path.replace(/\\/g, '/').split(/\//);
  389. path[ path.length - 1 ] = '';
  390. while (path.length) {
  391. if ((tmp = path.shift()) === '..') {
  392. res.pop();
  393. } else if (tmp !== '.') {
  394. res.push(tmp);
  395. }
  396. }
  397. return protocol + res.join('/');
  398. }
  399. window.UE = {
  400. getUEBasePath: getUEBasePath
  401. };
  402. })();