Keel v0.5.1 English GitHub

ui/core

所有界面模块的地基:

名字 作用
Widget 接口:能 Layout 的东西。所有组件、容器都实现它
ReloadState 窗口内容与 ui/window 之间用于 keel run 重载的接口;el 的根实现它
Func 把一段 Gio 布局函数当组件用
ViewportWidget、ViewportFunc 嵌入或包装组件时保留父级可见区域,跳过屏外绘制,同时保留完整内容尺寸
DecodeImage(ctx, source) 读取本地/HTTP/data 图片,限制编码大小与像素数;须在后台调用并管理超时。ReadImageSource / DecodeImageBytes 是它拆开的两步,kit 的 Image 用来另外解码 SVG、GIF 动图
Update(fn) 从任意 goroutine 修改界面:fn 在下一帧执行
Call(gtx, fn) 给写组件的人用:执行用户回调并让所有窗口重绘
Semantic(gtx, w, ops...)、Role(...) 给写组件的人用:声明组件的角色、名字、状态,让 Agent 看得见
Bind、BindIn、Bindings、BindingsIn 键位表:动作名到快捷键,BindIn 的上下文可以写条件表达式(Editor && !ReadOnly、Pane > Editor),见 菜单 · 上下文条件表达式
CurrentScrollGesture、ReportScrollGesture 滚动的设备(滚轮/触控板)和手势阶段;ui/window 从 macOS、Wayland 读来报告,Carousel 等组件读取
WindowControls、CurrentWindow() 组件拿到所在窗口的激活状态、标题区域登记、最小化、最大化、关闭能力,自定义标题栏用。ui/window 在布局期间登记当前窗口
  • 依赖:只依赖 Gio,以及内部的 ui/internal/loop。
  • 被谁依赖:el、kit、window、markdown。

线程规则:回调里直接改组件;其他 goroutine 改组件包进 core.Update。原因见 架构 · 线程规则。

ClipboardData、ClipboardImage、ClipboardReader 定义富粘贴交换数据与异步读取接口;core 不读取系统剪贴板,不引用 native。应用适配平台读取结果,由输入组件调度回 UI 线程。

常驻应用可以用 UpdateIf(func() bool) 在帧锁下执行后台检查,仅在回调返回 true 时请求重绘。轮询结果不变时返回 false,让 GPU 和 Go 的空闲回收能够完成。非驻留应用仍需通过一帧执行回调。