ui/el
GPUI 风格的元素与视图:视图是普通 struct,每帧 Render 返回一棵链式样式搭起来的元素树;flexbox 布局;元素状态(悬停、滚动、输入框内容)按元素路径或 ID 自动保存;Agent 语义自动生成。
- 依赖:
core、theme、locale,以及内部的ui/internal/loop、ui/internal/editorstyle、ui/internal/inputcontent,ui/internal/animation。不依赖kit、window。 - 被谁依赖:应用代码。
window通过FillsWindow接口认出el.Root,不引用本包。
| 文件 | 内容 |
|---|---|
element.go |
Element、Node、Styled[T] 的全部链式方法,Div、Text、Widget、Map;Decorate 包裹绘制,VisitWidgets 读取布局后的部件坐标 |
arena.go |
每个 root 的节点块、可复用节点缓冲、独立指针句柄和构建代号校验;Cache 和独立元素使用持久存储 |
reload.go |
core.ReloadState:在 keel run 重载间保留滚动位置和输入框文字,按树中位置、角色和名称匹配;从不保存密码 |
time.go |
帧时间、声明式定时器、显式 key 与减少动画 |
overlay.go |
声明式浮层、锚定定位、模态输入隔离、焦点约束与悬停查询 |
mount.go |
cx.Mount:把视图挂到窗口根部(kit 的 Dialog.Show、Sheet.Show、WindowNotifier 用它) |
key_context.go |
KeyContext、cx.ActionAt、cx.Perform(菜单和命令面板按动作名执行) |
scrollbar.go、scrollbar_mode.go |
滚动条绘制、显示策略(含跟随系统)与淡入淡出 |
focus.go |
原生焦点顺序、程序焦点、按键冒泡与默认激活、FocusVisible |
input.go |
Input、TextArea |
style.go |
Style、长度(Dp、Sp、Frac、Full、Fr)、对齐常量 |
layout.go、flow.go |
flexbox(含 Self)、换行与二维网格布局(GridCols、ColSpan、RowSpan、ColGap/RowGap) |
signal.go |
细粒度响应式 Signal[T]、Computed[T] 与自动依赖追踪的 Context.Memo(支持嵌套原地局部更新) |
paint.go |
绘制、点击区域、滚动、输入框、语义信息 |
text_measure.go |
只计算文字尺寸,同帧复用测量结果;使用 Gio 排版,不生成绘制操作 |
text_paint.go |
短的单行数字标签复用矢量字形片段;复杂排版或字形重叠时回退到 Gio 标签 |
text_atlas.go |
按需启用数字标签图片缓存;绘制前准备可见标签,限制每帧存储,并检查绘制时的参数 |
viewport.go |
绘制坐标、可视区域与最近滚动容器的程序滚动 |
state.go |
元素状态存储与回收;触屏长按打开右键菜单 |
root.go |
View、ViewFunc、Context、Root、Embed,每帧的执行顺序 |
使用指南:元素与视图。
input_paste.go 在默认文本插入前处理 OnPaste;可接入 core.ClipboardReader,原生读取失败回退 Gio 纯文本通路。异步完成通过 core.Update,编辑内容或选区变化后丢弃旧结果。
原子输入引用由 el.InputDocument 接入 ui/internal/inputcontent,后者只保存文本、引用范围、选区和编辑事务,不依赖 Gio 或其他 Keel 模块。kit 和 markdown 仅经 el 间接依赖它。
可拖拽盒子支持父坐标轴移动、边界阻力、松手速度与吸附点,详见拖拽与松手动画。
文字内容过渡支持淡入淡出、数字滚动和完整塑形簇的重排,详见文字内容变化。
SharedLayout 连接不同父容器中的前后两个元素,点击区域与锚定浮层同步移动。参见共享元素。
共享布局加 .Fly() 后可越过祖先裁剪,仍绘制在后续浮层下方;Inert 退场状态仍禁止交互并隐藏语义。
共享元素切换还会插值基础纯色、圆角、边框宽度和透明度。Text 同时声明 SharedLayout 与 ContentTransition 后,可跨父容器衔接文字,支持中途反向和字体变化。
共享容器加 MatchText 后,按相对 ID/路径自动配对子文字。共享过渡也支持线性渐变和 Elevation 阴影插值。