🌞 A lightweight JavaScript library that generates customizable heat maps, charts, and statistics to visualize date-based activity and trends.
v4.2.2
- Zero-dependencies and extremely lightweight!
- Written in TypeScript, allowing greater support for React, Angular, and other libraries!
- Full API available via public functions.
- Fully styled in CSS/SASS, fully responsive, and compatible with the Bootstrap library.
- Full CSS theme support (using :root variables).
- 4 views supported: Map, Chart, Days, and Statistics!
- Configuration dialog support per view.
- Fully configurable per DOM element.
- Toggling colors on/off support.
- Export all data to CSV, JSON, XML, and TXT.
- Import data from JSON, TXT, and CSV.
- 51 language translations available!
- Trend types allows data to be split up and viewed separately.
- Customizable tooltips.
- 12 additional themes available (for dark and light mode).
- Data pulling (does not support trend types).
- Color ranges support different colors per view.
All the documentation can be found here.
All modern browsers (such as Google Chrome, FireFox, and Opera) are fully supported.
afAfrikaansarArabichyArmenianbeBelarusianbnBengalibgBulgariancaCatalanzhChinese (simplified)daDanishnlDutchenEnglish (default)eoEsperantoetEstonianfaFarsifiFinnishfrFrenchfyFrisianglGaliciankaGeorgiandeGermanelGreekheHebrewhiHindihuHungarianisIcelandicidIndonesiangaIrishitItalianjaJapanesekoKoreanlvLatvianltLithuanianlbLuxembourgishmsMalayneNepalinoNorwegianplPolishptPortugueseroRomaniansiSinhaleseskSlovakslSlovenianesSpanishsvSwedishtlTagalogtaTamilzh-twTaiwaneseteTeluguthThaitrTurkishukUkrainian
To see a list of all the most recent changes, click here.
You can install the library with npm into your local modules directory using the following command:
npm install jheat.jsOr, you can download the latest zipped up version here.
Or, you can also use the following CDN links:
https://cdn.jsdelivr.net/gh/williamtroup/[email protected]/dist/heat.min.js
https://cdn.jsdelivr.net/gh/williamtroup/[email protected]/dist/heat.js.min.cssTo get started using Heat.js, do the following steps:
Make sure you include the "DOCTYPE html" tag at the top of your HTML, as follows:
<!DOCTYPE html><link rel="stylesheet" href="dist/heat.js.css">
<script src="dist/heat.js"></script><div id="heat-map" data-heat-js="{ 'views': { 'map': { 'showDayNames': true } } }">
Your HTML.
</div>To see a list of all the available binding options you can use for "data-heat-js", click here.
To see a list of all the available custom triggers you can use for "data-heat-js", click here.
Now, you can add/remove dates, which will update the heat map automatically!
<script>
var newDateObject = new Date();
$heat.addDate( "heat-map", newDateObject, "Trend Type 1", true );
$heat.removeDate( "heat-map", newDateObject, "Trend Type 1", true );
</script>That's it! Nice and simple. Please refer to the code if you need more help (fully documented).
To customize, and get more out of Heat.js, please read through the following documentation.
To see a list of all the public functions available, click here.
Configuration options allow you to customize how Heat.js will function. You can set them as follows:
<script>
$heat.setConfiguration( {
safeMode: false
} );
</script>To see a list of all the available configuration options you can use, click here.