-
Notifications
You must be signed in to change notification settings - Fork 28.5k
Clarify deprecation notice for jumpToWithoutSettling in scroll_position.dart #167200
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Clarify deprecation notice for jumpToWithoutSettling in scroll_position.dart #167200
Conversation
It looks like this pull request may not have tests. Please make sure to add tests or get an explicit test exemption before merging. If you are not sure if you need tests, consider this rule of thumb: the purpose of a test is to make sure someone doesn't accidentally revert the fix. Ask yourself, is there anything in your PR that you feel it is important we not accidentally revert back to how it was before your fix? Reviewers: Read the Tree Hygiene page and make sure this patch meets those guidelines before LGTMing.If you believe this PR qualifies for a test exemption, contact "@test-exemption-reviewer" in the #hackers channel in Discord (don't just cc them here, they won't see it!). The test exemption team is a small volunteer group, so all reviewers should feel empowered to ask for tests, without delegating that responsibility entirely to the test exemption group. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM 👍 . Indeed that's an improved deprecation message, thanks for cleaning this up.
/// Creates a widget that builds its child while assigning it a key. | ||
/// | ||
/// This is useful when you want to preserve the state of a widget when it moves | ||
/// around in the widget tree by associating it with a consistent key. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just double checking, but did you mean to include this docs change in this PR? Fine either way as it looks like an improvement as well.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I looks like these are from #167198
Does the customer testing failure look like something to be concerned about? I missed that at first. |
Rebasing to see if it resolves the customer_testing failure. |
b42cbaa
to
e19026a
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This deprecation message update LGTM as well, can you remove the other doc changes that are in the other linked PR?
/// Creates a widget that builds its child while assigning it a key. | ||
/// | ||
/// This is useful when you want to preserve the state of a widget when it moves | ||
/// around in the widget tree by associating it with a consistent key. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I looks like these are from #167198
Description
Improved the
@Deprecated
message forjumpToWithoutSettling
to clarify the risksand suggest appropriate alternatives like
jumpTo
or using a customScrollPosition
.This makes the warning more informative for developers, in line with Flutter's documentation practices.
Checklist