z1511676208 / lawer Goto Github PK

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

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

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

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

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

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

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

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

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

9.zIndex {Number} [默认值：900] //编辑器在页面上的z-index层级的基数，默认是900

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

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

12.isShow {Boolean} [默认值：true] //默认显示编辑器

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

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

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

16.focus {Boolean} [默认值：false] //初始化时，是否让编辑器获得焦点true或false

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

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

19.indentValue {String} [默认值：'2em'] //首行缩进距离，默认是2em

20.initialFrameWidth {Number} [默认值：1000] //初始化编辑器宽度，默认1000

21.initialFrameHeight {Number} [默认值：320] //初始化编辑器高度，默认320

22.readonly {Boolean} [默认值：false] //编辑器初始化结束后，编辑区域是否是只读的，默认是false

23.autoClearEmptyNode {Boolean} [默认值：true] //getContent时，是否删除空的inlineElement节点（包括嵌套的情况）

24.enableAutoSave {Boolean} [默认值：true] //启用自动保存

25.saveInterval {Number} [默认值：500] //自动保存间隔时间，单位ms

26.imageScaleEnabled {Boolean} [默认值：true] //启用图片拉伸缩放

27.fullscreen {Boolean} [默认值：false] //是否开启初始化时即全屏，默认关闭

28.imagePopup {Boolean} [默认值：true] //图片操作的浮层开关，默认打开

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

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

31.retainOnlyLabelPasted {Boolean} [默认值：false] //粘贴只保留标签，去除标签所有属性

32.pasteplain {Boolean} [默认值：false] //是否默认为纯文本粘贴。false为不使用纯文本粘贴，true为使用纯文本粘贴

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

### 完整的按钮列表
toolbars: [
[
'anchor', //锚点
'undo', //撤销
'redo', //重做
'bold', //加粗
'indent', //首行缩进
'snapscreen', //截图
'italic', //斜体
'underline', //下划线
'strikethrough', //删除线
'subscript', //下标
'fontborder', //字符边框
'superscript', //上标
'formatmatch', //格式刷
'source', //源代码
'blockquote', //引用
'pasteplain', //纯文本粘贴模式
'selectall', //全选
'print', //打印
'preview', //预览
'horizontal', //分隔线
'removeformat', //清除格式
'time', //时间
'date', //日期
'unlink', //取消链接
'insertrow', //前插入行
'insertcol', //前插入列
'mergeright', //右合并单元格
'mergedown', //下合并单元格
'deleterow', //删除行
'deletecol', //删除列
'splittorows', //拆分成行
'splittocols', //拆分成列
'splittocells', //完全拆分单元格
'deletecaption', //删除表格标题
'inserttitle', //插入标题
'mergecells', //合并多个单元格
'deletetable', //删除表格
'cleardoc', //清空文档
'insertparagraphbeforetable', //"表格前插入行"
'insertcode', //代码语言
'fontfamily', //字体
'fontsize', //字号
'paragraph', //段落格式
'simpleupload', //单图上传
'insertimage', //多图上传
'edittable', //表格属性
'edittd', //单元格属性
'link', //超链接
'emotion', //表情
'spechars', //特殊字符
'searchreplace', //查询替换
'map', //Baidu地图
'gmap', //Google地图
'insertvideo', //视频
'help', //帮助
'justifyleft', //居左对齐
'justifyright', //居右对齐
'justifycenter', //居中对齐
'justifyjustify', //两端对齐
'forecolor', //字体颜色
'backcolor', //背景色
'insertorderedlist', //有序列表
'insertunorderedlist', //无序列表
'fullscreen', //全屏
'directionalityltr', //从左向右输入
'directionalityrtl', //从右向左输入
'rowspacingtop', //段前距
'rowspacingbottom', //段后距
'pagebreak', //分页
'insertframe', //插入Iframe
'imagenone', //默认
'imageleft', //左浮动
'imageright', //右浮动
'attachment', //附件
'imagecenter', //居中
'wordimage', //图片转存
'lineheight', //行间距
'edittip ', //编辑提示
'customstyle', //自定义标题
'autotypeset', //自动排版
'webapp', //百度应用
'touppercase', //字母大写
'tolowercase', //字母小写
'background', //背景
'template', //模板
'scrawl', //涂鸦
'music', //音乐
'inserttable', //插入表格
'drafts', // 从草稿箱加载
'charts', // 图表
]
]
具体：可参考官方文档http://fex.baidu.com/ueditor/#start-toolbar