User interactions

13 Feb 201924 minutes to read

Enable tooltips for data points

Tooltips for data points can be enabled by using the “visible” of the tooltip property under the “commonSeriesOptions” in the pivot chart.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            //....
            //Enabling tooltip for data points
            tooltip:
            {
                visible: true
            }
        },
        //....
    });
});

Tooltip in JavaScript pivot chart control

HTML elements can be displayed in the tooltip by using the template option. The template option takes the value of the “id” attribute from the HTML element. You can use the #point.x# and #point.y# as place holders in the HTML element to display the X and Y values of the corresponding data points.

JAVASCRIPT

<body>
    <div id="PivotChart1" style="min-height: 275px; min-width: 525px; height: 460px; width: 720px"></div>
    <div id="Tooltip" style="display: none;">
        <label id="cc1">In </label>
        <label id="fyvalue">&nbsp;#point.x# </label>
        <label id="cc2">, customer count is</label>
        <label id="ccvalue">&nbsp;#point.y# </label>
    </div>
    <script type="text/javascript">
        $(function()
        {
            $("#PivotChart1").ejPivotChart(
            {
                //....
                commonSeriesOptions:
                {
                    //....
                    //Enabling tooltip of data points
                    tooltip:
                    {
                        visible: true,
                        template: 'Tooltip'
                    }
                },
                //....
            });
        });
    </script>
</body>

Tooltip template in JavaScript pivot chart control

By using the fill and border properties of the tooltip, you can customize its background color, border color, and border width.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            //....
            tooltip:
            {
                visible: true,
                //Customize tooltip background color and border
                fill: '#FF9933',
                border:
                {
                    width: 1,
                    color: "#993300"
                }
            }
        },
        //....
    });
});

Tooltip customization in JavaScript pivot chart control

The tooltip properties rx and ry are used to customize its corner radius.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            //....
            tooltip:
            {
                visible: true,
                //Customize the corner radius of the tooltip rectangle
                rx: "20",
                ry: "20"
            }
        },
        //....
    });
});

Tooltip with rounded corners in JavaScript pivot chart control

Zooming and panning

Enable zooming

There are two ways to zoom the chart:

When zooming.enable is set to true, you can zoom the chart by using the rubber band selection.
When the zooming.enableMouseWheel is set to true, you can zoom the chart by scrolling the mouse wheel.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        //Enable zooming in Chart
        zooming:
        {
            enable: true
        }
        //....
    });
});

Zooming in JavaScript pivot chart control

After zooming the chart, a zooming toolbar will appear with options to zoom, pan, and reset. Selecting the “Pan” will allow to view the chart and selecting “Reset” will reset the zoomed chart.

Panning in JavaScript pivot chart control

Types of zooming

You can zoom a particular axis, like the horizontal axis or the vertical axis or both axis by using the type when zooming.

NOTE

By default, the value for the type when zooming is “x,y” (indicating both axes) in the pivot chart.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        //Enable zooming in Chart
        zooming:
        {
            enable: true,
            //Enable horizontal zooming
            type: 'x'
        }
        //....
    });
});

Enable scrollbar

When enableScrollbar under zooming is set to true, the pivot chart is rendered along with scroll bars for a precise view of the data. The data can be viewed by using the scroll bar or by scrolling the mouse wheel.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        //Enable zooming in Chart
        zooming:
        {
            enableScrollbar: true
        }
        //....
    });
});

Scrollbar in JavaScript pivot chart control

Marker and crosshair

Marker shape customization

In the pivot chart, you can customize the marker shape with the following symbols:

Rectangle
Circle
Cross
Diamond
Pentagon
Hexagon
Star
Ellipse
Triangle

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Line
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    this.model.series[seriescount].marker.shape = "Triangle";
}

Marker customization in JavaScript pivot chart control

Enable crosshair and crosshair label

The crosshair allows you to view values at mouse position or touch contact point. The crosshair can be enabled by using the visible in the crosshair property. The crosshair label can be enabled by using the “visible” in the crosshairLabel property within its corresponding axis.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        //...
        //Initializing Crosshair
        crosshair:
        {
            visible: true
        },
        primaryXAxis:
        {
            //Enable Crosshair Label in X-Axis
            crosshairLabel:
            {
                visible: true
            }
        },
        primaryYAxis:
        {
            //Enable Crosshair Label to Y-Axis
            crosshairLabel:
            {
                visible: true
            }
        },
    });
});

Visibility of crosshair label in JavaScript pivot chart control

Crosshair line and label customization

By using the line property of the crosshair, you can customize its line color and width. By using fill and border properties of the crosshairLabel in its corresponding axis, you can customize its background color, border color, and border width.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        //...
        //Initializing Crosshair
        crosshair:
        {
            visible: true,
            //Customizing the crosshair line
            line:
            {
                color: 'gray',
                width: 2
            }
        },
        primaryXAxis:
        {
            //Enable Crosshair Label in X-Axis
            crosshairLabel:
            {
                visible: true,
                //Customizing the crosshair label background color and border
                fill: "red",
                border:
                {
                    color: "green",
                    width: 2
                }
            }
        },
        primaryYAxis:
        {
            //Enable Crosshair Label in Y-Axis
            crosshairLabel:
            {
                visible: true
            }
        },
    });
});

Customization of crosshair line and label in JavaScript pivot chart control

Trackball

Enable trackball

The trackball can be enabled by setting both - ‘visible’ of the crosshair to true and type of the crosshair to “trackball”. The default value of type is “crosshair”.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        //...
        //Initializing Crosshair
        crosshair:
        {
            visible: true,
            //Change crosshair type to trackball
            type: 'trackball'
        },
    });
});

Trackball in JavaScript pivot chart control

Trackball marker and line customization

The shape and size of the trackball marker can be customized by using the shape and size options of the crosshair marker. The color and width of the trackball line can be customized by using the “line” in the crosshair.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        //...
        //Initializing Crosshair
        crosshair:
        {
            visible: true,
            //Change crosshair type to trackball
            type: 'trackball',
            //Customize the trackball line color and width
            line:
            {
                color: '#800000',
                width: 2
            },
            //Customize the trackball marker shape, size and visibility
            marker:
            {
                shape: 'pentagon',
                size:
                {
                    height: 9,
                    width: 9
                },
                visible: true
            }
        },
    });
});

Customization of Trackball in JavaScript pivot chart control

Highlight

The pivot chart provides highlighting support for the series and data points by hovering the pointer. To enable highlighting, set the “enable” property to true in the highlightsettings of the series.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    this.model.series[seriescount].highlightSettings.enable = true
}

Highlight mode

You can set three different modes for highlighting data points and series by using the mode property of the highlightsettings.

series
points
cluster

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    {
        this.model.series[seriescount].highlightSettings.enable = true;
        this.model.series[seriescount].highlightSettings.mode = "series";
    }
}

Highlight mode in JavaScript pivot chart control

Customize the highlight styles

To customize the highlighted series, use the border.color, border.width, and opacity
options in the highlightSettings property.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    {
        this.model.series[seriescount].highlightSettings.enable = true;
        this.model.series[seriescount].highlightSettings.opacity = "0.5";
        this.model.series[seriescount].highlightSettings.border.width = "1.5";
        this.model.series[seriescount].highlightSettings.border.color = "red";
    }
}

Highlight style in JavaScript pivot chart control

Patterns to highlight

The pivot chart provides pattern support for highlighting the data by setting an appropriate value to the pattern property of the highlightSettings. The different types of highlight patterns are as follows:

chessboard
crosshatch
dots
packman
grid
turquoise
star
triangle
circle
tile
horizontalDash
verticalDash
rectangle
box
verticalStripe
horizontalStripe
bubble
diagonalBackward
diagonalForward

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    {
        this.model.series[seriescount].highlightSettings.enable = true;
        this.model.series[seriescount].highlightSettings.pattern = "chessboard";
    }
}

Highlight settings in JavaScript pivot chart control

Selection

The pivot chart provides selection support for the series and data points by clicking the mouse. To enable selection, set the “enable” property to true in the selectionSettings of the series.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    {
        this.model.series[seriescount].selectionSettings.enable = true;
    }
}

Selection mode

You can set three different selection modes for highlighting the data points and series by using the mode property of the selectionSettings.

series
points
cluster

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    {
        this.model.series[seriescount].selectionSettings.enable = true;
        this.model.series[seriescount].selectionSettings.mode = "series";
    }
}

Selection mode in JavaScript pivot chart control

Customize the selection styles

To customize the selection styles, use the border.color, border.width, and opacity options in the selectionSettings.

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    {
        this.model.series[seriescount].selectionSettings.enable = true;
        this.model.series[seriescount].selectionSettings.border.width = "1.5";
        this.model.series[seriescount].selectionSettings.border.color = "red";
    }
}

Selection style in JavaScript pivot chart control

Patterns for selection

The pivot chart provides pattern support for selecting data by setting an appropriate value to the pattern property of the selectionSettings. The different types of selection patterns are as follows:

chessboard
crosshatch
dots
packman
grid
turquoise
star
triangle
circle
tile
horizontalDash
verticalDash
rectangle
box
verticalStripe
horizontalStripe
bubble
diagonalBackward
diagonalForward

JAVASCRIPT

$(function()
{
    $("#PivotChart1").ejPivotChart(
    {
        ....
        commonSeriesOptions:
        {
            type: ej.PivotChart.ChartTypes.Column
        },
        seriesRendering: "onSeriesRender"
    });
});

function onSeriesRender(args)
{
    for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
    {
        this.model.series[seriescount].selectionSettings.enable = true;
        this.model.series[seriescount].selectionSettings.pattern = "chessboard";
    }
}

Selection settings in JavaScript pivot chart control