Display tooltips
A .NET Multi-platform App UI (.NET MAUI) tooltip is a small rectangular popup that displays a brief description of a view's purpose, when the user rests the pointer on the view. Tooltips display automatically, typically when the user hovers the pointer over the associated view:
- On Android, tooltips are displayed when users long press the view. Tooltips remain visible for a few seconds after the long press is released.
- On iOS, to show a tooltip your app must be an iPhone or iPad app running on a Mac with Apple silicon. Providing this criteria is met, tooltips are displayed when the pointer is positioned over the view for a few seconds, and remain visible until the pointer moves away from the view. Tooltips on iOS require the use of iOS 15.0+. For more information about using iPhone and iPad apps on a Mac with Apple silicon, see Use iPhone and iPad apps on Mac with Apple silicon.
- On Mac Catalyst, tooltips are displayed when the pointer is positioned over the view for a few seconds. Tooltips remain visible until the pointer moves away from the view. Tooltips on Mac Catalyst require the use of Mac Catalyst 15.0+.
- On Windows, tooltips are displayed when the pointer hovers over the view. Tooltips remain visible for a few seconds, or until the pointer stops hovering over the view.
Tooltips are defined by setting the ToolTipProperties.Text
attached property, on a view, to a string
:
<Button Text="Save"
ToolTipProperties.Text="Click to Save your data" />
The equivalent C# code is:
Button button = new Button { Text = "Save" };
ToolTipProperties.SetText(button, "Click to Save your data");
For more information about attached properties, see Attached properties.
By default, a tooltip is displayed centered above the pointer:
Note
Configuring tooltip placement is currently unsupported.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for