Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

ember-charts

Addepar106BSD-3-Clause3.0.2

A powerful and easy to use charting library for Ember.js.

ember-addon

readme

Ember Charts Build Status

A charting library built with the Ember.js and d3.js frameworks. It includes time series, bar, pie, and scatter charts which are easy to extend and modify. The out-of-the-box behavior these chart components represents our thoughts on best practices in chart interactivity and presentation.

Demo and Documentation

https://opensource.addepar.com/ember-charts/

Getting Started

JS Bin Starter Kit

https://emberjs.jsbin.com/rekawobugu/1/edit

Unfortunately, this version of Ember Charts is out of date, and the current maintainers of Ember Charts at Addepar have not been able to update it recently.

Ember Charts is an Ember CLI addon published to the public NPM repository at https://www.npmjs.com/package/ember-charts , so it can be installed like so:

# ember-cli >= 0.2.0
ember install:addon ember-charts

# ember-cli >= 0.2.3
ember install ember-charts

Once it's installed, you can customize the look of Ember Charts with CSS.

Installation with Bower (Globals-Based Version)

npm install -g bower      # install Bower
bower install ember-charts --save

Using Ember Charts with bower is deprecated and will eventually be removed. We recommend that you migrate your apps to Ember CLI! Documentation has been updated to show Ember CLI usage. If you need documentation for globals-based use, please check out version 0.5.0 of Ember Charts and follow the setup instructions under "Running Old Versions" to display the old guides.

Developing or Testing

After cloning this repo, install dependencies and run the demo application:

yarn
bower install
ember serve

Now you can:

Dependencies

  • ember
  • lodash
  • d3
  • jquery-ui

Browser Support

We aim to support the last two major versions of every common browser.

If you need to support further browsers, we welcome pull requests with fixes.

Touch support may work but has not been tested.

Contributing

Got something to add? Great! Bug reports, feature ideas, and (especially) pull requests are extremely helpful, and this project wouldn't be where it is today without lots of help from the community.

Please read the contribution guidelines for directions on opening issues and working on the project.

Versioning

Ember Charts uses Semantic Versioning to keep track of releases using the following format:

<major>.<minor>.<patch>

In a nutshell, this means:

  • Breaking changes to the API or behavior increases the major version
  • Adding functionality in a backwards-compatible way increases the minor version
  • Making backwards-compatible bug fixes increases the patch version

Releasing a New Version (For Maintainers)

Prior to releasing, ensure that the CHANGELOG.md is updated to track any changes that have been made since the prior release.

We increment version numbers and release using release-it:

npm run release -- <options>

The local configuration file for release-it is named .release-it.json, found in the root directory of the repository.

By default, release-it without options will increment the <patch> version number (X.Y.Z --> X.Y.(Z+1)) in the VERSION file and package.json file, and then commit the resulting changes to the ember-charts git repository.

If you want to control the version number, use these options:

npm run release -- major # 1.2.3 -> 2.0.0
npm run release -- minor # 1.2.3 -> 1.3.0
npm run release -- X.Y.Z # 1.2.3 -> X.Y.Z

Ember Charts has also configured release-it to automatically update the gh-pages branch (from which the demo and documentation website is published). This is done by pushing the /ember-dist/ directory after constructing it with ember build. These commands can be seen in the .release-it.json file.

release-it is also configured to automatically publish the updated version to npm.

Lastly, the new version should be released on Github, which can be done via the Github UI after the steps above are complete.

Copyright © 2013 Addepar, Inc. All Rights Reserved

Licensed under the BSD License (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE.md file.

changelog

Ember Charts Changelog

Ember Charts 1.2.2 (October 24, 2018)

Fixes minor bugs and implements some minor security improvements throughout the repository.

  • Updates lodash dependency to v4.17.4
  • Fixes a minor bug for horizontal bar charts where the width could be set to a negative value in certain edge cases, causing issues (#217)
  • Fixes a minor bug with chart colors in which the chart would not be able to parse an RGB color passed in by the user
  • Changes links in README, config files, and dummy app to use HTTPS instead of HTTP, and removes usages of target="_BLANK" in dummy app to remove security vulnerability (#223)

Ember Charts 1.2.1 (March 16, 2017)

Minor documentation updates and small bugfixes:

  • Updates documentation for installing and maintaining ember-charts (#192, #201)
  • Removes grunt dependencies and grunt-generated global dist files that were necessary prior to the Ember-CLI upgrade, and updates the documentation accordingly (#201)
  • Fixes a bug where labels in line series charts could be off by one day (#198)
  • Prevent modifying attributes during the render cycle (#189, improves #155)

Ember Charts 1.2.0 (October 28, 2016)

Most important: A number of reflected cross-site scripting (XSS) vulnerabilities were fixed (1050884d5bc17658f017666fbca15605481661ad, #177, #178). Our sincerest apologies for these. If you have further concerns about the security of Ember-Charts or other Addepar software, always feel free to send email to [security at addepar dot com].

Second most important: A new Stacked Vertical Bar chart (#171) has been added! It works a little differently from the partial bar stacking feature of Vertical Bar charts, which is now deprecated. Please consult the documentation of this feature and the demo application to learn more.

Finally, some bug fixes and smaller features:

  • In Horizontal Bar charts: When the chart is interactive (allows ToolTips on mouse hover), the chart width now adjusts for the presence of a scrollbar (#190)
  • In Scatter charts: The chart height now honors the bottom margin setting for the chart (#188)
  • In Time Series charts:
    • Minor ticks will no longer be drawn with overlapping labels when the chart is made narrow enough to hide the labels and then made wider again (#176)
    • If the heuristically computed interval between bars is different from the interval you selected, then the bars will now be drawn in the correct place even if you also specify a bar offset (#185)
  • In Pie charts:
    • The Other slice width is no longer incorrectly rounded to 0% (#181)
    • There is now a includeRoundedZeroPercentSlices boolean property to toggle whether or not to show 0% width slices (#181)
  • In (unstacked) Vertical Bar charts:
    • When you mouse-hover over a stacking slice in a stacked chart (stacked using the deprecated old functionality) with only one bar, the legend ToolTip no longer shows "undefined: NaN"; fixes bug #167 (#171)
    • Per-bar color overrides are once again respected; this was regressed by 1.1.0 change #173 (#182)
    • For charts without bar groups, we once again respect sortKey: "value" in order to sort bars by value; this was regressed by 0.5.0 change #81 (#183)

Ember Charts 1.1.0 (August 9, 2016)

A major update with a ton of goodies for Time Series charts (#169)!

  • Minor ticks for Time Series charts have been fixed!
  • Label rotation is now available for greater label density
  • Custom interval specific filters can be added to your time series labeling implementation (#154)
  • Label filtering has been improved:

    • Now removes based on modulus to maintain consistent and coherent label spacing
    • Dynamic Labels option has been optimized with many of the iterators and loops replaced with MATH and computed properties
    • Dynamic labeling used to pick an interval that was more specific than the one that fits the graph

    Plus extra bug fixes and smaller features:

  • Incorrect wording in the documentation was fixed (#153, #170)

  • Fixed color on Scatter chart legend (#152)
  • Allow configuring whether to add margin padding to Scatter charts with the new hasXDomainPadding and hasYDomainPadding boolean properties (#150)
  • Pie Chart Decimal Point Formatting (#158)
  • Pie Chart Label Intersect Improvement (#159, #162)
  • Mismatched Node type would throw exceptions (#168)
  • Vertical Bar charts no longer incorrectly color their bars when their input data do not have the same number of bar data points for all bar groups; fixes bug #172 (#173)
  • The wrong bars were being highlighted on legend mouse hover in Vertical Bar charts; fixes bug #172 (#173)

Ember Charts 1.0.0 (November 4, 2015)

The first version of Ember Charts in the npm repository! Now Ember-CLI can download the modules-based version from the npm repo. Otherwise identical to 0.5.1.

Ember Charts 0.5.1 (November 3, 2015)

Minor update

  • Allow setting tick spacing for X and Y axes separately instead of one common value. It is backward compatible. (#113)

Ember Charts 0.5.0 (October 29, 2015)

This release ports all CoffeeScript to JavaScript and moves our build to use Ember-CLI, bringing support for Ember 1.9 and 1.10.

Also:

  • Modules-based rather than globals-based usage
  • Documentation updates; thanks Okal (#78)
  • In grouped Vertical Bar charts, bars within a group are now sorted alphabetically by their bar label (#81) -- NOTE: this caused a regression for ungrouped charts fixed in 1.2.0 (#183)
  • All charts that support sorting their data (have a sortKey property) now can sort ascending or descending with a sortAscending boolean property (#83, #84)
  • The placement of ticks in Time Series charts now adjusts when you resize the chart (#85)
  • We removed padding from charts that did not need it (#87, #91)
  • The hover ToolTip is now shown on the Other slice of Pie charts (14761a713c198d5d1dc8ae9f8168d488ad3537b1)
  • Pie charts now have a showLegend boolean property to toggle their legend (#92, #93)
  • Added heuristics to better choose appropriate X-axis tick spacing and labels for Time Series charts (#96)
  • Some improvements to the bar stacking in Vertical Bar charts (#98, #99); NOTE: this functionality has been deprecated by #171
  • Fixes Pie chart labels that were truncating even though there was ample whitespace

Ember Charts 0.4.0 (February 18, 2015)

This will be the last ember-charts release to support Ember 1.8 and earlier compiled templates. See #77 for more information on our upgrade process.

  • Arbitrary keys are now supported for sorting pie and bar charts
  • Custom label format strings are now supported for pie, bar, and time series charts
  • Hours are now a supported option for selectedInterval in time series charts
  • Numerous bugfixes and enhancements to pie charts
    • Margins no longer are larger than they need to be for labels and legends
    • Labels in pie charts can no longer overlap each other
    • A minimum margin option is now available for pie charts
  • Other Bugfixes
    • Time series charts now rerender after data loads
    • Observers are torn down to fix application memory leaks
    • Hours and days now respect maxNumberOfLabels setting in time series charts
  • Demo App and Documentation updated

Ember Charts 0.3.0 (October 23, 2014)

  • Make the group optional when building a tooltip
  • Fix code style in chart functions for clarity
  • Implement sort-by-value on vertical bar charts
  • Allow axis labels on time series charts to be centered
  • Fix bug Assertion failed: Expected hash or Mixin instance
  • Implement more useful value labeling
  • Refactor time series charts API
    • Remove stacked bar option
    • Add left bar offset
    • General refactoring and documentation
  • Add Lo-Dash dependency to overview page
  • Fix example app compilation dependencies
  • Remove deprecation warning for this.state

Ember Charts 0.2.0 (July 21, 2014)

  • New README.md, CONTRIBUTING.md, and JS Bin example
  • Add addepar-mixins as a part of charts
  • Add bower install for external dependencies

Ember Charts 0.1.0 (June 20, 2014)

  • Initial release