跳到正文

段落里的选区为什么会断

在 Markdown 阅读器里拖过一段行内代码,复制出来的文字是完整的,底色却在代码两侧各断了一截。把窗口缩窄后,同一句还可能在换行处出现另一种空白。代码两侧的空隙来自行内盒的留白,跨行的空白则随排版变化。两者需要用不同的办法判断。

在同一句话里换四种样式

这段正文里,span 标出待发布状态,code 的等宽字体区分命令,a 带来下划线。浏览器可以用同一个 Selection 选中整段。

<p>核对 <span>待发布</span> 的 <code>git status</code>,再打开 <a href="#guide">使用说明</a>。</p>

同一段正文的原生选区,依次显示基础混排、横向边框、横向内边距、基线抬高和窄栏换行

上图在 Chromium 里选中同一段文字,逐个改变样式。最后一行沿用代码的内边距,把段落缩到 270 像素。

改动 浏览器里能看到什么
span 保持普通行内排版,只加字重 字宽可以变化,整行的选区仍连续。
在 span 加 border-inline: 3px solid 边框两侧各占 3 像素,后面的命令和链接右移 6 像素。正文里的文字选区会遇到这两条边线。
在 code 加 padding-inline: 6px 命令内部的空格跟随文字一起选中。命令两侧的内边距露出代码原来的浅底。
在 a 加 vertical-align: 8px 链接相对同行文字抬高,段落的行框随之增加。选区即使连续,文字的垂直关系也已经变了。
窄栏让句子自然换行 同一个 Range 画在两行上。第一行末尾和第二行开头之间的空白属于排版。

这几个属性作用在不同的东西上。横向边框和内边距占行内空间。圆角只修饰绘制轮廓。普通行内盒的上下边框和内边距可以画到文字上下,但行高由参与这一行排版的文字和盒子决定。链接如果只需要下划线,可以先用 text-decoration 和 text-underline-offset,再判断是否确实需要用盒子的底边来画。跨行的圆角、边框和背景则可以用 box-decoration-break 控制。

从选中的文字到屏幕上的颜色

比如从「的」拖到 git status 后面的逗号,浏览器里会同时存在三个可以观察的结果。

选中同一段文字时,DOM 范围、代码元素和文本矩形、选区底色在同一横轴上的关系

Selection 记录拖选的方向和端点。Selection.anchorNode 和 focusNode 分别对应起点和活动端。向左拖时,起点可以在文字右侧。getRangeAt(0) 返回的 Range 按文档顺序存储 startContainer 和 endContainer,画图时可以统一从文档前面走到后面。Range 的端点包含节点和偏移。端点落在文本节点上时,偏移以 UTF-16 码元计。落在元素上时,偏移表示子节点之间的位置。例如 git status 文本里的偏移 4 正好落在 status 的开头,左右留白没有对应的文本偏移。

浏览器根据字体、可用宽度和对齐方式,把这一段 DOM 排成若干行。一个文本节点可以跨出多个文字矩形。code 的外盒还包括它的内边距,整段 Range 跨过 code 时,getClientRects() 有可能同时返回代码元素的边框盒和里面的文字矩形。可以分别测量文字和元素的宽度。

const code = document.querySelector('p code');
const text = code?.firstChild;

if (code && text instanceof Text) {
  const range = document.createRange();
  range.selectNodeContents(text);

  console.table([
    { source: 'code 元素', width: code.getBoundingClientRect().width },
    { source: 'Text 节点', width: range.getBoundingClientRect().width },
  ]);
}

把这段代码放到前面的单行示例里,给 code 左右各加 6 像素内边距,元素比文字宽 12 像素。Marker 的左右内边距各 4 像素时,差值就是 8 像素。这里用 getBoundingClientRect() 读单行的宽度。跨行时它会把多个矩形围成一个大矩形,算缝隙要逐个看 getClientRects() 的结果。

CSS 高亮规范要求覆盖文字对应的字身区域,额外的盒子区域由浏览器决定。Chromium 在这个例子里会给 git status 中间的普通空格涂色,代码盒左右那两条 padding 露出原底色。把各个元素的 ::selection 设成同一个颜色,只解决了配色。::highlight() 同样使用高亮伪元素的覆盖规则。前面抬高链接的例子也说明了,原生选区可能画到整行那么高。文字矩形、元素盒和最终的高亮面积要分别核对。

Marker 怎样找到该补的那一小条

把代码的左右内边距从 4 像素改为 0,也能让这个例子里的文字区域接起来。代码会少占 8 像素,原本落到下一行的字可能留在上一行。Marker 的正文保留了原本的 padding: 0.08rem 0.25rem,补色在有选区时才出现。

在 Marker 里,浏览器的 Selection 继续负责鼠标拖选、键盘选择和复制。应用在旁边画一个绝对定位的 SVG,只给合格的缝隙放矩形。SVG 不占正文宽度,设置了 pointer-events: none,也没有文本可被顺手复制进去。选区的背景色和代码原有的浅底照常绘制。

读相邻的已选文字

useInlineSelectionGaps 从 Range 的共同祖先开始看文本节点。对每个相交节点,它用一个临时 Range 取出这个节点实际被选中的那一段。如果选区从 status 开始,测到的就是 status,代码前面的 git 仍在原来的位置。零宽矩形会跳过,跨行的节点保留首尾矩形。比较相邻两个节点时,用前一个节点的最后一个矩形和后一个节点的第一个矩形。

只有真实的代码边界才补色

同一段代码按拖选范围分为跨两侧、只跨左侧、反向只跨右侧和换行四种情形

图中用较深的颜色标出补色窄条,实际界面里补色取同一主题的选区底色。

每一侧都是独立判断。Marker 先要求两个矩形来自同一个正文块,并且只有一边属于行内代码。然后比两个文字矩形的纵向交集。当前实现用「交集大于较矮矩形的一半」判断同一视觉行,这是阅读器按当前排版采用的几何判定。下一步再检查文字断口是否贴着这一行的代码外盒边缘,断口宽度是否与该侧的 padding 相符。坐标与缩放可能带来小数,边缘与宽度比较都留了小于 1 像素的容差。

拿左侧验算一次。假设前面的已选文字结束于视口横坐标 180,代码文字开始于 184,代码元素左边缘在 180,左侧内边距正好是 4 像素。Marker 就画横坐标 180 到 184 这一条。另一侧要用后面的已选文字重新核对。反向拖选时 Range 的文档顺序相同,结果仍由两边实际选中哪些文字决定。换行后,上一行的尾部和下一行的开头各自有颜色,行与行之间留给正文排版。

把视口坐标换成 SVG 坐标

文字矩形的 left 和 top 是视口坐标,SVG 则跟着正文容器走。实现用每个缝隙的 left - host.left、top - host.top 当局部坐标,viewBox 的宽高采用同一次测得的容器宽高。比较内边距时,也会乘上元素的 currentCSSZoom,这样参与比较的都是同一坐标系中的长度。

拖选会连续触发 selectionchange,尺寸和字体也可能在同一轮更新中变化。这些事件交给同一个 requestAnimationFrame 合并处理。正文替换、容器缩放、字体加载和块展开后可以重新测量。普通滚动时,SVG 和正文容器一起移动。

打开批注时换一份 Range

阅读区收到有效选区时会用 cloneRange() 保存一份。点击「添加批注」后,草稿持有这份范围并聚焦输入框。在 Chromium 的实测里,原生选区此时清空。阅读区用草稿的 pendingRange 创建 Highlight,以 marker-pending 为名注册到 CSS.highlights,由 ::highlight(marker-pending) 继续给字涂色。补色层优先读取同一个 pendingRange,所以焦点离开正文后仍有坐标可用。查看现有批注时也可以从它的锚点取得临时高亮范围。

这里还要分别确定矩形的高度。在 Marker 的 Chromium 渲染里,原生选区沿行高绘制,补色高度按相邻文字的行高估算。草稿的 Custom Highlight 更贴近文字矩形,补色用相邻文字矩形的 top 和 height。如果沿用原生选区的高度,打开批注后,两条补色会从较矮的高亮上边冒出来。取消草稿或清空选区以后,对应的高亮和补色也随之移除。

Chromium 的 PaintHighlightOverlays 也能解释这段实测。它先在当前文字片段内尽量合并可合并的背景,再按高亮类型选矩形。原生选区调用 ComputeBackgroundRectForSelection,Custom Highlight 会走 ComputeBackgroundRect,从文字片段取局部矩形。源码还留有让后者对齐行高和断行处理的待办。两个背景刷成同色,边缘仍可能出现在不同高度。这里的补色高度是对当前渲染行为的适配。

从现有排版判断该改哪一层

在 GitHub 的 Primer CSS README 中,实测正文是 16 像素、行高 24 像素,行内代码字号为 13.6 像素,横向内边距为 5.44 像素。Marker 首次提交已使用 0.9em 的行内代码字号和 0.25rem 的横向内边距,提交没有注明设计来源。两套排版都有代码留白,尺寸、字体和配色各有自己的约定。

静态检查能约束什么

Lint 可以查出模板里把块级容器直接放进段落的写法,这可以用 HTML 段落的内容模型 判断,也可以约束项目约定的正文样式,例如阅读区颜色使用主题变量。若组件里包含运行时生成的 Markdown 正文,最终标签结构还需要从渲染结果验证。给所有 span 禁用边框或内边距会连正当的标签样式一起拦下,也无法判断一次选区真实跨了哪一侧。

折行、拖选方向、缩放后的坐标和批注焦点交接由浏览器决定。测试适合用同一段正文分别选中代码左侧、右侧和两侧,检查选中文本以及补色矩形的起止位置。把段落缩窄到发生换行后,再确认跨行处没有补色。打开批注编辑器时,先验证原生选区清空,再核对草稿还高亮刚才那段字。实机截图能额外发现颜色叠加、上下错位和几何断言看不到的细缝。

Marker 的桌面回归用例把窗口设为 125% 缩放,从代码后面的正文向左拖到 status,确认只生成右侧矩形。打开批注后,再核对矩形的横坐标和宽度是否仍接在同一侧。浏览器用例另行检查草稿矩形是否与相邻文字矩形等高。