You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

313 lines
15 KiB

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>Frappe Charts</title>
  6. <meta name="viewport" content="width=device-width, initial-scale=1">
  7. <meta name="keywords" content="open source javascript js charts library svg zero-dependency interactive data visualization beautiful drag resize">
  8. <meta name="description" content="A simple, responsive, modern charts library for the web.">
  9. <link rel="stylesheet" type="text/css" href="assets/css/normalize.css" media="screen">
  10. <link href='https://fonts.googleapis.com/css?family=Roboto:400,700' rel='stylesheet' type='text/css'>
  11. <link rel="stylesheet" type="text/css" href="assets/css/bootstrap.min.css" media="screen">
  12. <link rel="stylesheet" type="text/css" href="assets/css/frappe_theme.css" media="screen">
  13. <link rel="stylesheet" type="text/css" href="assets/css/index.css" media="screen">
  14. <link rel="stylesheet" type="text/css" href="assets/css/default.css" media="screen">
  15. <script src="assets/js/highlight.pack.js"></script>
  16. <script>hljs.initHighlightingOnLoad();</script>
  17. <link rel="shortcut icon" href="https://frappe.github.io/frappe/assets/img/favicon.png" type="image/x-icon">
  18. <link rel="icon" href="https://frappe.github.io/frappe/assets/img/favicon.png" type="image/x-icon">
  19. </head>
  20. <body>
  21. <div class="container">
  22. <div class="row hero" style="padding-top: 30px; padding-bottom: 0px;">
  23. <div class="jumbotron" style="background: transparent;">
  24. <h1>Frappe Charts</h1>
  25. <p class="mt-2">GitHub-inspired simple and modern charts for the web</p>
  26. <p class="mt-2">with zero dependencies.</p>
  27. <!--<p class="mt-2">Because dumb charts are hard to come by.</p>-->
  28. </div>
  29. <div class="col-sm-10 push-sm-1 later" style="font-size: 14px;">
  30. <div id="chart-composite-1" class="border"><svg height=225></svg></div>
  31. <p class="mt-1">Click or use arrow keys to navigate data points</p>
  32. </div>
  33. <div class="col-sm-10 push-sm-1 later" style="font-size: 14px;">
  34. <div id="chart-composite-2" class="border"><svg height=225></svg></div>
  35. </div>
  36. </div>
  37. <div class="group later">
  38. <div class="row section">
  39. <div class="col-sm-10 push-sm-1">
  40. <div class="dashboard-section">
  41. <h6 class="margin-vertical-rem">
  42. <!--Bars, Lines or <a href="http://www.storytellingwithdata.com/blog/2011/07/death-to-pie-charts" target="_blank">Percentages</a>-->
  43. Create a chart
  44. </h6>
  45. <p class="step-explain">Install</p>
  46. <pre><code class="hljs console"> npm install frappe-charts</code></pre>
  47. <p class="step-explain">And include it in your project</p>
  48. <pre><code class="hljs javascript"> import Chart from "frappe-charts/dist/frappe-charts.min.esm"</code></pre>
  49. <p class="step-explain">... or include it directly in your HTML</p>
  50. <pre><code class="hljs html"> &lt;script src="https://unpkg.com/frappe-charts@1.0.0/dist/frappe-charts.min.iife.js"&gt;&lt;/script&gt;</code></pre>
  51. <p class="step-explain">Make a new Chart</p>
  52. <pre><code class="hljs html"> &lt!--HTML--&gt;
  53. &lt;div id="chart"&gt;&lt;/div&gt;</code></pre>
  54. <pre><code class="hljs javascript"> // Javascript
  55. let data = {
  56. labels: ["12am-3am", "3am-6am", "6am-9am", "9am-12pm",
  57. "12pm-3pm", "3pm-6pm", "6pm-9pm", "9pm-12am"],
  58. datasets: [
  59. {
  60. label: "Some Data",
  61. values: [25, 40, 30, 35, 8, 52, 17, -4]
  62. },
  63. {
  64. label: "Another Set",
  65. values: [25, 50, -10, 15, 18, 32, 27, 14]
  66. },
  67. {
  68. label: "Yet Another",
  69. values: [15, 20, -3, -15, 58, 12, -17, 37]
  70. }
  71. ]
  72. };
  73. let chart = new Chart({
  74. parent: "#chart", // or a DOM element
  75. title: "My Awesome Chart",
  76. data: data,
  77. type: 'bar', // or 'line', 'scatter', 'pie', 'percentage'
  78. height: 250,
  79. colors: ['#7cd6fd', 'violet', 'blue'],
  80. // hex-codes or these preset colors;
  81. // defaults (in order):
  82. // ['light-blue', 'blue', 'violet', 'red',
  83. // 'orange', 'yellow', 'green', 'light-green',
  84. // 'purple', 'magenta', 'grey', 'dark-grey']
  85. format_tooltip_x: d => (d + '').toUpperCase(),
  86. format_tooltip_y: d => d + ' pts'
  87. });</code></pre>
  88. <div id="chart-types" class="border"></div>
  89. <div class="btn-group chart-type-buttons margin-vertical-px mx-auto" role="group">
  90. <button type="button" class="btn btn-sm btn-secondary active" data-type='bar'>Bar Chart</button>
  91. <button type="button" class="btn btn-sm btn-secondary" data-type='line'>Line Chart</button>
  92. <button type="button" class="btn btn-sm btn-secondary" data-type='pie'>Pie Chart</button>
  93. <button type="button" class="btn btn-sm btn-secondary" data-type='percentage'>Percentage Chart</button>
  94. </div>
  95. <p class="text-muted">
  96. <a target="_blank" href="http://www.storytellingwithdata.com/blog/2011/07/death-to-pie-charts">Why Percentage?</a>
  97. </p>
  98. </div>
  99. </div>
  100. <div class="col-sm-10 push-sm-1">
  101. <div class="dashboard-section">
  102. <h6 class="margin-vertical-rem">
  103. Update Values
  104. </h6>
  105. <pre><code class="hljs javascript"> // Update entire datasets
  106. chart.updateData(
  107. [
  108. {values: new_dataset_1_values},
  109. {values: new_dataset_2_values}
  110. ],
  111. new_labels
  112. );
  113. // Add a new data point
  114. chart.add_data_point(
  115. [new_value_1, new_value_2],
  116. new_label,
  117. index // defaults to last index
  118. );
  119. // Remove a data point
  120. chart.remove_data_point(index);</code></pre>
  121. <div id="chart-update" class="border"></div>
  122. <div class="chart-update-buttons mt-1 mx-auto" role="group">
  123. <button type="button" class="btn btn-sm btn-secondary" data-update="random">Random Data</button>
  124. <button type="button" class="btn btn-sm btn-secondary" data-update="add">Add Value</button>
  125. <button type="button" class="btn btn-sm btn-secondary" data-update="remove">Remove Value</button>
  126. </div>
  127. <pre><code class="hljs javascript margin-vertical-px"> ...
  128. // Include specific Y values in input data to be displayed as lines
  129. // (before passing data to a new chart):
  130. data.specific_values = [
  131. {
  132. label: "Altitude",
  133. line_type: "dashed", // or "solid"
  134. value: 38
  135. }
  136. ]
  137. ...</code></pre>
  138. </div>
  139. </div>
  140. <div class="col-sm-10 push-sm-1">
  141. <div class="dashboard-section">
  142. <h6 class="margin-vertical-rem">
  143. Plot Trends
  144. </h6>
  145. <pre><code class="hljs javascript"> ...
  146. xAxisMode: 'tick', // for short label ticks
  147. // or 'span' for long spanning vertical axis lines
  148. yAxisMode: 'span', // for long horizontal lines, or 'tick'
  149. isSeries: 1, // to allow for skipping of X values
  150. ...</code></pre>
  151. <div id="chart-trends" class="border"></div>
  152. <div class="btn-group chart-plot-buttons mt-1 mx-auto" role="group">
  153. <button type="button" class="btn btn-sm btn-secondary" data-type="line">Line</button>
  154. <button type="button" class="btn btn-sm btn-secondary" data-type="dots">Dots</button>
  155. <button type="button" class="btn btn-sm btn-secondary active" data-type="heatline">HeatLine</button>
  156. <button type="button" class="btn btn-sm btn-secondary" data-type="region">Region</button>
  157. </div>
  158. <pre><code class="hljs javascript margin-vertical-px"> ...
  159. type: 'line', // Line Chart specific properties:
  160. hideDots: 1, // Hide data points on the line; default 0
  161. heatline: 1, // Show a value-wise line gradient; default 0
  162. regionFill: 1, // Fill the area under the graph; default 0
  163. ...</code></pre>
  164. </div>
  165. </div>
  166. <div class="col-sm-10 push-sm-1">
  167. <div class="dashboard-section">
  168. <h6 class="margin-vertical-rem">
  169. Listen to state change
  170. </h6>
  171. <div class="row">
  172. <div class="col-sm-8">
  173. <div id="chart-events" class="border"></div>
  174. </div>
  175. <div class="col-sm-4">
  176. <div class="chart-events-data" class="border data-container">
  177. <div class="image-container border">
  178. <img class="moon-image" src="./assets/img/europa.jpg">
  179. </div>
  180. <div class="data margin-vertical-px">
  181. <h6 class="moon-name">Europa</h6>
  182. <p>Semi-major-axis: <span class="semi-major-axis">671034</span> km</p>
  183. <p>Mass: <span class="mass">4800000</span> x 10^16 kg</p>
  184. <p>Diameter: <span class="diameter">3121.6</span> km</p>
  185. </div>
  186. </div>
  187. </div>
  188. </div>
  189. <pre><code class="hljs javascript margin-vertical-px"> ...
  190. type: 'bar', // Bar Chart specific properties:
  191. isNavigable: 1, // Navigate across bars; default 0
  192. ...
  193. chart.parent.addEventListener('data-select', (e) => {
  194. update_moon_data(e.index); // e contains index and value of current datapoint
  195. });</code></pre>
  196. </div>
  197. </div>
  198. <div class="col-sm-10 push-sm-1">
  199. <div class="dashboard-section">
  200. <h6 class="margin-vertical-rem">
  201. Simple Aggregations
  202. </h6>
  203. <div id="chart-aggr" class="border"></div>
  204. <div class="chart-aggr-buttons mt-1 mx-auto" role="group">
  205. <button type="button" class="btn btn-sm btn-secondary" data-aggregation="sums">Show Sums</button>
  206. <button type="button" class="btn btn-sm btn-secondary" data-aggregation="average">Show Averages</button>
  207. </div>
  208. <pre><code class="hljs javascript margin-vertical-px"> chart.show_sums(); // and `hide_sums()`
  209. chart.show_averages(); // and `hide_averages()`</code></pre>
  210. </div>
  211. </div>
  212. <div class="col-sm-10 push-sm-1">
  213. <div class="dashboard-section">
  214. <h6 class="margin-vertical-rem">
  215. And a Month-wise Heatmap
  216. </h6>
  217. <div id="chart-heatmap" class="border"
  218. style="overflow: scroll; text-align: center; padding: 20px;"></div>
  219. <div class="heatmap-mode-buttons btn-group mt-1 mx-auto" role="group">
  220. <button type="button" class="btn btn-sm btn-secondary active" data-mode="discrete">Discrete</button>
  221. <button type="button" class="btn btn-sm btn-secondary" data-mode="continuous">Continuous</button>
  222. </div>
  223. <div class="heatmap-color-buttons btn-group mt-1 mx-auto" role="group">
  224. <button type="button" class="btn btn-sm btn-secondary active" data-color="default">Default green</button>
  225. <button type="button" class="btn btn-sm btn-secondary" data-color="halloween">GitHub's Halloween</button>
  226. </div>
  227. <pre><code class="hljs javascript margin-vertical-px"> let heatmap = new Chart({
  228. parent: "#heatmap",
  229. type: 'heatmap',
  230. height: 115,
  231. data: heatmap_data, // object with date/timestamp-value pairs
  232. discrete_domains: 1 // default: 0
  233. start: start_date,
  234. // A Date object;
  235. // default: today's date in past year
  236. // for an annual heatmap
  237. legend_colors: ['#ebedf0', '#fdf436', '#ffc700', '#ff9100', '#06001c'],
  238. // Set of five incremental colors,
  239. // beginning with a low-saturation color for zero data;
  240. // default: ['#ebedf0', '#c6e48b', '#7bc96f', '#239a3b', '#196127']
  241. });</code></pre>
  242. </div>
  243. </div>
  244. <div class="col-sm-10 push-sm-1">
  245. <div class="dashboard-section">
  246. <!-- Closing -->
  247. <div class="text-center" style="margin-top: 70px">
  248. <a href="https://github.com/frappe/charts/archive/master.zip"><button class="large blue button">Download</button></a>
  249. <p style="margin-top: 3rem;margin-bottom: 1.5rem;"><a href="https://github.com/frappe/charts" target="_blank">View on GitHub</a></p>
  250. <p style="margin-top: 1rem;"><iframe src="https://ghbtns.com/github-btn.html?user=frappe&repo=charts&type=star&count=true" frameborder="0" scrolling="0" width="94px" height="20px"></iframe></p>
  251. <p>License: MIT</p>
  252. </div>
  253. </div>
  254. </div>
  255. </div>
  256. </div>
  257. </div>
  258. <div class="built-with-frappe text-center" style="margin-top: -20px">
  259. <img style="padding: 5px; width: 40px; background: #fff" class="frappe-bird" src="https://frappe.github.io/frappe/assets/img/frappe-bird-grey.svg">
  260. <p style="margin: 24px 0 0px 0; font-size: 15px">
  261. Project maintained by <a href="https://frappe.io" target="_blank">Frappe</a>.
  262. Used in <a href="https://erpnext.com" target="_blank">ERPNext</a>.
  263. Read the <a href="https://medium.com/@pratu16x7/so-we-decided-to-create-our-own-charts-a95cb5032c97" target="_blank">blog post</a>.
  264. </p>
  265. <p style="margin: 24px 0 80px 0; font-size: 12px">
  266. Data from the <a href="https://www.amsmeteors.org" target="_blank">American Meteor Society</a>,
  267. <a href="http://www.sidc.be/silso" target="_blank">SILSO</a> and
  268. <a href="https://api.nasa.gov/index.html" target="_blank">NASA Open APIs</a>
  269. </p>
  270. </div>
  271. <a href="https://github.com/frappe/charts" target="_blank" class="github-corner" aria-label="View source on Github">
  272. <svg width="80" height="80" viewBox="0 0 250 250" style="fill:#9a9a9a; color:#fff; position: absolute; top: 0; border: 0; right: 0;" aria-hidden="true">
  273. <path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"></path>
  274. <path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"></path>
  275. <path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"></path>
  276. </svg>
  277. </a>
  278. <script src="assets/js/frappe-charts.min.js"></script>
  279. <script src="assets/js/old_index.js"></script>
  280. </body>
  281. </html>