FCKEditor 技术细节探讨

<script type="text/javascript"><!-- google_ad_client = "pub-1319682485411148";/* csdn.net(728x90) */google_ad_slot = "0852226150";google_ad_width = 728;google_ad_height = 90;// --></script><script src="http://pagead2.googlesyndication.com/pagead/show_ads.js" type="text/javascript"></script>

1. 如何初始化FCKEditor

可以在page中插入以下代码来引入FCKEditor:

<script type="text/javascript">

//<![CDATA[

var oFCKeditor = new FCKeditor( 'htmlPageText' );

oFCKeditor.BasePath = 'scripts/fckeditor/';

oFCKeditor.Value = '<%=pageAsHtml%>';

oFCKeditor.Width = '100%';

oFCKeditor.Height = '450';

oFCKeditor.Config['CustomConfigurationsPath'] = 'fckconfig.js'

oFCKeditor.Config['BaseHref'] = baseURL;

oFCKeditor.Config['EditorAreaCSS'] = 'custom.css';

oFCKeditor.Create();

//]]>

</script>

必须属性：

oFCKeditor.BasePath 指向FCK所在文件夹

oFCKeditor.Value 插入到FCK编辑区域的初始文本

可选属性：

oFCKeditor.Width 编辑区域的宽度

oFCKeditor.Height 编辑区域的高度

oFCKeditor.Config['CustomConfigurationsPath'] FCK的配置文件

oFCKeditor.Config['BaseHref'] Wiki service的base URL

oFCKeditor.Config['EditorAreaCSS'] 指定FCK 的样式文件

2. 如何增加一个toolbar item.

在方法 FCKToolbarItems.GetItem里面增加一个item 分支:

…

Case ‘newitem’:

oItem = new FCKToolbarButton();

break;

…

在方法 FCKCommands.GetCommand里面增加一个执行对象，改对象必须实现execute方法，它将在User点击toolbar item按钮时被调用。

…

Case ‘newitem’:

oCommand = new FCKNewItemCommand();

break;

…

FCKNewItemCommand对象定义如下：

Var FCKNewItemCommand = {};

FCKNewItemCommand.prototype.execute = function() {…};

3. 如何调用windows的copy, cut, paste等方法

FCK. ExecuteNamedCommand方法封装了document.execCommand. 我们可以通过document.execCommand 来执行copy, cut, paste方法。

Document.execCommand方法参数包括下面：

2D-Position 允许通过拖曳移动绝对定位的对象。

AbsolutePosition 设定元素的 position 属性为“absolute”(绝对)。

BackColor 设置或获取当前选中区的背景颜色。

Bold 切换当前选中区的粗体显示与否。

Copy 将当前选中区复制到剪贴板。

CreateBookmark 创建一个书签锚或获取当前选中区或插入点的书签锚的名称。

CreateLink 在当前选中区上插入超级链接，或显示一个对话框允许用户指定要为当前选中区插入的超级链接的 URL。

Cut 将当前选中区复制到剪贴板并删除之。

Delete 删除当前选中区。

FontName 设置或获取当前选中区的字体。

FontSize 设置或获取当前选中区的字体大小。

ForeColor 设置或获取当前选中区的前景(文本)颜色。

FormatBlock 设置当前块格式化标签。

Indent 增加选中文本的缩进。

InsertButton 用按钮控件覆盖当前选中区。

InsertFieldset 用方框覆盖当前选中区。

InsertHorizontalRule 用水平线覆盖当前选中区。

InsertIFrame 用内嵌框架覆盖当前选中区。

InsertImage 用图像覆盖当前选中区。

InsertInputButton 用按钮控件覆盖当前选中区。

InsertInputCheckbox 用复选框控件覆盖当前选中区。

InsertInputFileUpload 用文件上载控件覆盖当前选中区。

InsertInputHidden 插入隐藏控件覆盖当前选中区。

InsertInputImage 用图像控件覆盖当前选中区。

InsertInputPassword 用密码控件覆盖当前选中区。

InsertInputRadio 用单选钮控件覆盖当前选中区。

InsertInputReset 用重置控件覆盖当前选中区。

InsertInputSubmit 用提交控件覆盖当前选中区。

InsertInputText 用文本控件覆盖当前选中区。

InsertMarquee 用空字幕覆盖当前选中区。

InsertOrderedList 切换当前选中区是编号列表还是常规格式化块。

InsertParagraph 用换行覆盖当前选中区。

InsertSelectDropdown 用下拉框控件覆盖当前选中区。

InsertSelectListbox 用列表框控件覆盖当前选中区。

InsertTextArea 用多行文本输入控件覆盖当前选中区。

InsertUnorderedList 切换当前选中区是项目符号列表还是常规格式化块。

Italic 切换当前选中区斜体显示与否。

JustifyCenter 将当前选中区在所在格式化块置中。

JustifyLeft 将当前选中区所在格式化块左对齐。

JustifyRight 将当前选中区所在格式化块右对齐。

LiveResize 迫使 MSHTML 编辑器在缩放或移动过程中持续更新元素外观，而不是只在移动或缩放完成后更新。

MultipleSelection 允许当用户按住 Shift 或 Ctrl 键时一次选中多于一个站点可选元素。

Open 打开。

Outdent 减少选中区所在格式化块的缩进。

OverWrite 切换文本状态的插入和覆盖。

Paste 用剪贴板内容覆盖当前选中区。

Print 打开打印对话框以便用户可以打印当前页。

Redo 重做。

Refresh 刷新当前文档。

RemoveFormat 从当前选中区中删除格式化标签。

SaveAs 将当前 Web 页面保存为文件。

SelectAll 选中整个文档。

UnBookmark 从当前选中区中删除全部书签。

Underline 切换当前选中区的下划线显示与否。

Undo 撤消。

Unlink 从当前选中区中删除全部超级链接。

Unselect 清除当前选中区的选中状态。

4. 如何过滤copy内容

当User从word, excel拷贝内容的时候，FCK会弹出一个过滤page, 让User把内容拷贝到新弹出的page上，然后点击OK button进行过滤动作。这过程中要进行２次拷贝，并且我们一定要进行过滤行为的，不然当我们把内容保存到wiki的时候会有标签转化错误，因为word中包含的内容很多标签中含有’:’, 而wiki 中是不允许有这样的标签的。

我们希望User粘贴内容的时候能直接进行过滤，所以我们希望做一个隐藏的剪切板，当User Copy内容的时候先拷贝到隐藏的剪切板，然后我们从剪切板拿到copy内容进行过滤，再把过滤好的内容插入到FCK编辑器中（我们不能从windows剪切板拿到内容，所以自己做个剪切板）。

l 用iframe做个剪切板

<div style="width:0px;height:0px;">

<iframe name="clipboard" id="clipboard" frameborder="0" style="width:0px;height:0px;padding:0px;margin:0px;border:0px;"></iframe>

</div>

把宽度和高度设置为０，这样剪切板就不可见。（设置display属性为none的时候剪切板用不了）

l 通过以下代码让iframe进入可编辑状态，这样它就能用作剪切板

var clipboard = document.frames["clipboard"];

clipboardDocument = clipboard.document;

clipboardDocument.designMode = 'On';

FCKClipBoard.writeFullHtml(clipboardDocument, "");

clipboard.focus();

clipboardDocument.execCommand("paste", false, null);

FCKClipBoard.writeFullHtml = function(documentObj, content) {

var editHtmlData = '';

editHtmlData += '<html>/r/n<head>/r/n<title>KindEditor</title>/r/n';

editHtmlData += '</head>/r/n<body>/r/n';

editHtmlData += content;

editHtmlData += '/r/n</body>/r/n</html>/r/n';

documentObj.open();

documentObj.write(editHtmlData);

documentObj.close();

}

FCKClipBoard.writeFullHtml方法是用来初始化剪切板内容用的。

l 可以通过clipboardDocument.body.innerHTML去拿剪切板内容。

l 可以通过FCK.InsertHtml(html)把过滤完的html内容插入到FCK编辑器中。