docs: explain sidebar and native window coordination
This commit is contained in:
@@ -29,6 +29,7 @@ use crate::{
|
||||
|
||||
#[derive(Clone, Debug)]
|
||||
/// worker 到原生事件循环的通知,携带更新/错误/退出状态而不是可执行 VM 引用。
|
||||
// main 创建的 EventLoopProxy 被 worker、事件客户端和工具 HTTP 线程克隆,ApplicationHandler::user_event 统一接收。
|
||||
pub enum AppEvent {
|
||||
RuntimeFailed { message: String },
|
||||
DocumentUpdated,
|
||||
@@ -40,10 +41,12 @@ pub enum AppEvent {
|
||||
pub struct TesseraApp {
|
||||
// 运行时窗口资源编号与 winit WindowId 分属不同命名空间,输入携带前者,OS 事件匹配后者。
|
||||
resource: u64,
|
||||
// 共享运行时的退出/调度控制,所有原生窗口复用;OS 关闭需要先走运行时生命周期收尾。
|
||||
control: crate::api::RuntimeControl,
|
||||
exit_requested: bool,
|
||||
// 记录当前原生窗口所对应的运行时世代,避免重启后继续显示已失效的子窗口。
|
||||
native_session: u64,
|
||||
// 防止初始无文档时反复申请起始页面,与开发工具输入提交状态分开。
|
||||
startup_page_requested: bool,
|
||||
native_error: Option<String>,
|
||||
// 只有主窗口维护此表;子窗口有独立文档/绘制状态,但复用运行时控制与输入队列。
|
||||
@@ -53,12 +56,14 @@ pub struct TesseraApp {
|
||||
window: Option<Arc<Window>>,
|
||||
context: Option<Context<Arc<Window>>>,
|
||||
surface: Option<Surface<Arc<Window>, Arc<Window>>>,
|
||||
// 主窗口连接 worker 权威发布状态,子窗口保存从其投影的本地副本;输入客户端仍共享权威队列。
|
||||
namespace: Arc<RwLock<NamespaceState>>,
|
||||
developer_tools: DeveloperToolsState,
|
||||
// 最近一次绘制生成的宿主控件几何,用于下一次输入命中、光标和 IME 定位。
|
||||
layout: SceneLayout,
|
||||
pointer: Point,
|
||||
sidebar: crate::sidebar::State,
|
||||
// 最近交互是否把键盘路由给侧栏控件,决定 Tab/Enter/Space 是否先被宿主导航消费。
|
||||
sidebar_keyboard: bool,
|
||||
panning: bool,
|
||||
// 拖动开始时捕获视口,None 也可能表示拖动整张 Canvas,而非手势未开始。
|
||||
@@ -70,8 +75,10 @@ pub struct TesseraApp {
|
||||
event_client: crate::events::Client,
|
||||
// 保存按下时的版本与位置;释放时需确认仍处在同一会话与布局,防止旧画面误点击。
|
||||
guest_pressed: Option<crate::events::Input>,
|
||||
// 页面指针悬停和捕获分别存带版本令牌;按下捕获后不能随着指针移到别的出现而切目标。
|
||||
pointer_hover: Option<crate::events::Input>,
|
||||
pointer_capture: Option<crate::events::Input>,
|
||||
// 已发布帧的页面焦点令牌,含会话/布局版本;按键不能仅凭旧 Mount ID 发到新世代。
|
||||
guest_focus: Option<crate::events::Input>,
|
||||
// Enter/Space 的按下捕获;只在对应按键释放时发出一次 click,忽略系统连发。
|
||||
guest_key: Option<(NamedKey, crate::events::Input)>,
|
||||
@@ -81,12 +88,14 @@ pub struct TesseraApp {
|
||||
impl TesseraApp {
|
||||
/// 先建立连接权威 namespace 的有界事件客户端,再初始化主窗口状态。
|
||||
/// 客户端创建失败向调用方返回错误;原生窗口和像素表面延迟到 resumed 创建。
|
||||
// main 在启动原生 run_app 前调用;只建立输入客户端与状态,实际 OS 窗口依赖事件循环 resumed。
|
||||
pub fn new(
|
||||
namespace: Arc<RwLock<NamespaceState>>,
|
||||
activity: Activity,
|
||||
proxy: EventLoopProxy<AppEvent>,
|
||||
control: crate::api::RuntimeControl,
|
||||
) -> anyhow::Result<Self> {
|
||||
// 初始化可能启动/连接宿主事件发送设施,失败就停止应用构造,不能保留无权威输入通道的半初始化窗口。
|
||||
let event_client =
|
||||
crate::events::Client::new(proxy.clone(), namespace.clone(), control.clone())?;
|
||||
Ok(Self::with_event_client(
|
||||
@@ -99,6 +108,7 @@ impl TesseraApp {
|
||||
}
|
||||
|
||||
/// 建立窗口宿主状态并复用权威输入客户端,避免子窗口使用滞后的独立事件队列。
|
||||
// new 创建主状态、reconcile_windows 创建子状态时共用;子实例随后覆盖 resource 和 native_session。
|
||||
fn with_event_client(
|
||||
namespace: Arc<RwLock<NamespaceState>>,
|
||||
activity: Activity,
|
||||
@@ -106,6 +116,7 @@ impl TesseraApp {
|
||||
control: crate::api::RuntimeControl,
|
||||
event_client: crate::events::Client,
|
||||
) -> Self {
|
||||
// 窗口表面、会话身份、焦点和手势均从空状态开始,侧栏与开发工具各有独立宿主状态。
|
||||
Self {
|
||||
resource: crate::window::MAIN_WINDOW,
|
||||
control,
|
||||
@@ -141,37 +152,45 @@ impl TesseraApp {
|
||||
}
|
||||
|
||||
/// 将已发布窗口文档与原生资源对齐;session 更换时丢弃旧域的子窗口。
|
||||
// document_updated 的第一阶段调用;只让主实例协调子窗口,子实例收到更新时直接跳过协调。
|
||||
fn reconcile_windows(&mut self, event_loop: &ActiveEventLoop) {
|
||||
if self.resource != crate::window::MAIN_WINDOW {
|
||||
return;
|
||||
}
|
||||
// 共享状态读锁失败时保留现有原生窗口,本次不根据不完整信息删除或创建子资源。
|
||||
let Ok(namespace) = self.namespace.read() else {
|
||||
return;
|
||||
};
|
||||
// 同时复制会话、发布版本和提交编号,所有子文档快照使用同一批父发布元数据。
|
||||
let session = namespace.runtime_session;
|
||||
let revision = namespace.revision;
|
||||
let submission = namespace.submission;
|
||||
// 先复制已发布的子窗口投影并释放读锁,再创建/销毁 OS 资源;原生调用不会占着发布锁。
|
||||
let documents = namespace.document.windows.clone();
|
||||
drop(namespace);
|
||||
// 运行时世代变化不必立即销毁所有窗口,下面先检查发布投影是否已经属于新世代。
|
||||
if session != self.native_session {
|
||||
// 控制台 reset 可以保留旧投影但禁用输入;真正替换运行时后,
|
||||
// 新文档带新 session,此时销毁旧原生视图,防止跨世代复用。
|
||||
let replaces = documents
|
||||
.values()
|
||||
.any(|document| document.frame.session == session && session != 0);
|
||||
// 新世代已有有效子文档或明确无子窗口时清旧资源;session=0 的暂留投影不在此分支强制清空。
|
||||
if replaces || (session != 0 && documents.is_empty()) {
|
||||
self.children.clear();
|
||||
}
|
||||
self.native_session = session;
|
||||
}
|
||||
// 逐资源 ID 与新文档对照,缺失的窗口删除;session=0 投影允许保留旧窗口用于显示。
|
||||
self.children.retain(|id, child| {
|
||||
documents.get(id).is_some_and(|document| {
|
||||
document.frame.session == 0 || child.native_session == document.frame.session
|
||||
})
|
||||
});
|
||||
// 既有子窗口更新数据后刷新,新资源则建立独立宿主状态;不为每个子窗口创建另一套 VM。
|
||||
for (id, document) in documents {
|
||||
if let Some(child) = self.children.get_mut(&id) {
|
||||
// 本地子状态整体替换文档和发布元数据,再由 child.document_updated 应用该窗口焦点及原生命令。
|
||||
if let Ok(mut namespace) = child.namespace.write() {
|
||||
namespace.document = document;
|
||||
namespace.runtime_session = session;
|
||||
@@ -180,6 +199,7 @@ impl TesseraApp {
|
||||
}
|
||||
child.document_updated(event_loop);
|
||||
} else {
|
||||
// 新子窗口的 NamespaceState 只装本窗口投影;event_client 仍复用主客户端以校验权威会话和布局。
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState {
|
||||
document,
|
||||
runtime_session: session,
|
||||
@@ -194,9 +214,11 @@ impl TesseraApp {
|
||||
self.control.clone(),
|
||||
self.event_client.clone(),
|
||||
);
|
||||
// 把默认主资源号改成本次子窗口 ID,后续输入、viewport 和原生事件由该编号归属。
|
||||
child.resource = id;
|
||||
child.native_session = session;
|
||||
child.resumed(event_loop);
|
||||
// 原生创建失败将错误放到主工具界面,不把缺失 OS 窗口表述成运行时创建已成功呈现。
|
||||
if let Some(error) = &child.native_error {
|
||||
self.developer_tools.input_error = error.clone();
|
||||
self.developer_tools.open = true;
|
||||
@@ -208,6 +230,7 @@ impl TesseraApp {
|
||||
}
|
||||
|
||||
/// 只应用当前运行时身份的窗口命令;执行前从共享队列取走,避免重复执行。
|
||||
// 文档更新和 resumed 路径调用;消费一次性窗口动作,主关闭转退出请求而非直接终止 VM。
|
||||
fn apply_window_commands(&mut self) {
|
||||
let Ok(mut namespace) = self.namespace.write() else {
|
||||
return;
|
||||
@@ -216,11 +239,14 @@ impl TesseraApp {
|
||||
// 取走整批命令即表示消费;随后释放写锁,执行窗口 API 时不阻塞 worker 的文档发布。
|
||||
let commands = std::mem::take(&mut namespace.window_commands);
|
||||
drop(namespace);
|
||||
// 脱离锁后逐条检查世代;整个命令批已取走,过期/无目标命令会丢弃而不是留队重试。
|
||||
for envelope in commands {
|
||||
// 只有当前非零会话的命令可操作 OS 资源,旧域延迟发布的动作不能影响新窗口。
|
||||
if envelope.session == 0 || envelope.session != session {
|
||||
continue;
|
||||
}
|
||||
let id = envelope.command.window;
|
||||
// 关闭优先处理:主资源进入受控退出,子资源从原生表移除,然后不再落到普通窗口动作分支。
|
||||
if matches!(envelope.command.action, crate::window::Action::Close) {
|
||||
if id == crate::window::MAIN_WINDOW {
|
||||
self.request_exit();
|
||||
@@ -229,6 +255,7 @@ impl TesseraApp {
|
||||
}
|
||||
continue;
|
||||
}
|
||||
// 资源 ID 查本窗口或主实例管理的子窗口,查不到实际 Window 时直接跳过。
|
||||
let target = if id == self.resource {
|
||||
self.window.as_ref()
|
||||
} else {
|
||||
@@ -239,12 +266,14 @@ impl TesseraApp {
|
||||
let Some(window) = target else {
|
||||
continue;
|
||||
};
|
||||
// 尺寸使用逻辑单位,桌面位置使用物理屏幕坐标;这些 OS 操作都在原生事件线程执行。
|
||||
match envelope.command.action {
|
||||
crate::window::Action::Resize { width, height } => {
|
||||
let _ = window.request_inner_size(LogicalSize::new(width, height));
|
||||
}
|
||||
crate::window::Action::SetTitle(title) => window.set_title(&title),
|
||||
crate::window::Action::MoveTo { x, y } => {
|
||||
// 以平台能否读取外部位置作为可移动性检查,不支持时通过 RuntimeFailed 展示错误。
|
||||
if window.outer_position().is_ok() {
|
||||
window.set_outer_position(PhysicalPosition::new(x, y));
|
||||
} else {
|
||||
@@ -259,15 +288,19 @@ impl TesseraApp {
|
||||
crate::window::Action::Close => {}
|
||||
}
|
||||
}
|
||||
// 动作批执行后重新读取实际尺寸并发布,不能把 request_inner_size 的请求尺寸直接当成 OS 最终分配。
|
||||
self.publish_viewport();
|
||||
}
|
||||
|
||||
/// 将真实原生窗口尺寸换算成扣除侧栏的逻辑页面尺寸,并发布给 worker。
|
||||
// 创建、尺寸/比例变化、侧栏折叠和窗口命令收尾共用,页面可用宽度始终扣除当前侧栏占用。
|
||||
fn publish_viewport(&self) {
|
||||
let Some(window) = &self.window else {
|
||||
return;
|
||||
};
|
||||
// OS 返回设备像素,先按当前 scale_factor 转逻辑尺寸,再检查有效性和布局预算。
|
||||
let size = window.inner_size().to_logical::<f32>(window.scale_factor());
|
||||
// 最小化或无效尺寸不覆盖已知 viewport;避免把零面积/非有限值作为正常布局约束交 worker。
|
||||
if size.width <= 0.0
|
||||
|| size.height <= 0.0
|
||||
|| !size.width.is_finite()
|
||||
@@ -276,6 +309,7 @@ impl TesseraApp {
|
||||
return;
|
||||
}
|
||||
if let Ok(mut namespace) = self.namespace.write() {
|
||||
// 页面区域只横向减侧栏,工具是否打开由文档页决定;两轴上限受 UI 最大尺寸约束。
|
||||
let size = crate::layout::Size {
|
||||
width: (size.width - self.sidebar.left())
|
||||
.max(0.0)
|
||||
@@ -294,6 +328,7 @@ impl TesseraApp {
|
||||
.get(id)
|
||||
.is_some_and(|child| session != 0 && child.native_session == session)
|
||||
});
|
||||
// 主表只汇总当前非零世代且子文档也属于该世代的尺寸,防止旧原生窗口覆盖新域约束。
|
||||
for (id, child) in &self.children {
|
||||
if child.native_session == session
|
||||
&& session != 0
|
||||
@@ -309,6 +344,7 @@ impl TesseraApp {
|
||||
}
|
||||
|
||||
/// 仅请求原生事件循环安排重绘,不在调用处立即递归绘制。
|
||||
// 输入、文档及工具状态变化共用;window 尚未创建时自然跳过,不在这里分配像素缓冲。
|
||||
fn request_redraw(&self) {
|
||||
if let Some(window) = &self.window {
|
||||
window.request_redraw();
|
||||
@@ -316,7 +352,9 @@ impl TesseraApp {
|
||||
}
|
||||
|
||||
/// 通过托管开发工具入口打开指定工具页面,保留对应窗口上下文。
|
||||
// 快捷键、侧栏工具入口与启动逻辑共用;已有会话走带窗口身份事件,无会话才通过初始化 REPL 请求工具。
|
||||
fn open_developer_tool(&mut self, name: &str) {
|
||||
// 在一次读锁里保存本帧会话和布局版本,工具事件 mount=0,实际能力由 worker 解析执行。
|
||||
let input = self.namespace.read().ok().map(|namespace| {
|
||||
let frame = &namespace.document.frame;
|
||||
crate::events::Input {
|
||||
@@ -333,17 +371,20 @@ impl TesseraApp {
|
||||
}
|
||||
});
|
||||
if let Some(input) = input {
|
||||
// 初始文档还没有有效运行时令牌,initialize_tools 走本机 API;否则保持事件队列的窗口上下文。
|
||||
if input.session == 0 {
|
||||
self.developer_tools.initialize_tools(name);
|
||||
} else {
|
||||
self.send_guest(input);
|
||||
}
|
||||
}
|
||||
// 请求工具后先停止业务键盘路由,等文档发布再依据实际活动页重新建立路由和焦点。
|
||||
self.guest_keyboard = false;
|
||||
self.request_redraw();
|
||||
}
|
||||
|
||||
/// 接收完整文档更新,协调子窗口和原生命令,再更新输入焦点并请求重绘。
|
||||
// 主/子窗口发布通知都到此路径,资源同步后从完整 Frame 提取工具标记和页面焦点令牌。
|
||||
fn document_updated(&mut self, event_loop: &ActiveEventLoop) {
|
||||
// 先使原生资源对应新文档,再执行其窗口命令;随后重建焦点令牌,避免沿用旧布局身份。
|
||||
self.reconcile_windows(event_loop);
|
||||
@@ -351,10 +392,12 @@ impl TesseraApp {
|
||||
if let Ok(namespace) = self.namespace.read() {
|
||||
self.developer_tools.document_updated(&namespace.document);
|
||||
let frame = &namespace.document.frame;
|
||||
// 活动开发工具页接管宿主编辑,普通页面才允许后续 handle_guest_key 接收业务键盘。
|
||||
self.guest_keyboard = !frame
|
||||
.tabs
|
||||
.iter()
|
||||
.any(|tab| tab.active && tab.developer_tool.is_some());
|
||||
// 只有无故障帧才保存 focus 出现身份,令牌每次附当前 session/layout_version,不复用上帧旧版本。
|
||||
self.guest_focus =
|
||||
frame
|
||||
.focus
|
||||
@@ -376,9 +419,11 @@ impl TesseraApp {
|
||||
}
|
||||
|
||||
/// 先处理宿主管理输入、选择与快捷键,再按焦点决定是否交给页面。
|
||||
// window_event 的 KeyboardInput 分支调用;本函数决定宿主/页面/工具的优先级,实际源回调仍由 worker 执行。
|
||||
fn handle_keyboard(&mut self, event: &winit::event::KeyEvent) {
|
||||
// 宿主快捷键优先级最高;后续依次交给侧栏、页面交互、开发工具按钮及文本编辑。
|
||||
let command = self.modifiers.super_key() || self.modifiers.control_key();
|
||||
// 命令+B 只在首次按下切侧栏;切换后页面布局约束由 sidebar_action 重新发布。
|
||||
if command
|
||||
&& event.state == ElementState::Pressed
|
||||
&& !event.repeat
|
||||
@@ -387,11 +432,13 @@ impl TesseraApp {
|
||||
self.sidebar_action(crate::sidebar::Action::Toggle);
|
||||
return;
|
||||
}
|
||||
// Escape 先停止页面平移和按下捕获,后续仍可交当前工具编辑器处理焦点取消。
|
||||
if event.logical_key == Key::Named(NamedKey::Escape) {
|
||||
self.panning = false;
|
||||
self.space_down = false;
|
||||
self.guest_pressed = None;
|
||||
}
|
||||
// 无页面焦点且页面为 Canvas 时,Space 按住作为平移修饰键,不作为业务或 Console 输入。
|
||||
if event.logical_key == Key::Named(NamedKey::Space)
|
||||
&& self.guest_focus.is_none()
|
||||
&& self
|
||||
@@ -416,6 +463,7 @@ impl TesseraApp {
|
||||
self.request_redraw();
|
||||
return;
|
||||
}
|
||||
// 侧栏 Enter/Space 的按下/释放走同一 Interaction 捕获,释放确认动作后再调用 sidebar_action。
|
||||
if matches!(
|
||||
event.logical_key,
|
||||
Key::Named(NamedKey::Enter | NamedKey::Space)
|
||||
@@ -441,6 +489,7 @@ impl TesseraApp {
|
||||
}
|
||||
|
||||
if event.state == ElementState::Pressed && !event.repeat {
|
||||
// 主命令+W 关闭当前页,Ctrl+Tab 切页;处理成功才返回,未能生成有效事件时继续其他路由。
|
||||
let close = (self.modifiers.super_key() || self.modifiers.control_key())
|
||||
&& matches!(&event.logical_key, Key::Character(key) if key.eq_ignore_ascii_case("w"));
|
||||
let cycle = self.modifiers.control_key()
|
||||
@@ -450,10 +499,12 @@ impl TesseraApp {
|
||||
}
|
||||
}
|
||||
// 页面交互成功消费按键才提前返回;未处理的按键还可交给开发工具,保持明确的路由顺序。
|
||||
// 页面键盘处理返回是否消费,已消费就安排重绘并停止,不让同一次按键又编辑工具输入。
|
||||
if self.guest_keyboard && self.handle_guest_key(event) {
|
||||
self.request_redraw();
|
||||
return;
|
||||
}
|
||||
// 工具按钮和焦点导航先于普通文本编辑,使 Enter/Space 在控件焦点下执行控件动作。
|
||||
if self.developer_tools.keyboard_control(
|
||||
event,
|
||||
self.modifiers.shift_key(),
|
||||
@@ -463,9 +514,11 @@ impl TesseraApp {
|
||||
self.request_redraw();
|
||||
return;
|
||||
}
|
||||
// 抬起事件在上面的捕获路径处理过后就结束,以下快捷键与文本插入只处理按下。
|
||||
if event.state != ElementState::Pressed {
|
||||
return;
|
||||
}
|
||||
// 统一识别 F12 与平台常见工具快捷键;仅非重复按下发起打开 Console 的请求。
|
||||
let is_f12 = matches!(event.logical_key, Key::Named(NamedKey::F12));
|
||||
let is_i =
|
||||
matches!(&event.logical_key, Key::Character(value) if value.eq_ignore_ascii_case("i"));
|
||||
@@ -483,8 +536,10 @@ impl TesseraApp {
|
||||
if !self.developer_tools.open || self.developer_tools.focus.is_none() {
|
||||
return;
|
||||
}
|
||||
// 重新读取编辑快捷键修饰条件,命令字符在下面单独处理,不作为普通文本插入。
|
||||
let command = self.modifiers.super_key() || self.modifiers.control_key();
|
||||
if command && let Key::Character(value) = &event.logical_key {
|
||||
// 全选只改工具选择状态,粘贴先读系统剪贴板,复制/剪切先取得当前焦点对应的选中文本。
|
||||
match value.to_lowercase().as_str() {
|
||||
"a" => self.developer_tools.selection = true,
|
||||
"v" => match crate::clipboard::read() {
|
||||
@@ -493,6 +548,7 @@ impl TesseraApp {
|
||||
},
|
||||
"c" | "x" => {
|
||||
let selected = self.developer_tools.selected_text();
|
||||
// 没有可复制文本时不写空剪贴板;剪切也不在写入失败时删除编辑器内容。
|
||||
if !selected.is_empty() {
|
||||
match crate::clipboard::write(&selected) {
|
||||
Ok(()) if value.eq_ignore_ascii_case("x") => {
|
||||
@@ -518,6 +574,7 @@ impl TesseraApp {
|
||||
&& self.developer_tools.preedit.is_empty()
|
||||
&& let Some(text) = &event.text
|
||||
{
|
||||
// 普通按键文本剔除控制字符,换行/Tab 等编辑语义由命名键路径处理,IME Commit 则在 window_event 另行插入。
|
||||
let text: String = text.chars().filter(|c| !c.is_control()).collect();
|
||||
self.developer_tools.insert(&text);
|
||||
}
|
||||
|
||||
+20
-1
@@ -15,12 +15,14 @@ use crate::{
|
||||
|
||||
// 展开侧栏固定逻辑宽度;实际设备像素比例由后续显示列表缩放处理。
|
||||
pub const WIDTH: f32 = 256.0;
|
||||
// 顶部标题/原生按钮区域高度,app 的拖窗判断和 native_chrome 的系统按钮对齐共同使用。
|
||||
pub const HEADER: f32 = 40.0;
|
||||
// macOS 标题行预留原生三键安全区域,其他平台无需这段横向留白。
|
||||
pub const CONTROLS: f32 = if cfg!(target_os = "macos") { 86.0 } else { 0.0 };
|
||||
|
||||
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
|
||||
/// 侧栏释放激活后要执行的管理动作,绘制本身只登记它。
|
||||
// app::sidebar_action 执行这些已确认动作;页面 ID 来自本窗口的 Tab 投影,不是 VM 对象引用。
|
||||
pub enum Action {
|
||||
Toggle,
|
||||
NewPage,
|
||||
@@ -32,14 +34,17 @@ pub enum Action {
|
||||
/// 侧栏开合、控件交互和本帧目标集合,决定实际占用页面宽度。
|
||||
pub struct State {
|
||||
pub open: bool,
|
||||
// 跨帧保存悬停、键盘焦点和按下捕获;目标矩形则由每次 draw 重建。
|
||||
pub interaction: Interaction,
|
||||
// 最近绘制帧的逻辑命中集合,app 的指针及键盘事件使用,与显示列表保持同帧。
|
||||
pub targets: Vec<Target<Action>>,
|
||||
// 只滚动普通页面列表,顶部工具入口、折叠按钮和底部工作区标签保持固定。
|
||||
pub scroll: f32,
|
||||
}
|
||||
|
||||
impl Default for State {
|
||||
/// 建立类型约定的初始值,供尚未发布或尚未交互的状态使用。
|
||||
/// 建立默认展开的侧栏,交互目标等第一次 draw 时按实际页面重建。
|
||||
// TesseraApp 初始化时创建,默认展开、列表在起点,尚未绘制时没有交互目标。
|
||||
fn default() -> Self {
|
||||
Self {
|
||||
open: true,
|
||||
@@ -52,11 +57,13 @@ impl Default for State {
|
||||
|
||||
impl State {
|
||||
/// 返回展开侧栏占据的逻辑宽度,折叠时页面收回这部分空间。
|
||||
// scene 合成页面时用作横向偏移,app 发布布局视口时从窗口逻辑宽度扣除;折叠值为零。
|
||||
pub fn left(&self) -> f32 {
|
||||
if self.open { WIDTH } else { 0.0 }
|
||||
}
|
||||
|
||||
/// 判断指针是否落入宿主侧栏/展开按钮区域,保护页面输入边界。
|
||||
// app 路由页面指针、滚轮和键盘焦点时调用,判断宿主占用区而非只判断是否命中某个按钮。
|
||||
pub fn covers(&self, point: Point) -> bool {
|
||||
// 展开时整个侧栏横向带均拦截页面输入,y 的窗口有效范围由外层事件入口保证。
|
||||
// 折叠时只覆盖顶部三键安全区与展开按钮,不继续挡住左侧整列页面。
|
||||
@@ -68,6 +75,7 @@ impl State {
|
||||
}
|
||||
|
||||
/// 绘制工具入口、页面列表和展开控制,同时登记稳定的交互目标。
|
||||
// scene::build_scene 最后调用以覆盖宿主侧栏;height 为逻辑高度,返回命令由外层再统一乘设备 scale。
|
||||
pub fn draw(
|
||||
&mut self,
|
||||
tabs: &[Tab],
|
||||
@@ -76,6 +84,7 @@ impl State {
|
||||
) -> DisplayList {
|
||||
// 每帧重新生成控件目标与显示列表,保留 Interaction 的稳定身份状态,而不是复用上帧屏幕矩形。
|
||||
let mut ui = Ui::new(Theme::new(accent), self.interaction.clone());
|
||||
// 只有展开态铺侧栏背景,折叠态不画整列底色,让业务页面能使用原侧栏区域。
|
||||
if self.open {
|
||||
ui.fill(Rect::new(0.0, 0.0, WIDTH, height), theme::BAR);
|
||||
}
|
||||
@@ -86,6 +95,7 @@ impl State {
|
||||
CONTROLS + 4.0
|
||||
};
|
||||
// Draw a sidebar icon with primitives so its shape does not depend on fonts.
|
||||
// 展开按钮无文字标签,下面用描边和竖线组合图标;按钮矩形仍负责稳定 Toggle 命中。
|
||||
ui.button(
|
||||
Rect::new(toggle_x, 6.0, 30.0, 28.0),
|
||||
Action::Toggle,
|
||||
@@ -105,6 +115,7 @@ impl State {
|
||||
Action::NewPage,
|
||||
Button::new("+ 新建页面"),
|
||||
);
|
||||
// 四个固定工具入口不随页面列表滚动,name 作为 Action 参数,label 只是显示文字。
|
||||
for (index, (name, label)) in [
|
||||
("Console", "Console"),
|
||||
("Sources", "Sources"),
|
||||
@@ -125,6 +136,7 @@ impl State {
|
||||
);
|
||||
}
|
||||
ui.label(20.0, 303.0, "页面", theme::MUTED, false);
|
||||
// 普通页面可滚区域从固定工具区下方开始,底部为工作区标签留白;极矮窗口面积钳到零。
|
||||
let area = Rect::new(8.0, 333.0, WIDTH - 16.0, (height - 383.0).max(0.0));
|
||||
// 开发工具已由固定入口展示,因此页面列表仅收集普通页,保持原注册表顺序。
|
||||
let pages: Vec<_> = tabs
|
||||
@@ -136,10 +148,13 @@ impl State {
|
||||
.scroll
|
||||
.clamp(0.0, (pages.len() as f32 * 36.0 - area.height).max(0.0));
|
||||
ui.list.push(DrawCommand::PushClip(area));
|
||||
// 页面行按注册表顺序排,先减 scroll 得到本帧 y,再检查整行是否可见。
|
||||
for (index, tab) in pages.into_iter().enumerate() {
|
||||
// 每行步长 36、按钮高度 32,空出的 4 单位间距同样属于滚动内容节奏。
|
||||
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;
|
||||
}
|
||||
@@ -149,12 +164,14 @@ impl State {
|
||||
Action::Activate(tab.id),
|
||||
Button::new(&tab.title).selected(tab.active),
|
||||
);
|
||||
// 关闭按钮与整行激活按钮使用不同 Action,避免点关闭同时触发切页。
|
||||
ui.button(
|
||||
Rect::new(WIDTH - 40.0, y, 28.0, 32.0),
|
||||
Action::Close(tab.id),
|
||||
Button::new("×"),
|
||||
);
|
||||
}
|
||||
// 列表结束先恢复 clip,底部工作区标签保持固定位置且不继承页面列表裁剪。
|
||||
ui.list.push(DrawCommand::PopClip);
|
||||
ui.label(20.0, height - 32.0, "本地工作区", theme::MUTED, false);
|
||||
}
|
||||
@@ -171,9 +188,11 @@ mod tests {
|
||||
#[test]
|
||||
/// 先展开绘制再折叠重绘,检查交互目标只剩 Toggle、页面左侧让宽归零,其他区域不再拦截指针。
|
||||
fn collapsing_removes_every_host_target_except_the_toggle() {
|
||||
// 以生产默认展开状态建立初始目标,再折叠重建,验证目标清理而不是只验证绘制列表变短。
|
||||
let mut sidebar = State::default();
|
||||
sidebar.draw(&[], 800.0, theme::PALETTE[0]);
|
||||
assert!(sidebar.targets.len() > 1);
|
||||
// 第二次 draw 必须移除旧工具/页面目标,Interaction 也应对新集合重新校正捕获。
|
||||
sidebar.open = false;
|
||||
sidebar.draw(&[], 800.0, theme::PALETTE[0]);
|
||||
// 折叠后仅保留 Toggle,且页面不再让出左宽;顶部按钮区域之外的指针不被侧栏拦截。
|
||||
|
||||
Reference in New Issue
Block a user