Files
Dreierpack-Manager/docs/new_ui/qa-script-locator.md
T

37 lines
2.2 KiB
Markdown

<!-- SPDX-License-Identifier: GPL-3.0-only -->
# Native QA-Skripte · sichtbare Klickpunkte
Stand: 27. Oktober 2026. Diese Änderung betrifft ausschließlich den opt-in
JSONL-Commanddriver der Modern-UI-Demo. Produktgestaltung, normaler Maus-HitTest,
Rendering, Datenquelle und Engine werden nicht verändert.
`GetAbsoluteOffset(Border)` enthält Layout und Scroll, aber keine CSS-
Transformation. Deshalb trafen Selector-Klicks auf einen mit
`translate(0,-50%)` zentrierten Nachrichtendialog unterhalb des sichtbaren
Schließen-Buttons. Ein echter X11→SDL-Klick auf dessen sichtbare Position
funktioniert; die alte erfolglose Selectorprobe war kein Dialogdefekt.
`script_click_point()` verwendet die öffentliche RmlUI-API `Element::Project`,
die dieselbe vollständige inverse Transformation wie der native HitTest nutzt.
Der Helper löst die sichtbare Fensterposition der gewünschten Layoutmitte mit
höchstens acht begrenzten Korrekturen. Nicht endliche Werte, singuläre oder
numerisch nicht lösbare Projektionen und Punkte außerhalb des Contexts werden
abgelehnt. Abschließend muss der tatsächliche `GetElementAtPoint`-Treffer das
gewählte Element oder einen seiner Nachfahren ergeben; verdeckte Elemente
werden nicht versehentlich durch einen Klick auf ihre Überlagerung ersetzt.
Es gibt keine Dialog-ID-Sonderregel, keinen festen Pixelversatz und keinen
privaten Vendorheader. Explizite JSONL-Koordinaten `{x,y}` bleiben unverändert.
Selector-basierte Klick-, Zeiger-, Rad- und Drag-Startpunkte nutzen denselben
Locator. Bei einem nicht anklickbaren sichtbaren Mittelpunkt bricht der
QA-Treiber mit einer ausdrücklichen Fehlermeldung ab. Der Helper sucht keine
beliebige freie Teilfläche eines teilweise verdeckten Elements.
Der bestehende `modern_control_layout_tests` prüft in drei Themes bei vier
Dichten jeweils untransformierte, verschobene, skalierte und gedrehte Elemente
über tatsächlich zugestellte Mausclicks sowie die Ablehnung singulärer und
verdeckter Ziele. Der Target und der native App-Link sind unter Linux grün.
Ein zusätzlicher nativer Selector-Smoke trifft den sichtbaren Schließen-Button
über `:hover`, schließt den transformierten Dialog und erhält Source und
Revision. Das ist keine zusätzliche Windows-/macOS-Laufzeitabnahme.