Макет Круговой Диаграммы

Ссылка на API ▸ Макеты ▸ Макет Круговой Диаграммы

Макет круговой диаграммы предназначен для вычисления начальных и конечных углов дуг, составляющих круговую или кольцевую диаграмму:

Вы не обязаны использовать макет круговой диаграммы для создания круговой диаграммы; вы можете напрямую использовать форму дуги, если предпочитаете. Макет круговой диаграммы просто упрощает преобразование массива данных в массив объектов с атрибутами startAngle и endAngle, которые варьируются от 0 до 2π, которые затем можно передать генератору формы дуги.

d3.layout.pie()

Создаёт новую функцию круговой диаграммы со значением по умолчанию (число), компаратором сортировки (по убыванию значения), начальным углом (0) и конечным углом (2π). Возвращаемый объект макета является как объектом, так и функцией. То есть: вы можете вызвать макет как любую другую функцию, и макет имеет дополнительные методы, которые изменяют его поведение. Как и другие классы в D3, макеты следуют схеме цепочки вызовов методов, где методы-установщики возвращают сам макет, что позволяет вызывать несколько установщиков в одном компактном выражении.

pie(значения[, индекс])

Вычисляет функцию круговой диаграммы для указанного массива значений. Можно указать необязательный индекс, который передаётся функциям начального и конечного углов. Возвращаемое значение — массив описаний дуг:

• значение — значение данных, возвращаемое функцией-обработчиком значения.
• startAngle — начальный угол дуги в радианах.
• endAngle — конечный угол дуги в радианах.
• padAngle — угол отступа дуги в радианах.
• data — исходные данные для этой дуги.

Элементы возвращаются в исходном порядке, соответствующем значениям, даже если применяется порядок сортировки; это сохраняет исходный индекс каждого элемента в массиве значений, что полезно, если вы используете индекс для генерации категориального цвета или другого свойства отображения.

pie.value([функция-обработчик])

Указывает, как извлечь значение из связанных данных (например, устанавливает функцию-обработчик для макета круговой диаграммы для использования); функция-обработчик — функция, которая вызывается для каждого входного значения, переданного pie, эквивалентно вызову values.map(функция-обработчик) перед вычислением макета круговой диаграммы. Функция получает два аргумента: текущую запись данных и текущий индекс. Функция-обработчик значения по умолчанию — встроенная Number, которая похожа на функцию тождества. Если функция-обработчик не указана, возвращает текущую функцию-обработчик значения.

pie.sort([компаратор])

Если указан компаратор, устанавливает порядок сортировки данных для макета с помощью указанной функции компаратора. Передайте null для отключения сортировки. Если компаратор не указан, возвращает текущий порядок сортировки. Порядок сортировки по умолчанию — по убыванию значения. Сортировка сохраняет индекс (и индекс z) входных значений, влияя только на вычисленные углы. Функция компаратора вызывается для пар элементов данных из массива значений, переданного pie. Функции компаратора также могут быть реализованы с помощью d3.ascending или d3.descending.

pie.startAngle([угол])

Если указан угол, устанавливает общий начальный угол макета круговой диаграммы на указанное значение в радианах. Если угол не указан, возвращает текущее значение, которое по умолчанию равно 0. Начальный угол можно задать как константу или как функцию; если функция, она вычисляется один раз при вызове функции pie, получая на вход текущие данные и индекс.

pie.endAngle([угол])

Если указан угол, устанавливает общий конечный угол макета круговой диаграммы на указанное значение в радианах. Если угол не указан, возвращает текущее значение, которое по умолчанию равно 2π. Конечный угол можно задать как константу или как функцию; если функция, она вычисляется один раз при вызове функции pie, получая на вход текущие данные и индекс.

pie.padAngle([угол])

Если указан угол, устанавливает угол отступа макета круговой диаграммы на указанное значение в радианах. Смежные дуги будут разделены углом отступа. Если угол не указан, возвращает текущее значение, которое по умолчанию равно 0. Угол отступа можно задать как константу или как функцию; если функция, она вычисляется один раз при вызове функции pie, получая на вход текущие данные и индекс.