重温 Squire：高效的 HTML5 富文本编辑器

什么是 Squire？

Squire 是一款极其轻量级的 HTML5 富文本编辑器，最适合您应用程序的丰富输入表单和简单的文档创建。它提供跨浏览器支持，但刻意避免支持旧版浏览器的复杂性。它在 Opera 10、Firefox 3.5、Safari 4、Chrome 9 和 IE8 上运行效果最佳。

Squire 不适用于创建和编辑所见即所得的网站页面。然而，对于许多富文本输入和网络应用程序来说，Squire 可能正是您所需要的。它提供了不臃肿的力量。它还获得了麻省理工学院的许可，可以灵活重用。

在本教程中，我将向您展示如何下载 Squire 并使用它构建示例输入表单。如果您想了解 Squire 的实际应用，请访问演示。

乡绅从哪里来？

FastMail 团队构建了 Squire 来简化他们的网络邮件编辑器要求。 FastMail 是 Gmail 的优秀基于云的电子邮件替代方案 — 我是 FastMail 的日常用户。由于它的总部位于澳大利亚，并且根据与美国不同的法律运营，因此 FastMail 用户的隐私保护略有改善。您可以在这里阅读更多相关信息：FastMail 称其不受 NSA 监视。

正如 FastMail 团队在他们的博客中所写，他们之前使用过 CKeditor：

虽然不是一个糟糕的选择，但像大多数其他编辑器一样，它是为创建网站而不是编写电子邮件而设计的。因此，默认情况下，简单地插入图像就会出现一个包含三个选项卡和比您想象的更多选项的对话框…它还附带了自己的 UI 工具包和框架，我们必须对其进行大量自定义才能适应我们正在构建的新用户界面的其余部分；维护起来很痛苦。
由于我们关注速度和性能，我们也关心代码大小。我们用于之前（经典）UI 的 CKEditor 版本仅包含我们需要的插件，下载大小为 159 KB（gzip 压缩后；未压缩为 441 KB）。这只是代码，不包括样式和图像。

他们决定从头开始，打造 Squire。压缩和 gzip 后的 JavaScript 大小仅为 11.5 KB（未压缩时为 34.7 KB），并且没有依赖项，Squire 非常轻量级。

结果令人印象深刻。加载整个撰写屏幕、基础库、邮件和联系人模型代码以及呈现整个屏幕的所有 UI 代码所需的组合代码重量现在仅为 149.4 KB（未压缩时为 459.7 KB），比单独的 CKEditor 还小。

Squire 没有依赖性。没有 XHR 包装器、小部件库或灯箱覆盖层。工具栏没有用户界面，这消除了加载两个 UI 工具包带来的臃肿。这只是一个简单的 </code> 组件，可以通过 JavaScript 进行操作。</p> <h2>Squire 的工作原理</h2> <p>Squire 使用选择和范围 API 来操作 DOM。这消除了常见的跨浏览器不兼容性。再次来自 FastMail 博客：</p> <p>制作富文本编辑器是出了名的困难，因为不同的浏览器在这方面极其不一致。这些 API 都是 Microsoft 在 IE 全盛时期引入的，然后被其他供应商以各种不兼容的方式复制……大多数富文本编辑器执行命令，然后尝试清理浏览器创建的混乱。有了 Squire，我们就巧妙地绕过了这个问题。<br /> Squire 的总体理念是允许浏览器做尽可能多的事情（不幸的是不是很多），但在任何偏离要求的地方进行控制，或者存在显着的跨浏览器差异。</p> <p>安装 Squire<img decoding="async" src="https://www.xiazaiqun.com/wp-content/themes/zibll/img/thumbnail-lg.svg" data-src="https://img.czgho.com/wp-content/jzjc/2023/09/17/169484742447176.jpg" title="重温 Squire：高效的 HTML5 富文本编辑器插图1下载群" alt="重温 Squire：高效的 HTML5 富文本编辑器插图1下载群" /></p> <p>其次，将 <code class="inline">build/</code> 目录的内容复制到您的应用程序中。 p> </p> <p>第三，编辑 <code class="inline">document.html</code> 中的 <code class="inline"></code> 块以添加您希望编辑器使用的默认样式（或链接到外部样式表）。 </p> <h2>使用 Squire</h2> <p>让我们看一下 Squire 附带的演示应用程序。使用 Squire 时，您可以使用 <code class="inline"></code>，而不是 <code class="inline"><textarea></code> 元素。 </p> <p>在演示中：</p> <pre class="brush:html;toolbal:false;"> </pre> <p>登录后复制</p> <p><code class="inline">Document.html</code> 是一个具有默认样式的空白画布，它会加载 Squire：</p> <pre class="brush:html;toolbal:false;"> <title></title> ... a { text-decoration: underline; } h1 { font-size: 138.5%; } ... blockquote { border-left: 2px solid blue; margin: 0; padding: 0 10px; } </pre> <p>登录后复制</p> <p>使用 Squire 时，您可以将事件侦听器附加到 iframe 的加载事件。当此事件触发时，您可以通过 iframe.contentWindow.editor 获取对编辑器对象的引用。例如，演示 iframe 包括：</p> <p><code class="inline">onload=\"top.editor=this.contentWindow.editor\"</code></p> </p> <p>该演示有两种类型的链接，用于在 Squire 中操作内容。可以对任何选定文本进行操作的简单命令如下所示：</p> <p><code class="inline"><span id="bold">Bold</span></code></p> </p> <p>需要额外用户输入的复杂命令如下所示；他们添加了提示符 c:</p> <p><code class="inline"><span id="setFontSize" class="prompt">字体大小</span></code></p> <p>演示应用程序如下所示：</p> <p><img decoding="async" src="https://www.xiazaiqun.com/wp-content/themes/zibll/img/thumbnail-lg.svg" data-src="https://img.czgho.com/wp-content/jzjc/2023/09/17/169484742482207.jpg" title="重温 Squire：高效的 HTML5 富文本编辑器插图2下载群" alt="重温 Squire：高效的 HTML5 富文本编辑器插图2下载群" /></p> <p>演示页面顶部的 JavaScript 侦听对这些 span 命令的任何点击。如果提示类存在，它会从用户收集更多信息：</p> <pre class="brush:javascript;toolbal:false;"> var editor; document.addEventListener( \'click\', function ( e ) { var id = e.target.id, value; if ( id && editor && editor[ id ] ) { if ( e.target.className === \'prompt\' ) { value = prompt( \'Value:\' ); } editor[ id ]( value ); } }, false ); </pre> <p>登录后复制</p> <p>然后，它使用命令和任何用户提供的值调用 Squire 编辑器。然后，Squire 将命令应用于当前选定的文本：</p> <p><code class="inline">编辑器[ id ]( value );</code></p> <p>您可以了解有关 Squire 的更多信息，并在自述文件中查看其完整的 API 文档。</p> <h2>扩展演示</h2> <p>作为示例，让我们添加两个读取 Squire 编辑器状态的命令。我们将在演示命令标题的底部添加两个链接：</p> <pre class="brush:html;toolbal:false;"> <p> get selection | get doc </p> </header> </pre> <p>登录后复制</p> <p>当您选择某些文本并单击它时，所选内容将在警报中弹出，如下所示。</p> <p><img decoding="async" src="https://www.xiazaiqun.com/wp-content/themes/zibll/img/thumbnail-lg.svg" data-src="https://img.czgho.com/wp-content/jzjc/2023/09/17/169484742487711.jpg" title="重温 Squire：高效的 HTML5 富文本编辑器插图3下载群" alt="重温 Squire：高效的 HTML5 富文本编辑器插图3下载群" /></p> <p>让我们来看看更美观的演示及其工具栏：</p> <p><img decoding="async" src="https://www.xiazaiqun.com/wp-content/themes/zibll/img/thumbnail-lg.svg" data-src="https://img.czgho.com/wp-content/jzjc/2023/09/17/169484742419165.jpg" title="重温 Squire：高效的 HTML5 富文本编辑器插图4下载群" alt="重温 Squire：高效的 HTML5 富文本编辑器插图4下载群" /></p> <p>此页面的头块集成了 Bootstrap 的样式表和名为 <code class="inline">Squire-UI</code> 的样式表。它还为此 <code class="inline">Squire-UI</code> 提供 JavaScript。</p> <pre class="brush:html;toolbal:false;"> <title>Squire</title> <!--[if IE 8]>--> It also offers static html for a textarea in the body <textarea id="foo">

登录后复制

    
    $(document).ready(function () {
      UI = new SquireUI({replace: \'textarea#foo\', height: 300});
    });
    

$(div).load(options.buildPath + \'Squire-UI.html\', function() {
      this.linkDrop = new Drop({
        target: $(\'#makeLink\').first()[0],
        content: $(\'#drop-link\').html(),
        position: \'bottom center\',
        openOn: \'click\'
      });

    
        
        
        
        
            
        
    
    
        
        
        
            
        
        
    
...