Skip to content

essboyer/nvd3

This branch is 4 commits ahead of, 1803 commits behind novus/nvd3:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

d4e76b3 · Mar 13, 2014
Aug 14, 2013
Dec 3, 2013
Jun 18, 2013
Mar 13, 2014
Nov 26, 2013
Apr 24, 2013
Apr 24, 2013
Mar 7, 2014
May 23, 2012
Oct 17, 2013
Dec 18, 2013
Dec 30, 2013
Jun 16, 2012
Mar 7, 2014
Mar 13, 2014
Mar 7, 2014
Mar 13, 2014
Oct 16, 2013

Repository files navigation

NVD3 - v1.1.15-beta

Release notes for version 1.1.15 beta

  • Various fixes across the board

Overview

A reusable chart library for d3.js.

NVD3 may change from its current state, but will always try to follow the style of d3.js.

You can also check out the examples page. Note: The examples on nvd3.org are outdated. For examples on how to use the latest NVD3, please checkout the examples/ directory in the repository.


Current development focus

  • Getting documentation up.
  • Unifying common API functions between charts.
  • Bug fixes that come up.

Installation Instructions

d3.v3.js is a dependency of nv.d3.js. Be sure to include in in your project, then: Add a script tag to include nv.d3.js OR nv.d3.min.js in your project. Also add a link to the nv.d3.css file.

See wiki -> Documentation for more detail


If one of the existing models doesn't meet your needs, fork the project, implement the model and an example using it, send us a pull request, for consideration for inclusion in the project.

We cannot honor all pull requests, but we will review all of them.

Please do not aggregate pull requests. Aggregated pull requests are actually more difficult to review.

We are currently changing our branch structure so that master will be gauranteed stable. In addition, there is now a "development" branch. This branch reflects the latest changes to NVD3 and is not necessarily stable.


Minifying your fork:

Using Make

The Makefile requires UglifyJS and CSSMin

The easiest way to install UglifyJS and CSSMin is via npm. Run npm install -g uglify-js cssmin. After installing verify the setup by running uglifyjs --version and cssmin --help.

Once you have the uglifyjs and cssmin commands available, running make from your fork's root directory will rebuild both nv.d3.js and nv.d3.min.js.

make # build nv.d3.js and nv.d3.css and minify
make nv.d3.js # Build nv.d3.js
make nv.d3.min.js # Minify nv.d3.js into nv.d3.min.js
make nv.d3.css # Build nv.d3.css
make nv.d3.min.css # Minify nv.d3.css into nv.d3.min.css
make clean # Delete nv.d3.*js and nv.d3.*css

Without UglifyJS of CSSMin, you won't get the minified versions when running make.*

Using Grunt

You can use grunt instead of makefile to build js file. See more about grunt. Nodejs must be installed before you can use grunt. Run npm install in root dir to install grunt and it's dependencies.

Then, you can use these commands:

grunt # build nv.d3.js
grunt production # build nv.d3.js and nv.d3.min.js
grunt watch # watch file changes in src/, and rebuild nv.d3.js, it's very helpful when delevop NVD3
grunt lint # run jshint on src/**/*.js

**We ask that you DO NOT minify pull requests... If you need to minify please build pull request in separate branch, and merge and minify in your master.

Supported Browsers

NVD3 runs best on WebKit based browsers.

  • Google Chrome: latest version (preferred)
  • Opera 15+ (preferred)
  • Safari: latest version
  • Firefox: latest version
  • Internet Explorer: 9 and 10

Packages

No packages published

Languages

  • JavaScript 98.3%
  • CSS 1.7%