FCKeditor的配置与使用

huaxia524151

浏览: 578753 次
性别:
来自: 苏州

最近访客更多访客>>

hh_qq_love_hi

wangxinmei1988

u012366142

xx5333

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

其它

fckeditor ASP.net JavaScript .net Servlet

fckeditor - (1)资料介绍与安装
fckeditor介绍

FCKeditor是一个专门使用在网页上属于开放源代码的所见即所得文字编辑器。

1.fckeditor官网：http://www.fckeditor.net/

2.fckeditor下载：http://www.fckeditor.net/download
  FCKeditor_2.6.3（客户端javascript主程序）http://nchc.dl.sourceforge.net/sourceforge/fckeditor/FCKeditor_2.6.3.zip
  FCKeditor.Java（支持j2ee web平台服务器端程序）
  fckeditor-java-2.4-bin.zip(执行文件)
  http://nchc.dl.sourceforge.net/sourceforge/fckeditor/fckeditor-java-2.4-bin.zip
  fckeditor-java-2.4-src.zip（源文件）
  http://nchc.dl.sourceforge.net/sourceforge/fckeditor/fckeditor-java-2.4-src.zip
  fckeditor-java-demo-2.4.war（样例）
  http://nchc.dl.sourceforge.net/sourceforge/fckeditor/fckeditor-java-demo-2.4.war

3.fckeditor样例 http://www.fckeditor.net/demo/
  demo1:默认fckeditor
  demo2:多语言
  demo3:自定义工具集
  demo4:更换皮肤

4.fckeditor文档 http://docs.fckeditor.net/
  开发者手册:http://docs.fckeditor.net/FCKeditor_2.x/Developers_Guide
  使用者手册:http://docs.fckeditor.net/FCKeditor_2.x/Developers_Guide

安装
参考文档：http://docs.fckeditor.net/FCKeditor_2.x/Developers_Guide/Installation

试验环境:
MyEclipse6.0+Tomcat5.0+Mysql5.0

步骤:

1.在MyEclipse中新建一个web工程TestFckeditor
2.把FCKeditor_2.6.3解压后的生成的文件夹fckeditor拷贝到WebRoot下
3.检测安装是否成功访问http://127.0.0.1:8888/TestFckeditor/fckeditor/_samples/default.html

fckeditor - (2)集成

集成javascript步骤

  参考文档：http://docs.fckeditor.net/FCKeditor_2.x/Developers_Guide/Integration/JavaScript


  1.将JavaScript集成模块脚本放入<head>标签中

   Html代码
   <script type="text/javascript" src="fckeditor/fckeditor.js"></script>

   <script type="text/javascript" src="fckeditor/fckeditor.js"></script>

  2.创建fckeditor
   方法一：（内联）
    在<body>标签适当位置放入如下代码（通常放在标签中）

    Html代码
    <script>
    var oFCKeditor = new FCKeditor('FCKeditor1');
    oFCKeditor.BasePath = "fckeditor/";
    oFCKeditor.Create();
    </script>


   方法二：（替代<textarea>）
    在<head>标签中添加onload方法

    Html代码
    <script>
    window.onload = function()
    {
    var oFCKeditor = new FCKeditor( 'MyTextarea' ) ;
    oFCKeditor.BasePath = "fckeditor/" ;
    oFCKeditor.ReplaceTextarea() ;
    }
    </script>

    在<body>标签中添加以下代码

    Html代码
    <textarea id="MyTextarea" name="MyTextarea">
    This is <b>the</b> initial value.
    </textarea>

   方法三：（动态生成）

    在<head>标签中定义 createFckeditor()方法

    Html代码
    <script>
    function createFckeditor()
    {
    var div = document.getElementById("myFCKeditorDiv");
    var fck = new FCKeditor("myFCKeditor");
    fck.BasePath = "fckeditor/" ;
    div.innerHTML = fck.CreateHtml();
    }
    </script>


    在中div中动态显示fckeditor

    Html代码
    <a href="javascript:void(0);" onclick="createFckeditor();"> 动态创建fckeditor </a>
    <div id="myFCKeditorDiv"> </div>

fckeditor对象属性

  属性名  描述           默认值
  Width   宽度            100%
  Height   高度            200
  Value   编辑器初始化内容         空字符串
  ToolbarSet 工具条集合的名称(Default，Basic，或自定义) Default
  BathPath 编辑器的基路径,BasePath要正确设置，以“/”结尾 /fckeditor

  例如：

  Js代码
  var oFCKeditor = new FCKeditor( 'MyFckeditor' ) ;
  oFCKeditor.BasePath = "fckeditor/" ;
  oFCKeditor.Width="80%";
  oFCKeditor.Height="200";
  oFCKeditor.Value="ok";
  oFCKeditor.ToolbarSet="Basic";

fckeditor构造器

  Js代码
  var fckeditor=function(instanceName,width,height,toolbarSet,value) ;

  instanceName:编辑器输出的textarea元素的name属性或id属性的值，必须指定其他参数会赋给同名属性

  例如:

  Js代码
  var oFCKeditor = new FCKeditor( 'MyFckeditor' ,'80%','300','Basic','ok') ;


集成java步骤

  1.载入jar包

   将fckeditor-java-demo-2.4.war放入运行中的tomcat安装目录下的webapps文件夹中让其解压，从解压后的fckeditor-java-demo-2.4\WEB-INF\lib下拷贝所有的jar文件，加入web工程的classpath中（可以拷贝到WebRoot\WEB-INF\lib文件夹下）

   jar文件包括：
    fckeditor-java-core-2.4.jar
    commons-fileupload-1.2.1.jar
    commons-io-1.3.2.jar
    slf4j-api-1.5.2.jar
    slf4j-simple-1.5.2.jar

  2.在jsp页面中加入tablib指令和fck标签
   参看fckeditor-java-core-2.4.jar/META-INF/FCKeditor.tld

    Xml代码
    <short-name>FCK</short-name>
    <uri>http://java.fckeditor.net</uri>

   在jsp页面中加入tablib指令

    Html代码
    <%@ taglib uri="http://java.fckeditor.net" prefix="FCK"%>

   在<body>中加入自定义标签

    Html代码
    <FCK:editor instanceName="fck1" basePath="/fckeditor" value=" "></FCK:editor>

   注意：basePath以"/"开头代表工程的根路径而非web服务器的根路径，一定要指定value属性，而且值不能为空字符串"",否则会抛NullPointException。

fckeditor - (3)配置
参看文档：http://docs.fckeditor.net/FCKeditor_2.x/Developers_Guide/Configuration/Configuration_File

自定义配置方法

  1.直接修改主配置文件fckconfig.js

   fck主配置文件：fckeditor/fckconfig.js

  2.定义单独的配置文件（只需要写需要修改的配置项）

   2.1.创建myfckconfig.js配置自定义属性

    将myfckconfig.js放入fckeditor/editor文件夹下，

     Java代码
     //系统是否自动检测并运用适当的语言界面
     FCKConfig.AutoDetectLanguage = false ;
     //手动设置默认的语言：法语
     FCKConfig.DefaultLanguage = "fr" ;

   2.2载入自定义配置文件
    方法一：全局载入(对工程中所有fckeditor有效)
     在fckconfig.js找到

      Js代码
      FCKConfig.CustomConfigurationsPath = '' ;

     输入myfckconfig.js位置，FCKConfig.BasePath值fckeditor/editor文件夹

      Js代码
      FCKConfig.CustomConfigurationsPath = FCKConfig.BasePath+'myfckconfig.js ' ;


    方法二：局部载入（只对当前网页有效）

     Js代码
     var oFCKeditor = new FCKeditor( "FCKeditor1" ) ;
     oFCKeditor.Config["CustomConfigurationsPath"] = "myconfig.js" ;
     oFCKeditor.Create() ;



  3.在页面的调用代码中对FCKeditor的实例进行配置

   Js代码
   var oFCKeditor = new FCKeditor( "FCKeditor1" ) ;
   oFCKeditor.Config["AutoDetectLanguage"] = "fasle" ;
   oFCKeditor.Create() ;

配置加载顺序

  1.加载主配置文件fckconfig.js

  2.加载自定义的配置文件（如果有），覆盖相同的配置项

  3.使用对实例的配置覆盖相同的配置项（只对当前实例有效）

主配置文件（fckconfig.js部分属性中文注释）

  Js代码
  FCKConfig.CustomConfigurationsPath = '' ; // 自定义配置文件路径和名称
  FCKConfigFCKConfig.EditorAreaCSS = FCKConfig.BasePath 'css/fck_editorarea.css'; // 编辑区的样式表文件
  FCKConfig.EditorAreaStyles = '' ; // 编辑区的样式表风格
  FCKConfig.ToolbarComboPreviewCSS =''; //工具栏预览CSS
  FCKConfig.DocType = '' ;//文档类型
  FCKConfig.BaseHref = ''; // 相对链接的基地址
  FCKConfig.FullPage = false ; //是否允许编辑整个HTML文件,还是仅允许编辑BODY间的内容
  FCKConfig.StartupShowBlocks = false ;//决定是否启用"显示模块"
  FCKConfig.Debug = false ;//是否开启调试功能
  FCKConfigFCKConfig.SkinPath = FCKConfig.BasePath 'skins/default/' ; //皮肤路径
  FCKConfig.PreloadImages=... //预装入的图片
  FCKConfig.PluginsPath = FCKConfig.BasePath 'plugins/' ; //插件路径
  FCKConfig.AutoDetectLanguage = true ; //是否自动检测语言
  FCKConfig.DefaultLanguage   = 'zh-cn' ; //默认语言
  FCKConfig.ContentLangDirection = 'ltr' ; //默认的文字方向,可选"ltr/rtl",即从左到右或从右到左
  FCKConfig.ProcessHTMLEntities = true ; //处理HTML实体
  FCKConfig.IncludeLatinEntities = true ; //包括拉丁文
  FCKConfig.IncludeGreekEntities = true ;//包括希腊文
  FCKConfig.ProcessNumericEntities = false ;//处理数字实体
  FCKConfig.AdditionalNumericEntities = '' ;   //附加的数字实体
  FCKConfig.FillEmptyBlocks = true ; //是否填充空块
  FCKConfig.FormatSource   = true ; //在切换到代码视图时是否自动格式化代码
  FCKConfig.FormatOutput   = true ; //当输出内容时是否自动格式化代码
  FCKConfig.FormatIndentator = '    ' ; //当在源码格式下缩进代码使用的字符
  FCKConfig.StartupFocus = false ; //开启时焦点是否到编辑器,即打开页面时光标是否停留在fckeditor上
  FCKConfig.ForcePasteAsPlainText = false ; //是否强制粘贴为纯文件内容
  FCKConfig.AutoDetectPasteFromWord = true ; //是否自动探测从word粘贴文件,仅支持IE
  FCKConfig.ShowDropDialog = true ;//是否显示下拉菜单
  FCKConfig.ForceSimpleAmpersand = false ;//是否不把&符号转换为XML实体
  FCKConfig.TabSpaces   = 0 ;//按下Tab键时光标跳格数,默认值为零为不跳格
  FCKConfig.ShowBorders = true ;//合并边框
  FCKConfig.SourcePopup = false ;//弹出
  FCKConfig.ToolbarStartExpanded = true ;//启动fckeditor工具栏默认是否展开
  FCKConfig.ToolbarCanCollapse = true ;//是否允许折叠或展开工具栏
  FCKConfig.IgnoreEmptyParagraphValue = true ;//是否忽略空的段落值
  FCKConfig.FloatingPanelsZIndex = 10000 ;//浮动面板索引
  FCKConfig.HtmlEncodeOutput = false ;//是否将HTML编码输出
  FCKConfig.TemplateReplaceAll = true ;//是否替换所有模板
  FCKConfig.ToolbarLocation = 'In' ;//工具栏位置,
  FCKConfig.ToolbarSets = object ; // 编辑器的工具栏，可以自行定义，删减，可参考已存在工具栏
  FCKConfig.EnterMode = 'p'; // 编辑器中直接回车，在代码中生成，可选为p | div | br
  FCKConfig.ShiftEnterMode = 'br'; // 编辑器中Shift 回车，在代码中生成，可选为p | div | br
  FCKConfig.ContextMenu = 字符串数组; // 右键菜单的内容
  FCKConfig.FontColors = ""; // 文字颜色列表
  FCKConfig.FontNames = ""; // 字体列表
  FCKConfig.FontSizes = ""; // 字号列表
  FCKConfig.FontFormats = ""; // 文字格式列表
  FCKConfig.StylesXmlPath = ""; // CSS样式列表的XML文件的位置
  FCKConfig.TemplatesXmlPath = ""; // 模版的XML文件位置
  FCKConfig.SpellChecker = "ieSpell/Spellerpages"; // 拼写检查器
  FCKConfig.IeSpellDownloadUrl = ""; // 下载拼写检查器的网址
  FCKConfig.FullPage = true/false; // 是否允许编辑整个HTML文件，还是仅允许编辑BODY间的内容
  var _FileBrowserLanguage = 'php' ; // asp | aspx | cfm | lasso | perl | php | py
  var _QuickUploadLanguage = 'php' ;// asp | aspx | cfm | lasso | php[/code]    //第一个是文件浏览器使用的语言，第二个快速上传使用的语言，改成你需要的
  FCKConfig.LinkUploadAllowedExtensions = "" ; // empty for all
  FCKConfig.LinkUploadDeniedExtensions =".(php|php3|php5|phtml|asp|aspx|ascx|jsp|cfm|cfc|pl|bat|exe|dll|reg|cgi)$"    //这是两个允许和拒绝上传的文件类型列表
  FCKConfig.ImageBrowser = false ;//是否在插入图片功能里面启用服务器文件浏览功能
  FCKConfigFCKConfig.ImageBrowserURL = FCKConfig.BasePath 'filemanager/browser/default/browser.html?Type=ImageConnector=connectors/' _FileBrowserLanguage '/connector.' _FileBrowserExtension ;
  //Type=Image   表示文件类型是image这会使文件浏览器定位到文件上传路径/image/文件夹下面
  FCKConfig.FlashBrowser = false ;//是否在插入flash功能中启用服务器文件浏览功能
  FCKConfig.LinkUpload = false ;//是否启用插入链接的快速上传功能
  FCKConfig.ImageUpload = false ;//是否启用图片快速上传功能
  FCKConfig.FlashUpload = false ;//是否启用flash上传功能
  FCKConfigFCKConfig.SmileyPath = FCKConfig.BasePath 'images/smiley/msn/'; // 表情文件存放路径
  FCKConfig.SmileyImages = ''; // 表情文件名称列表，具体参考默认设置
  FCKConfig.SmileyColumns = 8; // 表情窗口显示表情列数
  FCKConfig.SmileyWindowWidth = 320; // 表情窗口显示宽度，此窗口会因为表情文件的改变而作调整
  FCKConfig.SmileyWindowHeight = 240; // 表情窗口显示高度，此窗口会因为表情文件的改变而作调整

常用自定义配置样例

  修改语言

   Js代码
   FCKConfig.AutoDetectLanguage = false ;
   FCKConfig.DefaultLanguage = 'zh-cn' ;



  添加中文字体

   Js代码
   FCKConfig.FontNames = '宋体;黑体;隶书;楷体_GB2312;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;




  更换换行模式

   Js代码
   FCKConfig.EnterMode = 'br' ;       // p | div | br
   FCKConfig.ShiftEnterMode = 'p' ; // p | div | br



  自定义表情

   Js代码
   FCKConfig.SmileyPath = FCKConfig.BasePath + 'images/ftl/' ;
   FCKConfig.SmileyImages =['01.gif','02.gif','03.gif','04.gif','05.gif','06.gif','07.gif','08.gif','09.gif','10.gif','11.gif','12.gif','13.gif','14.gif','15.gif','16.gif','17.gif','18.gif','19.gif','20.gif','21.gif'] ;
   FCKConfig.SmileyColumns = 8 ;
   FCKConfig.SmileyWindowWidth = 480 ;
   FCKConfig.SmileyWindowHeight = 180 ;

   如果表情图片太多，可以设置滚动条

       1.在fckeditor/editor/dialog/fck_smiley.html 中找到

     Js代码
     window.onload = function ()
     {
     oEditor.FCKLanguageManager.TranslatePage(document) ;
     dialog.SetAutoSize( true ) ;
     }

     将dialog.SetAutoSize( true ) 改为dialog.SetAutoSize( false)

       2.再找到

     Html代码
     <body style="overflow: hidden">
     <body>

     将 hidden改为auto




   更换皮肤

    Js代码
    FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/office2003/' ;

     fckeditor默认提供三种皮肤，如果想得到更多皮肤请访问:
     http://sourceforge.net/tracker/?atid=740153&group_id=75348&func=browse





  自定义工具集

   fckeditor提供两种工具集Default/Basic,也可以自己定义

   Js代码
   FCKConfig.ToolbarSets["MYTOOLBAR"] = [
       ['Source','-','FitWindow','-','Preview'],
       ['Undo','Redo'],
       ['Link','Unlink','Anchor'],
       ['Image','Flash','Table','Rule','Smiley','SpecialChar'],
       ['JustifyLeft','JustifyCenter','JustifyRight'],
       ['About'],
       '/',
       ['Bold','Italic','Underline'],
       ['OrderedList','UnorderedList','-','Outdent','Indent','Blockquote'],
       ['FontName','FontSize'],
       ['TextColor','BGColor']
   ] ;


  在页面调用,要显示设置FCKeditor对象的ToolbarSet属性

  Java代码
   var oFCKeditor = new FCKeditor( 'MyTextarea' ) ;
   oFCKeditor.BasePath = "fckeditor/" ;
   oFCKeditor.Config["CustomConfigurationsPath"] ='myfckconfig.js ' ;
   oFCKeditor.ToolbarSet="MYTOOLBAR";
   oFCKeditor.Create();

fckeditor - (4)文件上传
fckeditor默认不支持文件上传，需要下载web服务器端程序（fckeditor.java），并进行配置

1.在web.xml中加入ConnectorServlet的配置信息

  Xml代码
   <servlet>
     <servlet-name>Connector</servlet-name>
     <servlet-class>
      net.fckeditor.connector.ConnectorServlet
     </servlet-class>
     <load-on-startup>1</load-on-startup>
   </servlet>

   <servlet-mapping>
     <servlet-name>Connector</servlet-name>
     <url-pattern>
      /fckeditor/editor/filemanager/connectors/*
     </url-pattern>
   </servlet-mapping>

2.在classpath路径上创建fckeditor.properties(在src文件夹下创建)

  Java代码
   connector.userActionImpl=net.fckeditor.requestcycle.impl.UserActionImpl

乱码问题

  由于fckeditor未考虑中文乱码问题，所以需要对ConnectorServlet做修改

  解决fckeditor创建文件夹中文乱码问题

   在ConnectorServlet的doGet方法中找到String newFolderStr = UtilsFile.sanitizeFolderName(newFolderName);这行代码，在其上添加如下2行代码。

   Java代码
    //NewFolderName为新创建的文件夹名称，先用iso-8859-1编码将字符串还原成字节数组，在用utf-8重新编码
    String newFolderName = request.getParameter("NewFolderName");
    newFolderName = new String(newFolderName.getBytes("iso-8859-1"), "utf-8");

    String newFolderStr = UtilsFile.sanitizeFolderName(newFolderName);

  解决上传文件名为中文文件时出现乱码
   fckeditor在java平台采用的是commons-upload组件进行文件上传，只要修改ServletFileUpload的headerEncoding属性为utf-8就能解决上传文件名是中文时所出现的乱码问题。在ConnectorServlet的doPost方法中找到ServletFileUpload upload = new ServletFileUpload(factory);在其后加入下面代码

   Java代码
    FileItemFactory factory = new DiskFileItemFactory();
    ServletFileUpload upload = new ServletFileUpload(factory);

    //解决上传文件名为中文名时出现乱码
    upload.setHeaderEncoding("utf-8");

中文图片不能引用
  修改server.xml 端口为8080的Connector，添加属性URIEncoding="UTF-8"

  Xml代码
   <Connector port="8080" maxHttpHeaderSize="8192"
                 maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
                 enableLookups="false" redirectPort="8443" acceptCount="100"
                 connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8" />

解决上传文件名重名问题

  上传文件名用uuid随机生成的32位字符串代替，防止文件名重复

  Java代码
   String filename = FilenameUtils.getName(rawName);
   String baseName = FilenameUtils.removeExtension(filename);
   String extension = FilenameUtils.getExtension(filename);

    //上传文件名用uuid随机生成的32位字符串代替，防止文件名重复
   filename=UUID.randomUUID().toString().replace("-", "")+"."+extension;

控制允许上传文件的文件类型
  fckeditor把上传的文件分为四种：file，Image，Flash，Media
  fckeditor会对上传文件的类型进行两次验证（前台javascript验证和后台java验证）所以需要对myconfig.js和fckeditor.propertise进行配置
  例如：限制上传图片格式为gif和png
  在myconfig.js增加下面配置（可参看fckconfig.js的具体配置选项）

  Js代码
   FCKConfig.ImageUploadAllowedExtensions = ".(gif|png)$" ;


在fckeditor.propertise进行配置（可参看）

  Java代码
   connector.resourceType.image.extensions.allowed=gif|png



控制允许上传文件的文件大小

  1.在服务端的servlet中，在保存文件之前先判断一下文件大小，如果超出限制，就传递一个自定义的错误码，并且不再保存文件,在ConnectorServlet的doPost方法中找到if (!ExtensionsHandler.isAllowed(resourceType, extension))
  在后面添加else if语句块

   Java代码
    //如果文件的扩展名不允许上传
    if (!ExtensionsHandler.isAllowed(resourceType, extension))
        ur = new UploadResponse(UploadResponse.SC_INVALID_EXTENSION);
    //如果文件大小超出限制10k
    else if(uplFile.getSize()>10*1024){
    //传递一个自定义的错误码
        ur = new UploadResponse(204);
    }
    //如果不存在以上错误，则保存文件
    else {
        ...

    }

  2.修改对应的页面中的回调函数，增加对这个自定义的错误码的处理
  找到fckeditor/editor/filemanager/browser/default/frmupload.html和fckeditor/editor/dialog/fck_image/fck_image.js中的OnUploadCompleted方法，
  在switch 语句块中添加如下代码

   Js代码
    case 204 :
       alert( '文件太大' ) ;
       break ;

分享到：

插入样式表的方法 | SVN配置

2010-12-19 10:58
浏览 36527
评论(0)
分类:编程语言
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论