1.0.6 • Published 8 months ago

react-heatgrid v1.0.6

Weekly downloads
-
License
MIT
Repository
github
Last release
8 months ago

React HeatGrid

React HeatGrid is a versatile and customizable heatmap component for React applications.

ToolTip when hover on each grid.

Installation

You can install React HeatGrid via npm or yarn:

npm i react-heatgrid --save

Usage

To use the Calendar component from the react-heatgrid package, you need to import it and pass the required props. Below is an example of how to use the Calendar component along with an explanation of its props:

import React from 'react';
import { Calendar } from 'react-heatgrid';

const MyCalendar = () => {
  const calendarData = [
   { value: 9, day: '2023-08-23' },
    { value: 20, day: '2023-08-10' },
    { value: 49, day: '2023-07-17' },
    { value: 45, day: '2023-08-21' },
    { value: 7, day: '2023-07-23' },
    { value: 11, day: '2023-08-15' },
    { value: 28, day: '2023-08-26' },
    { value: 11, day: '2023-09-07' },
    { value: 27, day: '2023-09-08' },
    // you can add random day, skip a day and day can be date format like...
    { value: 27, day: new Date('2023-09-09') },
  ];

  const heatmapColors = ["#161b22","#0e4429","#006d32","#26a641","#39d353"];

  return (
    <div>
      <h1>My Calendar Heatmap</h1>
      <Calendar
        months={3}                 {/* Number of months to display */}
        data={calendarData}         {/* Array of data objects */}
        colors={heatmapColors}      {/* Array of heatmap colors */}
        tooltipLabel="activity"     {/* Tooltip label */}
      />
    </div>
  );
};

export default MyCalendar;

Props Guide

PropDescriptionDefault Value
monthsThe number of months to display in the calendar.3
gridSizeThe size of each grid cell in the calendar."20px"
gapThe gap between grid cells in the calendar."2px"
dataAn array of data objects representing each day in the calendar. Each object should have a 'value' (number) and 'day' (string) property.Required
colorsAn array of colors from low intensity to high. e.g "#161b22","#0e4429","#006d32","#26a641","#39d353"Required
fontSizeSize of text throughout the calendar."12px"
fontColorColor of the text"black"
DisabledToolTipDisable tooltips for grid cells.false
DisabledLegendDisable the legend of chartfalse
placementThe placement of tooltips relative to the grid cell ("top" or "bottom")."top"
tooltipBgThe background color of tooltips."#303030"
tooltipTextColorThe text color of tooltips."white"
tooltipLabelThe label for the tooltip, which can be one of "activity", "contributions", or a custom string."activity"
tooltipStyleAdditional CSS styles to apply to the tooltip. e.g {border:"1px solid red"}None
dateFormatEither "yyyy-mm-dd" (e.g 2023-01-31) or "WeekDay, Month Date, Year" (e.g Tue, Jan 31, 2023)"yyyy-mm-dd"
1.0.6

8 months ago

1.0.5

8 months ago

1.0.4

8 months ago

1.0.3

8 months ago

1.0.2

8 months ago

1.0.1

8 months ago

1.0.0

8 months ago