如何快速实现HTML编辑器.NET组件

作者：未知   请作者速与本人联系


得到“素材”

首先我们需要得到一个HTML编辑器的原始代码，网上有不少这类的编辑器，如大名鼎鼎的RichTextBox，为了避免版权纠纷，以我所做得为例（暂名：UltraTextBox）：在编辑器工具栏的空白地方点击鼠标右键－－>查看源代码，如图所示。

把代码拷贝出来保存成一个.htm文件就可以看到效果，是不是感觉很简单的就作了一半？：）

为了以后讲解方面我们把它保存为editor.aspx文件，在这里注意删除掉__VIEWSTATE一段。

然后把相应的图标，CSS文件等保存在相应的位置，否则你的界面会很难看，当然你也可以根据需要自己来做图标。

好了，准备工作基本做完，下面是讲怎样把它封装为.NET组件，方便你在工程中使用。

--------------------------------------------------------------------------------

封装成ASP.NET组件

首先在VS.NET环境里生成一个UltraTextBoxV1组件（也可以称为自定义控件，我习惯称为组件）项目，

using System;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.ComponentModel;
//设置该组件的标记前缀
[assembly:TagPrefix("gOODiDEA.UltraTextBoxV1", "UTBV1")]
namespace gOODiDEA.UltraTextBoxV1
{
    //添加类声明 
    [
    DefaultProperty("Text"),
    ValidationProperty("Text"),
    ToolboxData("<{0}:UltraTextBoxV1 runat=server>"),
    ParseChildren(false),
    Designer("gOODiDEA.UltraTextBoxV1.UltraTextBoxV1Designer")
    ]
    public class UltraTextBoxV1: System.Web.UI.Control, IPostBackDataHandler
    {
        private static readonly object ValueChangedEvent = new object();
        //声明一个代理用于处理值被改变的事件，当组件的值更改时发生ValueChanged事件 
        public event EventHandler ValueChanged
        {
            add
            {
                Events.AddHandler(ValueChangedEvent, value);
            }
            remove
            {
                Events.RemoveHandler(ValueChangedEvent, value) ;
            }
        }
        //触发值被改变事件的方法
        protected virtual void OnValueChanged(EventArgs e)
        {
            if( Events != null )
            {
                EventHandler oEventHandler = ( EventHandler )Events[ValueChangedEvent] ;
                if (oEventHandler != null) oEventHandler(this, e);
            }
        }
        //处理回发数据 
        bool IPostBackDataHandler.LoadPostData( string postDataKey, 
System.Collections.Specialized.NameValueCollection postCollection )
        {
            if ( postCollection[postDataKey] != Text )
            {
                Text = postCollection[postDataKey];
                return true;
            }
            return false;
        }
        //告诉应用程序该组件的状态已更改 
        void IPostBackDataHandler.RaisePostDataChangedEvent()
        {
            OnValueChanged( EventArgs.Empty );
        }

        //我们对一个编辑器主要需要实现下面4个属性，Text，Width，Height，BasePath。

        //Text属性：（从编辑器得到值和把值赋给编辑器）
        [Bindable(true),DefaultValue("")] 
        public string Text
        {
            get 
            {
                object o = ViewState["Text"];
                return ( o == null ) ? String.Empty : ( string )o;
            }
            set
            {
                ViewState["Text"] = value;
            }
        }

        //Width属性：（编辑器的宽）
        [Bindable(true),Category("Appearence"),DefaultValue("100%")] 
        public Unit Width
        {
            get 
            {
                object o = ViewState["Width"];
                return ( o == null ) ? Unit.Parse( "100%" ) : ( Unit )o ;
            }
            set
            { 
                ViewState["Width"] = value ;
            }
        }

        //Height属性：（编辑器的高）
        [Bindable(true),Category("Appearence"),DefaultValue("385px")] 
        public Unit Height
        {
            get 
            {
                object o = ViewState["Height"];
                return ( o == null ) ? Unit.Parse( "385px" ) : ( Unit )o ;
            }
            set
            {
                ViewState["Height"] = value ;
            }
        }

        //BasePath属性：（第一步保存的editor.aspx的路径以及以后做的插件的路径）
        [Bindable(true),DefaultValue("../UltraTextBoxV1Sys/Plug-Ins/")] 
        public string BasePath
        {
            get 
            {
                object o = ViewState["BasePath"];
                return (o == null) ? "../UltraTextBoxV1Sys/Plug-Ins/" : (string)o;
            }
            set
            {
                ViewState["BasePath"] = value;
            }
        } 

        //接下来是最重要的怎样把本组件和Editor.aspx结合起来，这里使用的是iframe技术：
        //覆盖Render方法，运行时输出：
        protected override void Render(HtmlTextWriter output)
        {
            System.Web.HttpBrowserCapabilities oBrowser = Page.Request.Browser ;
            //对应的IE版本必须是5.5或以上的版本 
            if (oBrowser.Browser == "IE" && oBrowser.MajorVersion >= 5.5 && oBrowser.Win32)
            {
                string sLink = BasePath + "Editor.aspx?FieldName=" + UniqueID;
                //如果不使用SetTimeout则会提示找不到对象 
                output.Write(
                "",
                sLink, 
                Width, 
                Height,
                Text,
                UniqueID,
                ID + "_editor"
                ) ;
                //存储编辑器的值 
                output.Write(
                "",
                UniqueID, 
                System.Web.HttpUtility.HtmlEncode(Text) ) ;
            }
        }
    } 

    //接下来给该组件实现一个设计时的界面：
    public class UltraTextBoxV1Designer : System.Web.UI.Design.ControlDesigner
    {
        public UltraTextBoxV1Designer(){}
        public override string GetDesignTimeHtml() 
        {
            UltraTextBoxV1 oControl = ( UltraTextBoxV1 )Component ;
            return String.Format(
            " cellspacing=/"0/" border=/"1/">
UltraTextBox 1.1 - {2}
",
            oControl.Width,
            oControl.Height,
            oControl.ID ) ;
        }
    }
} 

至此组件部分就基本做完，把它编译后的Dll拷贝你的项目文件夹下，在工具栏－－>组件里添加它，你就可以直接拖放进你的页面，在你的工程中使用。

--------------------------------------------------------------------------------

添加插件

这里举两个例子来说明怎样给该编辑器添加插件：

如果你要给编辑器添加一些功能，如上传图片，插入标签等，则首先应该给它添加一个图标：

然后在JScript代码里添加UTB_InsertImg()，UTB_InsertExcel()的实现：
function UTB_InsertImg()
{
//只能在编辑模式下使用
if ( ! UTB_validateMode() )
return;
HtmlEdit.focus();
//在当前光标处创建一个区域用于插入图片
var range = HtmlEdit.document.selection.createRange();
//用模式对话框打开上传页面，把返回值插入到编辑器中
var arr = showModalDialog(""uploadface.aspx"", """", ""dialogWidth:430px;dialogHeight:280px;help:0;status:0"");
if (arr != null)
{
//得到的返回值应该是形如：
range.pasteHTML( arr );
}
HtmlEdit.focus();
}

function UTB_InsertExcel()
{
if (!UTB_validateMode())
return;
HtmlEdit.focus();
//在这里其实就是插入一个Microsoft Office Web Components（MSOWC）组件
var range = HtmlEdit.document.selection.createRange();
range.pasteHTML("""");
HtmlEdit.focus();
} 

关于怎样实现上传图片在这里就不多讲，CSDN上这类帖子太多了。只是要注意一点，因为使用的是模式对话框，所以在该页面不能有回发事件，操作最好在iframe里做。

--------------------------------------------------------------------------------

总结

谢谢你能看到这里，至此一个简单的HTML编辑器就制作完成了，本文主要讲述了如何得到一个HTML编辑器的代码，如何把它封装成一个.NET组件以及通过两个列子讲解了给它添加插件的方法。从上面的步凑你可以看出制作一个HTML编辑器其实很简单，虽然借鉴了一些别人的代码，但如果你仔细分析一下那些JS脚本，你就会豁然开朗的，如果你有更好的想法希望能告诉我。