Chart.getSelection

Синтаксис

getSelection();

Описание

Метод getSelection возвращает объект, содержащий информацию о выделенных элементах рядов диаграммы.

Комментарии

Метод возвращает объект, в котором содержится массив Series. Этот массив состоит из объектов со следующими полями:

• Index. Индекс ряда данных, в котором выделены элементы;

• Points. Массив индексов значений по оси X для выделенных элементов ряда.

Пример

Для выполнения примера необходимо наличие на html-странице компонента Chart с наименованием «chart» (см. «Пример создания гистограммы»). Установим обработчики событий выделения и снятия выделения элементов на рядов данных на диаграмме:

// Устанавливаем обработчик события выделения рядов данных на диаграмме
chart.Selected.add(function() {
    console.log("Событие Selected");
    // Получаем объект выделения
    var selection = chart.getSelection();
    // Получаем массив с информацией о выделенных рядах данных
    var series = selection.Series;
    for (var i = 0; i < series.length; i++) {
        // Получаем элемент объекта выделения
        var serie = series[i];
        // Выводим в консоль браузера индекс выделенного ряда
        console.log("Ряд данных: " + serie.Index);
        // Получаем массив индексов по оси X элементов ряда
        var points = series[i].Points;
        console.log("Категории, в которых выделены данные:");
        // Выводим в консоль браузера Категории, в которых выделены элементы ряда
        for (var j = 0; j < points.length; j++) {
            var categorie = chart.getXAxis().getCategories()[points[j]];
            console.log("Категория: " + categorie);
        }
    }
});
// Устанавливаем обработчик события снятия выделения рядов данных на диаграмме
chart.Deselected.add(function() {
    console.log("Событие Deselected");
    // Перерисовываем ряды данных диаграммы
    var series = chart.getSeries();
    for (var i = 0; i < series.length; i++) {
        series[i].redraw();
    }
});

Удерживая клавишу SHIFT, выделим с помощью указателя мыши один из элементов ряда данных на диаграмме:

В результате этого действия в консоли браузера была выведена информация о выделенном элементе:

Событие Selected

Ряд данных: 2

Категории, в которых выделены данные:

Категория: 2003

Щелкнем левой кнопкой мыши по любой точки области построения диаграммы. В результате этого действия ряды данных диаграммы были перерисованы, после чего диаграмма приняла свой первоначальный вид. Также в консоли браузера было выведено сообщение о наступлении события Deselected:

Событие Deselected

См. также:

Chart