Hacker News Best

Terminal borders that don't cost a cell

8.5内容质量

TL;DR · AI 摘要

一种新型终端协议通过在单元格边缘绘制细线,实现无额外空间消耗的边框效果,提升TUI界面设计。

核心要点

  • 使用单元格边缘绘制细线,无需占用额外行或列。
  • 支持菜单、弹窗、面板式应用和图表等场景。
  • 已在Ghostty和Ratatui中实现并测试。

结构提纲

按章节快速跳转。

  1. 作者介绍当前TUI设计中边框问题的普遍性,并提出新方案。

  2. Unicode Box Drawing字符虽然常用,但无法完全满足设计需求。

  3. 通过在单元格边缘绘制细线,实现无空间消耗的边框效果。

  4. 适用于面板、菜单、图表等TUI界面设计场景。

  5. 已在Ghostty和Ratatui中实现并测试,效果显著。

思维导图

用一张图看清主题之间的关系。

查看大纲文本(无障碍 / 无 JS 友好)
  • 单元格边框协议
    • 实现方式
      • 单元格边缘绘制细线
      • 无需占用行或列
    • 应用场景
      • 面板与菜单
      • 图表与弹窗
      • TUI界面优化
    • 实现工具
      • Ghostty
      • Ratatui

金句 / Highlights

值得收藏与分享的关键句。

  • Every line in that screenshot is a cell border. None of them use up a row or column.

    — 第 5 段

    ⬇︎ 下载 PNG𝕏 分享到 X
  • With cell borders they sit on the pane's top edge. With box characters they need their own row inside the frame.

    — 第 7 段

    ⬇︎ 下载 PNG𝕏 分享到 X
  • btop-style braille graphs fill every cell with dots, so there's nowhere to put a gridline or an average line without giving up a row.

    — 第 9 段

    ⬇︎ 下载 PNG𝕏 分享到 X
#TUI#终端#Ratatui#Ghostty
打开原文

不占用单元格的终端边框 | Joshka.net

不占用单元格的终端边框

2026-11-13

:: tags:

#Ghostty

#Ratatui

#TUI

#Terminals

这篇文章(以及背后的代码)在很大程度上得到了AI的帮助。我不为此道歉。如果这让你感到不适,你可以随时关闭这个标签页。

我维护着Ratatui,因此我经常看到人们构建的TUI。其中很多最终看起来都差不多:单调的背景上简单的框,缺少了其他媒介中良好设计带来的许多元素。

边框是其中的一部分问题。它们必须占用空间,因此它们成为人们想要构建的面板的一部分。一个选项是放弃边框,只使用颜色,但边框在界定和环绕事物方面非常有用。在终端中有很多方法可以实现边框,但没有一种是完美的。我手动绘制了足够的┌──┐,对此我有自己的看法。

通常的方法是使用Unicode框线绘制块,它有128个字符用于线条、角落和连接。不知何故,这仍然不够:

因此,我一直在开发一种终端协议,它在单元格的边缘绘制细线。我已经将其作为Ghostty的补丁实现(在此之前,Rio中也有一个早期版本),并且我已经用Ratatui为其构建了演示应用程序。我希望能从终端和TUI的作者那里获得反馈。

该截图中的每一条线都是单元格边框。它们都没有占用一行或一列。标签位于每个面板的顶部边缘,文本字段在文本下方直接加下划线,按钮则是一行高且圆角。

这是同一款应用在没有单元格边框的终端中运行时的截图,回退到使用框线字符:

每个面板在每一边都失去了一行和一列,因此日志面板显示的行数减少了两行,笔记的换行方式也不同。标签移动到了框架内部。文本字段使用下划线属性,复选框和按钮变成了括号。

我会用它来做什么

  • 显然,边框。那些在每一边都不占用一行和一列的面板和面板。
  • 位于其他内容之上但仍看起来在顶层的菜单和弹出窗口。
  • 面板样式应用,其中布局是一组每个区域都想要边界的区域。
  • 文本字段、按钮和复选框等小部件,它们希望有一条线紧贴它们的文本。
  • 使事物看起来更整洁。在面板背景的外边缘加一个边框看起来会更干净,文本可以直接紧贴它。

详细观察

带有单元格边框的设置表,以及使用框线字符回退时的设置表:

标签的情况也是一样的。使用单元格边框时,它们位于面板的顶部边缘。使用框线字符时,它们需要在框架内部有自己的行:

图表

单元格之间的线条也适用于图表。btop风格的盲文图表用点填满了每个单元格,因此没有地方可以放置网格线或平均线而不牺牲一行。使用单元格边框时,它们位于点之间的单元格边缘。以下是使用Ratatui构建的这种风格的监控器:

而回退版本则必须放弃网格线:

动态演示

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

在演示进行到一半时,它会开启一个单元格的棋盘图案,这展示了所有内容如何与网格对齐。在这里切换它:

显示单元格网格

框线字符无法做到的事情

问题的根源在于框线字符是文本。每一行都是一个占据整个单元格的字形,而它们几乎所有令人烦恼的问题都源于这一点。

空间问题显而易见。在我的16英寸笔记本电脑上,使用一种我可以实际阅读的字体时,终端的大小大约是200x50(你的设置可能会稍微改变这个数值)。在这样的尺寸下,列数基本没有问题。行数却不行。一个包含几层嵌套面板的布局,很容易就用掉50行中的6到8行,仅仅只是为了画线。这会浪费大量屏幕空间,仅仅是为了装饰。

你也不能在两个都有内容的单元格之间画一条线。因此,你无法在文本字段下方直接画一条下划线,或者在按钮周围画一个边框,除非你为其添加额外的填充。圆角大致上可以工作,但角落的字形只有一种背景颜色,当面板的背景与周围不同时,每个角落会出现一块错误颜色的小方块。而线条本身则完全取决于字体的决定,包括其粗细和位置。

然后还有复制和粘贴的问题。在框线内选择一些文本时,框线也会被一同复制。每个在TUI中复制到Slack的人都知道那个小小的“│”清理舞蹈。有时候你确实需要框线(比如将表格粘贴到聊天中),但大多数时候它们只是垃圾。单元格边框不是文本,因此它们永远不会被复制,这双刃剑的效果显而易见。

实现方式

单元格边框是一种单元格属性,就像背景颜色一样。每个单元格最多可以携带12条线段:其四个边的两个部分,以及从中心延伸出的四个臂。每条线段都有自己的颜色、宽度、位置和样式,终端会将它们绘制在单元格网格上。边框存储在单元格中,因此它们会随着文本一起滚动、清除、插入和重新排列。清除或滚动时发生的情况已经有了答案,与颜色的处理方式相同。

将边分割成两部分,使得边框可以与象限块字符(如 ▖▗▘▝ 等)对齐。这使得在网格中从半格处绘制一个形状并仍然为其绘制一个整洁的边框变得容易。是的,这仍然使用一个字符进行填充,也许还有更好的方法来实现这一点。一次解决一个问题。

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

风格和连接点

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

当两个相邻的单元格都在它们共享的边上绘制线条时,它们会合并成一条线。优先级较高的笔画获胜,其次是更宽的笔画,然后是右侧或下方的笔画。这样,无论邻居的绘制顺序如何,一个聚焦的面板都可以提高其优先级并保持其整个轮廓。我第一次尝试的是“右侧/下方始终获胜”,但这种方法一直持续到聚焦的面板失去了一半的轮廓给邻居。

线格式

所有内容都是一个带有命名空间的DCS字符串:

code
ESC P 1 + b cell-border ; OP ; FIELDS... ESC \

常见的路径是一支笔,像当前背景颜色一样由光标持有。设置它,打印一些文本,打印的单元格就会获得边框:

code
ESC P 1 + b cell-border;pen;48;32;7aa2f7;0;0 ESC \     底部边缘,蓝色:下划线
hello
ESC [ 0 m                                              SGR 0 清除笔

也存在一些矩形命令,可以在不触碰笔的情况下设置或清除现有单元格的边框,还有一个能力查询功能。应用程序发送查询后,接着发送 DA1。如果 DA1 的回复在没有先收到单元格边框回复的情况下到达,说明终端不支持该功能,因此应用程序会回退到使用框字符,并保留它们所需的空间。不理解 DCS 的终端会忽略它,与任何未知的 DCS 处理方式相同。

终端至少需要笔、矩形命令和实线笔画。我努力让这个初步实现保持简洁,因为总会有一堆“...还有这个”要添加,而这会让人陷入一个滑坡效应。

线型、圆角连接、优先级和外部颜色是能力回复中列出的扩展字段,未知字段会被忽略,因此可以稍后添加。我更希望早期的决策尽可能成为双向门。

该规范将自己称为版本 1(即 DCS 1 + b 中的 1)。这是旧意义上的版本 1,是在我们都被语义化版本控制(semver)所困扰之前。这并不表示已经完成或稳定,而是表示这是我愿意写下来的第一个版本。你可以把它看作是 v0.1,或者草稿,或者你更喜欢的任何称呼。

先前的技术

此前已经有人做过类似的工作:

  • DECterm 中的 DEC 规则线(DA1 回复中的扩展 43)会在矩形周围绘制线条。这些线条会随着文本滚动,但它们是独立的一层:清除屏幕时它们不会被清除,并且在正常文本颜色下始终是 1 像素宽。
  • SGR 51 到 65:带框线、环形线、上划线和汉字边线。一些终端使用这些功能绘制边框,但它们是开/关属性,没有颜色、宽度或连接方式,也没有底部边线的属性。
  • Win32 控制台为顶部、左侧和右侧边线提供了每个单元格的网格标志。PDCurses 和 X/Open curses(WA_TOP、WA_LEFT 等)具有类似的属性。这些功能最接近本协议,但它们没有底部边线(Win32)、颜色、宽度或半边线。
  • IBM 3270 终端可以勾勒出整个输入字段的轮廓。

上述所有方法都无法在每条边线上提供具有自己颜色和宽度的线条。理由文档详细介绍了这些先前的技术,并解释了协议中每个选择的原因。

我自己的第一个原型是在 Rio 中实现的(raphamorim/rio#1947),当时使用的是 APC 而不是 DCS 的规范早期版本。反馈指出 APC 不适合重复使用:自 90 年代以来,Kermit 95 就一直将 APC 负载作为 Kermit 命令执行。DCS 是结构化终端命令已经存在的地方,终端会忽略它们无法识别的 DCS 字符串,因此我改用 DCS。

尴尬(边缘)情况

当我第一次展示这个功能时,大多数人问的问题都是这些。规范中对这些情况都有详细说明,但以下是我大致的结论。

多路复用器是人们首先问到的问题。tmux 和其他类似工具根据自己的单元格网格概念重新绘制窗口,因此将这些序列传递过去只会让边框出现在错误的位置。不了解该协议的多路复用器应丢弃这些序列,并自行回答 DA1,运行在其内部的应用程序会像在其他任何地方一样回退到使用框字符。了解该协议的多路复用器可以像处理其他任何属性一样存储边框,并重新绘制它们。

在共享边线上存在冲突的线条会在终端渲染时通过上述的优先级规则解决,因此应用程序写入单元格的顺序无关紧要。

删除、插入和全部删除的操作与背景颜色的处理方式相同。被删除的单元格会继承当前的笔触,而被插入或删除的线条会保留它们的边框。滚动回溯、备用屏幕和自动调整大小等功能大多可以免费获得,因为边框存在于单元格中。

关于成本:Ghostty 的更改大约涉及 1,650 行代码,其中相当一部分是测试代码。每个单元格获得一个 16 位的边框 ID,这个 ID 可以放入已有的填充空间中,因此单元格的大小不会增加,没有边框的屏幕也不会产生额外成本。这些 ID 指向一个共享整个终端的边框集合表(每个集合大约 100 字节)。一个典型的 TUI 通常只使用少量不同的集合,但该表永远不会被释放,因此在最坏情况下(所有 65,535 个 ID 都被使用),它大约需要 10-15 MB 的内存。

渲染时,只有具有边框的单元格才会进行额外的处理。每个单元格会查看其四个邻居以解决共享边的问题,因此更改一行也会重建其上下行。直线每个单元格只需几个实心四边形。圆角则成本更高,因为抗锯齿弧线是以每条边像素一行的小四边形绘制的。我尚未对这些内容进行适当的基准测试,这也是我最希望其他人能再检查一下的部分。

尝试一下

规范和理由在我的 Ghostty 分支中。Ghostty 分支实现了版本 1 的所有功能。到目前为止,我只在 macOS 上构建并运行了它,因此 GTK 和 OpenGL 的构建尚未经过测试。要构建并运行它(你需要 Zig 0.17 和 Xcode):

code
git
clone
-
b
joshka/cell-borders
https://github.com/joshka/ghostty.git
cd
ghostty
zig
build
-
Doptimize=ReleaseFast
-
Dxcframework-target=native
open
zig-out/Ghostty.app

在 Ghostty 中,同一分支上的画廊脚本会绘制上方的样式画廊。它首先检测支持情况,因此也可以作为另一个终端实现的快速检查:

code
python3
scripts/cell-borders.py
#
默认视图
python3
scripts/cell-borders.py
-
-styles
#
线样式、连接点和外部填充

运行后,你可以使用以下按键在视图之间切换:p 用于放置,c 用于颜色,h 用于块,j 用于连接点,e 用于半部分,s 用于样式,l 用于实时。w 用于切换笔触宽度,b 用于关闭边框以便进行比较,q 用于退出。每个视图都有一个对应的标志(--placement、--styles 等),如果你想从该视图开始。

平铺面板演示在 Ratatui 分支中。当终端不支持单元格边框时,它会回退到使用框绘制字符,这就是我上面制作比较截图的方式:

code
git
clone
-
b
joshka/cell-borders
https://github.com/joshka/ratatui.git
cd
ratatui
cargo
run
-
p
tiling-panes

使用鼠标拖动面板以重新平铺它们。n 和 v 用于分割,x 用于关闭,右键单击打开面板菜单。按 b 切换单元格边框和框绘制,按 g 以阴影方式显示交替的单元格并查看边缘所在的位置。

图表截图中的 btop 风格监视器也在同一分支中。鉴于其中大部分内容是由 AI 编写的,我曾短暂考虑将其命名为 bslop:

要运行它:

code
cargo
run
-
p
cell-border-top

它是一个真正的系统监视器(它会读取你实际的 CPU、内存、网络和进程),因此它比面板演示更能测试这个功能在繁忙屏幕上的表现。1 到 4 显示和隐藏框,b 和 g 的作用与面板演示中相同,h 或 ? 列出其余的键。由于 sysinfo 依赖项,它需要比 Ratatui 其他部分更新的 Rust(1.95)。

我想听听你的意见

我不认为这必须是唯一的解决方案,但我认为这是一个值得解决的问题,我希望它不仅仅是一个终端的特性(也不仅仅是一个周末的“剃牦牛”工作)。如果你正在开发终端,你会实现这个功能吗?哪些部分看起来成本较高?如果你正在开发一个 TUI(文本用户界面)库或应用,你的哪些组件会使用它?它们还需要什么目前没有的功能?欢迎在 Ghostty 的讨论区发表评论。

感谢阅读!还想阅读其他文章吗?

←

在 Axum 中 SQLx 查询的一种人体工程学模式