docs: explain hit selection and scroll viewport projection order

This commit is contained in:
2026-11-12 20:43:30 +08:00
parent 45b0b53d4f
commit afff46c0a8
4 changed files with 17 additions and 0 deletions
+4
View File
@@ -1,5 +1,7 @@
//! 通过真正的源/原生 hitTest 协议确定指针目标。
//! 按逆绘制顺序筛选候选,并在同一只读 VM 调用与预算中比较按下、释放目标;透明或未命中的子项可以继续回退。
//! UiBridge::dispatch 已验证窗口、发布版本和页面可见范围,再把有序 Mount 弱表交给 resolve;这里不自行选择窗口。
//! 两个点都按本次调用的当前几何和方法重新检查,不保存鼠标按下时的旧业务快照,也不在本模块派发 click。
//!
//! Resolve pointer targets in paint order through source/native hitTest methods.
//! Both press and release selectors share one read-only VM call and budget.
@@ -152,6 +154,7 @@ fn selector(
/ 2) as u32;
// 先调用 hitTest(block, mount, local),再把结果传给 validate。
// true 立即返回本 Mount;false 继续下一个候选,实现透明区域向下穿透。
// 两次 PushNull 占据 Call 的空接收者槽;block/mount/local 已显式加载,不能让 VM 再插入一次 receiver。
instructions.extend([
Instruction::new(Opcode::LoadConst, 0),
Instruction::simple(Opcode::PushNull),
@@ -276,6 +279,7 @@ pub fn resolve(
// 先保存调用结果再释放入口根,因此 VM 返回错误时也能完成入口清理。
vm.release(prepare)?;
// 只取选择值,丢弃只读依赖集合;一次性输入命中不建立绘制或布局的持久失效依赖。
// 命中期间的只读限制作用于已有业务对象,准备器仍可分配 Point/驱动函数等临时结果,不能把 ReadOnly 解释成禁止任何分配。
let (value, _) = result.map_err(|error| crate::endor_host::runtime_error(vm, error))?;
// 接受 Mount 或 Nil 两类驱动结果,其他值先释放其可能拥有根,再报告内部协议错误。
match value {