Class TooltipShowOn

Defines when tooltips should be displayed on the Slider component.

Inheritance

System.Object

TooltipShowOn

Namespace: Syncfusion.Blazor.Inputs

Assembly: Syncfusion.Blazor.dll

Syntax

public sealed class TooltipShowOn : Enum

Remarks

The TooltipShowOn enum controls the trigger conditions for showing tooltips. Different display modes provide varying levels of user interaction and accessibility support. The choice affects both user experience and performance, especially in touch-enabled environments.

Examples

<SfSlider TValue="int" Value="50">
    <SliderTooltip IsVisible="true" ShowOn="TooltipShowOn.Hover" Format="C2">
    </SliderTooltip>
</SfSlider>

Fields

Always

Keeps the tooltip continuously visible at all times.

Declaration

public const TooltipShowOn Always

Field Value

Type
TooltipShowOn

Remarks

The Always mode permanently displays the tooltip, ensuring the current value is always visible. This mode is useful for critical value displays or when users need constant reference to the current setting. However, it may impact visual layout and should be used carefully to avoid interface clutter.

Auto

Displays the tooltip automatically on both focus and click interactions.

Declaration

public const TooltipShowOn Auto

Field Value

Type
TooltipShowOn

Remarks

The Auto mode combines focus and click triggers, providing optimal accessibility support. The tooltip appears when users either tab to the slider handle (focus) or click/tap it directly. This mode ensures tooltips work well across different input methods including keyboard, mouse, and touch.

Focus

Displays the tooltip only when the slider handle receives focus.

Declaration

public const TooltipShowOn Focus

Field Value

Type
TooltipShowOn

Remarks

The Focus mode shows tooltips when users navigate to the slider using keyboard (Tab key) or screen readers. This mode is ideal for accessibility-focused applications and provides a clean interface for mouse users while ensuring keyboard navigation users always see current values.

Hover

Displays the tooltip when hovering over the slider handle.

Declaration

public const TooltipShowOn Hover

Field Value

Type
TooltipShowOn

Remarks

The Hover mode shows tooltips on mouse hover events, providing immediate feedback for mouse users. This mode works well for desktop applications but may not be suitable for touch-only devices where hover interactions are not available. Consider combining with other trigger modes for better accessibility.