diff --git a/docs/resources/ui/widgets/built-in-widgets/imgs/tooltip-on-focus.avif b/docs/resources/ui/widgets/built-in-widgets/imgs/tooltip-on-focus.avif new file mode 100644 index 00000000..350aa5c3 Binary files /dev/null and b/docs/resources/ui/widgets/built-in-widgets/imgs/tooltip-on-focus.avif differ diff --git a/docs/resources/ui/widgets/built-in-widgets/tooltip.md b/docs/resources/ui/widgets/built-in-widgets/tooltip.md index 6558c83e..5c69e636 100644 --- a/docs/resources/ui/widgets/built-in-widgets/tooltip.md +++ b/docs/resources/ui/widgets/built-in-widgets/tooltip.md @@ -117,6 +117,12 @@ Here’s exactly how you do it: On touch devices, the *Tooltip* opens on tap. To make it open on long press instead, use the **Trigger Mode** property. +### Show Tooltip on Focus + +The **Show Tooltip on Focus** toggle controls whether the tooltip is displayed when the child widget receives keyboard focus. This is particularly useful for improving accessibility and keyboard navigation, as it ensures users see helpful information when they tab through form fields, interactive elements or any important information. + +![tooltip-on-focus](imgs/tooltip-on-focus.avif) + ### Change tooltip alignment By default, the *Tooltip* appears below the target widget. You can change this setting using the **Preferred Direction** property. This allows you to open the Tooltip **Above**, **Left,** and **Right** directions in addition to the **Below**.