ASP.NET配置KindEditor文本编辑器-图文实例

2022-09-13 22:41:29

1.什么是KindEditor

KindEditor 是一套开源的在线HTML编辑器，主要用于让用户在网站上获得所见即所得编辑效果，开发人员可以用 KindEditor 把传统的多行文本输入框(textarea)替换为可视化的富文本输入框。 KindEditor 使用 JavaScript 编写，可以无缝地与 Java、.NET、PHP、ASP 等程序集成，比较适合在 CMS、商城、论坛、博客、Wiki、电子邮件等互联网应用上使用。

2.前期准备

到官网下载最新版的KindEditor 4.11，解压文件后可得

文件结构：

asp：与asp结合的示例代码

asp.net：与asp.net结合的示例代码

attached：上传文件的根目录，可在相关的代码中修改

examples：功能演示的示例代码

jsp：与jsp结合的示例代码

lang：语言包

php：与php结合的示例代码

plugins：控件的功能代码的实现

kindeditor.js：配置文件

kindeditor-min.js：集成文件

由于使用的是ASP.NET，所以将不需要的文件夹删掉。其中在asp.net中demo.aspx是参考代码，也可以删掉。

3.配置KindEditor

（1）新建网站，将精简后的kindeditor文件夹放到网站根目录下下，并且引用kindeditor/asp.net/bin/LitJSON.dll文件。

（2）新建index.aspx文件，引入相关文件

    <link href="kindeditor/plugins/code/prettify.css" rel="stylesheet" type="text/css" />

    <script src="kindeditor/lang/zh_CN.js" type="text/javascript"></script>

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

    <script src="kindeditor/plugins/code/prettify.js" type="text/javascript"></script>

    <script type="text/javascript">

        KindEditor.ready(function (K) {

            var editor = K.create('#content', {

                //上传管理

                uploadJson: 'kindeditor/asp.net/upload_json.ashx',

                //文件管理

                fileManagerJson: 'kindeditor/asp.net/file_manager_json.ashx',

                allowFileManager: true,

                //设置编辑器创建后执行的回调函数

                afterCreate: function () {

                    var self = this;

                    K.ctrl(document, 13, function () {

                        self.sync();

                        K('form[name=example]')[0].submit();

                    });

                    K.ctrl(self.edit.doc, 13, function () {

                        self.sync();

                        K('form[name=example]')[0].submit();

                    });

                },

                //上传文件后执行的回调函数,获取上传图片的路径

                afterUpload : function(url) {

                        alert(url);

                },

                //编辑器高度

                width: '700px',

                //编辑器宽度

                height: '450px;',

                //配置编辑器的工具栏

                items: [

                'source', '|', 'undo', 'redo', '|', 'preview', 'print', 'template', 'code', 'cut', 'copy', 'paste',

                'plainpaste', 'wordpaste', '|', 'justifyleft', 'justifycenter', 'justifyright',

                'justifyfull', 'insertorderedlist', 'insertunorderedlist', 'indent', 'outdent', 'subscript',

                'superscript', 'clearhtml', 'quickformat', 'selectall', '|', 'fullscreen', '/',

                'formatblock', 'fontname', 'fontsize', '|', 'forecolor', 'hilitecolor', 'bold',

                'italic', 'underline', 'strikethrough', 'lineheight', 'removeformat', '|', 'image', 'multiimage',

                'flash', 'media', 'insertfile', 'table', 'hr', 'emoticons', 'baidumap', 'pagebreak',

                'anchor', 'link', 'unlink', '|', 'about'

                ]

            });

            prettyPrint();

        });

    </script>

（3）在页面中添加一个textbox控件，将id命名为content，把属性"TextMode"属性改为Multiline

<body>

    <form id="form1" runat="server">

    <div id="main">

        <asp:TextBox id="content" name="content" TextMode="MultiLine" runat="server"></asp:TextBox>

    </div>

    </form>

</body>

（4）在浏览器查看

4.附件上传原理

在asp.net文件夹下有两个重要的file_manager_json.ashx，upload_json.ashx，一个负责文件管理，一个负责上传管理。你可以根据自己需求进行相关修改。

原理：通过实现接口IHttpHandler来接管HTTP请求。

file_manager_json.ashx

<%@ webhandler Language="C#" class="FileManager" %>

/**

 * KindEditor ASP.NET

 * 文件管理

 */

using System;

using System.Collections;

using System.Web;

using System.IO;

using System.Text.RegularExpressions;

using LitJson;

using System.Collections.Generic;

public class FileManager : IHttpHandler

{

    public void ProcessRequest(HttpContext context)

    {

        String aspxUrl = context.Request.Path.Substring(0, context.Request.Path.LastIndexOf("/") + 1);

        //根目录路径，相对路径

        String rootPath = "http://www.cnblogs.com/attached/";

        //根目录URL，可以指定绝对路径，比如 http://www.yoursite.com/attached/

        String rootUrl = aspxUrl + "http://www.cnblogs.com/attached/";

        //图片扩展名

        String fileTypes = "gif,jpg,jpeg,png,bmp";

        String currentPath = "";

        String currentUrl = "";

        String currentDirPath = "";

        String moveupDirPath = "";

        String dirPath = context.Server.MapPath(rootPath);

        String dirName = context.Request.QueryString["dir"];

        if (!String.IsNullOrEmpty(dirName)) {

            if (Array.IndexOf("image,flash,media,file".Split(','), dirName) == -1) {

                context.Response.Write("Invalid Directory name.");

                context.Response.End();

            }

            dirPath += dirName + "/";

            rootUrl += dirName + "/";

            if (!Directory.Exists(dirPath)) {

                Directory.CreateDirectory(dirPath);

            }

        }

        //根据path参数，设置各路径和URL

        String path = context.Request.QueryString["path"];

        path = String.IsNullOrEmpty(path) ? "" : path;

        if (path == "")

        {

            currentPath = dirPath;

            currentUrl = rootUrl;

            currentDirPath = "";

            moveupDirPath = "";

        }

        else

        {

            currentPath = dirPath + path;

            currentUrl = rootUrl + path;

            currentDirPath = path;

            moveupDirPath = Regex.Replace(currentDirPath, @"(.*?)[^\/]+\/$", "$1");

        }

        //排序形式，name or size or type

        String order = context.Request.QueryString["order"];

        order = String.IsNullOrEmpty(order) ? "" : order.ToLower();

        //不允许使用..移动到上一级目录

        if (Regex.IsMatch(path, @"\.\."))

        {

            context.Response.Write("Access is not allowed.");

            context.Response.End();

        }

        //最后一个字符不是/

        if (path != "" && !path.EndsWith("/"))

        {

            context.Response.Write("Parameter is not valid.");

            context.Response.End();

        }

        //目录不存在或不是目录

        if (!Directory.Exists(currentPath))

        {

            context.Response.Write("Directory does not exist.");

            context.Response.End();

        }

        //遍历目录取得文件信息

        string[] dirList = Directory.GetDirectories(currentPath);

        string[] fileList = Directory.GetFiles(currentPath);

        switch (order)

        {

            case "size":

                Array.Sort(dirList, new NameSorter());

                Array.Sort(fileList, new SizeSorter());

                break;

            case "type":

                Array.Sort(dirList, new NameSorter());

                Array.Sort(fileList, new TypeSorter());

                break;

            case "name":

            default:

                Array.Sort(dirList, new NameSorter());

                Array.Sort(fileList, new NameSorter());

                break;

        }

        Hashtable result = new Hashtable();

        result["moveup_dir_path"] = moveupDirPath;

        result["current_dir_path"] = currentDirPath;

        result["current_url"] = currentUrl;

        result["total_count"] = dirList.Length + fileList.Length;

        List<Hashtable> dirFileList = new List<Hashtable>();

        result["file_list"] = dirFileList;

        for (int i = 0; i < dirList.Length; i++)

        {

            DirectoryInfo dir = new DirectoryInfo(dirList[i]);

            Hashtable hash = new Hashtable();

            hash["is_dir"] = true;

            hash["has_file"] = (dir.GetFileSystemInfos().Length > 0);

            hash["filesize"] = 0;

            hash["is_photo"] = false;

            hash["filetype"] = "";

            hash["filename"] = dir.Name;

            hash["datetime"] = dir.LastWriteTime.ToString("yyyy-MM-dd HH:mm:ss");

            dirFileList.Add(hash);

        }

        for (int i = 0; i < fileList.Length; i++)

        {

            FileInfo file = new FileInfo(fileList[i]);

            Hashtable hash = new Hashtable();

            hash["is_dir"] = false;

            hash["has_file"] = false;

            hash["filesize"] = file.Length;

            hash["is_photo"] = (Array.IndexOf(fileTypes.Split(','), file.Extension.Substring(1).ToLower()) >= 0);

            hash["filetype"] = file.Extension.Substring(1);

            hash["filename"] = file.Name;

            hash["datetime"] = file.LastWriteTime.ToString("yyyy-MM-dd HH:mm:ss");

            dirFileList.Add(hash);

        }

        context.Response.AddHeader("Content-Type", "application/json; charset=UTF-8");

        context.Response.Write(JsonMapper.ToJson(result));

        context.Response.End();

    }

    public class NameSorter : IComparer

    {

        public int Compare(object x, object y)

        {

            if (x == null && y == null)

            {

                return 0;

            }

            if (x == null)

            {

                return -1;

            }

            if (y == null)

            {

                return 1;

            }

            FileInfo xInfo = new FileInfo(x.ToString());

            FileInfo yInfo = new FileInfo(y.ToString());

            return xInfo.FullName.CompareTo(yInfo.FullName);

        }

    }

    public class SizeSorter : IComparer

    {

        public int Compare(object x, object y)

        {

            if (x == null && y == null)

            {

                return 0;

            }

            if (x == null)

            {

                return -1;

            }

            if (y == null)

            {

                return 1;

            }

            FileInfo xInfo = new FileInfo(x.ToString());

            FileInfo yInfo = new FileInfo(y.ToString());

            return xInfo.Length.CompareTo(yInfo.Length);

        }

    }

    public class TypeSorter : IComparer

    {

        public int Compare(object x, object y)

        {

            if (x == null && y == null)

            {

                return 0;

            }

            if (x == null)

            {

                return -1;

            }

            if (y == null)

            {

                return 1;

            }

            FileInfo xInfo = new FileInfo(x.ToString());

            FileInfo yInfo = new FileInfo(y.ToString());

            return xInfo.Extension.CompareTo(yInfo.Extension);

        }

    }

    public bool IsReusable

    {

        get

        {

            return true;

        }

    }

}

upload_json.ashx

<%@ webhandler Language="C#" class="Upload" %>

/**

 * KindEditor ASP.NET

 * 上传管理

 */

using System;

using System.Collections;

using System.Web;

using System.IO;

using System.Globalization;

using LitJson;

public class Upload : IHttpHandler

{

    private HttpContext context;

    public void ProcessRequest(HttpContext context)

    {

        String aspxUrl = context.Request.Path.Substring(0, context.Request.Path.LastIndexOf("/") + 1);

        //文件保存目录路径

        String savePath = "http://www.cnblogs.com/attached/";

        //文件保存目录URL

        String saveUrl = aspxUrl + "http://www.cnblogs.com/attached/";

        //定义允许上传的文件扩展名

        Hashtable extTable = new Hashtable();

        extTable.Add("image", "gif,jpg,jpeg,png,bmp");

        extTable.Add("flash", "swf,flv");

        extTable.Add("media", "swf,flv,mp3,wav,wma,wmv,mid,avi,mpg,asf,rm,rmvb");

        extTable.Add("file", "doc,docx,xls,xlsx,ppt,htm,html,txt,zip,rar,gz,bz2");

        //最大文件大小

        int maxSize = 1000000;

        this.context = context;

        HttpPostedFile imgFile = context.Request.Files["imgFile"];

        if (imgFile == null)

        {

            showError("请选择文件。");

        }

        String dirPath = context.Server.MapPath(savePath);

        if (!Directory.Exists(dirPath))

        {

            showError("上传目录不存在。");

        }

        String dirName = context.Request.QueryString["dir"];

        if (String.IsNullOrEmpty(dirName)) {

            dirName = "image";

        }

        if (!extTable.ContainsKey(dirName)) {

            showError("目录名不正确。");

        }

        String fileName = imgFile.FileName;

        String fileExt = Path.GetExtension(fileName).ToLower();

        if (imgFile.InputStream == null || imgFile.InputStream.Length > maxSize)

        {

            showError("上传文件大小超过限制。");

        }

        if (String.IsNullOrEmpty(fileExt) || Array.IndexOf(((String)extTable[dirName]).Split(','), fileExt.Substring(1).ToLower()) == -1)

        {

            showError("上传文件扩展名是不允许的扩展名。\n只允许" + ((String)extTable[dirName]) + "格式。");

        }

        //创建文件夹

        dirPath += dirName + "/";

        saveUrl += dirName + "/";

        if (!Directory.Exists(dirPath)) {

            Directory.CreateDirectory(dirPath);

        }

        String ymd = DateTime.Now.ToString("yyyyMMdd", DateTimeFormatInfo.InvariantInfo);

        dirPath += ymd + "/";

        saveUrl += ymd + "/";

        if (!Directory.Exists(dirPath)) {

            Directory.CreateDirectory(dirPath);

        }

        String newFileName = DateTime.Now.ToString("yyyyMMddHHmmss_ffff", DateTimeFormatInfo.InvariantInfo) + fileExt;

        String filePath = dirPath + newFileName;

        imgFile.SaveAs(filePath);

        String fileUrl = saveUrl + newFileName;

        Hashtable hash = new Hashtable();

        hash["error"] = 0;

        hash["url"] = fileUrl;

        context.Response.AddHeader("Content-Type", "text/html; charset=UTF-8");

        context.Response.Write(JsonMapper.ToJson(hash));

        context.Response.End();

    }

    private void showError(string message)

    {

        Hashtable hash = new Hashtable();

        hash["error"] = 1;

        hash["message"] = message;

        context.Response.AddHeader("Content-Type", "text/html; charset=UTF-8");

        context.Response.Write(JsonMapper.ToJson(hash));

        context.Response.End();

    }

    public bool IsReusable

    {

        get

        {

            return true;

        }

    }

}

5.优化改进

使用KindEditor文本编辑器时，发现不能在图片空间中修改已上传图片的信息，删除图片等，也不能进行目录操作，我觉得这是比CKEditor和CKFinder结合的文本编辑器弱势的地方。

大致想了下，有两个方法可以解决：

一是：独立写一个图片管理的模块，进行可视化操作

二是：修改plugins/filemanager/filemanager.js，并结合handler进行操作。（这个方法扩展性比较好）

如果有人已经解决了这个问题，发个参考例子给我把，谢谢！！

如上述有什么不清晰的，可以去官网参考下！KindEditor

实例下载

码农公寓

相关文章