docs: clarify shell observation and window-local tab contracts
This commit is contained in:
@@ -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;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user