widget_tooltip 1.3.0

widget_tooltip: ^1.3.0 copied to clipboard

Features #

• TooltipGroup: Add TooltipGroup class to ensure only one tooltip is visible at a time within a group. Use TooltipController(group: group) to link controllers.
• dismissOnScroll: Add dismissOnScroll property (default true) to automatically dismiss the tooltip when the nearest Scrollable ancestor scrolls.

Bug Fixes #

• mounted check: Add mounted guard in post-frame callback to prevent crashes when widget is disposed between phases.
• overlay cleanup: Improve overlay removal safety with dedicated _removeOverlay() method.

Improvements #

• Code refactoring: Extract _calculateLayout into smaller methods (_resolveAnchors, _resolveOffsets) for better readability.
• Typed layout result: Replace anonymous record with _TooltipLayout class for clarity.
• Extract overlay building: Move final overlay construction to _insertFinalOverlay and _buildCombinedTooltip methods.

Bug Fixes #

• direction in ListView: Fix direction parameter being ignored inside ListView and other scrollable widgets (#7)
• tooltip positioning: Fix tooltip appearing near screen center instead of target due to incorrect measurement constraints
• scale animation: Fix scale animation not working — now triangle and message box animate as a unified element

Improvements #

• Two-phase positioning: Restore proven measure-then-position approach for reliable tooltip placement
• Combined tooltip element: Triangle and message box are now a single composite widget, ensuring consistent animation behavior
• ListView example: Add ListView tab to example app for testing scroll scenarios

Improvements #

• Unified tooltip widget: Merge triangle and message box into a single widget for smoother animations
• Better scale animation: Scale animation now expands from a single center point instead of separately
• Code simplification: Remove triangleOffset calculation and kTriangleOverlapOffset constant

Features #

• autoFlip: Add autoFlip property to automatically flip tooltip direction when there's not enough space at screen edges
• hover: Add WidgetTooltipTriggerMode.hover for Desktop/Web mouse hover support

Breaking Changes #

• messageStyle removed: Remove unused messageStyle property

Deprecations #

• tapAnyWhere: Deprecate WidgetTooltipDismissMode.tapAnyWhere in favor of tapAnywhere (correct spelling)

Bug Fixes #

• autoFlip: Simplified logic - now uses screen center to determine tooltip position (target in top half → tooltip below, target in bottom half → tooltip above)
• visibility: Auto-dismiss tooltip when target scrolls off-screen

Improvements #

• Add comprehensive documentation for TooltipController and WidgetTooltip classes
• Refactor internal variable names for better code readability
• Remove unused isLeft/isRight parameters from internal _TooltipOverlay widget
• Improve example app with better styling and demonstrations

• Bug fixed: Fix right padding not working when text is long

Features #

• Documentation: Improve documentation and examples.

Features #

• Performance: Improve performance and stability.

Features #

• Bug fixes: Fix minor bugs and improve stability.

Features #

• triangleRadius: Add new property to set the radius of the triangle.

Features #

• Widget Tooltip: Add new widget to display a tooltip.