FCKeditor如何使用

FCKEDITOR使用说明2008-01-29 12:11一、FCKEDITOR类参考:

构造器:

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

集合:

Config[Key]=value

这个集合用于更改配置中某一项的值,如

oFckeditor.Config["DefaultLanguage"]="pt-br"

方法:

Create() 建立并输出编辑器

RepaceTextArea(TextAreaName) 用启谈编辑器来替换对应的文本框

二、配置FCKEDITOR

主配置文件名为Fckconfig.js

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

修改后,在建立编辑器时,可以使用以下语法:

var oFCKeditor = new FCKeditor( 'FCKeditor1' )

oFCKeditor.Config['CustomConfigurationsPath'] = '/myconfig.js'

oFCKeditor.Create()

提醒:当你修改配置后,请清空浏览器缓存以查看效果

配置选项:

AutoDetectLanguage=true/false 自动检测语言

BaseHref="" 相对链接的基地址

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标记

三、自定义样式列表

FckStyls.xml是默认的自定义样式列表文件。

FCKEDITOR的样式工具栏中提供了预定义的样式,样式是通过XML文件定义的,默认的XML样式文件存在于FCkEditor根文件夹下的FckStyls.xml文件中这个XML文件的结构分析如下:

<?xml version="1.0" encoding="utf-8" ?>

<Styles >

<Style name="My Image" element="img">

<Attribute name="style" value="padding: 5px" />

<Attribute name="border" value="2" />

</Style >

<Style name="Italic" element="em" />

<Style name="Title" element="span">

<Attribute name="class" value="Title" />

</Style >

<Style name="Title H3" element="h3" />

</Styles>

每一个STYLE标记定义一种样式,NAME是显示在下拉列表中的样式名,ELEMENT属性指定此样式所适用的对象,因为FCKEDITOR中的样式是上下文敏感的,也就是说,选择不同的对象,仅会显示针对这类对象定义的样式

四、拼写检查

FCKEDITOR 带了两种拼写检查工具,一种是ieSpell,默认情况下使用这种,使用这种方式的拼写检查,要求客户下载并安装iespell这个小软件,另外,也提供 SpellPager的方式来进行拼写检查,不过,由于SPELLPAGER是由PHP编写的服务器端脚本,因此,要求你的WEB服务器必须支持PHP脚本语言方可

更改拼写检查器的方式请参见有关配置文件的详细说明

五、压缩脚本

为了提供脚本载入的效率,FCKEDITOR采用以下方法对脚本尽量压缩以减少脚本尺寸:

1,移除掉脚本中的注释

2.移除掉脚本中所有无意义的空白

另外,FCKEDITOR还提供了一个专门用于压缩脚本的工具以便 你在发布时能减小文件尺寸,你可以将_Packager文件夹中的Fckeditor.Packager.exe复制到FCKEDITOR根文件夹来运行并压缩脚本

六、本地化FCKEDITOR

如果FCKEDITOR没有提供您所需要的语言(实际上全有了),你也可以自行制作新的语言,你只需要复制出EN.JS,然后在其基础上进行翻译.另外,语言名称与对应的脚本文件名必须遵循RFC 3066标准,但是,需要小写,例如:Portuguess Language对应的脚本文件名必须为pt.js如果需要针对某个国家的某种语系,则可以在语系缩写后加上横线及国家缩写即可

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

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

FCKLanguageManager.AvailableLanguages =

{

en : 'English',

pt : 'Portuguese'

}

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

六、与ASP.NET服务器端脚本进行交互

1.把FCKEDITOR添中到工具箱

2.托拽FCKEDITOR控件到页面

3.为其指定名称

4.FCKEDITOR 类的所有属性不光可以在代码中使用,而且可以作为FCKEDITOR控件的属性直接使用,例如,要改变皮肤,可以在UI页面中指定SkinPath= "/fckeditor/editor/skins/office2003"即可,其实FCKEDITOR的ASP.NET版本可以做得更好,你可以找到 FCKEDITOR ASP.NET 2.1的源文件,然后修改该控件的设计,为其暴露更多有用的属性,重新编译即可

5,POSTBACK后的数据,使用FCKEDITOR控件的value属性获得

6. 由于默认状态下,ASP.NET不允许提交含有HTML及JAVASCRIPT的内容,因此,你必须将使用FCKEDITOR的页面的 ValidateRequest设为false.(<%@page validteRequest="false" %>即可)

七、设置上传文件语言

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

var _FileBrowserLanguage = 'asp' // asp | aspx | cfm | lasso | perl | php | py

var _QuickUploadLanguage = 'asp' // asp | aspx | cfm | lasso | php

这两行中改成您所需要调用的编辑器语言，如用asp.net则改为aspx；

八、解决中文的问题:

在web.config中加入:

<globalization requestEncoding="GB2312" responseEncoding="GB2312"/>

这样设置后可以显示中文的文件，但URL地址也是中文的；

如果服务器对中文地址的解析不好，可能导致图片无法浏览；

所以修改：editor\filemanager\browser\default\frmresourceslist.html

中的OpenFile函数，把

window.top.opener.SetUrl( fileUrl )

修改为:

window.top.opener.SetUrl( escape(fileUrl) )

九.设置上传的目录：

1:在web.config中设置:

<appSettings>

<add key="FCKeditor:UserFilesPath" value="/fck/UpLoad/" />

</appSettings>

2:在Session中设置:

在editor\filemanager\browser\default\connectors\aspx\connector.aspx中加入以下代码:

<script runat="server" language="C#">

protected override void OnInit(EventArgs e)

{

Session["FCKeditor:UserFilesPath"] = "/fck/UpLoad1/"

}

</script>

在线编辑器这个东东配置很麻烦！我这么配的成功了，不知道你行不行！

在要显示的jsp页面中导入<%@ taglib uri = "/WEB-INF/FCKeditor.tld" prefix = "fck" %>

把FCKeditor文件夹复制到项目根目录下

把者镇wEB-INF下的FCKeditor.tld和web.xml复制到WEB-INf下

把lib下的2个jar文件复制到lib里面

改代码：把 文本域textear的代码改成留言信息:<fck:editor id="neirong" basePath="/Car/FCKeditor/"width="300" height="300" skinPath="/Car/FCKeditor/editor/skins/silver/" toolbarSet="Default">input</fck:editor> 注意Car是项目名

如何设置自己想要的控件呢 ？

在KCFeditor下找到最基本的设置文件 fckconfig.js 把里面的difault去掉

在Basic里面加入神嫌卜自己想要的

还得把 jsp页面里面文本域代码中游穗的toolbarSet=“default”改成 Basic

根目录下面2个JS和3个XML文件保留，其他都可删除

_samples这个文件夹给的都是例子，不要也可以删除

editor里面有个lang文件夹，语言切换的，瞎运如果只用中文，保留zh.js和zh-cn.js和en.js就可以了，磨局梁其他的都可腊悔删去

---