affiliate-charts

Графики для кабинета партнёра в виде SVG-строк — воронки, водопад от GGR до комиссии, дневные ряды и KPI-плитки, работающие под строгой CSP.

Доступно в: npm GitHub Сайт проекта

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. В живом демо каждый параметр выведен на элемент управления, в светлой и тёмной теме, а ползунок ширины показывает, как полосы следуют за контейнером.