Breaking change flutter/flutter#134921 #9469
Conversation
|
Just a heads up - The cloud build check (flutter-website-staging) can be ignored, it is something I am working on (#9468) that I accidentally triggered for all presubmit PRs. It has been turned off! |
|
Hi @chunhtai could you take a look and see if the semantics tree change makes sense? |
chunhtai
left a comment
There was a problem hiding this comment.
Is the doc still valid? I remember we had a conversation whether the message should introduce a node at all.
| As a result, the generated semantics tree does not put `Tooltip.message` | ||
| immediately after `Tooltip.child`. | ||
|
|
||
| You may see accessibility test failures when a tooltip message is visible. |
There was a problem hiding this comment.
What's the reason for avoiding using "you"? I see plenty of "you"s when i searched for it in this directory.
There was a problem hiding this comment.
you are right, It shouldn't apply for design doc
|
|
||
| ## Migration guide | ||
|
|
||
| Update your failing accessibility tests. For the following widget tree: |
There was a problem hiding this comment.
Maybe
The accessibility test before the migration:
There was a problem hiding this comment.
Changed the wording to emphasize the "test" setting.
| You may see accessibility test failures when a tooltip message is visible. | ||
| This is because this update moved the tooltip message in the semantics tree. | ||
|
|
||
| ## Migration guide |
There was a problem hiding this comment.
Maybe we should mention the old behavior is no longer supported.
There was a problem hiding this comment.
I'm not sure we should say the current behavior is never making a comeback? The new behavior makes more sense as the default but maybe in the future it will be made configurable to allow developers to specify who the accessibility parent is, the overlay or the overlayportal?
There was a problem hiding this comment.
but for now there is no way to get back to original behavior, and I think we should communicate it more clearly. If we were to update the behavior later, we can update this doc with a new revision.
There was a problem hiding this comment.
I found it pretty hard to describe what "the old behavior" is so I added "adopt the new semantics order in your tests".
ae45ea0 to
24f5354
Compare
parlough
left a comment
There was a problem hiding this comment.
Thanks for this migration guide!
A few minor fixes:
| * [Windows: External windows should notify Flutter engine of lifecycle changes][] | ||
| * [Windows build path changed to add the target architecture][] | ||
| * [Deprecated API removed after v3.13][] | ||
| * [Accessibility traversal order of tooltip changed][] |
There was a problem hiding this comment.
You'll need to add the link definition for this link below.
Co-authored-by: Parker Lougheed <parlough@gmail.com>
…ooong/website into tooltip-message-accessibility
|
PTAL @atsansone |
Breaking change announcement for flutter/flutter#134921
Presubmit checklist