bar.html 33 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181
  1. <!DOCTYPE HTML>
  2. <html lang="" >
  3. <head>
  4. <meta charset="UTF-8">
  5. <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
  6. <title>Bar · Chart.js documentation</title>
  7. <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  8. <meta name="description" content="">
  9. <meta name="generator" content="GitBook 3.2.2">
  10. <meta name="author" content="chartjs">
  11. <link rel="stylesheet" href="../gitbook/style.css">
  12. <link rel="stylesheet" href="../gitbook/gitbook-plugin-search-plus/search.css">
  13. <link rel="stylesheet" href="../gitbook/gitbook-plugin-highlight/website.css">
  14. <link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
  15. <link rel="stylesheet" href="../style.css">
  16. <meta name="HandheldFriendly" content="true"/>
  17. <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
  18. <meta name="apple-mobile-web-app-capable" content="yes">
  19. <meta name="apple-mobile-web-app-status-bar-style" content="black">
  20. <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
  21. <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">
  22. <link rel="next" href="radar.html" />
  23. <link rel="prev" href="line.html" />
  24. <link rel="stylesheet" href="../gitbook/gitbook-plugin-chartjs/style.css">
  25. <script src="../gitbook/gitbook-plugin-chartjs/Chart.bundle.js"></script>
  26. <script src="../gitbook/gitbook-plugin-chartjs/chartjs-plugin-deferred.js"></script>
  27. </head>
  28. <body>
  29. <div class="book">
  30. <div class="book-summary">
  31. <div id="book-search-input" role="search">
  32. <input type="text" placeholder="Type to search" />
  33. </div>
  34. <nav role="navigation">
  35. <ul class="summary">
  36. <li class="chapter " data-level="1.1" data-path="../">
  37. <a href="../">
  38. Chart.js
  39. </a>
  40. </li>
  41. <li class="chapter " data-level="1.2" data-path="../getting-started/">
  42. <a href="../getting-started/">
  43. Getting Started
  44. </a>
  45. <ul class="articles">
  46. <li class="chapter " data-level="1.2.1" data-path="../getting-started/installation.html">
  47. <a href="../getting-started/installation.html">
  48. Installation
  49. </a>
  50. </li>
  51. <li class="chapter " data-level="1.2.2" data-path="../getting-started/integration.html">
  52. <a href="../getting-started/integration.html">
  53. Integration
  54. </a>
  55. </li>
  56. <li class="chapter " data-level="1.2.3" data-path="../getting-started/usage.html">
  57. <a href="../getting-started/usage.html">
  58. Usage
  59. </a>
  60. </li>
  61. </ul>
  62. </li>
  63. <li class="chapter " data-level="1.3" data-path="../general/">
  64. <a href="../general/">
  65. General
  66. </a>
  67. <ul class="articles">
  68. <li class="chapter " data-level="1.3.1" data-path="../general/responsive.html">
  69. <a href="../general/responsive.html">
  70. Responsive
  71. </a>
  72. </li>
  73. <li class="chapter " data-level="1.3.2" data-path="../general/device-pixel-ratio.html">
  74. <a href="../general/device-pixel-ratio.html">
  75. Pixel Ratio
  76. </a>
  77. </li>
  78. <li class="chapter " data-level="1.3.3" data-path="../general/interactions/">
  79. <a href="../general/interactions/">
  80. Interactions
  81. </a>
  82. <ul class="articles">
  83. <li class="chapter " data-level="1.3.3.1" data-path="../general/interactions/events.html">
  84. <a href="../general/interactions/events.html">
  85. Events
  86. </a>
  87. </li>
  88. <li class="chapter " data-level="1.3.3.2" data-path="../general/interactions/modes.html">
  89. <a href="../general/interactions/modes.html">
  90. Modes
  91. </a>
  92. </li>
  93. </ul>
  94. </li>
  95. <li class="chapter " data-level="1.3.4" data-path="../general/options.html">
  96. <a href="../general/options.html">
  97. Options
  98. </a>
  99. </li>
  100. <li class="chapter " data-level="1.3.5" data-path="../general/colors.html">
  101. <a href="../general/colors.html">
  102. Colors
  103. </a>
  104. </li>
  105. <li class="chapter " data-level="1.3.6" data-path="../general/fonts.html">
  106. <a href="../general/fonts.html">
  107. Fonts
  108. </a>
  109. </li>
  110. </ul>
  111. </li>
  112. <li class="chapter " data-level="1.4" data-path="../configuration/">
  113. <a href="../configuration/">
  114. Configuration
  115. </a>
  116. <ul class="articles">
  117. <li class="chapter " data-level="1.4.1" data-path="../configuration/animations.html">
  118. <a href="../configuration/animations.html">
  119. Animations
  120. </a>
  121. </li>
  122. <li class="chapter " data-level="1.4.2" data-path="../configuration/layout.html">
  123. <a href="../configuration/layout.html">
  124. Layout
  125. </a>
  126. </li>
  127. <li class="chapter " data-level="1.4.3" data-path="../configuration/legend.html">
  128. <a href="../configuration/legend.html">
  129. Legend
  130. </a>
  131. </li>
  132. <li class="chapter " data-level="1.4.4" data-path="../configuration/title.html">
  133. <a href="../configuration/title.html">
  134. Title
  135. </a>
  136. </li>
  137. <li class="chapter " data-level="1.4.5" data-path="../configuration/tooltip.html">
  138. <a href="../configuration/tooltip.html">
  139. Tooltip
  140. </a>
  141. </li>
  142. <li class="chapter " data-level="1.4.6" data-path="../configuration/elements.html">
  143. <a href="../configuration/elements.html">
  144. Elements
  145. </a>
  146. </li>
  147. </ul>
  148. </li>
  149. <li class="chapter " data-level="1.5" data-path="./">
  150. <a href="./">
  151. Charts
  152. </a>
  153. <ul class="articles">
  154. <li class="chapter " data-level="1.5.1" data-path="line.html">
  155. <a href="line.html">
  156. Line
  157. </a>
  158. </li>
  159. <li class="chapter active" data-level="1.5.2" data-path="bar.html">
  160. <a href="bar.html">
  161. Bar
  162. </a>
  163. </li>
  164. <li class="chapter " data-level="1.5.3" data-path="radar.html">
  165. <a href="radar.html">
  166. Radar
  167. </a>
  168. </li>
  169. <li class="chapter " data-level="1.5.4" data-path="doughnut.html">
  170. <a href="doughnut.html">
  171. Doughnut & Pie
  172. </a>
  173. </li>
  174. <li class="chapter " data-level="1.5.5" data-path="polar.html">
  175. <a href="polar.html">
  176. Polar Area
  177. </a>
  178. </li>
  179. <li class="chapter " data-level="1.5.6" data-path="bubble.html">
  180. <a href="bubble.html">
  181. Bubble
  182. </a>
  183. </li>
  184. <li class="chapter " data-level="1.5.7" data-path="scatter.html">
  185. <a href="scatter.html">
  186. Scatter
  187. </a>
  188. </li>
  189. <li class="chapter " data-level="1.5.8" data-path="area.html">
  190. <a href="area.html">
  191. Area
  192. </a>
  193. </li>
  194. <li class="chapter " data-level="1.5.9" data-path="mixed.html">
  195. <a href="mixed.html">
  196. Mixed
  197. </a>
  198. </li>
  199. </ul>
  200. </li>
  201. <li class="chapter " data-level="1.6" data-path="../axes/">
  202. <a href="../axes/">
  203. Axes
  204. </a>
  205. <ul class="articles">
  206. <li class="chapter " data-level="1.6.1" data-path="../axes/cartesian/">
  207. <a href="../axes/cartesian/">
  208. Cartesian
  209. </a>
  210. <ul class="articles">
  211. <li class="chapter " data-level="1.6.1.1" data-path="../axes/cartesian/category.html">
  212. <a href="../axes/cartesian/category.html">
  213. Category
  214. </a>
  215. </li>
  216. <li class="chapter " data-level="1.6.1.2" data-path="../axes/cartesian/linear.html">
  217. <a href="../axes/cartesian/linear.html">
  218. Linear
  219. </a>
  220. </li>
  221. <li class="chapter " data-level="1.6.1.3" data-path="../axes/cartesian/logarithmic.html">
  222. <a href="../axes/cartesian/logarithmic.html">
  223. Logarithmic
  224. </a>
  225. </li>
  226. <li class="chapter " data-level="1.6.1.4" data-path="../axes/cartesian/time.html">
  227. <a href="../axes/cartesian/time.html">
  228. Time
  229. </a>
  230. </li>
  231. </ul>
  232. </li>
  233. <li class="chapter " data-level="1.6.2" data-path="../axes/radial/">
  234. <a href="../axes/radial/">
  235. Radial
  236. </a>
  237. <ul class="articles">
  238. <li class="chapter " data-level="1.6.2.1" data-path="../axes/radial/linear.html">
  239. <a href="../axes/radial/linear.html">
  240. Linear
  241. </a>
  242. </li>
  243. </ul>
  244. </li>
  245. <li class="chapter " data-level="1.6.3" data-path="../axes/labelling.html">
  246. <a href="../axes/labelling.html">
  247. Labelling
  248. </a>
  249. </li>
  250. <li class="chapter " data-level="1.6.4" data-path="../axes/styling.html">
  251. <a href="../axes/styling.html">
  252. Styling
  253. </a>
  254. </li>
  255. </ul>
  256. </li>
  257. <li class="chapter " data-level="1.7" data-path="../developers/">
  258. <a href="../developers/">
  259. Developers
  260. </a>
  261. <ul class="articles">
  262. <li class="chapter " data-level="1.7.1" data-path="../developers/api.html">
  263. <a href="../developers/api.html">
  264. Chart.js API
  265. </a>
  266. </li>
  267. <li class="chapter " data-level="1.7.2" data-path="../developers/updates.html">
  268. <a href="../developers/updates.html">
  269. Updating Charts
  270. </a>
  271. </li>
  272. <li class="chapter " data-level="1.7.3" data-path="../developers/plugins.html">
  273. <a href="../developers/plugins.html">
  274. Plugins
  275. </a>
  276. </li>
  277. <li class="chapter " data-level="1.7.4" data-path="../developers/charts.html">
  278. <a href="../developers/charts.html">
  279. New Charts
  280. </a>
  281. </li>
  282. <li class="chapter " data-level="1.7.5" data-path="../developers/axes.html">
  283. <a href="../developers/axes.html">
  284. New Axes
  285. </a>
  286. </li>
  287. <li class="chapter " data-level="1.7.6" data-path="../developers/contributing.html">
  288. <a href="../developers/contributing.html">
  289. Contributing
  290. </a>
  291. </li>
  292. </ul>
  293. </li>
  294. <li class="chapter " data-level="1.8" data-path="../notes/">
  295. <a href="../notes/">
  296. Additional Notes
  297. </a>
  298. <ul class="articles">
  299. <li class="chapter " data-level="1.8.1" data-path="../notes/comparison.html">
  300. <a href="../notes/comparison.html">
  301. Comparison Table
  302. </a>
  303. </li>
  304. <li class="chapter " data-level="1.8.2" data-path="../notes/extensions.html">
  305. <a href="../notes/extensions.html">
  306. Popular Extensions
  307. </a>
  308. </li>
  309. <li class="chapter " data-level="1.8.3" data-path="../notes/license.html">
  310. <a href="../notes/license.html">
  311. License
  312. </a>
  313. </li>
  314. </ul>
  315. </li>
  316. <li class="divider"></li>
  317. <li>
  318. <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
  319. Published with GitBook
  320. </a>
  321. </li>
  322. </ul>
  323. </nav>
  324. </div>
  325. <div class="book-body">
  326. <div class="body-inner">
  327. <div class="book-header" role="navigation">
  328. <!-- Title -->
  329. <h1>
  330. <i class="fa fa-circle-o-notch fa-spin"></i>
  331. <a href=".." >Bar</a>
  332. </h1>
  333. </div>
  334. <div class="page-wrapper" tabindex="-1" role="main">
  335. <div class="page-inner">
  336. <div class="search-plus" id="book-search-results">
  337. <div class="search-noresults">
  338. <section class="normal markdown-section">
  339. <h1 id="bar">Bar</h1>
  340. <p>A bar chart provides a way of showing data values represented as vertical bars. It is sometimes used to show trend data, and the comparison of multiple data sets side by side.</p>
  341. <p><div class="chartjs-wrapper"><canvas id="chartjs-1" class="chartjs" width="undefined" height="undefined"></canvas><script>new Chart(document.getElementById("chartjs-1"),{"type":"bar","data":{"labels":["January","February","March","April","May","June","July"],"datasets":[{"label":"My First Dataset","data":[65,59,80,81,56,55,40],"fill":false,"backgroundColor":["rgba(255, 99, 132, 0.2)","rgba(255, 159, 64, 0.2)","rgba(255, 205, 86, 0.2)","rgba(75, 192, 192, 0.2)","rgba(54, 162, 235, 0.2)","rgba(153, 102, 255, 0.2)","rgba(201, 203, 207, 0.2)"],"borderColor":["rgb(255, 99, 132)","rgb(255, 159, 64)","rgb(255, 205, 86)","rgb(75, 192, 192)","rgb(54, 162, 235)","rgb(153, 102, 255)","rgb(201, 203, 207)"],"borderWidth":1}]},"options":{"scales":{"yAxes":[{"ticks":{"beginAtZero":true}}]}}});</script></div></p>
  342. <h2 id="example-usage">Example Usage</h2>
  343. <pre><code class="lang-javascript"><span class="hljs-keyword">var</span> myBarChart = <span class="hljs-keyword">new</span> Chart(ctx, {
  344. type: <span class="hljs-string">&apos;bar&apos;</span>,
  345. data: data,
  346. options: options
  347. });
  348. </code></pre>
  349. <h2 id="dataset-properties">Dataset Properties</h2>
  350. <p>The bar chart allows a number of properties to be specified for each dataset. These are used to set display properties for a specific dataset. For example, the colour of the bars is generally set this way.</p>
  351. <p>Some properties can be specified as an array. If these are set to an array value, the first value applies to the first bar, the second value to the second bar, and so on.</p>
  352. <table>
  353. <thead>
  354. <tr>
  355. <th>Name</th>
  356. <th>Type</th>
  357. <th>Description</th>
  358. </tr>
  359. </thead>
  360. <tbody>
  361. <tr>
  362. <td><code>label</code></td>
  363. <td><code>String</code></td>
  364. <td>The label for the dataset which appears in the legend and tooltips.</td>
  365. </tr>
  366. <tr>
  367. <td><code>xAxisID</code></td>
  368. <td><code>String</code></td>
  369. <td>The ID of the x axis to plot this dataset on. If not specified, this defaults to the ID of the first found x axis</td>
  370. </tr>
  371. <tr>
  372. <td><code>yAxisID</code></td>
  373. <td><code>String</code></td>
  374. <td>The ID of the y axis to plot this dataset on. If not specified, this defaults to the ID of the first found y axis.</td>
  375. </tr>
  376. <tr>
  377. <td><code>backgroundColor</code></td>
  378. <td><code>Color/Color[]</code></td>
  379. <td>The fill color of the bar. See <a href="../general/colors.html#colors">Colors</a></td>
  380. </tr>
  381. <tr>
  382. <td><code>borderColor</code></td>
  383. <td><code>Color/Color[]</code></td>
  384. <td>The color of the bar border. See <a href="../general/colors.html#colors">Colors</a></td>
  385. </tr>
  386. <tr>
  387. <td><code>borderWidth</code></td>
  388. <td><code>Number/Number[]</code></td>
  389. <td>The stroke width of the bar in pixels.</td>
  390. </tr>
  391. <tr>
  392. <td><code>borderSkipped</code></td>
  393. <td><code>String</code></td>
  394. <td>Which edge to skip drawing the border for. <a href="#borderskipped">more...</a></td>
  395. </tr>
  396. <tr>
  397. <td><code>hoverBackgroundColor</code></td>
  398. <td><code>Color/Color[]</code></td>
  399. <td>The fill colour of the bars when hovered.</td>
  400. </tr>
  401. <tr>
  402. <td><code>hoverBorderColor</code></td>
  403. <td><code>Color/Color[]</code></td>
  404. <td>The stroke colour of the bars when hovered.</td>
  405. </tr>
  406. <tr>
  407. <td><code>hoverBorderWidth</code></td>
  408. <td><code>Number/Number[]</code></td>
  409. <td>The stroke width of the bars when hovered.</td>
  410. </tr>
  411. </tbody>
  412. </table>
  413. <h3 id="borderskipped">borderSkipped</h3>
  414. <p>This setting is used to avoid drawing the bar stroke at the base of the fill. In general, this does not need to be changed except when creating chart types that derive from a bar chart.</p>
  415. <p>Options are:</p>
  416. <ul>
  417. <li>&apos;bottom&apos;</li>
  418. <li>&apos;left&apos;</li>
  419. <li>&apos;top&apos;</li>
  420. <li>&apos;right&apos;</li>
  421. </ul>
  422. <h2 id="configuration-options">Configuration Options</h2>
  423. <p>The bar chart defines the following configuration options. These options are merged with the global chart configuration options, <code>Chart.defaults.global</code>, to form the options passed to the chart.</p>
  424. <table>
  425. <thead>
  426. <tr>
  427. <th>Name</th>
  428. <th>Type</th>
  429. <th>Default</th>
  430. <th>Description</th>
  431. </tr>
  432. </thead>
  433. <tbody>
  434. <tr>
  435. <td><code>barPercentage</code></td>
  436. <td><code>Number</code></td>
  437. <td><code>0.9</code></td>
  438. <td>Percent (0-1) of the available width each bar should be within the category width. 1.0 will take the whole category width and put the bars right next to each other. <a href="#barpercentage-vs-categorypercentage">more...</a></td>
  439. </tr>
  440. <tr>
  441. <td><code>categoryPercentage</code></td>
  442. <td><code>Number</code></td>
  443. <td><code>0.8</code></td>
  444. <td>Percent (0-1) of the available width each category should be within the sample width. <a href="#barpercentage-vs-categorypercentage">more...</a></td>
  445. </tr>
  446. <tr>
  447. <td><code>barThickness</code></td>
  448. <td><code>Number</code></td>
  449. <td></td>
  450. <td>Manually set width of each bar in pixels. If not set, the base sample widths are calculated automatically so that they take the full available widths without overlap. Then, the bars are sized using <code>barPercentage</code> and <code>categoryPercentage</code>.</td>
  451. </tr>
  452. <tr>
  453. <td><code>maxBarThickness</code></td>
  454. <td><code>Number</code></td>
  455. <td></td>
  456. <td>Set this to ensure that bars are not sized thicker than this.</td>
  457. </tr>
  458. <tr>
  459. <td><code>gridLines.offsetGridLines</code></td>
  460. <td><code>Boolean</code></td>
  461. <td><code>true</code></td>
  462. <td>If true, the bars for a particular data point fall between the grid lines. The grid line will move to the left by one half of the tick interval. If false, the grid line will go right down the middle of the bars. <a href="#offsetgridlines">more...</a></td>
  463. </tr>
  464. </tbody>
  465. </table>
  466. <h3 id="offsetgridlines">offsetGridLines</h3>
  467. <p>If true, the bars for a particular data point fall between the grid lines. The grid line will move to the left by one half of the tick interval, which is the space between the grid lines. If false, the grid line will go right down the middle of the bars. This is set to true for a bar chart while false for other charts by default.</p>
  468. <p>This setting applies to the axis configuration. If axes are added to the chart, this setting will need to be set for each new axis.</p>
  469. <pre><code class="lang-javascript">options = {
  470. scales: {
  471. xAxes: [{
  472. gridLines: {
  473. offsetGridLines: <span class="hljs-literal">true</span>
  474. }
  475. }]
  476. }
  477. }
  478. </code></pre>
  479. <h2 id="default-options">Default Options</h2>
  480. <p>It is common to want to apply a configuration setting to all created bar charts. The global bar chart settings are stored in <code>Chart.defaults.bar</code>. Changing the global options only affects charts created after the change. Existing charts are not changed.</p>
  481. <h2 id="barpercentage-vs-categorypercentage">barPercentage vs categoryPercentage</h2>
  482. <p>The following shows the relationship between the bar percentage option and the category percentage option.</p>
  483. <pre><code class="lang-text">// categoryPercentage: 1.0
  484. // barPercentage: 1.0
  485. Bar: | 1.0 | 1.0 |
  486. Category: | 1.0 |
  487. Sample: |===========|
  488. // categoryPercentage: 1.0
  489. // barPercentage: 0.5
  490. Bar: |.5| |.5|
  491. Category: | 1.0 |
  492. Sample: |==============|
  493. // categoryPercentage: 0.5
  494. // barPercentage: 1.0
  495. Bar: |1.||1.|
  496. Category: | .5 |
  497. Sample: |==============|
  498. </code></pre>
  499. <h2 id="data-structure">Data Structure</h2>
  500. <p>The <code>data</code> property of a dataset for a bar chart is specified as a an array of numbers. Each point in the data array corresponds to the label at the same index on the x axis.</p>
  501. <pre><code class="lang-javascript">data: [<span class="hljs-number">20</span>, <span class="hljs-number">10</span>]
  502. </code></pre>
  503. <p>You can also specify the dataset as x/y coordinates when using the <a href="../axes/cartesian/time.html#time-cartesian-axis">time scale</a>.</p>
  504. <pre><code class="lang-javascript">data: [{x:<span class="hljs-string">&apos;2016-12-25&apos;</span>, y:<span class="hljs-number">20</span>}, {x:<span class="hljs-string">&apos;2016-12-26&apos;</span>, y:<span class="hljs-number">10</span>}]
  505. </code></pre>
  506. <h1 id="stacked-bar-chart">Stacked Bar Chart</h1>
  507. <p>Bar charts can be configured into stacked bar charts by changing the settings on the X and Y axes to enable stacking. Stacked bar charts can be used to show how one data series is made up of a number of smaller pieces.</p>
  508. <pre><code class="lang-javascript"><span class="hljs-keyword">var</span> stackedBar = <span class="hljs-keyword">new</span> Chart(ctx, {
  509. type: <span class="hljs-string">&apos;bar&apos;</span>,
  510. data: data,
  511. options: {
  512. scales: {
  513. xAxes: [{
  514. stacked: <span class="hljs-literal">true</span>
  515. }],
  516. yAxes: [{
  517. stacked: <span class="hljs-literal">true</span>
  518. }]
  519. }
  520. }
  521. });
  522. </code></pre>
  523. <h2 id="dataset-properties">Dataset Properties</h2>
  524. <p>The following dataset properties are specific to stacked bar charts.</p>
  525. <table>
  526. <thead>
  527. <tr>
  528. <th>Name</th>
  529. <th>Type</th>
  530. <th>Description</th>
  531. </tr>
  532. </thead>
  533. <tbody>
  534. <tr>
  535. <td><code>stack</code></td>
  536. <td><code>String</code></td>
  537. <td>The ID of the group to which this dataset belongs to (when stacked, each group will be a separate stack)</td>
  538. </tr>
  539. </tbody>
  540. </table>
  541. <h1 id="horizontal-bar-chart">Horizontal Bar Chart</h1>
  542. <p>A horizontal bar chart is a variation on a vertical bar chart. It is sometimes used to show trend data, and the comparison of multiple data sets side by side.
  543. <div class="chartjs-wrapper"><canvas id="chartjs-2" class="chartjs" width="undefined" height="undefined"></canvas><script>new Chart(document.getElementById("chartjs-2"),{"type":"horizontalBar","data":{"labels":["January","February","March","April","May","June","July"],"datasets":[{"label":"My First Dataset","data":[65,59,80,81,56,55,40],"fill":false,"backgroundColor":["rgba(255, 99, 132, 0.2)","rgba(255, 159, 64, 0.2)","rgba(255, 205, 86, 0.2)","rgba(75, 192, 192, 0.2)","rgba(54, 162, 235, 0.2)","rgba(153, 102, 255, 0.2)","rgba(201, 203, 207, 0.2)"],"borderColor":["rgb(255, 99, 132)","rgb(255, 159, 64)","rgb(255, 205, 86)","rgb(75, 192, 192)","rgb(54, 162, 235)","rgb(153, 102, 255)","rgb(201, 203, 207)"],"borderWidth":1}]},"options":{"scales":{"xAxes":[{"ticks":{"beginAtZero":true}}]}}});</script></div></p>
  544. <h2 id="example">Example</h2>
  545. <pre><code class="lang-javascript"><span class="hljs-keyword">var</span> myBarChart = <span class="hljs-keyword">new</span> Chart(ctx, {
  546. type: <span class="hljs-string">&apos;horizontalBar&apos;</span>,
  547. data: data,
  548. options: options
  549. });
  550. </code></pre>
  551. <h2 id="config-options">Config Options</h2>
  552. <p>The configuration options for the horizontal bar chart are the same as for the <a href="#configuration-options">bar chart</a>. However, any options specified on the x axis in a bar chart, are applied to the y axis in a horizontal bar chart.</p>
  553. <p>The default horizontal bar configuration is specified in <code>Chart.defaults.horizontalBar</code>.</p>
  554. </section>
  555. </div>
  556. <div class="search-results">
  557. <div class="has-results">
  558. <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
  559. <ul class="search-results-list"></ul>
  560. </div>
  561. <div class="no-results">
  562. <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
  563. </div>
  564. </div>
  565. </div>
  566. </div>
  567. </div>
  568. </div>
  569. <a href="line.html" class="navigation navigation-prev " aria-label="Previous page: Line">
  570. <i class="fa fa-angle-left"></i>
  571. </a>
  572. <a href="radar.html" class="navigation navigation-next " aria-label="Next page: Radar">
  573. <i class="fa fa-angle-right"></i>
  574. </a>
  575. </div>
  576. <script>
  577. var gitbook = gitbook || [];
  578. gitbook.push(function() {
  579. gitbook.page.hasChanged({"page":{"title":"Bar","level":"1.5.2","depth":2,"next":{"title":"Radar","level":"1.5.3","depth":2,"path":"charts/radar.md","ref":"charts/radar.md","articles":[]},"previous":{"title":"Line","level":"1.5.1","depth":2,"path":"charts/line.md","ref":"charts/line.md","articles":[]},"dir":"ltr"},"config":{"plugins":["-lunr","-search","search-plus","anchorjs","chartjs","ga"],"root":"./docs","styles":{"website":"style.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"anchorjs":{"icon":"#","placement":"left","visible":"always"},"ga":{"configuration":"auto","token":"UA-28909194-3"},"theme-default":{"styles":{"website":"style.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"search-plus":{},"chartjs":{"defaults":null},"highlight":{},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2}},"theme":"default","author":"chartjs","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Chart.js documentation","gitbook":"3.2.2"},"file":{"path":"charts/bar.md","mtime":"2018-03-01T21:46:31.675Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2018-03-01T21:50:47.970Z"},"basePath":"..","book":{"language":""}});
  580. });
  581. </script>
  582. </div>
  583. <script src="../gitbook/gitbook.js"></script>
  584. <script src="../gitbook/theme.js"></script>
  585. <script src="../gitbook/gitbook-plugin-search-plus/jquery.mark.min.js"></script>
  586. <script src="../gitbook/gitbook-plugin-search-plus/search.js"></script>
  587. <script src="https://cdnjs.cloudflare.com/ajax/libs/anchor-js/4.1.0/anchor.min.js"></script>
  588. <script src="../gitbook/gitbook-plugin-anchorjs/anchor-style.js"></script>
  589. <script src="../gitbook/gitbook-plugin-ga/plugin.js"></script>
  590. <script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
  591. <script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
  592. </body>
  593. </html>