docs: clarify shell observation and window-local tab contracts

This commit is contained in:
2026-11-12 20:58:37 +08:00
parent 2d5138c7ad
commit b15d0872d7
4 changed files with 18 additions and 7 deletions
+6 -1
View File
@@ -24,15 +24,21 @@ pub const CONTROLS: f32 = if cfg!(target_os = "macos") { 86.0 } else { 0.0 };
/// 侧栏释放激活后要执行的管理动作,绘制本身只登记它。
// app::sidebar_action 执行这些已确认动作;页面 ID 来自本窗口的 Tab 投影,不是 VM 对象引用。
pub enum Action {
// app 就地切换侧栏占用宽度并发布视口,不向 VM 发送标签事件。
Toggle,
// app 通过 open_developer_tool("New tab") 提交新页请求,不在 draw 内创建页面。
NewPage,
// 固定工具名称交给同一打开入口,是否复用已有工具页由运行时处理。
Tool(&'static str),
// app 将当前窗口标签 ID 放进 Input.mount,并以 tab-activate 交给 worker 校验与切页。
Activate(u64),
// 与激活使用相同身份通道,但事件种类为 tab-close,不能按列表行号关闭页面。
Close(u64),
}
/// 侧栏开合、控件交互和本帧目标集合,决定实际占用页面宽度。
pub struct State {
// 仅属宿主 UI 的开合状态;决定 left/covers/draw,不是托管页面中的可响应属性。
pub open: bool,
// 跨帧保存悬停、键盘焦点和按下捕获;目标矩形则由每次 draw 重建。
pub interaction: Interaction,
@@ -154,7 +160,6 @@ impl State {
let y = area.y + index as f32 * 36.0 - self.scroll;
// Register only fully visible rows: paint clipping must match input.
// 当前实现完全跳过部分可见行,绘制与注册都不发生;Clip 仍保护其他原语不溢出列表区域。
// 部分可见行整行跳过,既不产生切页按钮也不产生关闭按钮,防止不可见片段仍可激活。
if y < area.y || y + 32.0 > area.y + area.height {
continue;
}