前端UI组件【免费下载链接】ckeditor4The best enterprise-grade WYSIWYG editor. Fully customizable with countless features and plugins.项目地址https://gitcode.com/gh_mirrors/ck/ckeditor4点击查看免费下载CKEditor 4 从 4.13.0 起引入了一套选区优化selection optimization机制专门用于修正浏览器原生 DOM Selection 在元素边界处产生的不正确行为。本文以仓库中的手动测试规格 tests/core/selection/manual/optimization.md 为主线结合 core/selection/optimization.js 等核心源码讲解该机制的设计动机、底层实现原理并给出完整的手动验证步骤与自动化测试佐证。读完本文你将理解选区优化在什么条件下触发、何时被主动跳过并能像官方测试者一样系统性地验证编辑器的选区行为是否正常。一、为什么需要选区优化4.13.0 引入的背景在 WYSIWYG 编辑器中选区selection是所有编辑操作的起点删除、替换、应用样式、复制粘贴都建立在选区之上。然而各浏览器对光标/选区落在元素边界的处理并不一致会导致一系列怪异的编辑行为。CKEditor 4 在 4.13.0 版本中通过 issue #3175 的版本记录该机制集中修复了以下问题#3256在最后一个表格单元格内三击triple-click后删除内容不再把下方内容一并拉进表格#3118用三击选中一个段落并应用标题样式只作用于被选中的段落本身#3161双击仅包含一个单词的span元素时会生成正确的选区——只包含被点击的span本身。后续版本还针对该机制进行了修补例如 4.20 版本的#4931当编辑器内容只有列表且末尾存在空元素时全选并删除应删除所有列表项这一场景正是由于选区优化在列表中表现异常而出现的详见 CHANGES.md 中 4.20 的 Fixed Issues 记录。因此该机制并不只是锦上添花的体验优化而是直接影响删除、样式应用等核心编辑操作正确性的基础设施。二、源码原理选区是如何被优化的1. 自动挂载编辑器初始化即生效选区优化在编辑器构造阶段就被自动挂载开发者无需手动开启。在 core/editor.js 中可以看到// Optimize selection starting/ending on element boundaries (#3175). CKEDITOR.dom.selection.setupEditorOptimization( this );setupEditorOptimization定义于 core/selection/optimization.js它做了两件事监听编辑器的selectionCheck事件——该事件由 core/selection.js 在每次选区变化时触发例如鼠标拖选、键盘移动、点击等都会间接触发事件回调中调用选区的optimizeInElementEnds()方法尝试优化监听可编辑区域的keydown/keyup事件把当前是否按住 Shift 键记录到editor._.shiftPressed供后续判断使用。2. 核心方法optimizeInElementEnds每次selectionCheck触发时core/selection/optimization.js 中的CKEDITOR.dom.selection.prototype.optimizeInElementEnds会被调用其核心逻辑是var range this.getRanges()[ 0 ], editor this.root.editor; if ( !shouldOptimize( range, this ) ) { return; } var oldRange range.clone(); range.shrink( CKEDITOR.SHRINK_TEXT, false, { skipBogus: !CKEDITOR.env.webkit } ); preventListener false; preventRecurrency( editor, range, oldRange ); range.select(); preventListener true;其优化手段本质上是调用CKEDITOR.dom.range的shrink()方法把选区的起止边界收缩shrink到紧邻文本节点的位置。shrink的详细实现在 core/dom/range.js当模式为CKEDITOR.SHRINK_TEXT时它会用 DOM walker 在范围内寻找第一个/最后一个文本节点并把startContainer/endContainer锚定到文本节点两侧POSITION_BEFORE_START/POSITION_AFTER_END。{ skipBogus: !CKEDITOR.env.webkit }表示在非 WebKit 浏览器中跳过 bogusbr元素避免空段落中的占位符干扰收缩结果。代码注释中给出了一个直观的例子形如p{foo/p p]bar/p{表示选区起点、]表示选区终点的选区会被优化为p{foo}/p pbar/p即把原本悬空在元素边界上的锚点收拢到文本节点的真实边界上从而让后续的删除、样式操作拥有一个稳定、可预测的 DOM 锚点。3. 触发条件shouldOptimize 的判断逻辑优化并非无条件进行。core/selection/optimization.js 中的shouldOptimize函数定义了完整判断规则条件行为Shift 键被按下editor._.shiftPressed不优化用户正在做按住 Shift 的扩展选区操作选区为 fake selection如 widget 选区不优化选区已折叠collapsed不优化起点与终点容器是同一个元素不优化选区终点落在li列表项内含 IE8 下文本节点父级为li的情况不优化修复 #4931选区终点偏移为 0即终点位于元素开头优化起点偏移位于容器末尾或起点终点一端在文本节点、另一端不在优化其中起点终点一端在文本节点、另一端不在源码中的startsInText ^ endsInText即异或判断正是对一个锚点悬空在元素边界这一核心问题的精确定义——这种不对称的锚点状态最容易引发浏览器差异和错误行为。4. 防递归保护preventRecurrency优化会通过range.select()重新设置选区进而再次触发selectionCheck存在递归风险。core/selection/optimization.js 中的preventRecurrency用一次性监听器处理了两种情形若浏览器把优化后的选区又改回了优化前的初始选区即浏览器不配合则取消evt.cancel()本次selectionCheck事件避免同一选区被重复处理若浏览器未修改选区新选区与优化目标完全一致则通过模块级标志preventOptimization true阻止下一次优化避免无限循环。这一设计保证了优化过程在任意浏览器行为下都能收敛不会造成死循环或事件风暴。三、手动验证指南官方测试规格全流程仓库中的 tests/core/selection/manual/optimization.md 是一份 Bender 手动测试manual test规格文档用于人工验证选区优化机制没有引入怪异行为。它由 Bender 标签头与测试说明组成标签头含义如下bender-tags: selection, 4.13.0, bug, 3161, 3175, 3493 bender-ui: collapsed bender-ckeditor-plugins: wysiwygarea, toolbar, elementspath, sourcearea, list, undo, div, table, image, basicstyles, formatbender-tags标明测试类别selection表示选区相关4.13.0表示该测试对应 4.13.0 版本引入的功能bug以及 issue 编号3161、3175、3493标明其追溯的问题来源#3493 与 Shift 键监听器在setData()后的行为有关bender-ui: collapsed表示测试页面 UI 采用折叠布局两个编辑器并排展示bender-ckeditor-plugins声明测试所需的插件集合wysiwygarea可见编辑区、toolbar工具栏、elementspath元素路径、sourcearea源码视图、list列表、undo撤销、div、table、image、basicstyles基本样式、format格式用于构造覆盖列表、表格、图片、行内样式等丰富内容的编辑环境。测试方法操作方式全覆盖测试说明要求在两个编辑器中随意操作选区检查是否出现怪异行为并特别要求在测试过程中多次切换到source view源码视图再切回以确认模式切换不会影响选区的工作方式。需要覆盖的操作方式包括用鼠标拖选分别产生折叠选区collapsed与非折叠选区non-collapsed双击double click——对应 #3161 的span单词语境三击triple click——对应 #3256 表格单元格、#3118 段落标题的语境方向键Arrow keys移动光标ShiftArrow扩展选区ShiftHome/End快速扩展选区到行首/行尾Ctrl/CommandA全选。这些操作几乎覆盖了shouldOptimize判断逻辑中的每一条路径Shift 扩展选区走不优化分支鼠标双击/三击走边界收缩分支全选则对应起点终点跨越多个块级元素的场景。测试要点观察什么测试说明要求重点检查三类选区形态确认优化后没有怪异行为单行选区Single line selection同一行内、起点终点都在文本中间理论上不触发优化行为应与普通编辑器一致多行选区Multiline selection跨段落选择是优化机制的主要作用场景需确认删除、改样式时不会把相邻块级元素卷进来起点/终点位于元素开头或结尾的选区Selection that starts/ends at the start/end of element这是优化机制的核心目标场景需确认锚点收缩后视觉选区与操作结果一致且切到源码视图再返回后选区仍然稳定。如果所有操作后选区位置符合预期、删除与样式操作不波及意外内容则该版本通过手动验证。四、自动化测试佐证与手动规格呼应的单元测试手动测试之外仓库还提供了对应的自动化测试 tests/core/selection/optimization.js其中的用例可以视为手动规格中边界场景的机器化版本例如用例初始选区[]表示选区优化后选区case 1pfoo/pp[bar/pp]baz/ppfoo/pp[bar]/ppbaz/pcase 2pfoo[/ppbar]/ppbaz/ppfoo/pp[bar]/ppbaz/pcase 3pfoo[/ppbar/pp]baz/ppfoo/pp[bar]/ppbaz/pcase 8列表#4931ulli[foo/lili]bar/li/ululli[foo/lili]bar/li/ul不优化shift 按下pfoo/pp[bar/pp]baz/ppfoo/pp[bar/pp]baz/p不优化表中表示折叠光标位置。可见case 1~3 正好对应手动规格中选区起点/终点位于元素开头或结尾的场景验证了range.shrink( CKEDITOR.SHRINK_TEXT )把锚点收拢到pbar/p的文本两侧case 8 验证li内的选区不做优化对应 #4931 的回归保护shift 用例验证按住 Shift 时跳过优化的分支与手动规格中ShiftArrow的测试项一一对应该测试文件在 classic、divarea、inline 三种编辑器形态下均会执行见文件开头的bender.editors定义确保优化机制在经典可编辑区、div 编辑区与行内编辑器中行为一致。此外测试还覆盖了 #3493 的场景——通过setData()重设内容后触发keydown/keyup验证editor._.shiftPressed标志仍能正确更新防止数据重载后 Shift 状态残留导致优化逻辑误判。五、小结CKEditor 4 的选区优化机制以把悬空在元素边界上的选区锚点收缩到文本节点为核心理念通过 core/selection/optimization.js 中setupEditorOptimization、optimizeInElementEnds、shouldOptimize、preventRecurrency四个部分协同工作自动挂载、按条件触发、调用 core/dom/range.js 的shrink()收缩、并用防递归保护保证收敛。它修复了双击span、三击表格单元格、段落标题应用等一系列跨浏览器选区问题。如果你正在排查编辑器在选区跨元素边界时的怪异行为或需要为 4.13.0 及以上版本做回归验证可以按照 tests/core/selection/manual/optimization.md 的手动规格逐项操作并以 tests/core/selection/optimization.js 中的预期结果作为判定基准——两者结合即可形成对该机制完整、可信的验证闭环。赞分享前端UI组件【免费下载链接】ckeditor4The best enterprise-grade WYSIWYG editor. Fully customizable with countless features and plugins.项目地址https://gitcode.com/gh_mirrors/ck/ckeditor4点击查看免费下载相关推荐CKEditor 4 拖放不支持文件格式的通知机制手动验证与源码原理解析CKEditor 4 拖放不支持文件格式的通知机制手动验证与源码原理解析 拖放文件到 CKEditor 4 编辑器时如果文件格式不受支持如 SVG/Web前端UI组件CKEditor 4 媒体嵌入Media EmbedWidget 样式验证指南从手动测试到源码机制CKEditor 4 媒体嵌入Media EmbedWidget 样式验证指南从手动测试到源码机制 本篇技术指南以 CKEditor 4 仓库中的手动测试前端UI组件CKEditor 4 选择优化机制实战基于 insertion 手动测试剖析 selectionCheck 与 insertElement 的协同原理CKEditor 4 选择优化机制实战基于 insertion 手动测试剖析 selectionCheck 与 insertElement 的协同原理 导读前端UI组件上一篇SillyTavern 上手笔记3 条命令跑通本地 AI 聊天与角色出图下一篇零基础黑苹果配置工具从入门到精通的OpenCore EFI生成指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
前端UI组件【免费下载链接】ckeditor4The best enterprise-grade WYSIWYG editor. Fully customizable with countless features and plugins.项目地址https://gitcode.com/gh_mirrors/ck/ckeditor4点击查看免费下载CKEditor 4 从 4.13.0 起引入了一套选区优化selection optimization机制专门用于修正浏览器原生 DOM Selection 在元素边界处产生的不正确行为。本文以仓库中的手动测试规格 tests/core/selection/manual/optimization.md 为主线结合 core/selection/optimization.js 等核心源码讲解该机制的设计动机、底层实现原理并给出完整的手动验证步骤与自动化测试佐证。读完本文你将理解选区优化在什么条件下触发、何时被主动跳过并能像官方测试者一样系统性地验证编辑器的选区行为是否正常。一、为什么需要选区优化4.13.0 引入的背景在 WYSIWYG 编辑器中选区selection是所有编辑操作的起点删除、替换、应用样式、复制粘贴都建立在选区之上。然而各浏览器对光标/选区落在元素边界的处理并不一致会导致一系列怪异的编辑行为。CKEditor 4 在 4.13.0 版本中通过 issue #3175 的版本记录该机制集中修复了以下问题#3256在最后一个表格单元格内三击triple-click后删除内容不再把下方内容一并拉进表格#3118用三击选中一个段落并应用标题样式只作用于被选中的段落本身#3161双击仅包含一个单词的span元素时会生成正确的选区——只包含被点击的span本身。后续版本还针对该机制进行了修补例如 4.20 版本的#4931当编辑器内容只有列表且末尾存在空元素时全选并删除应删除所有列表项这一场景正是由于选区优化在列表中表现异常而出现的详见 CHANGES.md 中 4.20 的 Fixed Issues 记录。因此该机制并不只是锦上添花的体验优化而是直接影响删除、样式应用等核心编辑操作正确性的基础设施。二、源码原理选区是如何被优化的1. 自动挂载编辑器初始化即生效选区优化在编辑器构造阶段就被自动挂载开发者无需手动开启。在 core/editor.js 中可以看到// Optimize selection starting/ending on element boundaries (#3175). CKEDITOR.dom.selection.setupEditorOptimization( this );setupEditorOptimization定义于 core/selection/optimization.js它做了两件事监听编辑器的selectionCheck事件——该事件由 core/selection.js 在每次选区变化时触发例如鼠标拖选、键盘移动、点击等都会间接触发事件回调中调用选区的optimizeInElementEnds()方法尝试优化监听可编辑区域的keydown/keyup事件把当前是否按住 Shift 键记录到editor._.shiftPressed供后续判断使用。2. 核心方法optimizeInElementEnds每次selectionCheck触发时core/selection/optimization.js 中的CKEDITOR.dom.selection.prototype.optimizeInElementEnds会被调用其核心逻辑是var range this.getRanges()[ 0 ], editor this.root.editor; if ( !shouldOptimize( range, this ) ) { return; } var oldRange range.clone(); range.shrink( CKEDITOR.SHRINK_TEXT, false, { skipBogus: !CKEDITOR.env.webkit } ); preventListener false; preventRecurrency( editor, range, oldRange ); range.select(); preventListener true;其优化手段本质上是调用CKEDITOR.dom.range的shrink()方法把选区的起止边界收缩shrink到紧邻文本节点的位置。shrink的详细实现在 core/dom/range.js当模式为CKEDITOR.SHRINK_TEXT时它会用 DOM walker 在范围内寻找第一个/最后一个文本节点并把startContainer/endContainer锚定到文本节点两侧POSITION_BEFORE_START/POSITION_AFTER_END。{ skipBogus: !CKEDITOR.env.webkit }表示在非 WebKit 浏览器中跳过 bogusbr元素避免空段落中的占位符干扰收缩结果。代码注释中给出了一个直观的例子形如p{foo/p p]bar/p{表示选区起点、]表示选区终点的选区会被优化为p{foo}/p pbar/p即把原本悬空在元素边界上的锚点收拢到文本节点的真实边界上从而让后续的删除、样式操作拥有一个稳定、可预测的 DOM 锚点。3. 触发条件shouldOptimize 的判断逻辑优化并非无条件进行。core/selection/optimization.js 中的shouldOptimize函数定义了完整判断规则条件行为Shift 键被按下editor._.shiftPressed不优化用户正在做按住 Shift 的扩展选区操作选区为 fake selection如 widget 选区不优化选区已折叠collapsed不优化起点与终点容器是同一个元素不优化选区终点落在li列表项内含 IE8 下文本节点父级为li的情况不优化修复 #4931选区终点偏移为 0即终点位于元素开头优化起点偏移位于容器末尾或起点终点一端在文本节点、另一端不在优化其中起点终点一端在文本节点、另一端不在源码中的startsInText ^ endsInText即异或判断正是对一个锚点悬空在元素边界这一核心问题的精确定义——这种不对称的锚点状态最容易引发浏览器差异和错误行为。4. 防递归保护preventRecurrency优化会通过range.select()重新设置选区进而再次触发selectionCheck存在递归风险。core/selection/optimization.js 中的preventRecurrency用一次性监听器处理了两种情形若浏览器把优化后的选区又改回了优化前的初始选区即浏览器不配合则取消evt.cancel()本次selectionCheck事件避免同一选区被重复处理若浏览器未修改选区新选区与优化目标完全一致则通过模块级标志preventOptimization true阻止下一次优化避免无限循环。这一设计保证了优化过程在任意浏览器行为下都能收敛不会造成死循环或事件风暴。三、手动验证指南官方测试规格全流程仓库中的 tests/core/selection/manual/optimization.md 是一份 Bender 手动测试manual test规格文档用于人工验证选区优化机制没有引入怪异行为。它由 Bender 标签头与测试说明组成标签头含义如下bender-tags: selection, 4.13.0, bug, 3161, 3175, 3493 bender-ui: collapsed bender-ckeditor-plugins: wysiwygarea, toolbar, elementspath, sourcearea, list, undo, div, table, image, basicstyles, formatbender-tags标明测试类别selection表示选区相关4.13.0表示该测试对应 4.13.0 版本引入的功能bug以及 issue 编号3161、3175、3493标明其追溯的问题来源#3493 与 Shift 键监听器在setData()后的行为有关bender-ui: collapsed表示测试页面 UI 采用折叠布局两个编辑器并排展示bender-ckeditor-plugins声明测试所需的插件集合wysiwygarea可见编辑区、toolbar工具栏、elementspath元素路径、sourcearea源码视图、list列表、undo撤销、div、table、image、basicstyles基本样式、format格式用于构造覆盖列表、表格、图片、行内样式等丰富内容的编辑环境。测试方法操作方式全覆盖测试说明要求在两个编辑器中随意操作选区检查是否出现怪异行为并特别要求在测试过程中多次切换到source view源码视图再切回以确认模式切换不会影响选区的工作方式。需要覆盖的操作方式包括用鼠标拖选分别产生折叠选区collapsed与非折叠选区non-collapsed双击double click——对应 #3161 的span单词语境三击triple click——对应 #3256 表格单元格、#3118 段落标题的语境方向键Arrow keys移动光标ShiftArrow扩展选区ShiftHome/End快速扩展选区到行首/行尾Ctrl/CommandA全选。这些操作几乎覆盖了shouldOptimize判断逻辑中的每一条路径Shift 扩展选区走不优化分支鼠标双击/三击走边界收缩分支全选则对应起点终点跨越多个块级元素的场景。测试要点观察什么测试说明要求重点检查三类选区形态确认优化后没有怪异行为单行选区Single line selection同一行内、起点终点都在文本中间理论上不触发优化行为应与普通编辑器一致多行选区Multiline selection跨段落选择是优化机制的主要作用场景需确认删除、改样式时不会把相邻块级元素卷进来起点/终点位于元素开头或结尾的选区Selection that starts/ends at the start/end of element这是优化机制的核心目标场景需确认锚点收缩后视觉选区与操作结果一致且切到源码视图再返回后选区仍然稳定。如果所有操作后选区位置符合预期、删除与样式操作不波及意外内容则该版本通过手动验证。四、自动化测试佐证与手动规格呼应的单元测试手动测试之外仓库还提供了对应的自动化测试 tests/core/selection/optimization.js其中的用例可以视为手动规格中边界场景的机器化版本例如用例初始选区[]表示选区优化后选区case 1pfoo/pp[bar/pp]baz/ppfoo/pp[bar]/ppbaz/pcase 2pfoo[/ppbar]/ppbaz/ppfoo/pp[bar]/ppbaz/pcase 3pfoo[/ppbar/pp]baz/ppfoo/pp[bar]/ppbaz/pcase 8列表#4931ulli[foo/lili]bar/li/ululli[foo/lili]bar/li/ul不优化shift 按下pfoo/pp[bar/pp]baz/ppfoo/pp[bar/pp]baz/p不优化表中表示折叠光标位置。可见case 1~3 正好对应手动规格中选区起点/终点位于元素开头或结尾的场景验证了range.shrink( CKEDITOR.SHRINK_TEXT )把锚点收拢到pbar/p的文本两侧case 8 验证li内的选区不做优化对应 #4931 的回归保护shift 用例验证按住 Shift 时跳过优化的分支与手动规格中ShiftArrow的测试项一一对应该测试文件在 classic、divarea、inline 三种编辑器形态下均会执行见文件开头的bender.editors定义确保优化机制在经典可编辑区、div 编辑区与行内编辑器中行为一致。此外测试还覆盖了 #3493 的场景——通过setData()重设内容后触发keydown/keyup验证editor._.shiftPressed标志仍能正确更新防止数据重载后 Shift 状态残留导致优化逻辑误判。五、小结CKEditor 4 的选区优化机制以把悬空在元素边界上的选区锚点收缩到文本节点为核心理念通过 core/selection/optimization.js 中setupEditorOptimization、optimizeInElementEnds、shouldOptimize、preventRecurrency四个部分协同工作自动挂载、按条件触发、调用 core/dom/range.js 的shrink()收缩、并用防递归保护保证收敛。它修复了双击span、三击表格单元格、段落标题应用等一系列跨浏览器选区问题。如果你正在排查编辑器在选区跨元素边界时的怪异行为或需要为 4.13.0 及以上版本做回归验证可以按照 tests/core/selection/manual/optimization.md 的手动规格逐项操作并以 tests/core/selection/optimization.js 中的预期结果作为判定基准——两者结合即可形成对该机制完整、可信的验证闭环。赞分享前端UI组件【免费下载链接】ckeditor4The best enterprise-grade WYSIWYG editor. Fully customizable with countless features and plugins.项目地址https://gitcode.com/gh_mirrors/ck/ckeditor4点击查看免费下载相关推荐CKEditor 4 拖放不支持文件格式的通知机制手动验证与源码原理解析CKEditor 4 拖放不支持文件格式的通知机制手动验证与源码原理解析 拖放文件到 CKEditor 4 编辑器时如果文件格式不受支持如 SVG/Web前端UI组件CKEditor 4 媒体嵌入Media EmbedWidget 样式验证指南从手动测试到源码机制CKEditor 4 媒体嵌入Media EmbedWidget 样式验证指南从手动测试到源码机制 本篇技术指南以 CKEditor 4 仓库中的手动测试前端UI组件CKEditor 4 选择优化机制实战基于 insertion 手动测试剖析 selectionCheck 与 insertElement 的协同原理CKEditor 4 选择优化机制实战基于 insertion 手动测试剖析 selectionCheck 与 insertElement 的协同原理 导读前端UI组件上一篇SillyTavern 上手笔记3 条命令跑通本地 AI 聊天与角色出图下一篇零基础黑苹果配置工具从入门到精通的OpenCore EFI生成指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
到O(n)的思维转换)
