FCKeditor 介绍

FCKeditor 这个开源的HTML 文本编辑器可以让web 程序拥有如MS Word 这样强大的编辑功
能.FCKeditor 支持当前流行的浏览器如IE 5.5+, Firefox 1.0+, Mozilla 1.3+与Netscape 7+等

FCKeditor官司方网址：http://www.fckeditor.net/

FCKeditor在线DEMO： http://www.fckeditor.net/demo

FCKeditor下载直址： http://www.fckeditor.net/download (该版本为2.3.2)，最新版已经是2.4了。

2.FCKeditor.java介绍

不能直接在JSP项目中使用，需要FCKeditor.java库的支持。

FCKeditor.java是针对对JAVA中使用FCKeditor由Simone Chiaretta开发的FCKeditor的JAVA实现。

下载地址： http://www.fckeditor.net/download (最近版本为2.3)

 

3.在JAVA项目中使用FCKeditor在线编辑器

开发环境：JDK5.0 ＋<!--[if !supportLists]--> Eclipse3.2.1 + WTP1.5.2

（1）新建一个WEB工程：

（2）解压 FCKeditor_2.3.2.zip包，将其中的 edit 文件夹到项目中的 WebRoot 目录

（3）解压 FCKeditor_2.3.2.zip 包，将其中的 fckconfig.js、fckeditor.js、fckstyles.xml、fcktemplates.xml 文件夹到项目中的 WebRoot 目录

（4）解压 FCKeditor.java-2.3.zip 包，将其中的 /web/WEB-INF/lib 下的两个 jar 文件到项目的 WebRoot/WEB-INF/lib 目录

（5）解压 FCKeditor.java-2.3.zip 包，将其中的 /src 下的 FCKeditor.tld 文件到项目的 WebContent/WEB-INF 目录

（6）删除 WebContent/edit 目录下的 _source 文件夹（以“_”开始的文件，在项目中无用）

 修改WebContent/WEB-INF/web.xml文件，加入FCKeditor的配置信息，如下：

1. xml version="1.0" encoding="UTF-8"?>  
2. <web-app id="WebApp_ID" version="2.4"  
3.     xmlns="http://java.sun.com/xml/ns/j2ee"  
4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
5.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">  
6.     <display-name>FCKeditor<!--</span-->display-name>  
7.     <servlet>  
8.         <servlet-name>Connector<!--</span-->servlet-name>  
9.         <servlet-class>  
10.             com.fredck.FCKeditor.connector.ConnectorServlet  
11.         <!--</span-->servlet-class>  
12.         <init-param>  
13.             <param-name>baseDir<!--</span-->param-name>  
14.             <!-- 此为文件浏览路径 -->  
15.             <param-value>/UserFiles/<!--</span-->param-value>  
16.         <!--</span-->init-param>  
17.         <init-param>  
18.             <param-name>debug<!--</span-->param-name>  
19.             <param-value>true<!--</span-->param-value>  
20.         <!--</span-->init-param>  
21.         <load-on-startup>1<!--</span-->load-on-startup>  
22.     <!--</span-->servlet>  
23.     <servlet>  
24.         <servlet-name>SimpleUploader<!--</span-->servlet-name>  
25.         <servlet-class>  
26.             com.fredck.FCKeditor.uploader.SimpleUploaderServlet  
27.         <!--</span-->servlet-class>  
28.         <init-param>  
29.             <param-name>baseDir<!--</span-->param-name>  
30.             <!-- 此为文件上传路径，需要在WebRoot 目录下新建 UserFiles 文件夹 -->  
31.             <!-- 根据文件的类型还需要新建相关的文件夹 Image、Flash -->  
32.             <param-value>/UserFiles/<!--</span-->param-value>  
33.         <!--</span-->init-param>  
34.         <init-param>  
35.             <param-name>debug<!--</span-->param-name>  
36.             <param-value>true<!--</span-->param-value>  
37.         <!--</span-->init-param>  
38.         <init-param>  
39.             <!-- 此参数为是否开启上传功能 -->  
40.             <param-name>enabled<!--</span-->param-name>  
41.             <param-value>false<!--</span-->param-value>  
42.         <!--</span-->init-param>  
43.         <init-param>  
44.             <param-name>AllowedExtensionsFile<!--</span-->param-name>  
45.             <param-value><!--</span-->param-value>  
46.         <!--</span-->init-param>  
47.         <init-param>  
48.             <!-- 此参数为文件过滤，以下的文件类型都不可以上传 -->  
49.             <param-name>DeniedExtensionsFile<!--</span-->param-name>  
50.             <param-value>  
51.                 php|php3|php5|phtml|asp|aspx|ascx|jsp|cfm|cfc|pl|bat|exe|dll|reg|cgi  
52.             <!--</span-->param-value>  
53.         <!--</span-->init-param>  
54.         <init-param>  
55.             <param-name>AllowedExtensionsImage<!--</span-->param-name>  
56.             <param-value>jpg|gif|jpeg|png|bmp<!--</span-->param-value>  
57.         <!--</span-->init-param>  
58.         <init-param>  
59.             <param-name>DeniedExtensionsImage<!--</span-->param-name>  
60.             <param-value><!--</span-->param-value>  
61.         <!--</span-->init-param>  
62.         <init-param>  
63.             <param-name>AllowedExtensionsFlash<!--</span-->param-name>  
64.             <param-value>swf|fla<!--</span-->param-value>  
65.         <!--</span-->init-param>  
66.         <init-param>  
67.             <param-name>DeniedExtensionsFlash<!--</span-->param-name>  
68.             <param-value><!--</span-->param-value>  
69.         <!--</span-->init-param>  
70.         <load-on-startup>1<!--</span-->load-on-startup>  
71.     <!--</span-->servlet>  
72.     <servlet-mapping>  
73.         <servlet-name>Connector<!--</span-->servlet-name>  
74.         <url-pattern>  
75.             /editor/filemanager/browser/default/connectors/jsp/connector  
76.         <!--</span-->url-pattern>  
77.     <!--</span-->servlet-mapping>  
78.     <servlet-mapping>  
79.         <servlet-name>SimpleUploader<!--</span-->servlet-name>  
80.         <url-pattern>  
81.             /editor/filemanager/upload/simpleuploader  
82.         <!--</span-->url-pattern>  
83.     <!--</span-->servlet-mapping>  
84. <!--</span-->web-app>
85. 注：web.xml中已经加入了一些常用配置的说明。  
86. • 新建input.jsp文件，内容如下：(注意内容中的” testfck”这个id)
    •  
    •  id="testfck" <!--—注意这里 -->  
    •     basePath="/FCKeditor/"   
    •     height="60%"  
    •     skinPath="/FCKeditor/editor/skins/default/"   
    •     toolbarSet="Default"  
    •     imageBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/jsp/connector"  
    •     linkBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Connector=connectors/jsp/connector"  
    •     flashBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/jsp/connector"  
    •     imageUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Image"  
    •     linkUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=File"  
    •     flashUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Flash">  
    •  
      (10) 新建 文件，这个文件比较简单，只是简单的显示从 在线编辑器传递过来的内容，如下：
      <%= request.getParameter( "testfck" ) %>
      注意这里的getParameter(“testfck”)，这个”testfck”就是在input.jsp中设置的id。
      
      ４．FCKeditor类说明
      下面是用来在页面中建立编辑器的 FCKEDITOR 类的说明
      (1) 构造器:
      FCKeditor(instanceName[,width,height,toolbarSet,value])
      
      
      • instanceName:编辑器的唯一名称 (相当于ID)
      • WIDTH:宽度
      • HEIGHT:高度
      • toolbarSet:工具条集合的名称
      • value:编辑器初始化内容
      
      
      (2) 属性:
      • instanceName:编辑器实例名
      • width:宽度 ,默认值为100%
      • height:高度 ,默认值是200
      • ToolbarSet:工具集名称 ,参考FCKCONFIG.JS,默认值是Default
      • value:初始化编辑器的 HTML 代码,默认值为空
      • BasePath:编辑器的基路径 ,默认为/Fckeditor/文件夹,注意,尽量不要使用相对路径.最用相对于站点根路径的表示方法,要以/结尾
      • CheckBrowser:是否在显示编辑器前检查浏览器兼容性 ,默认为true
      • DisplayErrors:是否显示提示错误 ,默为true
      (3) 集合:
      Config[Key]=value
      这个集合用于更改配置中某一项的值 ,如
      oFckeditor.Config["DefaultLanguage"]="ptbr"
      (4) 方法:
      Create()
      建立并输出编辑器
      RepaceTextArea(TextAreaName)
      用编辑器来替换对应的文本框
      5.如何配置FCKEDITOR
      FCKEDITOR 提供了一套用于定制其外观 ,特性及行为的设置集.主配置文件名为Fckconfig.js你既可以编辑主配置文件,也可以自己定义单独的配置文件.配置文件使用JAVASCRIPT 语法.修改后,在建立编辑器时,可以使用以下语法:
      varoFCKeditor=newFCKeditor('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
     在JSP中集成FCKeditor<!--[endif]-->JavaScript集成：
    如上面内容所示，通过新建一个 FCKeditor对象，然后调用该对象的设置方法来设置 FCKeditor的各个属性，最后调用 FCKeditor的 ReplaceTextarea()替换 HTML页面中的 < textarea>标签。另外 FCKeditor也可以调用它的 create()方法来直接在 JSP嵌入 FCKeditor编辑器。
    注：注意上面的 oFCKeditor.BasePath = "" ;用这种方式 FCKeditor会去查找它的 editor目录下的 fckeditor.html文件，由于我是直接将 editor文件夹拷贝到 WebContent目录下，所以将它的 BasePath设置为 ””，如果您将 editor拷贝到其它目录，请设置相应的 BasePath属性。 FCKeditor默认是将其放在 fckeditor目录
    （2）<!--[endif]-->使用 自定义标签 该方法一定要完成第 步：解压 FCKeditor.java-2.3.zip 包，将其中的 /src 下的 FCKeditor.tld 文件到项目的 WebContent/WEB-INF 目录
    首先在 JSP中加入 FCKeditor标签：
    <%@ taglib uri=”/WEB-INF/FCKeditor.tld” prefix=”fck” %>
           JSP页面中加入如下代码，集成FCKeditor编辑器：
    js 代码

修改使用一下的隐藏文本域：

<textarea style="display:none" name="content1"> <%=content%></textarea>

1.