当前位置:

首页 > 编程开发 > Html 编辑器粘贴内容过滤技术详解

Html 编辑器粘贴内容过滤技术详解

针对HTML编辑器粘贴过滤需求,对比CKEditor与TinyMCE。CKEditor需手动设置Firefox权限,且无法保留Word格式;TinyMCE通过创建临时iframe(IE)或div(Firefox)绕过权限,保留格式,实现无感过滤。

本文目录

    最近在解决数据粘贴方面取得了不少进展,这是HTML在线编辑器所必须具备的技术。这里详细给大家介绍整个过程,并提供实现参考。研究过程中确实走了不少弯路,尝试了多种方式——由于美国的PM始终觉得有些影响用户体验的东西无法接受,导致好几个提案被否掉,不过收获还是相当丰富的。

    现在写代码喜欢需求驱动,先来看看这项技术的主要需求:

    • 能够过滤用户贴进来的纯文本数据
    • 能够过滤用户贴进来的HTML数据(未经HTML编码)
    • 能够过滤用户贴进来的Word数据,并能把大部分Word格式保留下来
    • 在这一过程中尽量不要让用户知道我们在做过滤
    • 不要去提示用户是否启用某种权限

    本例所适用的场景为使用iframe实现的HTML编辑器,而不是文本框(textarea或type为text的input)。

    研究过程中,主要参考了TinyMCE和CKEditor,但最后选择了TinyMCE的实现方法,具体原因在看完下面这段文字后就会明白。

    CKEditor的实现方式是在onpaste事件触发时,从剪贴板取出数据,处理取出的文本,然后再把处理好的文本存入剪贴板。有人可能会问:能不能在onpaste中直接取消paste动作,然后自己把获得的内容放入iframe当中?当时也试过这条路,但结果出人意料——直接从剪贴板拿出的数据是不包括格式信息的文本,特别是从Word粘贴过来的数据,纯文本,颜色、布局等数据都不存在。这样一来,用户只能粘贴没有格式的数据过来,然后自己重新在HTML编辑器里面编辑。但如果让浏览器自己去做粘贴,格式信息都会保留,浏览器会自动把Word的粘贴数据转换为XML数据,放入DOM中。所以为了保留格式信息,恐怕只能通过浏览器的标准粘贴行为的帮助来实现这一点。

    另外,CKEditor在Firefox中有一个致命的弱点:如果你要从剪贴板读写数据,就必须提示用户自己去设置一个叫signed.applets.codebase_principal_support的权限,Ja vaScript脚本是没有权限去设置的。虽然从技术角度来看这是很正常的,但很多产品经理无法接受这一点——至少我遇到的PM是这么认为的。

    以下是CKEditor获取和设置剪贴板的代码,供参考。

    复制代码

    function setClipboard(maintext) {
        if (window.clipboardData) {
            return (window.clipboardData.setData("Text", maintext));
        }
        else if (window.netscape) {
            netscape.security.PrivilegeManager.enablePrivilege('UniversalXPConnect');
            var clip = Components.classes['@mozilla.org/widget/clipboard;1'].createInstance(Components.interfaces.nsIClipboard);
            if (!clip) return;
            var trans = Components.classes['@mozilla.org/widget/transferable;1'].createInstance(Components.interfaces.nsITransferable);
            if (!trans) return;
            trans.addDataFla vor('text/unicode');
            var str = new Object();
            var len = new Object();
            var str = Components.classes["@mozilla.org/supports-string;1"].createInstance(Components.interfaces.nsISupportsString);
            var copytext=maintext;
            str.data=copytext;
            trans.setTransferData("text/unicode",str,copytext.length*2);
            var clipid=Components.interfaces.nsIClipboard;
            if (!clip) return false;
            clip.setData(trans,null,clipid.kGlobalClipboard);
            return true;
        }
        return false;
    }
    function getClipboard() {
        if (window.clipboardData) {
            return(window.clipboardData.getData('Text'));
        }
        else if (window.netscape) {
            netscape.security.PrivilegeManager.enablePrivilege('UniversalXPConnect');
            var clip = Components.classes['@mozilla.org/widget/clipboard;1'].createInstance(Components.interfaces.nsIClipboard);
            if (!clip) return;
            var trans = Components.classes['@mozilla.org/widget/transferable;1'].createInstance(Components.interfaces.nsITransferable);
            if (!trans) return;
            trans.addDataFla vor('text/unicode');
            clip.getData(trans,clip.kGlobalClipboard);
            var str = new Object();
            var len = new Object();
            try {
                trans.getTransferData('text/unicode',str,len);
            }
            catch(error) {
                return null;
            }
            if (str) {
                if (Components.interfaces.nsISupportsWString) str=str.value.QueryInterface(Components.interfaces.nsISupportsWString);
                else if (Components.interfaces.nsISupportsString) str=str.value.QueryInterface(Components.interfaces.nsISupportsString);
                else str = null;
            }
            if (str) {
                return(str.data.substring(0,len.value / 2));
            }
        }
        return null;
    }
    

    以下是提示用户启用权限的代码:

    复制代码

    if (window.netscape)
    {
        try
        {
            netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
        }
        catch (ex)
        {
            alert("If you want to do paste, please input 'about:config' in address bar, then input Enter.\n Set \"signed.applets.codebase_principal_support\" to \"true\"");
        }
    }
    

    于是转向了TinyMCE的实现方式。在看它的代码时,特别留意到它竟然不需要权限就能在Firefox下面搞定粘贴,并且还能保留Word格式,于是仔细阅读了其中的逻辑。TinyMCE的实现步骤在IE和Firefox下面是不同的:

    IE实现

    1. 在onpaste回调函数中创建一个临时的iframe,用于粘贴内容,这个iframe放在主窗口的body下面即可。
    2. 在当前光标位置创建一个Range,用来保存光标位置和选中信息。
    3. 让临时iframe获得焦点,执行粘贴命令,即document.execCommand(“paste”),内容会粘贴在临时的iframe中。
    4. 通过innerHTML获得临时iframe中的内容并进行过滤。
    5. 让HTML编辑器的iframe获得焦点,用之前创建的Range对象执行pasteHTML方法来粘贴过滤后的内容。
    6. 最后取消默认的paste动作。

    (临时iframe可以根据个人喜好从DOM中删除,但由于这个iframe可以在多个HTML编辑器之间共用,所以实现中仅仅改变了iframe的left、top来调整iframe的位置,而不是移除它。调整left和top的目的在于:焦点移到临时iframe的时候,如果HTML编辑器的iframe和临时iframe不在一个视图之内,屏幕会滚动,这样会导致屏幕没有原因的闪烁。)

    Firefox实现

    1. 在onpaste回调函数中创建一个临时的div,这个div放在HTML编辑器的iframe里面——这也是绕过权限问题的关键。
    2. 保存当前光标和焦点位置,然后将光标移到临时创建的div中。
    3. 通过window.setTimeout设置一个回调函数,在paste动作瞬间完成之后执行。
    4. 让paste动作执行(onpaste回调函数执行完毕)。
    5. 刚才设置的回调函数执行,在里面获得临时div的innerHTML并进行过滤。
    6. 恢复刚才保存的光标和焦点位置,并移除临时div。
    7. 通过inserthtml命令(execCommand(“inserthtml”))把过滤后的内容贴到HTML编辑器的iframe中。

    详细代码如下:

    复制代码

    function getSel(w)
    {
        return w.getSelection ? w.getSelection() : w.document.selection;
    }
    function setRange(sel,r)
    {
        sel.removeAllRanges();
        sel.addRange(r);
    }
    function filterPasteData(originalText)
    {
        var newText=originalText;
        //do something to filter unnecessary data
        return newText;
    }
    function block(e)
    {
        e.preventDefault();
    }
    var w,or,divTemp,originText;
    var newData;
    function pasteClipboardData(editorId,e)
    {
        var objEditor = document.getElementById(editorId);
        var edDoc=objEditor.contentWindow.document;
        if(isIE)
        {
            var orRange=objEditor.contentWindow.document.selection.createRange();
            var ifmTemp=document.getElementById("ifmTemp");
            if(!ifmTemp)
            {
                ifmTemp=document.createElement("IFRAME");
                ifmTemp.id="ifmTemp";
                ifmTemp.style.width="1px";
                ifmTemp.style.height="1px";
                ifmTemp.style.position="absolute";
                ifmTemp.style.border="none";
                ifmTemp.style.left="-10000px";
                ifmTemp.src="iframeblankpage.html";
                document.body.appendChild(ifmTemp);
                ifmTemp.contentWindow.document.designMode = "On";
                ifmTemp.contentWindow.document.open();
                ifmTemp.contentWindow.document.write("");
                ifmTemp.contentWindow.document.close();
            }else
            {
                ifmTemp.contentWindow.document.body.innerHTML="";
            }
            originText=objEditor.contentWindow.document.body.innerText;
            ifmTemp.contentWindow.focus();
            ifmTemp.contentWindow.document.execCommand("Paste",false,null);
            objEditor.contentWindow.focus();
            newData=ifmTemp.contentWindow.document.body.innerHTML;
            //filter the pasted data
            newData=filterPasteData(newData);
            ifmTemp.contentWindow.document.body.innerHTML=newData;
            //paste the data into the editor
            orRange.pasteHTML(newData);
            //block default paste
            if(e)
            {
                e.returnValue = false;
                if(e.preventDefault)
                    e.preventDefault();
            }
            return false;
        }else
        {
            enableKeyDown=false;
            //create the temporary html editor
            var divTemp=edDoc.createElement("DIV");
            divTemp.id='htmleditor_tempdiv';
            divTemp.innerHTML='\uFEFF';
            divTemp.style.left="-10000px"; //hide the div
            divTemp.style.height="1px";
            divTemp.style.width="1px";
            divTemp.style.position="absolute";
            divTemp.style.overflow="hidden";
            edDoc.body.appendChild(divTemp);
            //disable keyup,keypress, mousedown and keydown
            objEditor.contentWindow.document.addEventListener("mousedown",block,false);
            objEditor.contentWindow.document.addEventListener("keydown",block,false);
            enableKeyDown=false;
            //get current selection;
            w=objEditor.contentWindow;
            or=getSel(w).getRangeAt(0);
            //move the cursor to into the div
            var docBody=divTemp.firstChild;
            rng = edDoc.createRange();
            rng.setStart(docBody, 0);
            rng.setEnd(docBody, 1);
            setRange(getSel(w),rng);
            originText=objEditor.contentWindow.document.body.textContent;
            if(originText==='\uFEFF')
            {
                originText="";
            }
            window.setTimeout(function()
            {
                //get and filter the data after onpaste is done
                if(divTemp.innerHTML==='\uFEFF')
                {
                    newData="";
                    edDoc.body.removeChild(divTemp);
                    return;
                }
                newData=divTemp.innerHTML;
                // Restore the old selection
                if (or)
                {
                    setRange(getSel(w),or);
                }
                newData=filterPasteData(newData);
                divTemp.innerHTML=newData;
                //paste the new data to the editor
                objEditor.contentWindow.document.execCommand('inserthtml', false, newData );
                edDoc.body.removeChild(divTemp);
            },0);
            //enable keydown,keyup,keypress, mousedown;
            enableKeyDown=true;
            objEditor.contentWindow.document.removeEventListener("mousedown",block,false);
            objEditor.contentWindow.document.removeEventListener("keydown",block,false);
            return true;
        }
    }
    

    这里的pasteClipboardData是用作onpaste回调函数的。要使用它,可以通过下面的代码把它加到HTML编辑器的iframe的onpaste事件上。

    复制代码

    var ifrm=document.getElementById("editor")
    if(isIE)
    {
        ifrm.contentWindow.document.documentElement.attachEvent("onpaste", function(e){return pasteClipboardData(ifrm.id,e);});
    }
    else
    {
        ifrm.contentWindow.document.addEventListener("paste", function(e){return pasteClipboardData(ifrm.id,e);},false);
    }
    

    这里的filterPasteData函数就是专门用来做过滤的函数,具体要怎么去过滤纯文本、HTML及Word数据,将在下一篇讲解。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    常见的推荐算法在程序中的实例讲解
    常见的推荐算法在程序中的实例讲解

    推荐算法作为机器学习和数据挖掘领域的核心组成部分,在个性化推荐内容方面起到了重要的作用。在.NET开发中,我们可以使用不同的算法来实现推荐系统。本文将介绍三种常见的推荐算法:协同过滤、内容过滤和深度学习推荐系统,并为每种算法提供.NET源代码示例。协同过滤推荐算法协同过滤算法基于用户行为数据,通过分析用户之间的相似性来为用户提供推荐内容。常见的协同过滤算法包括基于用户的协同过滤和基于物品的协同过滤。下面是一个.NET示例,演示了基于用户的协同过滤算法的实现:```csharpusingSystem;usi

    企业微信创建企业提示失败怎么办 实名与填写检查
    企业微信创建企业提示失败怎么办 实名与填写检查

    先看提示属于哪类:名称占用就加后缀,实名不一致就重填本人信息,证件不清晰就重拍。统一社会信用代码逐位核对,连续三次失败别改材料重投,直接联系客服人工核。

    Modern Web Guidance 的 legacy-scan 反转建议应该怎样判断?
    Modern Web Guidance 的 legacy-scan 反转建议应该怎样判断?

    说明源码提交对字符串、生成器和数组的识别边界,以及扫描命令与发行包核验限制。

    Codex 0.170.0 正式版的语音与连接更新,适用范围有哪些限制?
    Codex 0.170.0 正式版的语音与连接更新,适用范围有哪些限制?

    0.170.0 的语音更新限于终端通话协商能力的明确新增,同名工具服务器跨环境支持仍标注实验性质;连接部分则修复大请求回退、认证竞态和云端重连等具体问题。这份正式版公告不足以证明所有账户、所有客户端都已具备完整语音功能。

    Hy4 flash 三种权重怎么选,安装和授权要注意哪些条件?
    Hy4 flash 三种权重怎么选,安装和授权要注意哪些条件?

    了解Hy4 flash、FP8与base的适用任务,阅读官方安装及图文代码,并核对资源和MaaS许可条件。

    OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化
    OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化

    OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化。说明已核实的更新范围、类型兼容性和本地版本确认方法。

    OpenAI Java SDK 4.108.0 的两项新增能力适合哪些项目?
    OpenAI Java SDK 4.108.0 的两项新增能力适合哪些项目?

    OpenAI Java SDK 4.108.0 面向 Live MCP 工具接入与 Managed Agents 预算状态处理,说明新增模型、事件含义、正式发布范围和适用限制。

    Free Claude Code 6.19.37 如何兼顾网页搜索与普通工具调用?
    Free Claude Code 6.19.37 如何兼顾网页搜索与普通工具调用?

    Free Claude Code 6.19.37 在自动搜索时保留客户端工具及选择条件,代理执行搜索后仍返回普通调用。说明适用场景、历史信息保留、请求约束与第三方项目的版本边界。

    Google GenAI Go SDK 1.78.0 的 v1beta 配置优先级怎样判断?
    Google GenAI Go SDK 1.78.0 的 v1beta 配置优先级怎样判断?

    Google GenAI Go SDK 1.78.0 将 Gemini Developer API 默认改为 v1,可用 HTTPOptions.APIVersion 或环境变量保留 v1beta,Vertex AI 默认值不变。

    Google GenAI SDK 3.5.0实时交互值得哪些项目升级评估?
    Google GenAI SDK 3.5.0实时交互值得哪些项目升级评估?

    解释实验性实时支持、环境检查与生产评估中需要验证的条件。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。