FCKEditor编辑器的施用（二） _Web前端

FCKEditor编辑器的使用（二）

如何配置FCKEDITOR?
FCKEDITOR提供了一套用于定制其外观,特性及行为的设置集.主配置文件名为Fckconfig.js?
既可以编辑主配置文件,也可以自己定义单独的配置文件.配置文件使用JAVASCRIPT语法.

修改后,在建立编辑器时,可以使用以下语法:?
var oFCKeditor = new FCKeditor( 'FCKeditor1' ) ;?
oFCKeditor.Config['CustomConfigurationsPath'] = '/myconfig.js' ;?
oFCKeditor.Create() ;

构造器:?
FCKeditor( instanceName[, width, height, toolbarSet, value] )?
instanceName:编辑器的唯一名称(相当于ID)?
WIDTH:宽度?
HEIGHT:高度?
toolbarSet:工具条集合的名称?
value:编辑器初始化内容

属性:?
instanceName:编辑器实例名?
width:宽度,默认值为100%?
height:高度,默认值是200?
ToolbarSet:工具集名称,参考FCKCONFIG.JS,默认值是Default?
value:初始化编辑器的HTML代码,默认值为空?
BasePath:编辑器的基路径,默认为/Fckeditor/文件夹,注意,尽量不要使用相对路径.最好能用相对于站点根路径的表示方法,要以/结尾?
CheckBrowser:是否在显示编辑器前检查浏览器兼容性,默认为true?
DisplayErrors:是否显示提示错误,默为true;

配置选项:?
AutoDetectLanguage=true/false 自动检测语言?
BaseHref="" _fcksavedurl="""" 相对链接的基地址?
ContentLangDirection="ltr/rtl" 默认文字方向?
ContextMenu=字符串数组,右键菜单的内容?
CustomConfigurationsPath="" 自定义配置文件路径和名称?
Debug=true/false 是否开启调试功能,这样,当调用FCKDebug.Output()时,会在调试窗中输出内容?
DefaultLanguage="" 缺省语言?
EditorAreaCss="" 编辑区的样式表文件?
EnableSourceXHTML=true/false 为TRUE时,当由可视化界面切换到代码页时,把HTML处理成XHTML?
EnableXHTML=true/false 是否允许使用XHTML取代HTML?
FillEmptyBlocks=true/false 使用这个功能,可以将空的块级元素用空格来替代?
FontColors="" 设置显示颜色拾取器时文字颜色列表?
FontFormats="" 设置显示在文字格式列表中的命名?
FontNames="" 字体列表中的字体名?
FontSizes="" 字体大小中的字号列表?
ForcePasteAsPlainText=true/false 强制粘贴为纯文本?
ForceSimpleAmpersand=true/false 是否不把&符号转换为XML实体?
FormatIndentator="" 当在源码格式下缩进代码使用的字符?
FormatOutput=true/false 当输出内容时是否自动格式化代码?
FormatSource=true/false 在切换到代码视图时是否自动格式化代码?
FullPage=true/false 是否允许编辑整个HTML文件,还是仅允许编辑BODY间的内容?
GeckoUseSPAN=true/false 是否允许SPAN标记代替B,I,U标记?
IeSpellDownloadUrl=""下载拼写检查器的网址?
ImageBrowser=true/false 是否允许浏览服务器功能?
ImageBrowserURL="" 浏览服务器时运行的URL?
ImageBrowserWindowHeight="" 图像浏览器窗口高度?
ImageBrowserWindowWidth="" 图像浏览器窗口宽度?
LinkBrowser=true/false 是否允许在插入链接时浏览服务器?
LinkBrowserURL="" 插入链接时浏览服务器的URL?
LinkBrowserWindowHeight=""链接目标浏览器窗口高度?
LinkBrowserWindowWidth=""链接目标浏览器窗口宽度?
Plugins=object 注册插件?
PluginsPath="" 插件文件夹?
ShowBorders=true/false 合并边框?
SkinPath="" 皮肤文件夹位置?
SmileyColumns=12 图符窗列数?
SmileyImages=字符数组图符窗中图片文件名数组?
SmileyPath="" 图符文件夹路径?
SmileyWindowHeight 图符窗口高度?
SmileyWindowWidth 图符窗口宽度?
SpellChecker="ieSpell/Spellerpages" 设置拼写检查器?
StartupFocus=true/false 开启时FOCUS到编辑器?
StylesXmlPath="" 设置定义CSS样式列表的XML文件的位置?
TabSpaces=4 TAB键产生的空格字符数?
ToolBarCanCollapse=true/false 是否允许展开/折叠工具栏?
ToolbarSets=object 允许使用TOOLBAR集合?
ToolbarStartExpanded=true/false 开启是TOOLBAR是否展开?
UseBROnCarriageReturn=true/false 当回车时是产生BR标记还是P或者DIV标记

如何设置上传文件语言

把FCKeditor根目录下面的fckconfig.js文件里

在使用时,系统会自动侦测客户端语系及国别而运用适当的界面语言.

当建立一种新的语言后,你必须在"Edit/lang/fcklanguagemanager.js"中为其建立一个条目,如下所示:?
FCKLanguageManager.AvailableLanguages =?
{

en : 'English',?
pt : 'Portuguese'?
}

需要提醒的是,文件必须保存为UTF-8格式

JS操作FCKEditor，以下转载

利用Javascript取和设FCKeditor值也是非常容易的，如下：

// 获取编辑器中HTML内容
function getEditorHTMLContents(EditorName) {?
??? var oEditor = FCKeditorAPI.GetInstance(EditorName);?
??? return(oEditor.GetXHTML(true));?
}

// 获取编辑器中文字内容
function getEditorTextContents(EditorName) {?
??? var oEditor = FCKeditorAPI.GetInstance(EditorName);?
??? return(oEditor.EditorDocument.body.innerText);?
}

// 设置编辑器中内容
function SetEditorContents(EditorName, ContentStr) {?
??? var oEditor = FCKeditorAPI.GetInstance(EditorName) ;?
??? oEditor.SetHTML(ContentStr) ;?
}

//另外还要让编辑器获得焦点:

var oEditor = FCKeditorAPI.GetInstance('content');

oEditor.Focus();

FCKeditorAPI是FCKeditor加载后注册的一个全局对象，利用它我们就可以完成对编辑器的各种操作。

在当前页获得 FCK 编辑器实例：
var Editor = FCKeditorAPI.GetInstance('InstanceName');

从 FCK 编辑器的弹出窗口中获得 FCK 编辑器实例：
var Editor = window.parent.InnerDialogLoaded().FCK;

从框架页面的子框架中获得其它子框架的 FCK 编辑器实例：
var Editor = window.FrameName.FCKeditorAPI.GetInstance('InstanceName');

从页面弹出窗口中获得父窗口的 FCK 编辑器实例：?
var Editor = opener.FCKeditorAPI.GetInstance('InstanceName');

获得 FCK 编辑器的内容：
oEditor.GetXHTML(formatted); // formatted 为：true|false，表示是否按HTML格式取出
也可用：?
oEditor.GetXHTML();

设置 FCK 编辑器的内容：
oEditor.SetHTML("content", false); // 第二个参数为：true|false，是否以所见即所得方式设置其内容。此方法常用于"设置初始值"或"表单重置"哦作。

插入内容到 FCK 编辑器：
oEditor.InsertHtml("html"); // "html"为HTML文本

检查 FCK 编辑器内容是否发生变化：
oEditor.IsDirty();

在 FCK 编辑器之外调用 FCK 编辑器工具条命令：
命令列表如下：
DocProps, Templates, Link, Unlink, Anchor, BulletedList, NumberedList, About, Find, Replace, Image, Flash, SpecialChar, Smiley, Table, TableProp, TableCellProp, UniversalKey, Style, FontName, FontSize, FontFormat, Source, Preview, Save, NewPage, PageBreak, TextColor, BGColor, PasteText, PasteWord, TableInsertRow, TableDeleteRows, TableInsertColumn, TableDeleteColumns, TableInsertCell, TableDeleteCells, TableMergeCells, TableSplitCell, TableDelete, Form, Checkbox, Radio, TextField, Textarea, HiddenField, Button, Select, ImageButton, SpellCheck, FitWindow, Undo, Redo

使用方法如下：
oEditor.Commands.GetCommand('FitWindow').Execute();

= FCKConfig.BasePath + 'plugins/'??
// FCKConfig.Plugins.Add( 'placeholder', 'en,it' ) ;?

去掉//后，就相当于把placeholder这个插件功能加上了，fckeditor的插件文件都在/editor/plugins/文件夹下分类按文件夹放置的，对于fckeditor2.0来说，里面有两个文件夹，也就是有两个官方插件，placeholder这个文件夹就是我们刚才加上去的，主要用于多参数或单参数自定义标签的匹配，这个在制作编辑模板时非常管用，要想看具体实例的话，大家可以去下载acms这个系统查看学习，另一个文件夹tablecommands就是编辑器里的表格编辑用到的了。当然，如果你想制作自己其它用途的插件，那就只要按照fckeidtor插件的制作规则制作完放置在/editor/plugins/下就行，然后再在fckeidtor.js里再添加FCKConfig.Plugins.Add('Plugin Name',',lang,lang');就可以了。

第二部分，如何让编辑器一打开的时候，编辑工具条不出现，等点“展开工具栏”时才出现？Easy，FCKeditor本身提供了这个功能啦，打开fckconfig.js，找到

FCKConfig.ToolbarStartExpanded = true ;
改成
FCKConfig.ToolbarStartExpanded = false ;
就可以啦！

第三部分，使用自己的表情图标，同样打开fckcofnig.js到最底部那一段

FCKConfig.SmileyPath = FCKConfig.BasePath + 'images/smiley/msn/' ;
FCKConfig.SmileyImages = ['regular_smile.gif','sad_smile.gif','wink_smile.gif'] ;
FCKConfig.SmileyColumns = 8 ;
FCKConfig.SmileyWindowWidth??? = 320 ;
FCKConfig.SmileyWindowHeight = 240 ;

上面这段已经是我修改过的了，为了我发表此文的版面不会被撑得太开，我把FCKConfig.SmileyImages那一行改得只有三个表情图了。

第一行，当然是表情图标路径的设置，第二行是相关表情图标文件名的一个List，第三行是指弹出的表情添加窗口最每行的表情数，下面两个参数是弹出的模态窗口的宽和高喽。

第四部分，文件上传管理部分

此部分可能是大家最为关心的，上一篇文章简单的讲了如何修改来上传文件以及使用fckeidtor2.0才提供的快速上传功能。再我们继续再深层次的讲解上传功能

FCKConfig.LinkBrowser = true ;
FCKConfig.ImageBrowser = true ;
FCKConfig.FlashBrowser = true ;在fckconfig.js找到这三句，这三句不是连着的哦，只是我把他们集中到这儿来了，设置为true的意思就是允许使用fckeditor来浏览服务器端的文件图像以及flash等，这个功能是你插入图片时弹出的窗口上那个“浏览服务器”按钮可以体现出来，如果你的编辑器只用来自己用或是只在后台管理用，这个功能无疑很好用，因为他让你很直观地对服务器的文件进行上传操作。但是如果你的系统要面向前台用户或是像blog这样的系统要用的话，这个安全隐患可就大了哦。于是我们把其一律设置为false;如下

FCKConfig.LinkBrowser = false ;
FCKConfig.ImageBrowser = false ;
FCKConfig.FlashBrowser = false ;

这样一来，我们就只有快速上传可用了啊，好！接下来就来修改，同样以asp为范例进行，进入/editor/filemanager/upload/asp/打开config.asp，修改
ConfigUserFilesPath = "/UserFiles/"这个设置是上传文件的总目录，我这里就不动了，你想改自己改了

好，再打开此目录下的upload.asp文件，找到下面这一段

Dim resourceType
If ( Request.QueryString("Type") <> "" ) Then
resourceType = Request.QueryString("Type")
Else
resourceType = "File"
End If?
然后再在其后面添加

ConfigUserFilesPath = ConfigUserFilesPath & resourceType &"/"& Year(Date()) &"/"& Month(Date()) &"/"?
这样的话，上传的文件就进入“/userfiles/文件类型（如image或file或flash)/年/月/”这样的文件夹下了，这个设置对单用户来用已经足够了，如果你想给多用户系统用，那就这样来改

ConfigUserFilesPath = ConfigUserFilesPath & Session("username") & resourceType &"/"& Year(Date()) &"/"& Month(Date()) &"/"?
这样上传的文件就进入“/userfiles/用户目录/文件类型/年/月/”下了，当然如果你不想这么安排也可以修改成别的，比如说用户目录再深一层等，这里的Session("username")请根据自己的需要进行修改或换掉。

上传的目录设置完了，但是上传程序还不会自己创建这些文件夹，如果不存在的话，上传不会成功的，那么我们就得根据上面的上传路径的要求进行递归来生成目录了。

找到这一段

Dim sServerDir
sServerDir = Server.MapPath( ConfigUserFilesPath )
If ( Right( sServerDir, 1 ) <> "\" ) Then
??? sServerDir = sServerDir & "\"
End If

把它下面的这两行

Dim oFSO
Set oFSO = Server.CreateObject( "Scripting.FileSystemObject" )?
用下面这一段代码来替换

dim arrPath,strTmpPath,intRow
strTmpPath = ""
arrPath = Split(sServerDir, "\")?
Dim oFSO
Set oFSO = Server.CreateObject( "Scripting.FileSystemObject" )
for intRow = 0 to Ubound(arrPath)
??? strTmpPath = strTmpPath & arrPath(intRow) & "\"
??? if oFSO.folderExists(strTmpPath)=false then
???? oFSO.CreateFolder(strTmpPath)
??? end if
next?
用这段代码就可以生成你想要的文件夹了，在上传的时候自动生成。

好了，上传文件的修改到现在可以暂时告一段落了，但是，对于中文用户还存在这么个问题，就是fckeditor的文件上传默认是不改名的，同时还不支持中文文件名，这样一来是上传的文件会变成“.jpg”这样的无法读的文件，再就是会有重名文件，当然重名这点倒没什么，因为fckeditor会自动改名，会在文件名后加（1）这样来进行标识。但是，我们通常的习惯是让程序自动生成不重复的文件名

在刚才那一段代码的下面紧接着就是
' Get the uploaded file name.
sFileName = oUploader.File( "NewFile" ).Name
看清楚了，这个就是文件名啦，我们来把它改掉，当然得有个生成文件名的函数才行，改成下面这样

'//取得一个不重复的序号
Public Function GetNewID()
dim ranNum
dim dtNow
randomize
dtNow=Now()
ranNum=int(90000*rnd)+10000
GetNewID=year(dtNow) & right("0" & month(dtNow),2) & right("0" & day(dtNow),2) & right("0" & hour(dtNow),2) & right("0" & minute(dtNow),2) & right("0" & second(dtNow),2) & ranNum
End Function

' Get the uploaded file name.
sFileName = GetNewID() &"."& split(oUploader.File( "NewFile" ).Name,".")(1)

这样一来，上传的文件就自动改名生成如20050802122536365.jpg这样的文件名了，是由年月日时分秒以及三位随机数组成的文件名了