posts - 496,comments - 227,trackbacks - 0

ckeditor 的官方网站是 ,我当前使用的版本是v3.0.1。

一、使用方法:

1、在页面中引入ckeditor核心文件ckeditor.js

2、在使用编辑器的地方插入html控件

如果是asp.net环境,也可用服务器端控件

注意在控件中加上 class="ckeditor" 。

3、将相应的控件替换成编辑器代码

4、配置编辑器

    ckeditor的配置都集中在 ckeditor/config.js 文件中,下面是一些常用的配置参数:

// 界面语言,默认为 'en'

    config.language = 'zh-cn';

// 设置宽高

    config.width = 400;

    config.height = 400;

// 编辑器样式,有三种:'kama'(默认)、'office2003'、'v2'

    config.skin = 'v2';

// 背景颜色

    config.uicolor = '#fff';

// 工具栏(基础'basic'、全能'full'、自定义)plugins/toolbar/plugin.js

    config.toolbar = 'basic';

    config.toolbar = 'full';

    这将配合:
    config.toolbar_full = [
       ['source','-','save','newpage','preview','-','templates'],
       ['cut','copy','paste','pastetext','pastefromword','-','print', 'spellchecker', 'scayt'],
       ['undo','redo','-','find','replace','-','selectall','removeformat'],
       ['form', 'checkbox', 'radio', 'textfield', 'textarea', 'select', 'button', 'imagebutton', 'hiddenfield'],
       '/',
       ['bold','italic','underline','strike','-','subscript','superscript'],
        ['numberedlist','bulletedlist','-','outdent','indent','blockquote'],
        ['justifyleft','justifycenter','justifyright','justifyblock'],
        ['link','unlink','anchor'],
       ['image','flash','table','horizontalrule','smiley','specialchar','pagebreak'],
       '/',
        ['styles','format','font','fontsize'],
        ['textcolor','bgcolor']
    ];

    //工具栏是否可以被收缩
    config.toolbarcancollapse = true;

    //工具栏的位置
    config.toolbarlocation = 'top';//可选:bottom

    //工具栏默认是否展开
    config.toolbarstartupexpanded = true;

// 取消 “拖拽以改变尺寸”功能 plugins/resize/plugin.js
    config.resize_enabled = false;

    //改变大小的最大高度

    config.resize_maxheight = 3000;

    //改变大小的最大宽度
    config.resize_maxwidth = 3000;

    //改变大小的最小高度
    config.resize_minheight = 250;

    //改变大小的最小宽度
    config.resize_minwidth = 750;
// 当提交包含有此编辑器的表单时,是否自动更新元素内的数据
    config.autoupdateelement = true;

// 设置是使用绝对目录还是相对目录,为空为相对目录
    config.basehref = ''

    // 编辑器的z-index值
    config.basefloatzindex = 10000;

//设置快捷键
    config.keystrokes = [
       [ ckeditor.alt 121 /*f10*/, 'toolbarfocus' ],  //获取焦点
        [ ckeditor.alt 122 /*f11*/, 'elementspathfocus' ],  //元素焦点

       [ ckeditor.shift 121 /*f10*/, 'contextmenu' ],  //文本菜单

       [ ckeditor.ctrl 90 /*z*/, 'undo' ],  //撤销
        [ ckeditor.ctrl 89 /*y*/, 'redo' ],  //重做
        [ ckeditor.ctrl ckeditor.shift 90 /*z*/, 'redo' ],  //

        [ ckeditor.ctrl 76 /*l*/, 'link' ],  //链接

        [ ckeditor.ctrl 66 /*b*/, 'bold' ],  //粗体
        [ ckeditor.ctrl 73 /*i*/, 'italic' ],  //斜体
        [ ckeditor.ctrl 85 /*u*/, 'underline' ],  //下划线

        [ ckeditor.alt 109 /*-*/, 'toolbarcollapse' ]
    ]

    //设置快捷键 可能与浏览器快捷键冲突 plugins/keystrokes/plugin.js.
    config.blockedkeystrokes = [
        ckeditor.ctrl 66 /*b*/,
        ckeditor.ctrl 73 /*i*/,
        ckeditor.ctrl 85 /*u*/
    ]

    //设置编辑内元素的背景色的取值 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' } );

    //界面编辑框的背景色 plugins/dialog/plugin.js
    config.dialog_backgroundcovercolor = '#fffefd'; //可设置参考
    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 = ' ;

    //是否对编辑区域进行渲染 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;

    //是否转换一些拉丁字符为html plugins/entities/plugin.js
    config.entities_latin = true;

    //是否转换一些特殊字符为ascii字符 如"this is chinese: 汉语."转换为"this is chinese: 汉语." 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;times new roman;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;

    //是否忽略段落中的空字符 若不忽略 则字符将以“”表示 plugins/wysiwygarea/plugin.js
    config.ignoreemptyparagraph = true;

    //在清除图片属性框中的链接属性时 是否同时清除两边的

simone 阅读(41914) 评论(10)     所属分类: javascript

feedback:
# re: ckeditor 配置使用
2010-03-26 14:44 |
请教一下,3.1版本里,没了这个
//当从word里复制文字进来时,是否进行文字的格式化去除 plugins/pastefromword/plugin.js

怎解决?  回复  
  
# re: ckeditor 配置使用
2010-04-16 11:53 |
@jameslin
我配置是复制 word中的样式 没有在ckeditor中显示呢
急需解决 qq在线等……  回复  
  
# re: ckeditor 配置使用
2010-07-18 23:28 |
好东西,我正需要呢,谢谢!  回复  
  
# re: ckeditor 配置使用
2011-06-21 11:43 |
问个问题呗:ckeditor只能点击开始部分才能输入文字,怎样解决这个问题呢?我qq 277122154,谢了!!!  回复  
  
# re: ckeditor 配置使用
2011-08-09 16:25 |
好东西  回复  
  
# re: ckeditor 配置使用
2011-12-01 16:23 |
从word直接复制到ckeditor中,有些浏览器会使得开头空一行,而且字体默认为仿宋。且没有plugins/pastefromword/plugin.js文件  回复  
  
# re: ckeditor 配置使用
2012-06-04 23:58 |
图片超链接的时候没有浏览啊???怎么办?加我qq459384747谢谢  回复  
  
# re: ckeditor 配置使用
2012-12-13 08:36 |
为什么我按照上面的内容做的,asp.net却不管用啊???  回复  
  
# re: ckeditor 配置使用
2013-10-09 12:17 |
为什么不能上传图片了  回复  
  
# re: ckeditor 配置使用[未登录]
2013-10-26 08:07 |
@源源
我是自己又添加了个上传功能  回复  
  

只有注册用户后才能发表评论。


网站导航:
              
 
"));
网站地图