CKEDITOR二次開發(fā)之插件開發(fā)方法

2024-09-06 19:17:01

字體：大中小

供稿：網(wǎng)友

在開始之前，感性的認(rèn)知一下CKEditor源碼的組織形式是很有用的. CKEditor固有的一些文件被組織到ckeditor/_source目錄里. 核心的功能，諸如DOM元素操作，事件處理，初始化腳本和一些環(huán)境設(shè)置被包含在ckeditor/_source/core文件夾內(nèi). 而其它的一些功能, 比如格式化，拷貝和粘貼, 圖片和鏈接, 都被實(shí)現(xiàn)為插件形式放在ckeditor/_source/plugins文件夾內(nèi). 每個(gè)文件夾表示一個(gè)插件. 并且在每個(gè)文件夾內(nèi), 有一個(gè)plugin.js的文件包含了該插件需要用到的代碼.

你可以看到源代碼被組織成不同的文件. 為了減少HTTP請(qǐng)求, CKEditor把不同的文件壓縮并打包到ckeditor.js和ckeditor_basic.js里。

創(chuàng)建一個(gè)日期插件（date）

1、在"ckeditor/plugins/"目錄下新建一個(gè)"date"目錄，然后在"date"目錄下新建一個(gè)"plugin.js"，輸入以下代碼：

CKEDITOR.plugins.add('date', {  requires: ['dialog'],  init: function (a) {    var b = a.addCommand('date', new CKEDITOR.dialogCommand('date'));    a.ui.addButton('date', {      label: a.lang.date.toolbar,      command: 'date',      icon: this.path + 'images/date.jpg'    });    CKEDITOR.dialog.add('date', this.path + 'dialogs/date.js');  }});

2、增加"images"目錄，放入一個(gè)"date.jpg"的圖片，當(dāng)然圖片可以從google找一個(gè)，16*16大小的正好。

3、增加"dialogs"目錄，新建一個(gè)"date.js"，輸入如下代碼：

CKEDITOR.dialog.add('date', function(editor){  var escape = function(value){    return value;  };  return {    title: '日歷控件',    resizable: CKEDITOR.DIALOG_RESIZE_BOTH,    minWidth: 300,    minHeight: 80,    contents: [{      id: 'cb',      name: 'cb',      label: 'cb',      title: 'cb',      elements: [{        type: 'text',        label: '請(qǐng)輸入日期控件名稱',        id: 'lang',        required: true,      },{        type:'html',        html:'<span>說(shuō)明：日歷控件選擇的日期、時(shí)間將回填到該輸入框中。</span>'      }]    }],    onOk: function(){      lang = this.getValueOf('cb', 'lang');      editor.insertHtml("<p>" + lang + "</p>");    },    onLoad: function(){    }  };});

4、接下來(lái)就是把插件加入到CKEditor里了，我是直接修改CKEditor插件的核心文件。

找到ckeditor目錄下的"ckeditor.js"，這里的代碼是經(jīng)過(guò)壓縮的，我們用CKEditor原來(lái)的about插件做參考。查找"about"，找到

fullPage:false,height:200,plugins:'about,basicstyles

然后在"about"后面增加"date"，這里就變成

plugins:'about,date,basicstyles

繼續(xù)查找"about"，找到

j.add('about',{init:function(l){var m=l.addCommand('about',new a.dialogCommand('about'));m.modes={wysiwyg:1,source:1};m.canUndo=false;l.ui.addButton('About',{label:l.lang.about.title,command:'about'});a.dialog.add('about',this.path+'dialogs/about.js');}});

在這個(gè) j 前面增加

j.add('date', {requires: ['dialog'],init: function(l){l.addCommand('date', new a.dialogCommand('date'));l.ui.addButton('date', {label: l.lang.date.toolbar,command: 'date',icon: this.path + 'images/code.jpg'});a.dialog.add('date', this.path + 'dialogs/date.js');}});

接下來(lái)查找"i.toolbar_Basic="，這就是CKEditor默認(rèn)的工具欄了，我們?cè)谶@里加上"date"，你可以加在你想要的位置，例如

['Maximize','ShowBlocks','-','date']

5、進(jìn)入"ckeditor/lang"，在"zh-cn.js"中增加"date:'日期插件'"。

,date:{toolbar: '日期控件'}, link: { toolbar: '插入/編輯超鏈接', other: '<其他>',

6、對(duì)CKEditor的修改已經(jīng)OK了。

當(dāng)然了，顯示ckeditor的工具欄時(shí)，也可以配置：打開config.js

/*Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.For licensing, see LICENSE.html or http://ckeditor.com/license*/CKEDITOR.editorConfig = function( config ){  // Define changes to default configuration here. For example:  // config.language = 'fr';  // config.uiColor = '#AADC6E';  config.toolbar =  [    ['Source'],    ['Cut', 'Copy', 'Paste', 'PasteText', 'PasteFromWord', '-', 'Print', 'Link', 'Unlink', 'Anchor'],    ['Undo', 'Redo', '-', 'Find', 'Replace', '-', 'SelectAll', 'ImageButton', 'Image'],    ['Styles', 'Format', 'Font', 'FontSize'],    ['TextColor', 'BGColor'],    ['date'] //剛創(chuàng)建的日期插件（date）  ];};

實(shí)例圖片：