Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

组件内部 zIndex 抬升子树排序键，根级浮层（scrim/下拉菜单）失去命中与绘制优先级

クローズ 初心者向け
  • 何か問題がありますか？
#95 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 2 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1時間未満
初心者へのやさしさ
78/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
cpp
領域
desktop-dev

調査の方向性

components/slider.h から始めてください。そこでは .hit の矩形が固定値の zIndex で作成されています。次に core/dsl.h の rebuildOrderedElements が subtreeMaxZIndex によって子要素をどのように並べ替えているかを確認してください。回帰テストは tests/unit/slider_subtree_z_order.cpp です。まずビルドして実行し、失敗しているアサーションを確認してください。page->subtreeMaxZIndex が 0 になり、オーバーレイがページの後に並ぶようになれば完了です。その際、slider の他の動作は変更せず、テストが通るようにしてください。

索引モデルが issue の本文から書いたものです。

説明

现象

宿主应用（节点编辑器画布）中，页面内容包含滑条组件后，合成在其后的根级浮层——全窗口 scrim 与下拉菜单面板——完全失去命中优先级：点击 scrim/菜单项时，事件落到页面底层的输入区（画布 mouseArea），浮层被意外收起、菜单项永远无法选中。绘制序同样被压到页面之下。

宿主真机 A/B 实证（同一画布、同一浮层代码，唯一变量是页面内是否存在滑条参数节点）：

  • 页面含滑条节点 → 点击浮层菜单项的坐标，事件穿透到画布输入区；
  • 页面不含滑条节点（无参数的节点）→ 同一坐标由 scrim 正确拦截并收起浮层。

根因

命中测试与绘制的遍历顺序按 orderedChildren / orderedRoots 排序，排序键是 subtreeMaxZIndex（core/dsl.h 的 rebuildOrderedElements，升序排序、命中逆序遍历）。

而 components/slider.h 的内部热区自带硬编码 zIndex：

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，附上述回归测试。

主要言語
C++
スター
2k
フォーク
177
平均マージ
2日 1時間
マージ済み PR（30日）
13

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

sudoevolve/EUI-NEO のほかの issue

sudoevolve/EUI-NEO の issue をすべて見る

似ている issue

C++ の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。