TooltipModifier class

A Material Design tooltip.

Tooltips provide text labels which help explain the function of a button or other user interface action. Wrap the button in a Tooltip widget and provide a message which will be shown when the widget is long pressed.

Many widgets, such as IconButton, FloatingActionButton, and PopupMenuButton have a tooltip property that, when non-null, causes the widget to include a Tooltip in its build.

Tooltips improve the accessibility of visual widgets by proving a textual representation of the widget, which, for example, can be vocalized by a screen reader.

{@tool dartpad} This example show a basic Tooltip which has a Text as child. message contains your label to be shown by the tooltip when the child that Tooltip wraps is hovered over on web or desktop. On mobile, the tooltip is shown when the widget is long pressed.

** See code in examples/api/lib/material/tooltip/tooltip.0.dart ** {@end-tool}

{@tool dartpad} This example covers most of the attributes available in Tooltip. decoration has been used to give a gradient and borderRadius to Tooltip. height has been used to set a specific height of the Tooltip. preferBelow is false, the tooltip will prefer showing above Tooltip's child widget. However, it may show the tooltip below if there's not enough space above the widget. textStyle has been used to set the font size of the 'message'. showDuration accepts a Duration to continue showing the message after the long press has been released or the mouse pointer exits the child widget. waitDuration accepts a Duration for which a mouse pointer has to hover over the child widget before the tooltip is shown.

** See code in examples/api/lib/material/tooltip/tooltip.1.dart ** {@end-tool}

{@tool dartpad} This example shows a rich Tooltip that specifies the richMessage parameter instead of the message parameter (only one of these may be non-null. Any InlineSpan can be specified for the richMessage attribute, including WidgetSpan.

** See code in examples/api/lib/material/tooltip/tooltip.2.dart ** {@end-tool}

{@tool dartpad} This example shows how Tooltip can be shown manually with TooltipTriggerMode.manual by calling the TooltipState.ensureTooltipVisible function.

** See code in examples/api/lib/material/tooltip/tooltip.3.dart ** {@end-tool}

See also:

Inheritance
Available extensions

Constructors

TooltipModifier({Key? key, Key? modifierKey, Widget? child, String? message, InlineSpan? richMessage, double? height, EdgeInsetsGeometry? padding, EdgeInsetsGeometry? margin, double? verticalOffset, bool? preferBelow, bool? excludeFromSemantics, Decoration? decoration, TextStyle? textStyle, TextAlign? textAlign, Duration? waitDuration, Duration? showDuration, TooltipTriggerMode? triggerMode, bool? enableFeedback, TooltipTriggeredCallback? onTriggered})
Creates a tooltip.
const

Properties

decoration → Decoration?
Specifies the tooltip's shape and background color.
final
enableFeedback → bool?
Whether the tooltip should provide acoustic and/or haptic feedback.
final
excludeFromSemantics → bool?
Whether the tooltip's message or richMessage should be excluded from the semantics tree.
final
hashCode → int
The hash code for this object.
no setterinherited
height → double?
The height of the tooltip's child.
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
margin → EdgeInsetsGeometry?
The empty space that surrounds the tooltip.
final
message → String?
The text to display in the tooltip.
final
modifierKey → Key?
The actual key of the widget, which Modifier wrapped
finalinherited
onTriggered → TooltipTriggeredCallback?
Called when the Tooltip is triggered.
final
padding → EdgeInsetsGeometry?
The amount of space by which to inset the tooltip's child.
final
preferBelow → bool?
Whether the tooltip defaults to being displayed below the widget.
final
richMessage → InlineSpan?
The rich text to display in the tooltip.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
showDuration → Duration?
The length of time that the tooltip will be shown after a long press is released (if triggerMode is TooltipTriggerMode.longPress) or a tap is released (if triggerMode is TooltipTriggerMode.tap) or mouse pointer exits the widget.
final
textAlign → TextAlign?
How the message of the tooltip is aligned horizontally.
final
textStyle → TextStyle?
The style to use for the message of the tooltip.
final
triggerMode → TooltipTriggerMode?
The TooltipTriggerMode that will show the tooltip.
final
verticalOffset → double?
The vertical gap between the widget and the displayed tooltip.
final
waitDuration → Duration?
The length of time that a pointer must hover over a tooltip's widget before the tooltip will be shown.
final

Methods

build(BuildContext context) → Widget
Describes the part of the user interface represented by this widget.
inherited
buildWithChild(BuildContext context, Widget? child) → Widget
A build method that receives an extra child parameter.
override
createElement() → SingleChildStatelessElement
Create a SingleChildStatelessElement
inherited
debugDescribeChildren() → List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
modified() → Modifier

Available on Widget, provided by the ModifierTransformer extension

Transform normal widget to Modifier
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String
Returns a one-line detailed description of the object.
inherited
toStringShort() → String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited