【Asp.net精品源码栏目提醒】:本文主要为网学会员提供“FCKEDITOR使用手册_精品版 - 培训资料”,希望对需要FCKEDITOR使用手册_精品版 - 培训资料网友有所帮助,学习一下!
FCKEDITOR 使用手册 .基本页就是编辑器所在页以及装 入编辑器的JS脚本 .用来建立编辑器的脚本 .编辑器的语言和皮肤. .建立编辑器. .载入预置的编辑文档内容. .从现在开始用户可以阅读和编辑文档了不过拖拽支持以及工具栏都是不可用的 .载入编辑器引擎脚本 .建立工具栏并且可用 .从现在开始编辑器的所有功能都已经完整 .载入工具栏图标 脚本压缩 在打包任何新版本时编辑器的JS脚本将会进行预处理.预处理步骤如下: .移除所有代码注释 .移除所有无用的空白字符. .将脚本合并成几个文件 使用上面的方法我们可以将脚本文件的大小压缩到原来的50. 压缩后原始的代码仍然存在于一个名为_Source的文件夹中 如何打包 编辑器已经自带了打包程序它位于FCKEDITOR的根文件夹中_PACKAGER文件夹中名为Fckeditor.Packager.exe将其 复制到FCKEDITOR根文件夹中并运行即可自动将JS脚本打包并压缩 需要注意的是该程序是一个.NET程序必须安装.NET FRAMEWORK才能使用 想要获取支持 如果你捐赠15000欧元你就可以获得1年的免费技术支持比较贵的说相当于人民币15万不过西欧的费用相当惊人 如何安装 1.下载最新版的FCKEDITOR 2.解压缩到你的站点根文件夹中名为FCKEDITOR的文件夹中名称必须为FCKEDITOR因为配置文件中已经使用此名称来标示出 FCKEDITOR的位置 3.现在编辑器就可以使用了如果想要查看演示可以按下面方法访问: http://ltyour-sitegt/FCKeditor/_samples/default.html 注意:你可以将FCKEDITOR放置到任何文件夹默认情况下将其放入到FCKEDITOR文件夹是最为简单的方法.如果你放入的文件 夹使用别的名称请修改配置文件夹中编辑器BasePath参数如下所示: oFckeditor.BasePathquot/Components/fckeditor/quot 另外FCKEDITOR文件夹中所有以下划线开头的文件夹及文件都是可选的可以安全的从你的发布中删除.它们并不是编辑器运行时必需的 如何将FCKEDITOR整合进我的页面 由于目前的版本提供的FCKEDITOR仅提供了JAVASCRIPT式的整合因此这里仅讲述如何应用JAVASCRIPT来整合FCKEDITOR 到站点中当然其他各种语言的整合你可以参考_samples文件夹中的例子来完成 1假如编辑器已经安装在你的站点的/FCKEDITOR/文件夹下.那么第一步我们需要做的就是在页面的HEAD段中放入SCRIPT标记以引入 JAVASCRIPT整合模块.例如: ltscript typequottext/javascriptquot srcquot/fckeditor/fckeditor.jsquotgtlt/scriptgt 其中路径是可更改的 2现在FCKEDITOR类已经可以使用了.有两个方法在页面中建立一个FCKEDITOR编辑器: 方法1:内联方式建议使用:在页面的FORM标记内需要插入编辑器的地方置入以下代码: script typequottext/javascriptquotgt var oFCKeditor new FCKeditor FCKeditor1 oFCKeditor.Create lt/scriptgt 方法2:TEXTAREA标记替换法不建议使用:在页面的ONLOAD事件中添加以下代码以替换一个已经存在的TEXTAREA标记 lthtmlgt ltheadgt ltscript typequottext/javascriptquotgt window.onload function var oFCKeditor new FCKeditor MyTextarea oFCKeditor.ReplaceTextarea lt/scriptgt lt/headgt ltbodygt lttextarea idquotMyTextareaquot namequotMyTextareaquotgtThis is ltbgtthelt/bgt initial value.lt/textareagt lt/bodygt lt/htmlgt 3.现在编辑器可以使用了 FCKEDITOR类参考: 下面是用来在页面中建立编辑器的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 集合: ConfigKeyvalue 这个集合用于更改配置中某一项的值如 oFckeditor.ConfigquotDefaultLanguagequotquotpt-brquot 方法: Create 建立并输出编辑器 RepaceTextAreaTextAreaName 用编辑器来替换对应的文本框 如何配置FCKEDITOR FCKEDITOR提供了一套用于定制其外观特性及行为的设置集.主配置文件名为Fckconfig.js 你既可以编辑主配置文件也可以自己定义单独的配置文件.配置文件使用 JAVASCRIPT语法. 修改后在建立编辑器时可以使用以下语法: var oFCKeditor new FCKeditor FCKeditor1 oFCKeditor.ConfigCustomConfigurationsPath /myconfig.js oFCKeditor.Create 提醒:当你修改配置后请清空浏览器缓存以查看效果 配置选项: AutoDetectLanguagetrue/false 自动检测语言 Basehrefquotquot _fcksavedurlquotquotquotquot 相对链接的基地址 ContentLangDirectionquotltr/rtlquot 默认文字方向 ContextMenu字符串数组右键菜单的内容 CustomConfigurationsPathquotquot 自定义配置文件路径和名称 Debugtrue/false 是否开启调试功能这样当调用FCKDebug.Output时会在调试窗中输出内容 DefaultLanguagequotquot 缺省语言 EditorAreaCssquotquot 编辑区的样式表文件 EnableSourceXHTMLtrue/false 为TRUE时当由可视化界面切换到代码页时把HTML处理成XHTML EnableXHTMLtrue/false 是否允许使用XHTML取代HTML FillEmptyBlockstrue/false 使用这个功能可以将空的块级元素用空格来替代 FontColorsquotquot 设置显示颜色拾取器时文字颜色列表 FontFormatsquotquot 设置显示在文字格式列表中的命名 FontNamesquotquot 字体列表中的字体名 FontSizesquotquot 字体大小中的字号列表 ForcePasteAsPlainTexttrue/false 强制粘贴为纯文本 ForceSimpleAmpersandtrue/false 是否不把amp符号转换为XML实体 FormatIndentatorquotquot 当在源码格式下缩进代码使用的字符 FormatOutputtrue/false 当输出内容时是否自动格式化代码 FormatSourcetrue/false 在切换到代码视图时是否自动格式化代码 FullPagetrue/false 是否允许编辑整个HTML文件还是仅允许编辑BODY间的内容 GeckoUseSPANtrue/false 是否允许SPAN标记代替BIU标记 IeSpellDownloadUrlquotquot下载拼写检查器的网址 ImageBrowsertrue/false 是否允许浏览服务器功能 ImageBrowserURLquotquot 浏览服务器时运行的URL ImageBrowserWindowHeightquotquot 图像浏览器窗口高度 ImageBrowserWindowWidthquotquot 图像浏览器窗口宽度 LinkBrowsertrue/false 是否允许在插入链接时浏览服务器 LinkBrowserURLquotquot 插入链接时浏览服务器的URL LinkBrowserWindowHeightquotquot链接目标浏览器窗口高度 LinkBrowserWindowWidthquotquot链接目标浏览器窗口宽度 Pluginsobject 注册插件 PluginsPathquotquot 插件文件夹 ShowBorderstrue/false 合并边框 SkinPathquotquot 皮肤文件夹位置 SmileyColumns12 图符窗列数 SmileyImages字符数组 图符窗中图片文件名数组 SmileyPathquotquot 图符文件夹路径 SmileyWindowHeight 图符窗口高度 SmileyWindowWidth 图符窗口宽度 SpellCheckerquotieSpell/Spellerpagesquot 设置拼写检查器 StartupFocustrue/false 开启时FOCUS到编辑器 StylesXmlPathquotquot 设置定义CSS样式列表的XML文件的位置 TabSpaces4 TAB键产生的空格字符数 ToolBarCanCollapsetrue/false 是否允许展开/折叠工具栏 ToolbarSetsobject 允许使用TOOLBAR集合 ToolbarStartExpandedtrue/false 开启是TOOLBAR是否展开 UseBROnCarriageReturntrue/false 当回车时是产生BR标记还是P或者DIV标记 如何自定义样式列表呢 FCKEDITOR的样式工具栏中提供了预定义的样式样式是通过XML文件定义的 默认的XML样式文件存在于FCkEditor根文件夹下的 FckStyls.xml文件中 这个XML文件的结构分析如下: ltxml versionquot1.0quot encodingquotutf-8quot gt ltStyles gt ltStyle namequotMy Imagequot elementquotimgquotgt ltAttribute namequotstylequot valuequotpadding: 5pxquot /gt ltAttribute namequotborderquot valuequot2quot /gt lt/Style gt ltStyle namequotItalicquot elementquotemquot /gt ltStyle namequotTitlequot elementquotspanquotgt ltAttribute namequotclassquot valuequotTitlequot /gt lt/Style gt ltStyle namequotTitle H3quot elementquoth3quot /gt lt/Stylesgt 每一个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 如果需要针对某个国家的某种语系则可以在语系缩写后加上横线及国家缩写即可 在使用时系统会自动侦测客户端语系及国别而运用适当的界面语言. 当建立一种新的语言后你必须在quotEdit/lang/fcklanguagemanager.jsquot中为其建立一个条目如下所示: FCKLanguageManager.AvailableLanguages en : English pt : Portuguese 需要提醒的是文件必须保存为UTF-8格式 如何与服务器端脚本进行交互 请查看例子以得到相关内容 另外在ASP.NET中以以下步骤使用 1.把FCKEDITOR添中到工具箱 2.托拽FCKEDITOR控件到页面 3.为其指定名称 4.FCKEDITOR 类的所有属性不光可以在代码中使用而且可以作为FCKEDITOR控件的属性直接使用例如要改变皮肤可以在UI页面中指定SkinPath quot/fckeditor/editor/skins/office2003quot即可其实FCKEDITOR的ASP.NET版本可以做得更好你可以找到 FCKEDITOR ASP.NET 2.1的源文件然后修改该控件的设计为其暴露更多有用的属性重新编译即可 5POSTBACK后的数据使用FCKEDITOR控件的value属性获得 6. 由于默认状态下ASP.NET不允许提交含有HTML及JAVASCRIPT的内容因此你必须将使用FCKEDITOR的页面的 ValidateRequest设为false.ltpage validteRequestquotfalsequot gt即可 -------------------------------------------------------- 附 一、如何设置上传文件语言 把FCKeditor根目录下面的fckconfig.js文件里 var _FileBrowserLanguage asp //aspaspxcfm lasso perl php py var _QuickUploadLanguage asp // asp aspx cfm lasso php 这两行中改成您所需要调用的编辑器语言如用asp.net则改为aspx 二、解决中文的问题: 在web.config 中加入: ltglobalization requestEncodingquotGB2312quot responseEncodingquotGB2312quot/gt 这样设置后可以显示中文的文件但URL地址也是中文的 如果服务器对中文地址的解析不好可能导致图片无法浏览 所以修改editorfilemanagerbrowserdefaultfrmresourceslist.html 中的OpenFile函数把 window.top.opener.SetUrl fileUrl 修改为: window.top.opener.SetUrl escapefileUrl 三.设置上传的目录 1:在web.config中设置: ltappSettingsgt ltadd keyquotFCKeditor:UserFilesPathquot valuequot/fck/UpLoad/quot /gt lt/appSettingsgt 2:在Session中设置: 在editorfilemanager browserdefaultconnectorsaspxconnector.aspx中加入以下代码: ltscript runatquotserverquot languagequotCquotgt protected override void OnInitEventArgs e SessionquotFCKeditor:UserFilesPathquot quot/fck/UpLoad1/quot lt/scriptgt 附如何在asp.net中动 态设置上传图片的路径 1.在javascript中修改FCKConfig.ImageBrowserURL的值修改方式如下 FCKConfig.ImageBrowserURL quotPath要上传的文件路径quot 如:要把文件上传到站点根目录的UploadFile文件夹中则设置为 FCKConfig.ImageBrowserURL quotPath/UploadFilequot 2.在quoteditorfilemanagerbrowserdefaultconnectorsaspxconnector.aspxquot文件最后中增加以下程序 ltscript runatquotserverquot languagequotCquotgt protected override void OnInitEventArgs e if Request.QueryStringquotPathquotnull SessionquotFCKeditor:UserFilesPathquot quot/UpLoadFiles/quot //设置默认值 else SessionquotFCKeditor:UserFilesPathquot Request.QueryStringquotPathquot lt/scriptgt Feedback 1楼 楼主 回复 引用 查看 2007-08-22 15:45 by 春风依旧 javascript调用方式 ltscript. type”text/javascript” src”FCKeditor/fckeditor.js”gtlt/scrīptgt lttextarea name”content” cols”80〃 rows”4〃gt lt/textareagt ltscript. type”text/javascript”gt var FCKeditor new FCKeditor”content” oFCKeditor.BasePath “FCKeditor/” oFCKeditor.Height 400 oFCKeditor.ToolbarSet “Default” oFCKeditor.ReplaceTextarea lt/scriptgt 如果想要使用从数据库读来的文本数据或者是后台来自文件的txt/html文本数据。上一篇:【精品】第01章计算机、程序设计与C++入门