## 现象 宿主应用(节点编辑器画布)中,页面内容包含滑条组件后,合成在**其后**的根级浮层——全窗口 scrim 与下拉菜单面板——完全失去命中优先级:点击 scrim/菜单项时,事件落到页面底层的输入区(画布 mouseArea),浮层被意外收起、菜单项永远无法选中。绘制序同样被压到页面之下。 宿主真机 A/B 实证(同一画布、同一浮层代码,唯一变量是页面内是否存在滑条参数节点): - 页面含滑条节点 → 点击浮层菜单项的坐标,事件穿透到画布输入区; - 页面不含滑条节点(无参数的节点)→ 同一坐标由 scrim 正确拦截并收起浮层。 ## 根因 命中测试与绘制的遍历顺序按 `orderedChildren` / `orderedRoots` 排序,排序键是 `subtreeMaxZIndex`(`core/dsl.h` 的 `rebuildOrderedElements`,升序排序、命中逆序遍历)。 而 `components/slider.h` 的内部热区自带硬编码 zIndex: ```cpp ui_.rect(id_ + ".hit") .size(width_, height_) .states(...) .zIndex(10) // ← 抬升整个滑条子树的排序键 .interactive() .sliderInputFrom(id_) .build(); ``` 滑条栈内 `.hit` 的输入优先级本就由合成序保证(栈内最后一个子元素,逆序命中时最先被测试),这个 zIndex(10) 没有栈内收益,却把**页面子树**的 max z 抬到 10——所有默认 z=0 的根级浮层在根级兄弟排序中被排到页面之后(命中先测试页面、绘制后画页面),浮层即失效。 两个连带推论: 1. 由于排序只看 z 不看合成序,浮层即便**晚于**页面合成也无法挽回; 2. 同理,滑条所在子树还会压过**其后合成的兄弟子树**中 z=0 的交互元素(如后画到滑条上方的卡片控件),不只是根级浮层场景。 ## 最小复现(单元级) root stack → `page` stack(内含一个 `components::slider`)→ `overlay` rect(`onClick`,z 默认 0,后合成)。 `ui.layout(...)` 后:`page->subtreeMaxZIndex == 10`,且 root 的 `orderedChildren` 中 overlay 被排到 page 之前——逆序命中遍历先测 page。修复后两者均为 0、稳定序保持合成序(overlay 在后,逆序命中先达)。 (已随修复提交回归测试 `tests/unit/slider_subtree_z_order.cpp`:修复前该测试在第一条断言失败——`slider inflates page subtreeMaxZIndex to 10`。) ## 影响 凡页面内容包含滑条,宿主的模态浮层(下拉、右键菜单、scrim)、以及页面上后合成的 z=0 交互控件,命中与绘制都被滑条子树压过。组件库若未来有更多组件内部使用 zIndex,同类风险会扩大。 ## 建议修复 移除 `slider.h` `.hit` 的 `.zIndex(10)`(其栈内优先级由合成序保证,行为不变)。随后提 PR,附上述回归测试。
Activity
build(deps): eui-neo 升至含滑条 z 序修复的 791cb46(上游 PR #96)
sudoevolve commentedon Oct 10, 2026
Fixed by #96: the slider hit area no longer raises its page subtree z-order; regression coverage is included.