flot中文参考

Flot Reference
flot参考文档
--------------

Consider a call to the plot function:
下面是对绘图函数plot的调用：

var plot = $.plot(placeholder, data, options)

The placeholder is a jQuery object or DOM element or jQuery expression
that the plot will be put into. This placeholder needs to have its
width and height set as explained in the README (go read that now if
you haven't, it's short). The plot will modify some properties of the
placeholder so it's recommended you simply pass in a div that you
don't use for anything else. Make sure you check any fancy styling
you apply to the div, e.g. background images have been reported to be a
problem on IE 7.

占位符placeholder是一个jQuery对象或者DOM元素或者jQuery表单式，绘图函数将把
图表画在placeholder内。

这个占位符需要设置高宽(这在README文档里面已经介绍过，如果你还没有阅读过现在
就去阅读吧，文档很短)。
plot函数画图时将修改这个占位符的内容，因此你最好使用一个空的DIV元素作为占位符，
另外注意不要给占位符

设置花哨的样式，比如，在IE7.0下，给占位符设置背景图将会出错。

The format of the data is documented below, as is the available
options. The "plot" object returned has some methods you can call.
These are documented separately below.

函数可以使用的数据格式会在后面说明，plot返回对象有一些方法可供调用，在后面会分开
介绍。

Note that in general Flot gives no guarantees if you change any of the
objects you pass in to the plot function or get out of it since
they're not necessarily deep-copied.

另外请注意，flot不保证plot函数内的对象被修改或删除后仍然能正常工作(废话)。

Data Format
数据格式
-----------

The data is an array of data series:
flot的数据是一个数列数组(plot函数中的data参数:每条曲线一个data项参数，绘制多条曲
线时，是一个数组，每个数组元素是一条曲线的data项参数)：

[ series1, series2, ... ]

A series can either be raw data or an object with properties. The raw
data format is an array of points:

数列可以是原始数据，也可以是数据对象，原始数据格式是由一组表示数据点的坐标值的数
组构成：

[ [x1, y1], [x2, y2], ... ]

E.g.

[ [1, 3], [2, 14.01], [3.5, 3.14] ]

Note that to simplify the internal logic in Flot both the x and y
values must be numbers (even if specifying time series, see below for
how to do this). This is a common problem because you might retrieve
data from the database and serialize them directly to JSON without
noticing the wrong type. If you're getting mysterious errors, double
check that you're inputting numbers and not strings.

请注意，flot的纵横坐标值都必须是数字(即使用时间数列也是，后面会介绍到)，
这是个很常见的错误，因为你很可能从数据库获取数据后没有检查数据类型就直接转化成
json对象使用。

如果你觉得遇到了莫名其妙的错误，请确认一下你输入的是数字而不是字符串。

If a null is specified as a point or if one of the coordinates is null
or couldn't be converted to a number, the point is ignored when
drawing. As a special case, a null value for lines is interpreted as a
line segment end, i.e. the points before and after the null value are
not connected.

如果坐标为值为空 ,或者其中的一个坐标值为空，或者不是数字，或者说不能转换为数字，
那么这个节点将被忽略，

并且该节点前后的2个节点之间不会使用直线来连接。

Lines and points take two coordinates. For bars, you can specify a
third coordinate which is the bottom of the bar (defaults to 0).

折线图和散点图每个节点有2个参数，直方图则有3个参数，第三个参数来指定直方图的
底部位置(缺省值是0)。

The format of a single series object is as follows:

单个图表对象的数据格式参数如下所示：

{
color: color or number //颜色
data: rawdata //数据
label: string //曲线名称
lines: specific lines options //折线图坐标参数
bars: specific bars options //直方图坐标参数
points: specific points options //散点图坐标参数
xaxis: 1 or 2 //使用哪一条X轴，如果某条数轴没有被任何一条曲线使用，该数轴不会
在图表上出现

yaxis: 1 or 2 //使用哪一条Y轴
clickable: boolean //允许监听鼠标点击事件
hoverable: boolean //允许监听鼠标悬停事件
shadowSize: number //曲线阴影
}

You don't have to specify any of them except the data, the rest are
options that will get default values. Typically you'd only specify
label and data, like this:

一般情况下你无须设置每一个参数， 你只需要设置其中几个特定的参数即可，其他参数会
使用默认值。例如：

{
label: "y = 3",
data: [[0, 3], [10, 3]]
}

The label is used for the legend, if you don't specify one, the series
will not show up in the legend.

label用于指定曲线名称，如果没有设置label的值，图表标题区域不会出现。

If you don't specify color, the series will get a color from the
auto-generated colors. The color is either a CSS color specification
(like "rgb(255, 100, 123)") or an integer that specifies which of
auto-generated colors to select, e.g. 0 will get color no. 0, etc.