Skip to content

Commit 59b3d98

Browse files
Yair Lahavclaude
andcommitted
Name the Windows AXTree error so it is not filed as our bug
Running the showcase on Windows desktop with a screen reader attached prints "Failed to update ui::AXTree" every time the mouse crosses a tooltip. It looks exactly like the kind of thing this pass exists to find, and it is not ours: flutter/flutter#182444, open, P2, with a fix in review. The mechanism is worth writing down because Plinth meets both halves of it by ordinary means -- PlinthTooltip wraps Flutter's own Tooltip, whose OverlayPortal grafts overlay children into the tree, and the showcase sidebar is a ListView, whose two-pane semantics add a synthetic node. A detached node gets filtered before the traversal parent is told, and the Windows tree keeps a reference to something gone. Nothing to fix here, and no workaround published. Windows desktop only. Web builds semantics as DOM through an unrelated path, so the browser pass this document actually describes never sees it -- worth saying plainly, since the natural reading of an error that alarming is that the earlier web results are in doubt. Co-Authored-By: Claude Opus 5 <[email protected]>
1 parent 881cc16 commit 59b3d98

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

‎docs/B0C_SCREEN_READER_PASS.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -229,6 +229,24 @@ Alert and notification icons and titles moved a long way this cycle. The
229229
question is not whether they pass a ratio — that is asserted in tests —
230230
but whether the result still looks like the alert's colour.
231231
232+
## What is not a failure
233+
234+
**On Windows desktop**, the console prints
235+
`Failed to update ui::AXTree, error: N will not be in the tree and is
236+
not the new root` when the mouse crosses tooltipped elements.
237+
238+
That is [flutter/flutter#182444](https://github.com/flutter/flutter/issues/182444),
239+
an open P2 engine bug, and it is not ours. `ListView`'s two-pane
240+
semantics create a synthetic node while `Tooltip`'s `OverlayPortal`
241+
grafts overlay children in; a detached node is filtered before the
242+
traversal parent is notified, so the Windows tree keeps a stale
243+
reference. Plinth meets both halves by wrapping Flutter's own `Tooltip`
244+
and putting the showcase sidebar in a `ListView`.
245+
246+
Windows desktop only. Flutter web builds semantics as DOM elements
247+
through an unrelated path, so a pass run in a browser never sees it —
248+
which is the pass this document describes.
249+
232250
## What counts as a failure
233251
234252
- Any control announced as "button" or "" with no name.

0 commit comments

Comments
 (0)