README

Morris.js 是为 http://howmanyleft.co.uk/ 上的图表提供动力的库。它是一个用于绘制线形、柱形、区域和饼图的简单 API。

感谢！

- Olly (olly@oesmith.co.uk)

寻求贡献者

遗憾的是，我无法再积极支持 Morris.js。我关注着问题，但很少有时间修复错误或审查拉取请求。

如果您有兴趣积极为 Morris.js 贡献，请通过上面的电子邮件地址与我联系。

要求

• jQuery (>= 1.7 建议使用，但可能也与较旧版本兼容)
• Raphael.js (>= 2.0)

用法

见 网站。

开发

非常大胆。

分叉、修改，甚至添加一些测试，然后发送拉取请求 :)

请记住，Morris.js 是一个 CoffeeScript 项目。请在项目的根目录中的 .coffee 文件中进行更改，而不是在编译后的 JavaScript 文件中进行更改。

开发者快速入门

您需要 node.js。我建议在开发环境中使用 nvm 安装 node。

安装 node 后，使用 npm install -g grunt-cli 安装 grunt，然后在 morris.js 项目文件夹中使用 npm install 安装其他测试/构建依赖项。

此外，还需要 bower 来检索其他测试依赖项。
使用 npm install -g bower 安装它，然后在 morris 项目文件夹中运行 bower install。

设置完成后，您可以使用 grunt 编译、压缩并运行测试。

注意：我在尝试使用感知差异来捕获渲染回归。由于不同平台之间的字体渲染差异，pdiff 测试目前仅在 OS X 上通过。

变更日志

0.5.1 - 2014年6月15日

• 修复触摸事件处理。
• 修复柱形图中 stacked=false 的错误 #275
• 可配置的垂直段 #297
• 弃用 continuousLine 选项。

0.5.0 - 2014年3月19日

• 更新 grunt 依赖关系 #288
• 数据对象中的甜甜圈段颜色配置 #281
• 可自定义线宽和点绘制 #272
• 修复 @options.smooth 的错误 #266
• 可单独禁用坐标轴的选项 #253
• 范围选择 #252
• 用于 x 标签的周格式 #250
• 更新开发者快速入门说明 #243
• 感知差异实验。
• 将原始数据行添加到 hover 回调中 #264
• 甜甜圈图的 setData 方法 #211
• 自动调整大小 #111
• 修复 travis 构建问题 #298
• 条形图圆角选项 #305
• 设置 X 轴标签的填充选项 #306
• 使用本地 JavaScript 代码示例。
• 非时间序列事件 #314

0.4.3 - 2013年5月12日

• 修复闪烁的悬停框 #186
• xLabelAngle 选项（对角标签！） #239
• 修复区域图填充错误 #190
• 使事件处理器可链式调用
• gridTextFamily 和 gridTextWeight 选项
• 修复 setData 时的悬停 #213
• 修复 hideHover 的行为 #236

0.4.2 - 2013年4月14日

• 修复 DST 处理 #191
• 从 Morris.Donut 中的字符串解析数据值 #189
• 非累积区域图 #199
• 将 Y 轴标签四舍五入到有效数字 #162
• 自定义默认悬停内容 #179

0.4.1 - 2013年2月8日

• 修复目标和事件渲染。 #181
• 当向 setData 传递空数据时不崩溃 #142
• 甜甜圈的 labelColor 选项 #159

0.4.0 - 2013年1月26日

• 目标和事件 #103。
• Bower 包管理器元数据。
• 更灵活的格式化程序 #107。
• 颜色回调。
• 时间轴标签的十年间隔。
• 非连续线调整 #116。
• 堆叠条形图 #120。
• HTML 悬停 #134。
• Y轴标签格式 #139.
• 禁用坐标轴 #114.

0.3.3 - 2012年11月1日

• 条形图！ #101.

0.3.2 - 2012年10月28日

• 面积图！ #47.
• 一些主要的重构和测试套件改进。
• 按系列设置平滑参数 #91.
• 自定义字符串x值的日期格式 #90.

0.3.1 - 2012年10月13日

• 为甜甜圈添加 formatter 选项以自定义值标签 #75.
• 在折线图中循环 lineColors 以避免颜色耗尽 #78.
• 添加选择甜甜圈段的方法。 #79.
• 当所有y值都是零时，yMin不要为负。 #80.
• 当parseTime为false时不要排序数据 #83.
• 自定义点的样式。 #87.

0.3.0 - 2012年9月15日

• 甜甜圈图！
• 错误修复：ymin/ymax错误 #71.
• 错误修复：当数据指示水平线时的无限循环 #66.

0.2.10 - 2012年6月26日

• 支持y轴上的十进制标签 #58.
• 更好的坐标轴标签裁剪 #63.
• 使用 setData 方法使用更新后的数据重新绘制图表 #64.
• 错误修复：具有零个或一个非空值的系列 #65.

0.2.9 - 2012年5月15日

• 错误修复：修复零值回归
• 错误修复：不要修改用户提供的数据

0.2.8 - 2012年5月10日

• 使用 xLabelFormat 选项自定义x轴标签
• 仅在指定时区信息时使用时区
• 修复旧IE浏览器中的错误（主要在示例中！）
• 添加 preunits 和 postunits 选项
• 更好的非连续系列数据支持

0.2.7 - 2012年4月2日

• 添加 xLabels 选项
• 重构x轴标签
• 更好的ISO日期支持
• 修复非时间序列图表中单个值的错误

0.2.6 - 2012年3月18日

• 部分系列支持（请参阅 examples/quarters.html 中的 null y值）
• parseTime 选项的错误修复，用于非时间序列数据

0.2.5 - 2012年3月15日

• 支持原始毫秒时间戳（带有 dateFormat 选项）
• 支持 YYYY-MM-DD HH:MM[:SS[.SSS]] 日期格式
• 支持十进制数字标签

0.2.4 - 2012年3月8日

• 支持负的 y 值
• ymin 选项
• units 选项

0.2.3 - 2012年3月6日

• 支持 jQuery 无冲突兼容性
• 支持 ISO 周数日期
• 可选隐藏鼠标移出时的悬停效果（hideHover）
• 可选跳过日期解析，将 X 值作为等间距序列处理（parseTime）

0.2.2 - 2012年2月29日

• 错误修复：当 options.data.length == 2 时鼠标悬停错误
• 自动排序 options.data

0.2.1 - 2012年2月28日

• 在 options.element 中接受 DOM 元素 或 ID
• 添加 smooth 选项
• 错误修复：克隆 @default
• 添加 ymax 选项

许可协议

版权所有（c）2012-2014，Olly Smith。保留所有权利。

在满足以下条件的情况下，允许重新分发和使用源代码和二进制形式，是否修改不限：

1. 源代码重新分发必须保留上述版权声明、本条件列表和以下免责声明。
2. 二进制形式重新分发必须在文档和/或其他与分发提供的材料中复制上述版权声明、本条件列表和以下免责声明。

本软件由版权所有者和贡献者提供“现状”并明确或暗示地放弃任何明示或暗示的保证，包括但不限于对适销性和特定目的适用性的暗示保证。在任何情况下，版权所有者或贡献者不应对任何直接、间接、偶然、特殊、示范性或后果性损害（包括但不限于替代商品或服务的采购；使用、数据或利润的损失；或业务中断）承担责任，无论此类损害是否因使用本软件引起，即使已被告知此类损害的可能性。