Search results

User Interaction in ASP.NET Linear Gauge

30 Jul 2021 / 2 minutes to read

Tooltip

Linear Gauge displays the details about a pointer value through LinearGaugeTooltipSettings, when the mouse hovers over the pointer. To enable the tooltip, set Enable property as ”true“.

razor
Copied to clipboard
@using Syncfusion.EJ2.LinearGauge;

@Html.EJS().LinearGauge("gauge").Tooltip(new Syncfusion.EJ2.LinearGauge.LinearGaugeTooltipSettings 
    {
        Enable = true
    }).Axes(new List<Syncfusion.EJ2.LinearGauge.LinearGaugeAxis>
        {
            new Syncfusion.EJ2.LinearGauge.LinearGaugeAxis
        {
            Pointers = new List<LinearGaugePointer>
            {
                new Syncfusion.EJ2.LinearGauge.LinearGaugePointer
                { 
                    Value = 80
                }
            }
        }
    }
).Render()
![Linear Gauge with tooltip for pointer value](../images/tooltip.png)

Tooltip format

Tooltip in the Linear Gauge control can be formatted using the Format property in LinearGaugeTooltipSettings. It is used to render the tooltip in certain format or to add a user-defined unit in the tooltip. By default, the tooltip shows the pointer value only. In addition to that, more information can be added in the tooltip. For example, the format ”{value}km” shows pointer value with kilometer unit in the tooltip.

razor
Copied to clipboard
@using Syncfusion.EJ2.LinearGauge;

@Html.EJS().LinearGauge("gauge").Tooltip(new Syncfusion.EJ2.LinearGauge.LinearGaugeTooltipSettings {
    Enable = true, Format = "{value}km"
}).Axes(new List<Syncfusion.EJ2.LinearGauge.LinearGaugeAxis>
{
    new Syncfusion.EJ2.LinearGauge.LinearGaugeAxis
    {
        Pointers = new List<LinearGaugePointer>
        {
            new Syncfusion.EJ2.LinearGauge.LinearGaugePointer
            {
              Value = 80
            }
        }
    }
}).Render()

Linear Gauge with tooltip format for pointer value

Tooltip Template

The HTML element can be rendered in the tooltip of the Linear Gauge using the Template property in LinearGaugeTooltipSettings. The ”${value}” can be used as placeholders in the HTML element to display the pointer values of the corresponding axis.

razor
Copied to clipboard
@using Syncfusion.EJ2.LinearGauge;

@Html.EJS().LinearGauge("gauge").Tooltip(new Syncfusion.EJ2.LinearGauge.LinearGaugeTooltipSettings {
    Enable = true, Template = "<div>Pointer: 80 </div>"
}).Axes(new List<Syncfusion.EJ2.LinearGauge.LinearGaugeAxis>
{
    new Syncfusion.EJ2.LinearGauge.LinearGaugeAxis
    {
        Pointers = new List<LinearGaugePointer>
        {
            new Syncfusion.EJ2.LinearGauge.LinearGaugePointer
            {
              Value = 80
            }
        }
    }
}).Render()

Linear Gauge with tooltip template for pointer value

Customize the appearance of the tooltip

The tooltip can be customized using the following properties in LinearGaugeTooltipSettings.

  • Fill - To fill the color for tooltip.
  • EnableAnimtion - To enable or disable the tooltip animation.
  • Border - To set the color and width for the border of the tooltip.
  • TextStyle - To customize the style of the text in tooltip.
  • ShowAtMousePosition - To show the tooltip at the mouse position.
razor
Copied to clipboard
@using Syncfusion.EJ2.LinearGauge;

@Html.EJS().LinearGauge("gauge").Tooltip(new Syncfusion.EJ2.LinearGauge.LinearGaugeTooltipSettings {
    Enable = true, Fill = "#e5bcbc",
    Border = new Syncfusion.EJ2.LinearGauge.TooltipSettingsBorderTooltip
    {
        Width = 2, Color = "#d80000"
    }
}).Axes(new List<Syncfusion.EJ2.LinearGauge.LinearGaugeAxis>
{
    new Syncfusion.EJ2.LinearGauge.LinearGaugeAxis
    {
        Pointers = new List<LinearGaugePointer>
        {
            new Syncfusion.EJ2.LinearGauge.LinearGaugePointer
            {
              Value = 80
            }
        }
    }
}).Render()

Linear Gauge with tooltip customization

Positioning the tooltip

The tooltip is positioned at the ”End” of the pointer. To change the position of the tooltip at the start, or center of the pointer, set the Position property to ”Start” or ”Center“.

razor
Copied to clipboard
@using Syncfusion.EJ2.LinearGauge;

@Html.EJS().LinearGauge("gauge").Tooltip(new Syncfusion.EJ2.LinearGauge.LinearGaugeTooltipSettings {
    Enable = true, Position = TooltipPosition.Center
}).Axes(new List<Syncfusion.EJ2.LinearGauge.LinearGaugeAxis>
{
    new Syncfusion.EJ2.LinearGauge.LinearGaugeAxis
    {
        Pointers = new List<LinearGaugePointer>
        {
            new Syncfusion.EJ2.LinearGauge.LinearGaugePointer
            {
              Value = 50, Type=Point.Bar, Color="blue"
            }
        }
    }
}).Render()

Linear Gauge with tooltip position

Pointer Drag

To drag either marker or bar pointer to the desired axis value, set the EnableDrag property as ”true” in LinearGaugePointer.

razor
Copied to clipboard
@using Syncfusion.EJ2.LinearGauge;

@Html.EJS().LinearGauge("gauge").Axes(new List<Syncfusion.EJ2.LinearGauge.LinearGaugeAxis>
{
    new Syncfusion.EJ2.LinearGauge.LinearGaugeAxis
    {
        Pointers = new List<LinearGaugePointer>
        {
            new Syncfusion.EJ2.LinearGauge.LinearGaugePointer
            {
              Value = 80, EnableDrag = true
            }
        }
    }
}).Render()

Linear Gauge with pointer drag