Feat: make tooltip position customizeable #175047
Conversation
github-actions
bot
added
framework
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces a positionDelegate to the Tooltip widget, allowing for customizable tooltip positioning. The implementation is clean, adding the new property and integrating it into the existing layout logic. The changes are well-documented and include a new test case to verify the custom positioning behavior. My only suggestion is to add a dartpad example to the documentation to further improve usability for developers, as recommended by the Flutter style guide.
| /// A custom position delegate function for computing where the tooltip should be positioned. | ||
| /// | ||
| /// If provided, this function will be called instead of the default positioning logic | ||
| /// to determine where to place the tooltip relative to its target. | ||
| /// | ||
| /// This allows for custom positioning such as left/right positioning, or any other | ||
| /// arbitrary positioning logic. | ||
| /// | ||
| /// If null, the default positioning behavior is used (above or below the target). | ||
| final TooltipPositionDelegate? positionDelegate; |
There was a problem hiding this comment.
The documentation for the new positionDelegate property is clear and helpful. To further improve usability and align with the Flutter style guide, consider adding a dartpad example demonstrating its usage.1
This would provide developers with a runnable example of how to implement custom tooltip positioning, for instance, showing how to position the tooltip to the left or right of the target widget.
Style Guide References
Footnotes
-
The style guide recommends providing sample code using
{@tool dartpad}for runnable examples to help developers understand how to use new features. ↩
rkishan516
force-pushed
the
tooltip-position
branch
2 times, most recently
from
5bf2348 to
e79e955
Compare
QuncCccccc
left a comment
QuncCccccc
left a comment
There was a problem hiding this comment.
Overall looks good! Thanks for your contribution:)!
| /// Signature for computing the position of a tooltip. | ||
| /// | ||
| /// The arguments are: | ||
| /// * `target`: The offset of the target the tooltip is positioned near in the global coordinate system. |
There was a problem hiding this comment.
Is this offset the center of the target? If so, we might want to clarify it in documentation.
There was a problem hiding this comment.
Updated the documentation to show, target is center of triggering widget.
| /// | ||
| /// The arguments are: | ||
| /// * `target`: The offset of the target the tooltip is positioned near in the global coordinate system. | ||
| /// * `size`: The size of the overlay in which the tooltip is being positioned. |
There was a problem hiding this comment.
Not sure if this would be helpful for users to calculate the offset. It's fine to me. Can we add one more parameter like "targetSize" to this callback? I think it would be helpful to calculate the tooltip position. For example, if we want the tooltip to show up on the upper right corner of the target, this parameter would be useful. WDYT:)? I think the target size info can be found in OverlayChildLayoutInfo.
There was a problem hiding this comment.
Yes, I don't think size will be useful, so replacing it with targetSize which as you said will help in aligning tooltip to different required position. Also updating test, such that it shows as an example for aligning to top right.
QuncCccccc
left a comment
QuncCccccc
left a comment
There was a problem hiding this comment.
The linux analyzer shows some format issue. To fix, run dart format packages/flutter/lib/src/material/tooltip.dart
rkishan516
force-pushed
the
tooltip-position
branch
from
e79e955 to
410be52
Compare
QuncCccccc
left a comment
QuncCccccc
left a comment
There was a problem hiding this comment.
LGTM with nits:) Thank you for your contribution!
| /// The arguments are: | ||
| /// * `target`: The center point of the target widget in the global coordinate system. | ||
| /// * `targetSize`: The size of the target widget that triggers the tooltip. | ||
| /// * `childSize`: The size of the tooltip itself. |
There was a problem hiding this comment.
how about just tooltipSize?
| layoutInfo.childPaintTransform, | ||
| layoutInfo.childSize.center(Offset.zero), | ||
| ); | ||
| final Size targetSize = layoutInfo.childSize; |
There was a problem hiding this comment.
just nit:
| final Size targetSize = layoutInfo.childSize; | |
| final Size tooltipSize = layoutInfo.childSize; |
rkishan516
force-pushed
the
tooltip-position
branch
2 times, most recently
from
9463fe8 to
8e16e20
Compare
dkwingsmt
left a comment
dkwingsmt
left a comment
There was a problem hiding this comment.
Generally looking good.
| /// * `preferBelow`: Whether the tooltip prefers to be positioned below the target. | ||
| /// | ||
| /// Returns the offset from the top left of the overlay to the top left of the tooltip. | ||
| typedef TooltipPositionDelegate = |
There was a problem hiding this comment.
Do you think we might encounter new properties for this delegate in the future? Extending this parameter list will be breaking. What do you think of grouping them into a data class for extensibility? We might call it TooltipPositionContext and the delegate will just take one parameter.
There was a problem hiding this comment.
Yup, makes sense. Let me update this.
| required double verticalOffset, | ||
| required bool preferBelow, |
There was a problem hiding this comment.
I wonder if we can remove the values from Tooltip's parameter list. If the app provides a delegate they would know all information needed for this algorithm anyway.
There was a problem hiding this comment.
I don't know both verticalOffset and preferBelow are used when delegate is not given. So, I don't think we can remove these.
rkishan516
force-pushed
the
tooltip-position
branch
from
8e16e20 to
fae5799
Compare
dkwingsmt
added
the
autosubmit
auto-submit
bot
removed
the
autosubmit
|
autosubmit label was removed for flutter/flutter/175047, because - The status or check suite Google testing has failed. Please fix the issues identified (or deflake) before re-applying this label. |
rkishan516
added
the
autosubmit
flutter-dashboard
bot
removed
the
autosubmit
…10229) Manual roll Flutter from e11e2c11288b to 7cd821c21093 (73 revisions) Manual roll requested by [email protected] flutter/flutter@e11e2c1...7cd821c 2025-10-14 [email protected] Fix computeDistanceToActualBaseline throws when accessing child size (flutter/flutter#176906) 2025-10-14 [email protected] iOS can set application locale before view controller is set (flutter/flutter#176592) 2025-10-14 [email protected] Roll ANGLE to a branch based on d9fa255a5c22 (flutter/flutter#176747) 2025-10-14 [email protected] Relands "Fixes keyboard selects disabled radio" (flutter/flutter#176977) 2025-10-14 [email protected] Fix expansion tile is missing state announcement on non-Apple platforms (flutter/flutter#175480) 2025-10-14 [email protected] impeller: allows access of float uniforms by name (flutter/flutter#176728) 2025-10-14 [email protected] Roll dart sdk to 3.11.0-17.0.dev (flutter/flutter#176947) 2025-10-13 [email protected] Move iOS integration tests (flutter/flutter#176940) 2025-10-13 [email protected] Make sure that an InputDatePickerFormField doesn't crash in 0x0 envir… (flutter/flutter#176047) 2025-10-13 [email protected] [web] Match the behavior of other platforms in Web Locale.toString if the country code is an empty string (flutter/flutter#176862) 2025-10-13 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Fixes keyboard selects disabled radio (#176727)" (flutter/flutter#176958) 2025-10-13 [email protected] Fixes keyboard selects disabled radio (flutter/flutter#176727) 2025-10-13 [email protected] Roll Packages from e319c40 to d062181 (2 revisions) (flutter/flutter#176916) 2025-10-13 [email protected] Roll SwiftShader to 794b0cfce1d8 (flutter/flutter#176806) 2025-10-13 [email protected] Make DropdownMenu generic type non nullable (flutter/flutter#176711) 2025-10-12 [email protected] Roll Fuchsia Linux SDK from BWGpRvpdQh-HJpq1c... to _dd0Jv50H0oUI2Ad8... (flutter/flutter#176895) 2025-10-11 [email protected] Roll Fuchsia Linux SDK from JpiUsek1hU5r9QVKP... to BWGpRvpdQh-HJpq1c... (flutter/flutter#176880) 2025-10-11 [email protected] fix: content hash check for LUCI_CONTEXT (flutter/flutter#176867) 2025-10-11 [email protected] Feat: make tooltip position customizeable (flutter/flutter#175047) 2025-10-11 [email protected] Roll Dart SDK from d88d8bf2b53c to 65b171958c93 (3 revisions) (flutter/flutter#176871) 2025-10-11 [email protected] feat: apply radioGroup role to segmented control widgets (flutter/flutter#176157) 2025-10-10 [email protected] Make sure that a CheckboxMenuButton doesn't crash in 0x0 environment (flutter/flutter#176450) 2025-10-10 [email protected] [WebParagraph] Support for more styles, placeholders, decorations, etc (flutter/flutter#172853) 2025-10-10 [email protected] Set up a version of build_ios_framework_module_test that only runs on x64 machines and extend its timeout (flutter/flutter#176811) 2025-10-10 [email protected] Roll Packages from 0b41de3 to e319c40 (1 revision) (flutter/flutter#176833) 2025-10-10 [email protected] [tool/dap] Forward app.warning events from Flutter to DAP client (flutter/flutter#176827) 2025-10-10 [email protected] Roll Dart SDK from 70c00d3ceb3a to d88d8bf2b53c (1 revision) (flutter/flutter#176830) 2025-10-10 [email protected] Remove unnecessary nullable types in examples. (flutter/flutter#176713) 2025-10-10 [email protected] Roll Fuchsia Linux SDK from xArtL4DH0FsdwSqG_... to JpiUsek1hU5r9QVKP... (flutter/flutter#176822) 2025-10-10 [email protected] Cleanup OutlinedButton.icon documentation and implementation (flutter/flutter#176630) 2025-10-10 [email protected] [HCPP] Properly remove hcpp views that are no longer visible (flutter/flutter#176742) 2025-10-10 [email protected] Make sure that an InputChip doesn't crash in 0x0 environment (flutter/flutter#175930) 2025-10-10 [email protected] Update Flutter templates' Dart style (flutter/flutter#175963) 2025-10-10 [email protected] Make sure that a DropdownButtonFormField doesn't crash in 0x0 environ… (flutter/flutter#174958) 2025-10-10 [email protected] Make sure that an InkWell doesn't crash in 0x0 environment (flutter/flutter#175871) 2025-10-10 [email protected] Handle#6537 end drawer button (flutter/flutter#173026) 2025-10-10 [email protected] Roll Dart SDK from a9b7bd4b0b32 to 70c00d3ceb3a (4 revisions) (flutter/flutter#176815) 2025-10-10 [email protected] Change default Linux thread policy to merge platform and UI threads. (flutter/flutter#176759) 2025-10-09 [email protected] [ Tool ] Roll package:dwds to 26.0.0 (flutter/flutter#176808) 2025-10-09 [email protected] Update `CHANGELOG` to include 3.35.6 notes (flutter/flutter#176803) 2025-10-09 [email protected] Announce text and button together when DropdownMenu is treated as a button (flutter/flutter#176428) 2025-10-09 [email protected] [native_assets] create macOS CCompilerConfig via xcrun --find (flutter/flutter#175717) 2025-10-09 [email protected] [Impeller] Fix broken links in README. (flutter/flutter#176770) 2025-10-09 [email protected] Fix links to Custom Flutter Engine Embedders in README. (flutter/flutter#175807) ...
This MR adds positionDelegate argument to tooltip which allows to change tooltip position. fixes: flutter#172758 ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing.
3 participants
This MR adds positionDelegate argument to tooltip which allows to change tooltip position.
fixes: #172758
Pre-launch Checklist
///).