编辑器初始化参数¶
Contents
- 编辑器初始化参数
- width
- height
- minWidth
- minHeight
- items
- noDisableItems
- filterMode
- htmlTags
- wellFormatMode
- resizeType
- themeType
- langType
- designMode
- fullscreenMode
- basePath
- themesPath
- pluginsPath
- langPath
- minChangeSize
- urlType
- newlineTag
- pasteType
- dialogAlignType
- shadowMode
- zIndex
- useContextmenu
- syncType
- indentChar
- cssPath
- cssData
- bodyClass
- colorTable
- afterCreate
- afterChange
- afterTab
- afterFocus
- afterBlur
- afterUpload
- uploadJson
- fileManagerJson
- allowPreviewEmoticons
- allowImageUpload
- allowFlashUpload
- allowMediaUpload
- allowFileUpload
- allowFileManager
- fontSizeTable
- imageTabIndex
- formatUploadUrl
- fullscreenShortcut
- extraFileUploadParams
- filePostName
- fillDescAfterUploadImage
- afterSelectFile
- pagebreakHtml
- allowImageRemote
- autoHeightMode
- fixToolBar
width¶
编辑器的宽度，可以设置px或%，比textarea输入框样式表宽度优先度高。
- 数据类型: String
- 默认值: textarea输入框的宽度
示例:
K.create('#id', {
width : '700px'
});
items¶
配置编辑器的工具栏，其中”/”表示换行，”|”表示分隔符。
- 数据类型: Array
- 默认值:
[
'source', '|', 'undo', 'redo', '|', 'preview', 'print', 'template', 'code', 'cut', 'copy', 'paste',
'plainpaste', 'wordpaste', '|', 'justifyleft', 'justifycenter', 'justifyright',
'justifyfull', 'insertorderedlist', 'insertunorderedlist', 'indent', 'outdent', 'subscript',
'superscript', 'clearhtml', 'quickformat', 'selectall', '|', 'fullscreen', '/',
'formatblock', 'fontname', 'fontsize', '|', 'forecolor', 'hilitecolor', 'bold',
'italic', 'underline', 'strikethrough', 'lineheight', 'removeformat', '|', 'image', 'multiimage',
'flash', 'media', 'insertfile', 'table', 'hr', 'emoticons', 'baidumap', 'pagebreak',
'anchor', 'link', 'unlink', '|', 'about'
]
| source | HTML代码 |
| preview | 预览 |
| undo | 后退 |
| redo | 前进 |
| cut | 剪切 |
| copy | 复制 |
| paste | 粘贴 |
| plainpaste | 粘贴为无格式文本 |
| wordpaste | 从Word粘贴 |
| selectall | 全选 |
| justifyleft | 左对齐 |
| justifycenter | 居中 |
| justifyright | 右对齐 |
| justifyfull | 两端对齐 |
| insertorderedlist | 编号 |
| insertunorderedlist | 项目符号 |
| indent | 增加缩进 |
| outdent | 减少缩进 |
| subscript | 下标 |
| superscript | 上标 |
| formatblock | 段落 |
| fontname | 字体 |
| fontsize | 文字大小 |
| forecolor | 文字颜色 |
| hilitecolor | 文字背景 |
| bold | 粗体 |
| italic | 斜体 |
| underline | 下划线 |
| strikethrough | 删除线 |
| removeformat | 删除格式 |
| image | 图片 |
| flash | Flash |
| media | 视音频 |
| table | 表格 |
| hr | 插入横线 |
| emoticons | 插入表情 |
| link | 超级链接 |
| unlink | 取消超级链接 |
| fullscreen | 全屏显示 |
| about | 关于 |
| 打印 | |
| code | 插入程序代码 |
| map | Google地图 |
| baidumap | 百度地图 |
| lineheight | 行距 |
| clearhtml | 清理HTML代码 |
| pagebreak | 插入分页符 |
| quickformat | 一键排版 |
| insertfile | 插入文件 |
| template | 插入模板 |
| anchor | 插入锚点 |
filterMode¶
true时根据 htmlTags 过滤HTML代码，false时允许输入任何代码。
- 数据类型: Boolean
- 默认值: true
Note
4.1.1版本开始默认值为true。
htmlTags¶
指定要保留的HTML标记和属性。Object的key为HTML标签名，value为HTML属性数组，”.”开始的属性表示style属性。
- 数据类型: Object
- 默认值:
{
font : ['color', 'size', 'face', '.background-color'],
span : [
'.color', '.background-color', '.font-size', '.font-family', '.background',
'.font-weight', '.font-style', '.text-decoration', '.vertical-align', '.line-height'
],
div : [
'align', '.border', '.margin', '.padding', '.text-align', '.color',
'.background-color', '.font-size', '.font-family', '.font-weight', '.background',
'.font-style', '.text-decoration', '.vertical-align', '.margin-left'
],
table: [
'border', 'cellspacing', 'cellpadding', 'width', 'height', 'align', 'bordercolor',
'.padding', '.margin', '.border', 'bgcolor', '.text-align', '.color', '.background-color',
'.font-size', '.font-family', '.font-weight', '.font-style', '.text-decoration', '.background',
'.width', '.height', '.border-collapse'
],
'td,th': [
'align', 'valign', 'width', 'height', 'colspan', 'rowspan', 'bgcolor',
'.text-align', '.color', '.background-color', '.font-size', '.font-family', '.font-weight',
'.font-style', '.text-decoration', '.vertical-align', '.background', '.border'
],
a : ['href', 'target', 'name'],
embed : ['src', 'width', 'height', 'type', 'loop', 'autostart', 'quality', '.width', '.height', 'align', 'allowscriptaccess'],
img : ['src', 'width', 'height', 'border', 'alt', 'title', 'align', '.width', '.height', '.border'],
'p,ol,ul,li,blockquote,h1,h2,h3,h4,h5,h6' : [
'align', '.text-align', '.color', '.background-color', '.font-size', '.font-family', '.background',
'.font-weight', '.font-style', '.text-decoration', '.vertical-align', '.text-indent', '.margin-left'
],
pre : ['class'],
hr : ['class', '.page-break-after'],
'br,tbody,tr,strong,b,sub,sup,em,i,u,strike,s,del' : []
}
themeType¶
指定主题风格，可设置”default”、”simple”，指定simple时需要引入simple.css。
- 数据类型: String
- 默认值: “default”
示例:
<link rel="stylesheet" href="../themes/default/default.css" />
<link rel="stylesheet" href="../themes/simple/simple.css" />
<script charset="utf-8" src="../kindeditor.js"></script>
<script charset="utf-8" src="../lang/zh-CN.js"></script>
<script>
var editor;
KindEditor.ready(function(K) {
editor = K.create('#editor_id', {
themeType : 'simple'
});
});
</script>
langType¶
指定语言，可设置”en”、”zh-CN”，需要引入lang/[langType].js。
- 数据类型: String
- 默认值: “zh-CN”
示例:
<link rel="stylesheet" href="../themes/default/default.css" />
<script charset="utf-8" src="../kindeditor.js"></script>
<script charset="utf-8" src="../lang/en.js"></script>
<script>
var editor;
KindEditor.ready(function(K) {
editor = K.create('#editor_id', {
langType : 'en'
});
});
</script>
urlType¶
改变站内本地URL，可设置”“、”relative”、”absolute”、”domain”。空为不修改URL，relative为相对路径，absolute为绝对路径，domain为带域名的绝对路径。
- 数据类型: String
- 默认值: “”
dialogAlignType¶
设置弹出框(dialog)的对齐类型，可设置”“、”page”，指定page时按当前页面居中，指定空时按编辑器居中。
- 数据类型: String
- 默认值: “page”
colorTable¶
指定取色器里的颜色。
- 数据类型: Array
- 默认值:
[
['#E53333', '#E56600', '#FF9900', '#64451D', '#DFC5A4', '#FFE500'],
['#009900', '#006600', '#99BB00', '#B8D100', '#60D978', '#00D5FF'],
['#337FE5', '#003399', '#4C33E5', '#9933E5', '#CC33E5', '#EE33EE'],
['#FFFFFF', '#CCCCCC', '#999999', '#666666', '#333333', '#000000']
]
afterUpload¶
上传文件后执行的回调函数。
- 数据类型: Function
- 默认值: 无
KindEditor.ready(function(K) {
K.create('#id', {
afterUpload : function(url) {
alert(url);
}
});
});
fontSizeTable¶
指定文字大小。
- 数据类型: Array
- 默认值:
['9px', '10px', '12px', '14px', '16px', '18px', '24px', '32px']
extraFileUploadParams¶
上传图片、Flash、视音频、文件时，支持添加别的参数一并传到服务器。
- 数据类型: Array
- 默认值: {}
KindEditor.ready(function(K) {
K.create('#id', {
extraFileUploadParams : {
item_id : 1000,
category_id : 1
}
});
});
Note
4.1.1版本开始支持。
fillDescAfterUploadImage¶
true时图片上传成功后切换到图片编辑标签，false时插入图片后关闭弹出框。
- 数据类型: Boolean
- 默认值: false
Note
4.1.2版本开始支持。
pagebreakHtml¶
可指定分页符HTML。
- 数据类型: String
- 默认值: <hr style=”page-break-after: always;” class=”ke-pagebreak” />
Note
4.1.3版本开始支持。