2012-02-21 23:50:41 +01:00
|
|
|
# Morris.js - pretty time-series line graphs
|
|
|
|
|
|
2012-04-02 15:57:15 +02:00
|
|
|
[](http://travis-ci.org/oesmith/morris.js)
|
|
|
|
|
|
2012-02-21 23:50:41 +01:00
|
|
|
Morris.js is the library that powers the graphs on http://howmanyleft.co.uk/.
|
|
|
|
|
|
2012-04-01 23:29:48 +02:00
|
|
|
It's a bit rough around the edges, but it's getting pretty usable now. Expect it to get even better soon.
|
2012-02-21 23:50:41 +01:00
|
|
|
|
|
|
|
|
Cheers!
|
|
|
|
|
|
|
|
|
|
\- Olly
|
|
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
|
|
|
|
|
- [jQuery](http://jquery.com/) (>= 1.7 recommended, but it'll probably work with older versions)
|
|
|
|
|
- [Raphael.js](http://raphaeljs.com/) (>= 2.0)
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
2012-02-26 02:13:19 +01:00
|
|
|
See [the website](http://oesmith.github.com/morris.js/).
|
2012-02-21 23:50:41 +01:00
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
|
|
Very daring.
|
|
|
|
|
|
2012-04-01 23:29:48 +02:00
|
|
|
Fork, hack, possibly even add some tests, then send a pull request :)
|
|
|
|
|
|
|
|
|
|
Tests use [qunit](http://docs.jquery.com/QUnit), and are in `test.html`.
|
2012-02-26 02:13:19 +01:00
|
|
|
|
2012-02-28 23:29:33 +01:00
|
|
|
## Changelog
|
|
|
|
|
|
2012-05-10 08:41:53 +02:00
|
|
|
### 0.2.8 - 10th May 2012
|
|
|
|
|
|
|
|
|
|
- Customising x-axis labels with `xLabelFormat` option
|
|
|
|
|
- Only use timezones when timezone info is specified
|
|
|
|
|
- Fix old IE bugs (mostly in examples!)
|
|
|
|
|
- Added `preunits` and `postunits` options
|
|
|
|
|
- Better non-continuous series data support
|
|
|
|
|
|
2012-04-02 22:30:02 +02:00
|
|
|
### 0.2.7 - 2nd April 2012
|
2012-04-01 23:29:48 +02:00
|
|
|
|
2012-04-02 22:30:02 +02:00
|
|
|
- Added `xLabels` option
|
2012-04-01 23:29:48 +02:00
|
|
|
- Refactored x-axis labelling
|
|
|
|
|
- Better ISO date support
|
|
|
|
|
- Fix bug with single value in non time-series graphs
|
|
|
|
|
|
2012-03-18 21:43:58 +01:00
|
|
|
### 0.2.6 - 18th March 2012
|
|
|
|
|
|
|
|
|
|
- Partial series support (see `null` y-values in `examples/quarters.html`)
|
|
|
|
|
- `parseTime` option bugfix for non-time-series data
|
|
|
|
|
|
2012-03-15 22:48:03 +01:00
|
|
|
### 0.2.5 - 15th March 2012
|
|
|
|
|
|
|
|
|
|
- Raw millisecond timestamp support (with `dateFormat` option)
|
|
|
|
|
- YYYY-MM-DD HH:MM[:SS[.SSS]] date support
|
|
|
|
|
- Decimal number labels
|
|
|
|
|
|
2012-03-08 22:04:12 +01:00
|
|
|
### 0.2.4 - 8th March 2012
|
|
|
|
|
|
|
|
|
|
- Negative y-values support
|
|
|
|
|
- `ymin` option
|
|
|
|
|
- `units` options
|
|
|
|
|
|
2012-03-06 23:13:18 +01:00
|
|
|
### 0.2.3 - 6th Mar 2012
|
|
|
|
|
|
|
|
|
|
- jQuery no-conflict compatibility
|
|
|
|
|
- Support ISO week-number dates
|
2012-03-08 22:04:12 +01:00
|
|
|
- Optionally hide hover on mouseout (`hideHover`)
|
|
|
|
|
- Optionally skip parsing dates, treating X values as an equally-spaced series (`parseTime`)
|
2012-03-06 23:13:18 +01:00
|
|
|
|
2012-02-29 22:10:48 +01:00
|
|
|
### 0.2.2 - 29th Feb 2012
|
|
|
|
|
|
|
|
|
|
- Bugfix: mouseover error when options.data.length == 2
|
|
|
|
|
- Automatically sort options.data
|
|
|
|
|
|
2012-02-28 23:29:33 +01:00
|
|
|
### 0.2.1 - 28th Feb 2012
|
|
|
|
|
|
|
|
|
|
- Accept a DOM element *or* an ID in `options.element`
|
|
|
|
|
- Add `smooth` option
|
|
|
|
|
- Bugfix: clone `@default`
|
|
|
|
|
- Add `ymax` option
|
|
|
|
|
|
2012-02-26 02:13:19 +01:00
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
Copyright (c) 2012, Olly Smith
|
|
|
|
|
All rights reserved.
|
|
|
|
|
|
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
|
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
|
|
|
|
|
|
1. Redistributions of source code must retain the above copyright notice, this
|
|
|
|
|
list of conditions and the following disclaimer.
|
|
|
|
|
2. Redistributions in binary form must reproduce the above copyright notice,
|
|
|
|
|
this list of conditions and the following disclaimer in the documentation
|
|
|
|
|
and/or other materials provided with the distribution.
|
|
|
|
|
|
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
|
|
|
|
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
|
|
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
|
|
|
|
|
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
|
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
|
|
|
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
|
|
|
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
|
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
|
|
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
