SuperAPI AI 工具集

ui-features

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

该技能是 sidecar 中实现 UI/UX 功能的统一入口,主要覆盖模态框、键盘快捷键、鼠标命中区、滚动条与胶囊/标签渲染等。使用要点如下。

用途与主要能力:新增模态框须统一使用 internal/modal,并以 ui.OverlayModal 渲染,避免手工计算命中区;胶囊/标签使用 styles.RenderPillWithStyle,在 nerdFontsEnabled 为 false 时自动回退;键盘要求 Commands、FocusContext 与 bindings.go 三处一致,名称简短并设置优先级;鼠标命中区每次渲染重建,先加通用区域后加具体区域;渲染需保持在 View 宽高内以避免头/尾重叠;滚动条支持鼠标拖动,并需处理滚轮边界与惯性合并。

使用方式(关键点):模态框在 View 与 Update 中都调用 ensureModal,并按宽度缓存。自定义键需在 modal.HandleKey 之前拦截,Tab、Enter、Esc 由内部处理。文本输入视图需实现 plugin.TextInputConsumer 并返回 true,防止应用级快捷键截获输入。滚动需实现 plugin.WheelBoundaryConsumer,边界判断复用 internal/scroll.Bounds,并通过 tty.WheelBurst 合并滚轮事件;测试可用 internal/scroll/scrolltest。插件不得自行渲染页脚,应用依据 Commands() 统一渲染。

适用场景:在该代码库内新增模态框、快捷键、滚动区域、鼠标交互或页脚提示时参考。

限制:仅适用于 sidecar 项目内的 Go/Bubble Tea 实现;具体配置项、版本兼容与完整快捷键清单以项目文档为准,资料未提供独立安装命令与外部定价信息。