CKEditor使用指南.docx
- 文档编号:2388717
- 上传时间:2023-05-03
- 格式:DOCX
- 页数:16
- 大小:37.43KB
CKEditor使用指南.docx
《CKEditor使用指南.docx》由会员分享,可在线阅读,更多相关《CKEditor使用指南.docx(16页珍藏版)》请在冰点文库上搜索。
CKEditor使用指南
ExtJS_CKEditor使用指南
2011年6月30日Wangfeng1@
1.将资源文件复制到工程的WEBROOT目录下或者自己在WEBROOT下自己建一个文件夹存放资源文件
比如我们把资源文件放在webroot/scripts/lib/ckeditor文件夹下
2.在项目的入口页面引入以下3个js文件:
ckeditor/ckeditor.js
Ext.form.BasicForm.js
Ext.ux.CKEditor.js
比如在index.html中引入:
3.以上两步完成之后富文本编辑器就可以使用了,以下说明如何使用:
与其他组件使用类似,只需要将xtype设置为ckeditor类型就OK
在CKConfig属性下配置工具栏
比如:
{xtype:
'ckeditor',
hideLabel:
true,
fieldLabel:
'Editor',
name:
'htmlcode',
CKConfig:
{
toolbar:
[
['Source','Cut',['Undo','Redo'],['Find'],
['AreaImage'],['Uploadflash'],
['SpecialChar','HorizontalRule','PageBreak'],
['Subscript','Superscript'],
['Image','Flash','Preview','Templates'], '/',
['Format','Font','FontSize'],
['Bold','Italic','Underline','Strike'],
['TextColor','BGColor'],
['NumberedLists','BulletedLists'],
['JustifyLeft','JustifyCenter','JustifyRight'],
['Paragraph'],['Table'],['Uploadimg'],
['Link','Unlink','Anchor']
],
width:
840,
height:
290
}
4.富文本编辑器CKConfigtoolbar说明
CKConfigtoolbar是根据自己需求来定义编辑器的工具栏,也根据自己需要进行分组,每组内容只需要放在同一个中括号逗号隔开即可。
换行用’/’
比如:
['Undo','Redo'],['Find']排列结果:
Toolbar内容说明:
Source:
源码
Cut:
剪切
Copy:
复制
Paste:
粘贴
PasteText:
粘贴为无格式文本
PasteFromWord:
从MSword粘贴
Preview:
预览
Templates:
模板
Bold:
加粗
Italic:
斜体
underline:
下划线
Strike:
穿过线
Subscript:
下标
Superscript:
上标
Undo:
撤销
Redo:
重做
Find:
查询
NumberedList:
数字列表
BulletedList:
实体列表
Outdent:
减小缩进
Indent:
增大缩进
JustifyLeft:
做对齐
JustifyCenter:
居中对齐
JustifyRight:
右对齐
JustifyBlock:
两端对齐
Link:
超链接
Unlink:
取消超链接
Anchor:
锚点
Image:
图像
Flash:
Flash动画
Table:
表格
HorizontalRule:
水平线
Smiley:
表情
SpecialChar:
特殊字符
PageBreak:
分页符
Styles:
样式
Format:
格式
Font:
字体
FontSize:
字体大小
TextColor:
文本颜色
BGColor:
背景颜色
Maximize:
全屏
ShowBlocks:
显示区块
5.Ext中使用ckeditor的配置文件说明
富文本编辑器在Ext.form.CKEditor.js中自定义
配置CKEditor,可以通过编辑ckeditor文件夹下的config.js来更改CKEditor的默认配置,也可以在页面创建CKEditorConfig的实例来添加或覆盖config.js里面的配置
Config.js中的一些配置:
config.filebrowserUploadUrl=””上传文件
config.filebrowserImageUploadUrl=””上传图片
config.filebrowserFlashUploadUrl=””上传Flash
config.filebrowserBrowseUrl=””浏览文件
config.filebrowserImageBrowseUrl=””浏览图像库
根据自己所写的接口进行以上的配置,如果没有配置上传图片或者Flash,默认为上传文件
比如:
以下是Servlet中实现图片Flash的上传配置方法
config.filebrowserImageUploadUrl='/ckeditor/fileUploadServlet?
cmd=uploadImg';
config.filebrowserFlashUploadUrl='/ckeditor/fileUploadServlet?
cmd=uploadFlash';
例子中配置完成后操作上传功能就会调用指定方法,可以根据自己需求来配置所使用的方法。
6.Ckeditor自身的一些配置说明(config.js配置文件)
Config.js参数说明:
当提交包含有此编辑器的表单时,是否自动更新元素内的数据
config.autoUpdateElement=true
编辑器的z-index值
config.baseFloatZIndex=10000
设置是使用绝对目录还是相对目录,为空为相对目录
config.baseHref=''
设置快捷键从上往下依次是:
获取焦点,元素焦点,文本菜单,撤销,重做,重做,链接,粗体,斜体,下划线
config.keystrokes=
[
[CKEDITOR.ALT+121,'toolbarFocus'],
[CKEDITOR.ALT+122,'elementsPathFocus'],
[CKEDITOR.SHIFT+121,'contextMenu'],
[CKEDITOR.CTRL+90,'undo'],
[CKEDITOR.CTRL+89,'redo'],
[CKEDITOR.CTRL+CKEDITOR.SHIFT+90,'redo'],
[CKEDITOR.CTRL+76,'link'],
[CKEDITOR.CTRL+66,'bold'],
[CKEDITOR.CTRL+73,'italic'],
[CKEDITOR.CTRL+85,'underline'],
[CKEDITOR.ALT+109,'toolbarCollapse']
]
设置快捷键可能与浏览器快捷键冲突在plugins/keystrokes/plugin.js.设置
config.blockedKeystrokes=
[
CKEDITOR.CTRL+66,
CKEDITOR.CTRL+73,
CKEDITOR.CTRL+85
]
设置编辑内元素的背景色的取值plugins/colorbutton/plugin.js.
config.colorButton_backStyle=
{
element:
'span',
styles:
{'background-color':
'#(color)'}
}
设置前景色的取值plugins/colorbutton/plugin.js
config.colorButton_colors='000,800000,8B4513,2F4F4F,008080,000080,4B0082,696969,B22222,A52A2A,DAA520,006400,40E0D0,0000CD,800080,808080,F00,FF8C00,FFD700,008000,0FF,00F,EE82EE,A9A9A9,FFA07A,FFA500,FFFF00,00FF00,AFEEEE,ADD8E6,DDA0DD,D3D3D3,FFF0F5,FAEBD7,FFFFE0,F0FFF0,F0FFFF,F0F8FF,E6E6FA,FFF’
是否在选择颜色时显示“其它颜色”选项plugins/colorbutton/plugin.js
config.colorButton_enableMore=false
区块的前景色默认值设置plugins/colorbutton/plugin.js
config.colorButton_foreStyle=
{
element:
'span',
styles:
{'color':
'#(color)'}
};
所需要添加的CSS文件在此添加可使用相对路径和网站的绝对路径
config.contentsCss='./contents.css';
文字方向
config.contentsLangDirection='rtl';//从左到右
CKeditor的配置文件若不想配置留空即可
CKEDITOR.replace('myfiled',{customConfig:
'./config.js'});
界面的语言配置设置为'zh-cn'即可
config.defaultLanguage='en';
界面编辑框的背景色plugins/dialog/plugin.js
config.dialog_backgroundCoverColor='rgb(255,254,253)';//可设置参考
config.dialog_backgroundCoverColor='white'//默认
背景的不透明度数值应该在:
0.0~1.0之间plugins/dialog/plugin.js
config.dialog_backgroundCoverOpacity=0.5
移动或者改变元素时边框的吸附距离单位:
像素plugins/dialog/plugin.js
config.dialog_magnetDistance=20;
是否拒绝本地拼写检查和提示默认为拒绝目前仅firefox和safari支持plugins/wysiwygarea/plugin.js.
config.disableNativeSpellChecker=true
进行表格编辑功能如:
添加行或列目前仅firefox支持
plugins/wysiwygarea/plugin.js
config.disableNativeTableHandles=true;//默认为不开启
是否开启图片和表格的改变大小的功能
config.disableObjectResizing=true;
config.disableObjectResizing=false//默认为开启
设置HTML文档类型
config.docType='
DOCTYPEhtmlPUBLIC"-//W3C//DTDXHTML1.0Transitional//EN""http:
//www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">'
是否对编辑区域进行渲染
plugins/editingblock/plugin.js
config.editingBlock=true
编辑器中回车产生的标签
config.enterMode=CKEDITOR.ENTER_P//可选:
CKEDITOR.ENTER_BR或CKEDITOR.ENTER_DIV
是否使用HTML实体进行输出plugins/entities/plugin.js
config.entities=true
定义更多的实体plugins/entities/plugin.js
config.entities_additional='#39'//其中#代替了&
是否转换一些难以显示的字符为相应的HTML字符plugins/entities/plugin.js
config.entities_greek=true
是否转换一些拉丁字符为HTMLplugins/entities/plugin.js
config.entities_latin=true;
是否转换一些特殊字符为ASCII字符如:
"ThisisChinese:
汉语."转换为:
"ThisisChinese:
汉语."
plugins/entities/plugin.js
config.entities_processNumerical=false
添加新组件
config.extraPlugins='myplugin';//非默认仅示例
使用搜索时的高亮色plugins/find/plugin.js
config.find_highlight=
{
element:
'span',
styles:
{'background-color':
'#ff0','color':
'#00f'}
};
默认的字体名plugins/font/plugin.js
config.font_defaultLabel='Arial';
字体编辑时的字符集可以添加常用的中文字符:
宋体、楷体、黑体等plugins/font/plugin.js
config.font_names='Arial;TimesNewRoman;Verdana';
文字的默认式样plugins/font/plugin.js
config.font_style=
{
element :
'span',
styles :
{'font-family':
'#(family)'},
overrides:
[{element:
'font',attributes:
{'face':
null}}]
};
字体默认大小plugins/font/plugin.js
config.fontSize_defaultLabel='12px';
字体编辑时可选的字体大小plugins/font/plugin.js
config.fontSize_sizes='8/8px;9/9px;10/10px;11/11px;12/12px;14/14px;16/16px;18/18px;20/20px;22/22px;24/24px;26/26px;28/28px;36/36px;48/48px;72/72px'
设置字体大小时使用的式样plugins/font/plugin.js
config.fontSize_style=
{
element :
'span',
styles :
{'font-size':
'#(size)'},
overrides:
[{element:
'font',attributes:
{'size':
null}}]
};
是否强制复制来的内容去除格式plugins/pastetext/plugin.js
config.forcePasteAsPlainText=false//不去除
是否强制用“&”来代替“&”plugins/htmldataprocessor/plugin.js
config.forceSimpleAmpersand=false;
对address标签进行格式化plugins/format/plugin.js
config.format_address={element:
'address',attributes:
{class:
'styledAddress'}};
对DIV标签自动进行格式化plugins/format/plugin.js
config.format_div={element:
'div',attributes:
{class:
'normalDiv'}};
对H1标签自动进行格式化plugins/format/plugin.js
config.format_h1={element:
'h1',attributes:
{class:
'contentTitle1'}};
对H2标签自动进行格式化plugins/format/plugin.js
config.format_h2={element:
'h2',attributes:
{class:
'contentTitle2'}};
对H3标签自动进行格式化plugins/format/plugin.js
config.format_h1={element:
'h3',attributes:
{class:
'contentTitle3'}};
对H4标签自动进行格式化plugins/format/plugin.js
config.format_h1={element:
'h4',attributes:
{class:
'contentTitle4'}};
对H5标签自动进行格式化plugins/format/plugin.js
config.format_h1={element:
'h5',attributes:
{class:
'contentTitle5'}};
对H6标签自动进行格式化plugins/format/plugin.js
config.format_h1={element:
'h6',attributes:
{class:
'contentTitle6'}};
对P标签自动进行格式化plugins/format/plugin.js
config.format_p={element:
'p',attributes:
{class:
'normalPara'}};
对PRE标签自动进行格式化plugins/format/plugin.js
config.format_pre={element:
'pre',attributes:
{class:
'code'}};
用分号分隔的标签名字在工具栏上显示plugins/format/plugin.js
config.format_tags='p;h1;h2;h3;h4;h5;h6;pre;address;div'
是否使用完整的html编辑模式如使用,其源码将包含:
等标签config.fullPage=false
编辑器的高度config.height=200
是否忽略段落中的空字符若不忽略则字符将以“”表示plugins/wysiwygarea/plugin.js
config.ignoreEmptyParagraph=true
在清除图片属性框中的链接属性时是否同时清除两边的标签plugins/image/plugin.js
config.image_removeLinkByEmptyURL=true
界面的现实语言可选择"zh-cn"
config.language=true
一组用逗号分隔的标签名称,显示在左下角的层次嵌套中plugins/menu/plugin.js.
config.menu_groups='clipboard,form,tablecell,tablecellproperties,tablerow,tablecolumn,table,anchor,link,image,flash,checkbox,radio,textfield,hiddenfield,imagebutton,button,select,textarea'
显示子菜单时的延迟,单位:
msplugins/menu/plugin.js
config.menu_subMenuDelay=400;
当执行“新建”命令时,编辑器中的内容plugins/newpage/plugin.js
config.newpage_html=""
当从word里复制文字进来时,是否进行文字的格式化去除plugins/pastefromword/plugin.js
config.pasteFromWordIgnoreFontFace=true;//默认为忽略格式
是否使用
等标签修饰或者代替从word文档中粘贴过来的内容plugins/pastefromword/plugin.js
config.pasteFromWordKeepsStructure=false;
从word中粘贴内容时是否移除格式plugins/pastefromword/plugin.js
config.pasteFromWordRemoveStyle=false
对应后台语言的类型来对输出的HTML内容进行格式化
config.protectedSource.push(/<\?
[\s\S]*?
\?
>/g); //PHPCode
config.protectedSource.push(//g); //ASPCode
ASP.NetCode默认为空
config.protectedSource.push(/(]+>[\s|\S]
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- CKEditor 使用指南