概览
直方图是一种将数值数据分箱的图表,可将分箱显示为细分列。它们用于描述数据集的分布:值落入范围的频率。
Google 图表会自动选择箱数。所有分箱的宽度相同,并且高度与箱中数据点的数量成比例。在其他方面,直方图与柱形图类似。
示例
下面是恐龙身长的直方图:
直方图会显示最常见的小于 10 米的垃圾桶,而超过 40 米的恐龙只有一种。我们可以将光标悬停在此柱上,发现它就是 Seismosaurus(这只是一头非常庞大的文凭;古生物学家不确定)。
生成此直方图的代码如下所示。定义数据(此处使用 google.visualization.arrayToDataTable
)后,可通过调用 google.visualization.Histogram
来定义图表,并使用 draw
方法进行绘制。
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load("current", {packages:["corechart"]}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Dinosaur', 'Length'], ['Acrocanthosaurus (top-spined lizard)', 12.2], ['Albertosaurus (Alberta lizard)', 9.1], ['Allosaurus (other lizard)', 12.2], ['Apatosaurus (deceptive lizard)', 22.9], ['Archaeopteryx (ancient wing)', 0.9], ['Argentinosaurus (Argentina lizard)', 36.6], ['Baryonyx (heavy claws)', 9.1], ['Brachiosaurus (arm lizard)', 30.5], ['Ceratosaurus (horned lizard)', 6.1], ['Coelophysis (hollow form)', 2.7], ['Compsognathus (elegant jaw)', 0.9], ['Deinonychus (terrible claw)', 2.7], ['Diplodocus (double beam)', 27.1], ['Dromicelomimus (emu mimic)', 3.4], ['Gallimimus (fowl mimic)', 5.5], ['Mamenchisaurus (Mamenchi lizard)', 21.0], ['Megalosaurus (big lizard)', 7.9], ['Microvenator (small hunter)', 1.2], ['Ornithomimus (bird mimic)', 4.6], ['Oviraptor (egg robber)', 1.5], ['Plateosaurus (flat lizard)', 7.9], ['Sauronithoides (narrow-clawed lizard)', 2.0], ['Seismosaurus (tremor lizard)', 45.7], ['Spinosaurus (spiny lizard)', 12.2], ['Supersaurus (super lizard)', 30.5], ['Tyrannosaurus (tyrant lizard)', 15.2], ['Ultrasaurus (ultra lizard)', 30.5], ['Velociraptor (swift robber)', 1.8]]); var options = { title: 'Lengths of dinosaurs, in meters', legend: { position: 'none' }, }; var chart = new google.visualization.Histogram(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
可以省略标签(这里是恐龙名称),在这种情况下,提示将仅显示数值。
控制颜色
下面是民族人口的直方图:
有超过 200 个国家/地区的人口不到 1 亿,之后则呈现严峻尾声。
此直方图使用 colors
选项以绿色绘制数据:
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['green'], };
与所有 Google 图表一样,颜色可以指定为英文名称或十六进制值。
控制存储分区
默认情况下,Google 图表将使用知名的直方图算法自动选择范围大小。不过,有时您可能需要替换该行为,上面的图表便是示例。第一个存储分区中的国家/地区太多了,很难对其他国家/地区进行检查。
对于此类情况,直方图提供了两个选项:histogram.bucketSize
(用于替换算法并对存储分区大小进行硬编码)和 histogram.lastBucketPercentile
。第二个选项需要更多说明:它会更改存储分区大小的计算,以忽略高于或低于指定值(以您指定的百分比为准)的值。这些值仍包含在直方图中,但不会影响其分桶方式。如果您不希望离群值归入自己的存储分区中,系统会改用第一个或最后一个存储分区对离群值进行分组。
在上图中,我们在计算存储分区大小时忽略了前五个值和后五个值。这些值仍会绘制图表;唯一的变化是存储分区大小,但这样做会让直方图更具可读性。
此示例还展示了如何更改纵轴的缩放比例以使用“镜像日志”缩放比例,这在绘制具有长小值长尾的数据图表时也有所帮助。
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['#e7711c'], histogram: { lastBucketPercentile: 5 }, vAxis: { scaleType: 'mirrorLog' } };
如您所见,如果将计算结果的顶部和底部百分之五移除,得到的存储分区大小将为 10000000,否则为 100000000。如果您一直知道 10,000,000 的存储分区大小符合您的需求,那么您可以使用 histogram.bucketSize
来实现此目的:
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['#e7711c'], histogram: { bucketSize: 10000000 } };
在以下示例中,我们展示了如何扩大存储分区的范围,并显示更多存储分区,并且它们之间没有间隙。maxNumBuckets
选项可用于增加默认桶数。histogram.minValue
和 histogram.maxValue
选项将扩大存储分区的范围,但请注意,如果存在超出此范围的数据,这些选项不会缩小此范围。
此示例还表明,您可以使用 hAxis
的显式 ticks
选项指定要为每个存储分区显示的刻度线。这不会影响分区本身,只会影响 tick 的显示方式。
另请注意,我们指定了 chartArea.width
,因此,在没有视觉伪影的情况下,存储分区的数量会更加准确。以下是此示例的选项。
var options = { title: 'Approximating Normal Distribution', legend: { position: 'none' }, colors: ['#4285F4'], chartArea: { width: 405 }, hAxis: { ticks: [-1, -0.75, -0.5, -0.25, 0, 0.25, 0.5, 0.75, 1] }, bar: { gap: 0 }, histogram: { bucketSize: 0.01, maxNumBuckets: 400, minValue: -1, maxValue: 1 } };
多系列图书
下面是根据标准模型得出的子原子粒子费用直方图:
上图有一个系列,其中包含所有粒子。子原子粒子可以分为四组:夸克、量子和玻色子。我们将每个集合视为自己的系列:
在此图表中,我们针对四种类型的子原子粒子分别使用不同的系列(因此也使用了颜色)。我们将 interpolateNulls
明确设置为 false
,以确保不会绘制 null 值(因为序列长度不等需要)。我们还设置了 legend.maxLines
,以向图例再添加一行代码:
var data = google.visualization.arrayToDataTable([ ['Quarks', 'Leptons', 'Gauge Bosons', 'Scalar Bosons'], [2/3, -1, 0, 0], [2/3, -1, 0, null], [2/3, -1, 0, null], [-1/3, 0, 1, null], [-1/3, 0, -1, null], [-1/3, 0, null, null], [-1/3, 0, null, null] ]); var options = { title: 'Charges of subatomic particles', legend: { position: 'top', maxLines: 2 }, colors: ['#5C3292', '#1A8763', '#871B47', '#999999'], interpolateNulls: false, };
正在加载
google.charts.load
软件包名称为 "corechart"
。
google.charts.load("current", {packages: ["corechart"]});
可视化图表的类名称为 google.visualization.Histogram
:
var visualization = new google.visualization.Histogram(container);
数据格式
填充直方图数据表的方法有两种。如果只有一个系列:
var data = google.visualization.arrayToDataTable([ ['Name', 'Number'], ['Name 1', number1], ['Name 2', number2], ['Name 3', number3], ... ]);
...当有多个系列时:
var data = google.visualization.arrayToDataTable([ ['Series Name 1', 'Series Name 2', 'Series Name 3', ...], [series1_number1, series2_number1, series3_number1, ...], [series1_number2, series2_number2, series3_number2, ...], [series1_number3, series2_number3, series3_number3, ...], ... ]);
目前,直方图不支持可选列角色。
配置选项
名称 | |
---|---|
动画时长 |
动画的时长(以毫秒为单位)。如需了解详情,请参阅动画文档。 类型:数字
默认:0
|
动画缓和 |
已应用于动画的加/减速函数。提供的选项如下:
类型:字符串
默认:“线性”
|
animation.startup |
确定图表是否会在初始绘制时以动画形式呈现。如果为 类型:布尔值
默认 false
|
坐标轴位置 |
相较于图表区域,轴标题的放置位置。支持的值:
类型:字符串
默认:使用“out”
|
backgroundColor |
图表主区域的背景颜色。可以是简单的 HTML 颜色字符串(例如 类型:字符串或对象
默认:“白色”
|
backgroundColor.stroke 中 |
图表边框的颜色,采用 HTML 颜色字符串的形式。 类型:字符串
默认:'#666'
|
backgroundColor.strokeWidth |
边框宽度(以像素为单位)。 类型:数字
默认:0
|
backgroundColor.fill |
图表的填充颜色,以 HTML 颜色字符串表示。 类型:字符串
默认:“白色”
|
bar.groupWidth |
一组条形的宽度,采用以下任一格式指定:
类型:数字或字符串
默认:黄金比例,约为“61.8%”。
|
图表区域 |
一个具有成员的对象,用于配置图表区域的位置和大小(绘制图表本身时,不包括轴和图例)。支持两种格式:数字或后跟 % 的数字。简单的数字是一个以像素为单位的值,数字后跟 % 是一个百分比。示例: Type:对象
默认:null
|
chartArea.backgroundColor |
图表区域背景颜色。使用字符串时,它可以是十六进制字符串(例如,“#fdc”)或英语颜色名称。使用对象时,可以提供以下属性:
类型:字符串或对象
默认:“白色”
|
图表区域 |
从左边框绘制图表的距离。 类型:数字或字符串
默认:自动
|
图表区域 |
从上边框绘制图表的距离。 类型:数字或字符串
默认:自动
|
图表区域.宽度 |
图表区域宽度。 类型:数字或字符串
默认:自动
|
图表.a.height |
图表区域高度。 类型:数字或字符串
默认:自动
|
颜色 |
用于图表元素的颜色。字符串数组,其中每个元素都是一个 HTML 颜色字符串,例如: 类型:字符串数组
默认:默认颜色
|
dataOpacity |
数据点的透明度,1.0 表示完全不透明,0.0 表示完全透明。在散点图、直方图、条形图和柱形图中,这指的是可见数据:散点图中的点和另一些视图中的矩形。在选择数据创建点(例如折线图和面积图)的图表中,这指的是悬停或选择时出现的圆形。组合图表同时显示了这两种行为,而且此选项对其他图表没有影响。(要更改趋势线的不透明度,请参阅趋势线的不透明度)。 类型:数字
默认:1.0
|
启用互动 |
图表是抛出基于用户的事件还是响应用户互动。如果设为 false,则图表不会抛出“select”事件或其他基于互动的事件(但会抛出“ready”或“error”事件),并且不会显示悬停文本或者根据用户输入以其他方式更改。 类型:布尔值
默认:true
|
focusTarget |
悬停鼠标时获得焦点的实体的类型。此外,还会影响点击鼠标时选择的实体,以及与事件相关联的数据表元素。可以是以下某一项:
在 focusTarget 'category' 中,提示显示所有类别值。这可用于比较不同系列的值。 类型:字符串
默认:'datum'
|
字体大小 |
图表中所有文字的默认字体大小(以像素为单位)。您可以使用特定图表元素的属性来替换此设置。 类型:数字
默认:自动
|
字体名称 |
图表中所有文本的默认字体。您可以使用特定图表元素的属性来替换此设置。 类型:字符串
默认:“Nearline”
|
forceIFrame |
在内嵌框架内绘制图表。(请注意,在 IE8 中,系统会忽略此选项;所有 IE8 图表都是在 iframe 中绘制的)。 类型:布尔值
默认:false
|
轴 |
包含用于配置各种横轴元素的成员。如需指定此对象的属性,您可以使用对象字面量表示法,如下所示: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Type:对象
默认:null
|
hAxis.gridlines |
一个用于配置横轴网格线的属性。 请注意,横轴网格线是垂直绘制的。如需指定此对象的属性,您可以使用对象字面量表示法,如下所示: {color: '#333', minSpacing: 20} Type:对象
默认:null
|
hAxis.gridlines.color |
图表区域内水平网格线的颜色。请指定有效的 HTML 颜色字符串。 类型:字符串
默认:“#CCC”
|
hAxis.gridlines.count |
图表区域内水平网格线的大致数量。如果为 类型:数字
默认:-1
|
hAxis.gridlines.interval |
相邻网格线之间的大小数组(以数据值而非像素表示)。此选项目前仅适用于数字轴,但类似于仅用于日期和时间的 类型:介于 1 到 10 之间的数字,不包括 10。
默认:计算出的值
|
hAxis.gridlines.minSpacing |
hAxis 主网格线之间的最小屏幕空间(以像素为单位)。
主要网格的默认值是 类型:数字
默认:计算出的值
|
hAxis.gridlines.multiple |
所有网格线和刻度线的值都必须是此选项值的倍数。请注意,与间隔不同的是,不考虑 10 的倍数的幂。因此,您可以通过指定 类型:数字
默认:1
|
hAxis.gridlines.units |
在与图表计算网格线一起使用时,替换日期/日期时间/时段数据类型各个方面的默认格式。允许设置年、月、日、小时、分钟、秒和毫秒的格式。 常规格式为: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } 如需了解详情,请参阅日期和时间。 Type:对象
默认:null
|
hAxis.minorGridline |
包含用于配置横轴上的次要网格线的对象,与 hAxis.gridlines 选项类似。 Type:对象
默认:null
|
hAxis.minorGridlines.color |
图表区域内水平次要网格线的颜色。请指定有效的 HTML 颜色字符串。 类型:字符串
默认:网格线和背景颜色的混合
|
hAxis.minorGridlines.count |
除了通过将计数设为 0 来停用次要网格外, 类型:数字
默认:1
|
hAxis.minorGridlines.interval |
minGridlines.interval 选项与主网格线选项类似,但所选间隔将始终是主网格线的偶数除数。
线性缩放的默认间隔为 类型:数字
默认:1
|
hAxis.minorGridlines.minSpacing |
相邻的次要网格线之间以及次要网格和主要网格线之间所需的最小空间(以像素为单位)。对于线性比例,默认值是主要网格的 1/2;对于日志比例,最小值为 1/5 的 minSpacing。 类型:数字
默认:计算出
|
hAxis.minorGridlines.multiple |
与主要 类型:数字
默认:1
|
hAxis.minorGridlines.units |
在与图表计算的 MinorDisk 网格线结合使用时,覆盖日期/日期时间/时段数据类型各个方面的默认格式。允许设置年、月、日、小时、分钟、秒和毫秒的格式。 常规格式为: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } 如需了解详情,请参阅日期和时间。 Type:对象
默认:null
|
hAxis.textPosition |
横轴文本相对于图表区域的位置。支持的值:“out”、“in”、“none”。 类型:字符串
默认:使用“out”
|
hAxis.textStyle |
用于指定横轴文本样式的对象。此对象的格式如下: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Type:对象
默认:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
Haxis.title |
类型:字符串
默认:null
|
hAxis.titleTextStyle |
用于指定横轴标题文本样式的对象。此对象的格式如下: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Type:对象
默认:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.allowContainerBoundaryTextCutoff |
如果为 false,则将隐藏最外层的标签,而不是允许图表容器剪裁它们。如果为 true,将允许剪裁标签。 类型:布尔值
默认:false
|
hAxis.slantedText |
如果为 true,请以某个角度绘制横轴文本,以帮助沿轴放置更多文本;如果为 false,则垂直绘制横轴文本。默认行为是,如果直立绘制时无法使文本完全适合文本,则将其倾斜。请注意,仅当 类型:布尔值
默认:自动
|
hAxis.slantedTextAngle |
横轴文本的角度(如果绘制为斜面)。如果 类型:数字,-90-90
默认:30 个
|
hAxis.maxAlternation |
水平轴文本的层级数上限。如果轴文本标签太拥挤,服务器可能会上移或下移相邻标签,以使标签更靠近。此值用于指定要使用的最多层数;如果标签可以拟合而不会重叠,服务器可以使用的层数会更少。对于日期和时间,默认值为 1。 类型:数字
默认:2
|
hAxis.maxTextLines |
文本标签允许的行数上限。如果标签过长,则标签可以占据多行,并且默认情况下,行数受可用空间的高度限制。 类型:数字
默认:自动
|
hAxis.minTextSpacing |
两个相邻文本标签之间允许的最小水平间距(以像素为单位)。如果标签间隔太密集或标签过长,间距可能会降至此阈值以下,并且在这种情况下,系统会应用其中一个标签简洁性指标(例如截断标签或丢弃一些标签)。 类型:数字
默认:
hAxis.textStyle.fontSize 的值 |
hAxis.showTextEvery |
要显示的横轴标签数量,其中 1 表示显示每个标签,2 表示显示其他标签,以此类推。默认设置为尝试在不重叠的情况下尽可能多显示标签。 类型:数字
默认:自动
|
hAxis.viewWindowMode |
指定如何缩放横轴以在图表区域内呈现值。支持以下字符串值:
类型:字符串
默认:相当于“ nice”,但使用
haxis.viewWindow.min 和 haxis.viewWindow.max 时优先级更高。 |
hAxis.viewWindow |
指定横轴的剪裁范围。 Type:对象
默认:null
|
hAxis.viewWindow.max |
剪裁窗口结束的位置索引(从零开始)。此索引及更高级别的数据点会被剪裁。它与 当 类型:数字
默认:自动
|
hAxis.viewWindow.min |
剪裁窗口从零开始的行索引。索引值低于此值的数据点将被剪裁。它与 当 类型:数字
默认:自动
|
直方图.bucketSize |
硬编码每个直方图栏的大小,而不是让它通过算法确定。 类型:数字
默认:自动
|
直方图.hideBucketItems |
省略直方图块之间的细除法,使其变为一系列实线。 类型:布尔值
默认:false
|
直方图.lastBucketPercentile |
计算直方图的存储分区大小时,忽略顶部和底部的 类型:数字
默认:0
|
直方图.最小值 |
扩大存储分区范围以包含此值。 类型:数字
默认:自动 - 使用流量下限
|
直方图 |
扩大存储分区范围以包含此值。 类型:数字
默认:自动 - 使用流量上限
|
直方图.numBucketsRule |
如何计算默认桶数。可能的值包括:
类型:字符串
默认:
'sqrt' |
高度 |
图表的高度(以像素为单位)。 类型:数字
默认:包含元素的高度
|
interpolateNulls |
是否猜测缺少的点的值。如果为 true,则它将根据相邻点来猜测任何缺失数据的值。如果为 false,则会在未知点处换行。
使用 类型:布尔值
默认:false
|
堆叠 |
如果设置为 true,则在每个网域值上堆叠所有系列的元素。注意:在 Column、Area 和 SteppedArea 图表中,Google 图表会颠倒图例项的顺序,以便更好地与堆叠系列元素的堆叠方式保持一致(例如,Series 0 将是最底层的图例项)。此要求不适用于条形图。
对于 100% 堆叠,每个元素的计算值将显示在实际值之后的提示中。
对于
100% 堆叠仅支持 类型:布尔值/字符串
默认:false
|
传奇 |
包含用于配置图例各个方面的成员的对象。如需指定此对象的属性,您可以使用对象字面量表示法,如下所示: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type:对象
默认:null
|
图例匹配 |
图例的对齐方式。可以是下列选项之一:
起点、中心和终点相对于图例的样式(垂直或水平)。例如,在“right”图例中,“start”和“end”分别位于顶部和底部;对于“top”图例,“start”和“end”分别位于该区域的左侧和右侧。 默认值取决于图例的位置。对于“底部”图例,默认值为“居中”;其他图例默认为“开始”。 类型:字符串
默认:自动
|
图例.max 行 |
图例中的行数上限。将此列设置为大于 1 的数字,以便为图例添加线条。注意:用于确定实际呈现的行数的准确逻辑仍在变化。 目前,仅当图例位置为“顶部”时,此选项才有效。 类型:数字
默认:1
|
图例页 |
选择的初始页面索引(从零开始)。 类型:数字
默认:0
|
图例位置 |
图例的位置。可以是下列选项之一:
类型:字符串
默认:“right”
|
图例样式 |
用于指定图例文本样式的对象。此对象的格式如下: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Type:对象
默认:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
屏幕方向 |
图表的方向。如果设置为 类型:字符串
默认:“横向”
|
反向类别 |
如果设置为 true,则会从右向左绘制系列。默认是从左向右绘制。 类型:布尔值
默认:false
|
series |
对象的数组,其中每个对象描述图表中相应系列的格式。如需为系列使用默认值,请指定空对象 {}。如果未指定系列或值,将使用全局值。每个对象支持以下属性:
您可以指定对象数组,每个对象按给定顺序应用于数据系列,也可以指定一个对象,其中每个子项都有一个指示其所适用的数据系列的数字键。例如,以下两个声明是相同的,并将第一个系列声明为黑色且未显示在图例中,第四个声明为红色且未显示在图例中: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } 类型:对象数组或包含嵌套对象的对象
默认:{}
|
主题 |
主题是一组预定义的选项值,共同发挥作用以实现特定的图表行为或视觉效果。目前只提供一个主题:
类型:字符串
默认:null
|
标题 |
要在图表上方显示的文字。 类型:字符串
默认:无标题
|
title 位置 |
与图表区域相比,图表标题的放置位置。支持的值:
类型:字符串
默认:使用“out”
|
titleTextStyle |
用于指定标题文本样式的对象。此对象的格式如下: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Type:对象
默认:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
工具提示 |
一个具有成员的对象,用于配置各种提示元素。如需指定此对象的属性,您可以使用对象字面量表示法,如下所示: {textStyle: {color: '#FF0000'}, showColorCode: true} Type:对象
默认:null
|
hint.isHTML |
如果设置为 true,则使用 HTML 呈现(而不是 SVG 渲染)的提示。如需了解详情,请参阅自定义提示内容。 注意:气泡图可视化图表不支持通过提示列数据角色自定义 HTML 提示内容。 类型:布尔值
默认:false
|
tooltip.showColorCode |
如果为 true,则在提示中的系列信息旁边显示彩色方块。当 类型:布尔值
默认:自动
|
提示文本 |
用于指定提示文本样式的对象。此对象的格式如下: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Type:对象
默认:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.trigger |
使提示显示的用户交互:
类型:字符串
默认:焦点
|
vAxes |
如果图表包含多个垂直轴,请指定各个垂直轴的属性。每个子对象都是一个
如需指定具有多个垂直轴的图表,请先使用 { series: { 2: { targetAxisIndex:1 } }, vAxes: { 1: { title:'Losses', textStyle: {color: 'red'} } } }
该属性可以是对象或数组:该对象是一个对象集合,其中每个对象都有一个数字标签,用于指定它定义的轴(这是上面显示的格式);数组是一个对象数组,每个轴对应一个对象。例如,以下数组样式的表示法与上面显示的 vAxes: [ {}, // Nothing specified for axis 0 { title:'Losses', textStyle: {color: 'red'} // Axis 1 } ] 类型:对象数组或包含子对象的对象
默认:null
|
轴 |
包含用于配置各种纵轴元素的成员。如需指定此对象的属性,您可以使用对象字面量表示法,如下所示: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Type:对象
默认:null
|
vAxis.baseline |
类型:数字
默认:自动
|
vAxis.baselineColor |
指定纵轴基线的颜色。可以是任何 HTML 颜色字符串,例如 类型:数字
默认:'black'
|
vAxis.direction |
纵轴上的值增大的方向。默认情况下,图表底部会显示低值。指定 类型:1 或 -1
默认:1
|
vAxis.format |
数字轴标签的格式字符串。这是 ICU 模式集的一部分。例如,对于值 10、7.5 和 0.5,
应用于标签的实际格式来自加载 API 时使用的语言区域。如需了解详情,请参阅加载包含特定语言区域的图表。
在计算刻度线值和网格线时,系统将考虑所有相关网格选项的若干备选组合,如果带格式的对勾标记被复制或重叠,则替代项将被拒绝。因此,如果您只想显示整数刻度值,则可以指定 类型:字符串
默认:自动
|
vAxis.gridlines |
一个具有成员的对象,用于在垂直轴上配置网格线。请注意,纵轴网格线是水平绘制的。如需指定此对象的属性,您可以使用对象字面量表示法,如下所示: {color: '#333', minSpacing: 20} Type:对象
默认:null
|
vAxis.gridlines.color |
图表区域内垂直网格线的颜色。请指定有效的 HTML 颜色字符串。 类型:字符串
默认:“#CCC”
|
vAxis.gridlines.count |
图表区域内水平网格线的大致数量。如果为 类型:数字
默认:-1
|
vAxis.gridlines.interval |
相邻网格线之间的大小数组(以数据值而非像素表示)。此选项目前仅适用于数字轴,但类似于仅用于日期和时间的 类型:介于 1 到 10 之间的数字,不包括 10。
默认:计算出的值
|
vAxis.gridlines.minSpacing |
hAxis 主网格线之间的最小屏幕空间(以像素为单位)。
主要网格的默认值是 类型:数字
默认:计算出的值
|
vAxis.gridlines.multiple |
所有网格线和刻度线的值都必须是此选项值的倍数。请注意,与间隔不同的是,不考虑 10 的倍数的幂。因此,您可以通过指定 类型:数字
默认:1
|
vAxis.gridlines.units |
在与图表计算网格线一起使用时,替换日期/日期时间/时段数据类型各个方面的默认格式。允许设置年、月、日、小时、分钟、秒和毫秒的格式。 常规格式为: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]}, hours: {format: [/*format strings here*/]}, minutes: {format: [/*format strings here*/]}, seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]} } } 如需了解详情,请参阅日期和时间。 Type:对象
默认:null
|
vAxis.minorGridline |
一个对象,用于配置纵轴上的次要网格线,类似于 vAxis.gridlines 选项。 Type:对象
默认:null
|
vAxis.minorGridlines.color |
图表区域内垂直次要网格的颜色。请指定有效的 HTML 颜色字符串。 类型:字符串
默认:网格线和背景颜色的混合
|
vAxis.minorGridlines.count |
Minor 网格线选项大部分都已弃用,除非通过将计数设为 0 来停用次要网格线。次要网格线的数量取决于主要网格线(请参阅 vAxis.gridlines.interval)与最小所需空间之间的时间间隔(请参阅 vAxis.minorGridlines.minSpacing)。 类型:数字
默认:1
|
vAxis.minorGridlines.interval |
minGridlines.interval 选项与主网格线选项类似,但所选间隔将始终是主网格线的偶数除数。
线性缩放的默认间隔为 类型:数字
默认:1
|
vAxis.minorGridlines.minSpacing |
相邻的次要网格线之间以及次要网格和主要网格线之间所需的最小空间(以像素为单位)。对于线性比例,默认值是主要网格的 1/2;对于日志比例,最小值为 1/5 的 minSpacing。 类型:数字
默认:计算出
|
vAxis.minorGridlines.multiple |
与主要 类型:数字
默认:1
|
vAxis.minorGridlines.units |
在与图表计算的 MinorDisk 网格线结合使用时,覆盖日期/日期时间/时段数据类型各个方面的默认格式。允许设置年、月、日、小时、分钟、秒和毫秒的格式。 常规格式为: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } 如需了解详情,请参阅日期和时间。 Type:对象
默认:null
|
vAxis.logScale |
如果为 true,则将纵轴设置为对数刻度。注意:所有值都必须为正数。 类型:布尔值
默认:false
|
vAxis.scaleType |
类型:字符串
默认:null
|
vAxis.textPosition |
纵轴文本相对于图表区域的位置。支持的值:“out”、“in”、“none”。 类型:字符串
默认:使用“out”
|
vAxis.textStyle |
用于指定纵轴文本样式的对象。此对象的格式如下: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Type:对象
默认:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.ticks |
使用指定的数组替换自动生成的 Y 轴 tick。数组的每个元素都应该是有效的 tick 值(例如数字、日期、日期时间或时间)或对象。如果是对象,则它应该包含 tick 值的
除非您指定要替换的 示例:
类型:元素数组
默认:自动
|
vAxis.title |
类型:字符串
默认:无标题
|
vAxis.titleTextStyle |
用于指定纵轴标题文本样式的对象。此对象的格式如下: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Type:对象
默认:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.maxValue |
将纵轴的最大值移动到指定值;在大多数图表中,该值会向上。如果该值设为小于数据最大 y 值的值,系统会忽略此参数。
类型:数字
默认:自动
|
vAxis.minValue |
将纵轴的最小值移至指定值;在大多数图表中,此值会下降。如果设置的此值大于数据中的最小 y 值,系统会忽略此参数。
类型:数字
默认:null
|
vAxis.viewWindowMode |
指定如何缩放纵轴以在图表区域内呈现值。支持以下字符串值:
类型:字符串
默认:相当于“ nice”,但使用
vaxis.viewWindow.min 和 vaxis.viewWindow.max 时优先级更高。 |
vAxis.viewWindow |
指定纵轴的剪裁范围。 Type:对象
默认:null
|
vAxis.viewWindow.max |
要呈现的垂直数据值的上限。 当 类型:数字
默认:自动
|
vAxis.viewWindow.min |
要呈现的最小垂直数据值。 当 类型:数字
默认:自动
|
width |
图表的宽度(以像素为单位)。 类型:数字
默认:包含元素的宽度
|
方法
方法 | |
---|---|
draw(data, options) |
绘制图表。图表仅在 返回值类型:无
|
getAction(actionID) |
返回包含请求的 返回值类型:
|
getBoundingBox(id) |
返回一个对象,包含图表元素
值是相对于图表容器而言的。在绘制图表之后调用此方法。 返回值类型:
|
getChartAreaBoundingBox() |
返回一个包含图表内容的左侧、顶部、宽度和高度的对象(即不包括标签和图例):
值是相对于图表容器而言的。在绘制图表之后调用此方法。 返回值类型:
|
getChartLayoutInterface() |
返回一个对象,其中包含有关图表的屏幕位置及其元素的信息。 可以对返回的对象调用以下方法:
在绘制图表之后调用此方法。 返回值类型:
|
getHAxisValue(xPosition, optional_axis_index) |
返回 示例: 在绘制图表之后调用此方法。 返回值类型:数字
|
getImageURI() |
返回序列化为图片 URI 的图表。 在绘制图表之后调用此方法。 请参阅打印 PNG 图表。 返回值类型:返回值类型
|
getSelection() |
返回一组选定图表实体。
可选择的实体包括条形、图例条目和类别。
在此图表中,在任何时候都只能选择一个实体。
返回值类型:一组选择元素
|
getVAxisValue(yPosition, optional_axis_index) |
返回 示例: 在绘制图表之后调用此方法。 返回值类型:数字
|
getXLocation(dataValue, optional_axis_index) |
返回 示例: 在绘制图表之后调用此方法。 返回值类型:数字
|
getYLocation(dataValue, optional_axis_index) |
返回 示例: 在绘制图表之后调用此方法。 返回值类型:数字
|
removeAction(actionID) |
从图表中移除所请求的 返回值类型:
none |
setAction(action) |
设置要在用户点击操作文本时执行的提示操作。
所有提示提示操作均应在调用图表的 返回值类型:
none |
setSelection() |
选择指定的图表实体。取消之前选择的所有内容。
可选择的实体包括条形、图例条目和类别。
对于此图表,一次只能选择一个实体。
返回值类型:无
|
clearChart() |
清除该图表,并释放其分配的所有资源。 返回值类型:无
|
事件
如需详细了解如何使用这些事件,请参阅基本互动、处理事件和触发事件。
名称 | |
---|---|
animationfinish |
在过渡动画播放完毕时触发。 属性:无
|
click |
在用户点击图表内时触发。可用于识别标题、数据元素、图例条目、轴、网格线或标签何时得到点击。 属性:targetID
|
error |
尝试渲染图表出错时触发。 属性:ID、消息
|
legendpagination |
在用户点击图例分页箭头时触发。传回当前图例中从零开始的页面索引和总页数。 属性:currentPageIndex、totalPages
|
onmouseover |
用户将鼠标放在视觉实体上时触发。传递相应数据表元素的行索引和列索引。 柱形与数据表中的单元格、列的图例条目(行索引为 null)以及行与类别(列索引为 null)相关联。 属性:行、列
|
onmouseout |
在用户离开可见实体时触发。传递相应数据表元素的行索引和列索引。柱形与数据表中的单元格、列的图例条目(行索引为 null)以及行与类别(列索引为 null)相关联。 属性:行、列
|
ready |
此图表已准备好进行外部方法调用。如果您想与图表交互,并在绘制后调用方法,则应在调用 属性:无
|
select |
在用户点击视觉实体时触发。如需了解所选内容,请调用 属性:无
|
数据政策
所有代码和数据都会在浏览器中进行处理和呈现。不会向任何服务器发送数据。