投稿 提交工具 投放合作

bubblezone:Bubble Tea 终端 UI 鼠标区域检测库

开发框架 924 29 Go 2026-11-20 在 GitHub 打开

为 Bubble Tea/lipgloss 应用注入零宽标记并扫描区域,让嵌套组件能判断鼠标事件是否落在自身边界内。

bubblezone 是一个 Go 库,解决 Bubble Tea 与 lipgloss 应用中组件层级变深后难以判断鼠标点击落在哪个组件的问题。它用零可打印宽度的标记包裹组件区域,在根模型的 View() 输出上调用 zone.Scan() 记录各标记的偏移并从输出中剥离;子组件在 Update() 中用 zone.Get(id).InBounds(mouseMsg) 判断事件是否落在自身边界内,从而实现聚焦、点击按钮等交互。标记不影响 lipgloss.Width() 计算,提供全局与非全局管理器,以及 NewPrefix() 生成唯一前缀避免 ID 冲突。注意事项:MaxHeight/MaxWidth 硬裁剪会破坏区域标记,Scan() 只应在根模型调用,InBounds 基于矩形区域判断。README 提示 Bubble Tea v2 用户可考虑其后继项目 bloom,bubblezone v1 仍适用于 v1 程序。

Star 趋势2026-11-06 — 2026-11-20当前 Stars 9247 日 +4

91992292411-0611-1111-1311-1511-1711-20