affiliate-charts рисует графики для партнёрских программ в виде SVG-строк. Один вызов возвращает разметку — в Node при сборке или в браузере. Без зависимостей; ядро и воронка вместе занимают 4,5 КБ в gzip.
Графики
- Воронка — от кликов до первых депозитов в штуках и от депозитов до выручки в деньгах: база каждого события рядом с тем, что партнёр на нём заработал, а отмены и отклонённые записи — на той же шкале. Воронка конверсии в SVG в трёх формах: полосы, ступени или классическая центрированная фигура.
- Водопад — водопад от GGR до комиссии шаг за шагом: итоги стоят на нуле, каждое изменение отходит от текущей накопленной суммы.
- Дневные ряды — линии, область или столбцы по дням, не больше двух рядов на одной оси значений, с необязательным периодом для сравнения.
- KPI-плитки и спарклайны — подпись, значение, изменение, окрашенное по тому, хорошее ли оно, и тренд; спарклайн высотой 32 px для ячейки таблицы.
- Рейтинги, доли, тепловые карты и когорты, шкалы и потоки — полосы по источникам, 100%-полоса или кольцо, треугольники когорт, прогресс до следующего уровня и sankey от источников до регистраций.
Сделано для кабинета
- Работает под строгой CSP. Никаких
style="",<style>,<script>,data:— графики кабинета под строгой CSP вродеdefault-src 'self', где большинство библиотек графиков ломаются. - Небольшие. Ядро плюс по файлу на каждый график: водопад добавляет к ядру 1,1 КБ, дневные ряды — 2,9 КБ, рейтинги — 0,9 КБ.
- Читаются на телефоне. Полосы следуют ширине контейнера, а текст сохраняет свой размер в пикселях.
- Честные по устройству. Шаги никогда не суммируются, деньги и штуки никогда не делят одну ось, отсутствующая конверсия — прочерк, а не
0%, и библиотека никогда не форматирует и не вычисляет показываемые числа: каждая подпись и каждое значение — ваша строка. - Настраиваемый стиль. Полосы берут цвет вашего
brand, подогнанный по контрасту к светлой или тёмной поверхности; текст и линии используютcurrentColor, а у каждого элемента есть класс, который можно перекрасить стилями.
Как подключить
Установите npm install affiliate-charts, импортируйте файл графика, например affiliate-charts/charts-funnel.js, и передайте ему шаги — у каждого подпись, значение и уже отформатированная вами строка для показа:
const svg = Charts.funnel(steps, { title: 'Funnel' });
Некорректные данные вызывают TypeError — библиотека никогда не чинит данные. Одни и те же входные данные дают одни и те же байты в пределах минорной версии.
Лицензия
MIT © 301ST. В живом демо каждый параметр выведен на элемент управления, в светлой и тёмной теме, а ползунок ширины показывает, как полосы следуют за контейнером.