返回资讯中心
外部精选
软件工程
#社区热议

Ratatui 维护者开发终端协议,在单元格边缘绘制细边框

来源标题:Terminal borders that don't cost a cell

Ratatui 维护者正在开发一种终端协议,在单元格边缘绘制细线条来显示边框,从而不占用单元格空间。该协议已作为 Ghostty 补丁实现(此前在 Rio 中也有早期版本),并用 Ratatui 构建了演示应用。

Hacker Newsvinhnx2026/11/13 · 4 天前30 分钟阅读

以下正文由 AI 翻译自 Hacker News(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

这篇文章(以及它背后的代码)是在 AI 的大量帮助下写成的。我不会为此道歉。如果这让你不舒服,关掉标签页就好。

我维护 Ratatui,所以见过很多别人做的 TUI。它们大多看起来都差不多:无聊背景上的普通方框,缺少了其他媒介里好设计能带来的很多东西。

边框是问题的一部分。边框必须占空间,所以它们就成了人们想做的面板的一部分。一个选择是去掉边框、只用颜色,但边框在划分和包围内容方面真的很好用。在终端里弄出边框有很多种办法,但没有一种是 100% 完美的。我手画过足够多的 ┌──┐,所以对此有看法。

常见做法是 Unicode 的 Box Drawing 区块,它有 128 个字符,用于线条、拐角和连接。不知怎的,这仍然不够:

所以我一直在做一个终端协议,改为在单元格的边缘绘制细线。我把它做成了 Ghostty 的一个补丁(在那之前,Rio 里也有一个更早的版本),并用 Ratatui 为它做了演示应用。我希望得到终端和 TUI 作者的反馈。

那张截图里的每一条线都是单元格边框。它们都不占用行或列。标签页标题位于每个面板的上边缘,文本框的下划线就在文字正下方,按钮只有一行高且是圆角的。

这是同一个应用在没有单元格边框的终端里的样子,回退到 box-drawing 字符:

每个面板的每一边都损失一行和一列,所以日志面板少显示两行,笔记的换行方式也不同了。标签页标题移到了框架内部。文本框改用下划线属性,复选框和按钮变成了方括号。

设置表单,先是单元格边框,然后是 box-drawing 回退:

标签页也是一样。有单元格边框时,它们位于面板的上边缘。用 box 字符时,它们需要在框架内部单独占一行:

单元格之间的线对图表也适用。btop 风格的盲文图表用点填满每个单元格,所以如果不牺牲一行,就没地方放网格线或平均线。有了单元格边框,它们就位于点之间的单元格边缘上。这是一个用 Ratatui 构建的该风格监视器:

以及回退版本,它不得不去掉网格线:

这是平铺面板演示,移动面板、打开菜单和关于对话框:

进行到一半时,它会打开单元格的棋盘格显示,展示所有东西如何与网格对齐。在这里切换它:

根源在于 box-drawing 字符是文本。每条线都是一个占满整个单元格的字形,几乎所有烦人的地方都源于此。

空间是显而易见的一个。在我那台 16 英寸笔记本上,用我真正能看清的字体,终端大概是 200x50(你的偏好设置会让这个数字有些变化)。在这个尺寸下,列大多没问题。行不行。一个有几层嵌套面板的布局,很容易把 50 行里的 6 到 8 行只花在线上。为了装饰放弃这么多屏幕空间,代价太大了。

你也没法在两个都有内容的单元格之间放一条线。所以没办法在文字正下方给文本框加下划线,也没法给按钮描边,除非在它周围加内边距。圆角勉强能用,但拐角字形只有一种背景色,当面板背景和周围不同时,每个角上就会出现一小块颜色不对的方块。而线条本身是什么样,包括粗细和位置,全由字体决定。

然后是复制粘贴。选中方框里的一些文本,你会把方框也一起选中。每个从 TUI 往 Slack 里粘贴过的人,都熟悉清理那些小 │ 的操作。有时候你确实想要方框(比如把表格粘贴到聊天里),但大多数时候它是垃圾。单元格边框不是文本,所以永远不会被复制,这一点有利也有弊。

单元格边框是一种单元格属性,就像背景色一样。每个单元格最多可以携带十二条线段:四条边各自的兩半,以及从中心伸出的四条臂。每条线段都有自己的颜色、宽度、位置和样式,终端把它们绘制在单元格网格之上。

边框存储在单元格里,所以它们会随文本一起滚动、擦除、插入和重排。擦除或滚动时会发生什么,已经有答案了,和颜色一样。

边缘被分成两半,这样边框就能与象限块字符(▖▗▘▝ 之类)对齐。这样一来,画一个距网格半格的形状并给它加上整齐的边框就很容易了。是的,填充仍然要用一个字符,这部分也许有更好的做法。一次解决一个问题。

如果设计需要,同样的思路可以扩展到六分区和八分区,或者四分之一和八分之一的宽度。

线条可以是实线、双线、虚线或点线。单元格的每个角和中心可以是方形或圆角,半径可配置,弧线带抗锯齿。圆角可以指定一个外部颜色,这样当面板背景与背后不同时,弧线以外的区域也能正确绘制。

当两个相邻单元格都在共享边缘上放置线条时,它们会合并成一条线。优先级更高的笔画获胜,然后是更宽的,然后是右边或下边的。这样,聚焦的面板可以提高优先级并保持其完整轮廓,无论邻居以什么顺序绘制。我第一次尝试是“右边/下边总是赢”,直到聚焦面板被邻居抢走了一半轮廓,这个方案才作废。

所有内容都是一个带命名空间的 DCS 字符串: ESC P 1 + b cell-border ; OP ; FIELDS... ESC \

常见路径是一支画笔,像当前背景色一样保持在光标上。设置它,打印一些文本,打印出来的单元格就会带上边框: ESC P 1 + b cell-border;pen;48;32;7aa2f7;0;0 ESC \ 底边,蓝色:一条下划线 hello ESC [ 0 m SGR 0 清除画笔

还有一些矩形命令,可以在现有单元格上设置或清除边框,而不影响

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →