饼图

   

本文档介绍了如何使用 Chart API 创建饼图。

目录

图表专用功能 Overview 图表类型 (cht) 系列颜色 (chco) 饼图标签 (chl) 饼图旋转 (chp)

标准功能 图表标题（chtt、chts） 图表图例文本和样式（chdl、chdlp、chdls） 图表边距 (chma) 背景填充 (chf) 固体填充 (chf) 渐变填充 (chf) 条纹填充 (chf) 数据函数 (chfd)

概览

饼图适用于显示部分与整体之间的简单比例信息。 您可以创建单系列饼图（每个系列由多个切片组成），也可以创建多系列同心圆饼图。

每个系列描述一个饼图，每个数据值指定一个切片。使用嵌套的饼图（如下所述）时，请使用多个系列。

如需显示与切片关联的文本，您必须使用饼图标签或图表图例。饼图标签是图表周围的文本，其中有一条直线指向切片。图例是通过颜色关联的文本。

标签	图例	标签和图例
chl=January|February|March|April	chdl=January|February|March|April	chl=January|February|March|April chdl=30°|40°|50°|60°

值在显示时是相对于彼此而言的：因此值为 1、2、3 的图表与值为 100,200,300 的图表看起来一样。不过，在使用文本格式数据时，大于 100 的值会被截断为 100，因此您需要使用具有自定义缩放的文本格式才能正确显示大于 100 的切片（使用最小/最大值为 chds=0,<max-slice-size> 的 chds 参数）。

如果采用的是负值，那么相应尺寸的切片将显示为空。

图表类型

您可以创建三种常规类型的饼图：平面饼图、同心饼图或 3D 饼图。请使用以下语法指定一种饼形图表：

语法

cht=<chart_type>

其中，<chart_type> 是以下类型之一：

参数	说明	示例
p	二维饼形图表。 仅提供一个数据系列；后续的数据系列会遭到忽略。 默认情况下，饼图细分颜色由深橙色转换为浅黄色。按照系列颜色中的说明指定其他颜色。 按照饼图标签中所述，使用 chl 指定标签。 Google Chart API 会根据图表大小 (chs) 参数中指定的宽度和高度的最小值，计算圆形的半径。 如果要添加标签，则可能需要将宽度尺寸指定为高度尺寸的两倍，以确保标签完全可见。	cht=p chs=200x100
p3	三维饼形图表。 指定数据和格式的方法与上述二维饼图指定的方式相同。 如果您要在三维饼图中添加标签，则可能需要将宽度尺寸指定为高度尺寸的 2.5 倍，以确保标签完全可见。	cht=p3 chs=250x100
pc	同心圆饼形图表。 提供两个或以上的数据系列。	cht=pc chd=s:Helo,Wrld
所有类型	如果在数据中使用负值，则会导致相应切片显示为“空白”。	cht=pc chd=t: 10,-10,10,-10| 5,-5,5,-5,5,-5,5,-5,5,-5

 

系列颜色 chco

您可以使用 chco 参数指定所有值、每个值或某些值的颜色。

语法

chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>

<color>

切片颜色，采用 RRGGBB 十六进制格式。指定单一系列颜色，该系列中的所有切片将按照从最深（第一个数据成员）到最浅（最后一个数据成员）颜色的等级进行着色。指定两种或更多颜色（用 | 分隔），以描述各个切片颜色。如果您有多个系列（即包含同心圆的图表），则可以通过使用逗号分隔值来指定不同系列的值。如果指定的切片/系列颜色少于显示的切片/系列，则图表将从系列的切片列表的开头循环或从图表的系列列表的开头循环。您无法为多系列图表中的每个系列指定截然不同的渐变效果。

说明	示例
指定单一颜色，以实现从最深（第一个切片）到最浅（最后一个切片）的渐变。	chco=0000FF
定义一种渐变色；此示例中由黄色渐变为红色。	chd=t:10,20,30,40,50 chco=FFFF10,FF0000
定义单独的切片颜色；每个切片指定一种颜色。	chd=t:10,20,30 chco=FF0000|00FF00|0000FF
此图表包含两个数据系列，但将颜色指定为从黄色到红色的所有切片的单一渐变 (BBBB00—BB0000)。	chco=BBBB00,BB0000
此例的同心图表同时包含系列颜色和各个切片颜色。该图表有两个同心数据系列。 以人类可读的形式，颜色是 chco=green|red,blue|yellow。逗号将它分成两个系列： 绿色|红色 - 表示各切片交替使用绿色和红色 蓝色|黄色 - 表示各切片交替使用蓝色和黄色	chd=s:eYY,ORVM chco=008800|880000,000088|888800

返回页首

饼图标签 chl

您可以使用 chl 参数为各个饼图切片指定标签。您还可以显示一条具有相同或不同值的图例，每个切片一个图例条目。

字符串值注意事项：标签字符串中只允许安全的网址字符。为了安全起见，如果字符串中包含不属于字符集 0-9a-zA-Z 的字符，您应该对其进行网址编码。 您可以在此处找到网址编码器。

语法

chl=
  <label_value>|
    ...
  <label_value>

<label_value>

要应用于切片的字符串值。标签会连续应用于 chd 中的数据点。如果您有多个系列（例如同心圆饼图），则会按照 chd 中指定的顺序向所有序列中的所有点应用标签。在各个标签之间使用竖线分隔符 ( |)。使用两个连续的竖线字符（中间不加空格）来指定缺失的中间值：|| 。您无需为所有切片添加标签。

 

示例

说明	示例
适用于三维饼形图表的标签。	chl=May|Jun|Jul|Aug|Sep|Oct chs=220x100
使用 chs 指定图表大小时，请考虑标签需要多少空间。 通常，为了正确显示标签，二维饼图的宽度大约是高度的两倍，而三维饼图的宽度需要大约为高度的 2.5 倍。 在第一个示例中，由于图表不够宽，因此仅部分显示标签。 第二个示例展示了图表宽度为 280 像素才能完整显示标签。（向 <img> 元素明确添加了边框。）	chl=May|June|July|August| September|October chs=220x100 chl=May|June|July|August| September|October chs=280x100

返回页首

饼图旋转chp

默认情况下，第一个系列从 3:00 开始绘制，并沿图表顺时针方向绘制，但您可以使用 chp 参数指定自定义旋转。

语法

chp=<radians>
  

<radians>

一个浮点值，用于描述图表顺时针旋转的弧度。一整圈为 2π（2 pi，约为 6.28）弧度。

示例

说明	示例
如需更改饼图的方向，请使用 chp=<angle_in_radians>	chd=t:20,80 chd=t:80,20 chp=0.628
下面是另一个饼图旋转示例。这些标记可以与图表形状标记结合使用，以创建一些有趣的效果。

 

返回页首

标准功能

此网页上的其他功能均为标准图表功能。

图表标题 chtt、chts [所有图表]

您可以为图表标题指定文字、颜色和字体大小。

语法

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt - 指定图表标题。

<chart_title>chart_title

要为图表显示的标题。您无法指定标题的显示位置，但可以选择指定字体大小和颜色。使用 + 号表示空格，使用竖线字符 ( |) 表示换行符。

 

chts [可选] - chtt 参数的颜色和字体大小。

<color>

标题颜色，采用 RRGGBB 十六进制格式。默认颜色为黑色。

<font_size>

标题的字体大小（以点为单位）。

<opt_alignment>

[可选] 标题的对齐方式。选择以下某个区分大小写的字符串值：“l”（左）、“c”（居中）、“r”（右）。默认值为“c”。

 

示例

说明	示例
标题使用默认颜色和字体大小的图表。 请使用加号 (+) 指定一个空格。 使用竖线字符 (|) 强制换行。 此处未指定 chts。	chtt=Site+visitors+by+month| January+to+July
一个图表，带有蓝色右对齐的 20 点标题。	chtt=Site+visitors chts=FF0000,20,r

返回页首

图表图例文本和样式 chdl、chdlp、chdls [所有图表]

图例是图表的侧边部分，用于为每个系列提供简短的文字说明。您可以指定与此图例中的每个系列相关联的文本，并指定这些文本在图表上的显示位置。

如需了解如何设置图例周围的外边距，另请参阅 chma。

有关字符串值的注意事项：标签字符串中只允许使用安全网址字符。为了安全起见，如果字符串中包含不属于字符集 0-9a-zA-Z 的字符，您应该对其进行网址编码。 您可以在 Google 可视化文档中找到网址编码器。

语法

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl - 要在图例中显示的每个系列的文字。

<data_series_label>data_series_label

图例条目的文本。每个标签都适用于 chd 数组中的相应系列。使用“+”号表示空格。如果您未指定此参数，图表将不会获得图例。您无法在标签中指定换行符。图例通常会扩大以容纳图例文本，而图表区域会缩小以适应图例。

chdlp - [可选] 图例的位置以及图例条目的顺序。您可以指定 <position> 和/或 <label_order>。如果同时指定这两者，请使用竖线字符将其分隔。如果您希望在图例中跳过 chdl 中的空图例条目，则可以向任何值添加“s”。示例：chdlp=bv、chdlp=r、chdlp=bv|r、chdlp=bvs|r

<opt_position>

[可选] 指定图例在图表上的位置。如需指定图例与图表区域或图片边框之间的额外内边距，请使用 chma 参数。 从下列值中选择一个：

• b - 图例位于图表底部，水平行中的图例条目。
• bv - 图例位于图表底部，垂直列中的图例条目。
• t - 图例位于图表顶部，水平行中的图例条目。
• tv - 图例位于图表顶部，垂直列中的图例条目。
• r - [默认] 图例位于图表右侧，垂直列中图例条目。
• l - 图例位于图表左侧，垂直列中的图例条目。

<opt_label_order>

[可选] 标签在图例中的显示顺序。 从下列值中选择一个：

• l - [垂直图例的默认] 按照为 chdl 指定的顺序显示标签。
• r - 按照为 chdl 指定的反向顺序显示标签。在堆叠条形图中，这非常有用，可让图例
  按照条形图的显示顺序显示。
• a - [横向图例的默认] 自动排序：大致表示按长度排序，长度最短者排在最前面，以 10 个像素的块为单位。当两个元素的长度相同（划分为 10 像素块）时，先列出的元素会最先显示。
• 0,1,2... - 自定义标签顺序。这是 chdl 中从零开始的标签索引列表，以英文逗号分隔。

chdls - [可选] 指定图例文本的颜色和字体大小。

<color>

图例文本颜色，采用 RRGGBB 十六进制格式。

<size>

图例文本的点大小。

 

示例

说明	示例
两个图例示例。请按与数据系列相同的顺序指定图例文本。	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
第一个图表展示了横向图例条目（chdlp=t，默认布局为横向），第二个图表展示了底部纵向图例条目 (chdlp=bv)。	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
此示例演示了如何更改字体大小。	chdls=0000CC,14

返回页首

图表边距 chma [所有图表]

您可以指定图表边距的大小（以像素为单位）。边距从指定的图表尺寸 (chs) 向内计算；增加边距尺寸不会增加图表的总大小，但会在必要时缩小图表区域。

默认情况下，外边距为计算图表尺寸后剩下的部分。此默认值因图表类型而异。您指定的外边距是最小值；如果图表区域为外边距留出了空间，则外边距大小就是剩下的空间大小；不能将外边距压成小于任何图例和标签所要求的大小。下图显示了图表的基本组成部分：

图表外边距包括轴标签和图例区域。除非您使用 chma 指定较大的宽度，否则图例区域会自动调整大小以准确适应文本；在这种情况下，它会将外边距尺寸扩大到更宽，从而缩小图表区域。您无法通过指定过小的大小来剪裁图例，但可以让其占用的空间超过所需空间。 提示：在条形图中，如果条形具有固定大小（默认设置），则无法缩小图表区域宽度。您必须使用 chbh 指定较小的条形尺寸或可调整大小的条形尺寸。

 

语法

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>

<left_margin>、 <right_margin>、 <top_margin>、 <bottom_margin>

图表区域周围的最小边距尺寸（以像素为单位）。请提高此值以包含一些内边距，以防止轴标签碰到图表的边框。

<opt_legend_width>、 <opt_legend_height>

[可选] 图例周围的外边距宽度（以像素为单位）。 使用此选项可避免图例触碰图表区域或图片边缘。

 

示例

说明	示例
在此示例中，图表每边的最小外边距为 30 像素。由于图表图例的宽度超过 30 像素，因此右侧的边距会设置为图表图例的宽度，并且与其他边距不同。 轴标签在图表区域之外，因此在外边距空间内绘制。	chma=30,30,30,30
若要在图例周围添加外边距，请设置 <opt_legend_width> 和 <opt_legend_height> 参数的值。 在此例中，图例的宽度约为 60 像素。如果您将 <opt_legend_width> 设为 80 像素，则外边距会延伸到图例之外 20 像素。	chma=20,20,20,30|80,20

返回页首

轴样式和标签 [折线图、条形图表、Google-o-meter、雷达图、散点图]

您可以指定要在图表上显示的轴，并为它们提供自定义标签、位置、范围和样式。

并非所有图表在默认情况下都会显示轴线。您可以使用 chxt 参数精确指定图表应显示的轴。默认轴线不会显示数字；您必须在 chxt 参数中指定一条轴才能显示数字。

您可以选择让轴显示反映数据值的数字，也可以指定自定义轴。 默认设置是显示数值，其值范围在 0—100 之间。 不过，您可以使用 chxr 更改该范围以显示任何范围，还可以使用 chxs 设置值的样式（例如，显示货币符号或小数位）。

如果您选择使用自定义值（例如“周一、周二、周三”），则可以使用 chxl 参数。 要沿着轴将这些标签放置在特定位置，请使用 chxp 参数。

最后，您可以使用 chxs 和 chxtc 参数指定自定义轴标签和数字轴标签的颜色、大小、对齐方式和其他属性。

有关字符串值的注意事项：标签字符串中只允许使用安全网址字符。为了安全起见，如果字符串中包含不属于字符集 0-9a-zA-Z 的字符，您应该对其进行网址编码。 您可以在 Google 可视化文档中找到网址编码器。

本部分包含以下主题：

• 可见轴 (chxt) - 要显示的轴。
• 轴范围 (chxr) - 每个轴的值范围。
• 自定义轴标签 (chxl) - 要在轴上显示的自定义值。
• 轴标签位置 (chxp) - 自定义标签沿每个轴的位置。
• 轴标签样式 (chxs) - 轴标签的颜色、大小、对齐方式和格式。
• 轴刻度线样式 (chxtc) - 特定轴的刻度线长度。

---

显示的轴 chxt

条形图、折线图、雷达图和散点图默认显示一条或两条轴线，但这些线不包含值。 如需显示轴线上的值，或更改显示的轴，您必须使用 chxt 参数。 默认情况下，轴值的范围在 0-100 之间，除非您使用 chxr 属性明确缩放它们。要隐藏折线图中的所有轴线，请在 cht 参数中的图表类型值后面指定 :nda（例如：cht=lc:nda）。

默认情况下，顶部和底部的轴不会在值旁显示刻度线，而左侧和右侧的轴则会显示它们。您可以使用 chxs 参数更改此行为。

语法

chxt=
  <axis_1>
    ,...,
  <axis_n>

<axis>

在图表上显示的轴。可用的轴包括：

• x - 底部 x 轴
• t - 顶部 x 轴 [Google-o-Meter 不支持]
• y - 左侧 y 轴
• r - 右侧 y 轴 [Google-o-Meter 不支持]

您可以指定多个相同类型的轴，例如 cht=x,x,y。这将沿着图表底部堆叠两组 x 轴。在沿显示数值的轴添加自定义标签时，这非常有用（请参阅下面的示例）。轴是从内向外绘制的，因此如果您有 x,x，则第一个 x 表示最内层的副本，下一个 x 表示下一个向外的副本，依此类推。

 

示例

说明	示例
此示例展示了一个包含 x 轴、y 轴、顶部轴 (t) 和右侧轴 (r) 的折线图。 由于未指定标签，因此图表中所有轴的范围默认为 0 到 100。 请注意，默认情况下，顶部和底部的轴不会在标签旁边显示刻度线。	chxt=x,y,r,t
您可以多次添加相同的值，从而为每条轴添加多组标签。以下示例显示了两组 x 轴和两组 y 轴。如此处所示，在仅使用默认的轴标签时，这并非特别有用。不过，您可以使用 chxl 参数为每个轴的每个副本指定自定义标签。	<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chls=2.0&chls=200x" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chls=200
此示例展示了一个水平条形图，其中包含一条 x 轴、一条 y 轴、一条顶部 t 轴和一条右侧 r 轴。 由于省略了轴标签，因此 Chart API 会为 x 轴和 t 轴显示 0 到 100 的范围。 y 轴和 r 轴的范围取决于条形的数量。在本示例中，有五个条形，因此 Chart API 显示的是 0 到 4 的范围。第一个标签在第一个条形的底部居中，第二个标签位于第二个条形底部的中心，以此类推。	chxt=x,y,r,t
您可以通过在图表类型后指定 :nda 来禁止折线图中的默认轴。	cht=lc:nda

返回页首

轴范围 chxr

您可以使用 chxr 参数分别指定每条轴上显示的值的范围。请注意，这不会更改图表元素的比例，只会更改轴标签的比例。 如果您想让轴数字描述实际数据值，请分别将 <start_val> 和 <end_val> 设置为数据格式范围的下限值和上限值。如需了解详情，请参阅轴缩放。

如果您要指定轴的范围，则必须使用 chxt 参数将其设为可见。

如需指定自定义轴值，请使用 chxl 参数。

语法

请使用竖线字符 ( |) 分隔多个轴标签范围。

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>

<axis_index>

要将标签应用到哪个轴。这是 chxt 指定的轴数组中从零开始的索引。例如，r 轴在 chxt=x,r,y 中为 1。

<start_val>

定义此轴的下限值的数字。

<end_val>

定义此轴的最高值的数字。

<opt_step>

[可选] 轴上刻度线之间的计数步长。没有默认的步长值；计算该步长是为了尝试显示一组间距适当的标签。

 

示例

说明	示例
此示例显示了左右 y 轴（y 和 r）和一条 x 轴 (x)。 每个轴都有一个定义的范围。由于未指定标签或位置，因此系统会从给定范围中获取值，并在该范围内以相等的间距排列各个值。在该折线图表中，这些值以相等的间距沿 x 轴排列。 r 轴的轴方向反转（索引 2），因为第一个值 (1000) 大于最后一个值 (0)。	chxt=x,y,r chxr=   0,0,500|   1,0,200|   2,1000,0
此例已为 x 轴指定了值。 轴标签沿轴均匀分布。<opt_step> 参数指定了值五 (5)。	chxt=x chxr=0,10,50,5

返回页首

自定义轴标签 chxl

您可以使用 chxl 参数指定任何轴上的自定义字符串轴标签。您可以指定任意数量的标签。如果您显示轴（使用 chxt 参数）并且未指定自定义标签，则系统将应用标准数字标签。要指定自定义数字范围，请改用 chxr 参数。

要沿着轴设置标签的特定位置，请使用 chxp 参数。

语法

为您要添加标签的每条轴指定一个参数集。请使用竖线字符 (|) 分隔多组标签。

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>

<axis_index>

要应用标签的轴。这是 chxt 参数数组的一个索引。例如，如果您有 chxt=x,x,y,y，则索引 0 为第一个 x 轴，1 为第二个 x 轴。

<label_1>| ... |<label_n>

要沿此轴放置的一个或多个标签。这些标签可以是字符串或数值；字符串不需要括在引号中。label_1 显示在轴的最低位置，label_n 显示在最高位置。其他标签则以相等的间距排列在它们之间。使用 + 标记表示空格。您无法在标签中指定换行符。请使用竖线字符分隔标签。注意 ：请勿在 chxl 参数的最后一个标签后面添加竖线。

 

示例

说明	示例
此图表展示了如何为两条轴添加自定义标签。请注意如何以相等的间距排列各值，以及最后的 chxl 值不能以竖线结尾。	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
此示例包括左侧和右侧 y 轴上的轴标签（y 和 r），还包含两组 x 轴 (x) 值。您可以考虑使用 chxs 在 y 轴上添加刻度线。	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|50|100| 2:|A|B|C| 3:|2005|2006|2007
此示例包括左侧和右侧 y 轴上的轴标签（y 和 r）。它还包含两组 x 轴 (x) 值。请注意下方 x 轴集合的空标签，用来将值分隔开。 此例左侧 y 轴上的轴标签采用了默认值。	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
如果要添加一个通用标签来描述整个轴（例如，将一个轴标记为“费用”，将另一个轴标记为“学生”），请使用 chxt 属性在每一侧添加一个额外的轴，然后使用 chxl 在每条边上添加一个自定义标签，并使用 chxp 将其间隔在轴中间。	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

返回页首

轴标签位置 chxp

您可以指定要显示的轴标签，无论使用默认标签还是使用 chxl 指定的自定义标签。如果您未使用此参数指定确切位置，标签将沿着轴按默认步长值以相等的间距排列开。如果您未指定 chxl，则刻度线标签将是默认值（通常是数据值或条形图中的条形数字）。

语法

请使用竖线字符 (|) 分隔多个定位集。

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>

<axis_index>

要指定位置的轴。这是 chxt 参数数组的索引。例如，如果您有 chxt=x,x,y,y，则索引 0 为第一个 x 轴，1 为第二个 x 轴，依此类推。

<label_1_position>,...,<label_n_position>

：标签沿轴的位置。这是以英文逗号分隔的数值列表，其中每个值都设置了 chxl 数组中相应标签的位置：第一个条目应用于第一个标签，依此类推。位置是该轴的范围中的一个值。 请注意，除非您使用 chxr 指定了自定义范围，否则该值将始终为 0—100。位置的数量必须与相应轴的标签数量相同。

 

示例

说明	示例
此示例在图表的指定位置包含 r 轴标签。标签文本使用 chxl 参数指定。 指定位置为 0 的标签位于 y 轴或 r 轴的底部，或者 x 轴或 t 轴的左侧。 指定位置为 100 的标签位于 y 轴或 r 轴顶部，或者位于 x 轴或 t 轴右侧。	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
此示例演示了如何显示默认标签值，但仅在指定位置显示。 chxp=1,10,35,75 - y 轴应仅显示三个标签：10、35 和 75。由于未指定自定义标签文本，因此会显示这些轴值。请注意，使用 chxp 时，您不必平均间隔标签。如果此处未指定 chxp，则 y 轴上的默认标签值距离将以每 20 个单位为单位，如第二张图表所示。	chxt=x,y chxp=1,10,35,75 chxt=x,y 未指定 chxp

返回页首

轴标签样式 chxs

您可以为轴标签（包括自定义标签和默认标签值）指定字体大小、颜色和对齐方式。同一轴上的所有标签都具有相同的格式。如果一个轴有多个副本，您可以为每个副本设置不同的格式。您还可以指定标签字符串的格式，例如显示货币符号或尾随零。

默认情况下，顶部和底部的轴不会在值旁显示刻度线，而左侧和右侧的轴则会显示它们。

语法

多个轴的值应使用竖线字符 (|) 进行分隔。

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>

<axis_index>axis_index

应用此变量的轴。它是 chxt 参数中从零开始的索引。

<opt_format_stringopt_format_string>

[可选] 这是一个可选的格式字符串，如果使用，紧跟在轴索引编号后面，无需插入英文逗号。它以字母 N 开头，后跟以下值，所有值均为可选： 格式设置字符串语法如下：
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
每个元素的含义如下：

• <preceding_text> - 每个值前面的文字。
• *...* - 用星号括起来的可选块，您可以在其中指定数字的格式详情。以下值均受支持且均为可选：
  • <number_type> - 数值的数字格式。选择以下任一选项：
    • f - [默认] 浮点格式。 还可以考虑使用 <decimal_places> 值指定精度。
    • p - 百分比格式。系统会自动附加 % 符号。注意：使用此格式时，从 0.0 到 1.0 的数据值会映射到 0 到 100%（例如，0.43 将显示为 43%）。
    • e - 科学记数法格式。
    • c<CUR> - 以指定货币的格式设置数字的格式，并使用适当的货币标记。将 <CUR> 替换为三个字母的货币代码。示例：cEUR 表示欧元。 您可以在 ISO 网站上找到这些代码的列表，不过并非所有符号都受支持。
  • <decimal_places> - 一个整数，用于指定要显示的小数位数。该值将四舍五入（而非截断）到此长度。默认值为 2。
  • z - 显示尾随零。默认为 no。
  • s - 显示组分隔符。默认为 no。
  • x 或 y - 按照指定方式显示 x 或 y 坐标中的数据。x 数据的含义因图表类型而异：对您的图表进行实验以确定其含义。默认值为“y”。
• <following_text> - 每个值后面的字面量文本。

<opt_label_color>

要应用于轴文本（而非轴线）的颜色，采用 RRGGBB 十六进制格式。轴线颜色是使用 opt_axis_color 单独指定的。默认为灰色。

<opt_font_size>

[可选] 指定字体大小（以像素为单位）。此参数是可选的。

<opt_alignment>

[可选] 标签对齐方式。对于顶部或底部的轴，指示标签如何与其上方或下方的刻度线对齐；对于左侧或右侧轴，指示标签如何在其接触轴的边界框内对齐。指定以下某个数字：

• -1 - 顶部或底部：标签位于刻度线的右侧；左侧或右侧：标签在其区域内左对齐。R 轴标签的默认值。
• 0 - 顶部或底部：标签在刻度线上居中；左侧或右侧：标签在各自区域内居中。x 轴和 t 轴标签的默认值。
• 1 - 顶部或底部：标签位于刻度线左侧；左侧或右侧：标签在其区域内右对齐。y 轴标签的默认值。

<opt_axis_or_tick>

[可选；Google-o-meter 中不支持] - 是否显示此轴的刻度线和/或轴线。刻度线和轴线仅适用于最内侧的轴（例如，最内侧的两个 x 轴不支持它们）。请使用以下某个值：

• l（小写“L”）- 仅绘制轴线。
• t - 仅绘制刻度线。刻度线是轴标签旁边的小线。
• lt - [默认] 为所有标签绘制轴线和刻度线。
• _ -（下划线）既不绘制轴线，也不绘制刻度线。 如果您要隐藏轴线，请使用此值。

<tick_color>tick_color

[Google-o-meter 不支持] 刻度线颜色，采用 RRGGBB 十六进制格式。默认为灰色。

<opt_axis_coloropt_axis_color>

[可选] 此轴线的颜色，采用 RRGGBB 十六进制格式。默认为灰色。

 

示例

说明	示例
为第二条 x 轴（1 月、2 月、3 月）指定字体大小和颜色。	chxt=x,y,r,x chxr=2,0,4 chxl=3:|Jan|Feb|Mar|      1:|min|average|max chxp=1,10,35,75 chxs=3,0000DD,13,0,t
为右侧 y 轴指定了字体大小、颜色和对齐方式。已绘制刻度线，但未绘制轴线。	chxt=x,y,r,x chxl=3:|Jan|Feb|Mar|      2:|min|average|max chxp=2,10,35,95 chxs=2,0000DD,13,-1,t,FF0000
此图表包含三个数据集，并显示三组轴标签，每个标签系列对应一个。每组标签都使用自定义格式字符串设置格式，如下所示： 0N*e,000000| 0 表示第一个数据系列 N 表示格式字符串 * 表示格式说明符的开头 e 表示科学计数法 * 表示格式说明符的结尾 000000 表示黑色文本。 1N*cUSD*Mil,FF0000| 1 表示第二个系列 N 表示格式字符串 * 表示格式说明符的开头 c 表示货币标记 USD 将美元指定为要使用的货币标记 * 表示格式说明符的结尾 Mil 是跟在字符串后面的字面量 FF0000 表示红色文字。 2N*sz2*,0000FF 2 表示第三个系列 N 表示格式字符串 * 表示格式说明符的开头 s 表示显示分组说明符（在美式英语语言区域中，即为每三个零添加一个英文逗号） z2 表示显示两个尾随零 0000FF 表示蓝色文本。 轴标签范围使用 chxr 参数（axis_index、start、end、step）设置。 如果未设置，则默认值为 0—100。	chd=s:   984sttvuvkQIBLKNCAIi,   DEJPgq0uov17zwopQODS,   AFLPTXaflptx159gsDrn chxr=   0,0,1000000,250000|   1,0,60|   2,0,5000 chxs=   0N*e,000000|   1N*cUSD*Mil,FF0000|   2N*sz2*,0000FF

返回页首

轴刻度线样式 chxtc

您可以为特定轴指定长刻度线。这通常用于将刻度线延伸到图表的长度。使用 chxs 参数更改刻度线颜色。

应使用竖线字符 (|) 分隔多个轴的值。数据系列中的值应以英文逗号分隔。

语法

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>

<axis_index>axis_index

应用此变量的轴。这是 chxt 参数中从零开始的索引。请使用竖线分隔符分隔不同轴的值。

<tick_length_1>,...,<tick_length_n>

相应轴上刻度线的长度（以像素为单位）。如果给定了单个值，则它会应用于所有值；如果指定了多个值，则轴刻度线会在该轴的值列表中循环。正值会在图表区域以外绘制，并由图表边框剪裁。最大的正值为 25。负值会在图表区域内绘制，并由图表区域边框剪裁。

 

示例

说明	示例
使用 chxtc 创建红色长刻度线的示例。此处的刻度线长度超过了图表区域的宽度，但为了适应图表的大小，我们进行了剪裁。 chxt=x,y,r,x - 显示左轴、一条右轴和两条底部轴。 chxl=2:|min|average|max|3:|Jan|Feb|Mar - 分配给“r”轴（右侧）和外侧 x 轴的标签文本。 chxp=2,10,35,95 - 这三个标签沿 r 轴（索引=2）的自定义标签位置。 chxs=2,0000dd,13,-1,t,FF0000 - r 轴的轴标签样式：文字颜色、文字大小、左对齐和红色刻度线。 chxtc=1,10|2,-180 - y 轴和 r 轴的轴刻度线长度。 第一个值指定轴外侧长度为 10 像素的刻度线。第二个值指定轴内部长度为 180 像素的刻度线；负数表示刻度线位于轴内部，并且系统会剪裁刻度线以适应图表的大小。	chxt=x,y,r,x chxl=   2:|min|average|max|   3:|Jan|Feb|Mar chxp=2,10,35,95 chxs=   2,0000dd,13,-1,t,FF0000 chxtc=1,10|2,-180
此图表展示了交替的刻度线长度。chxtc 为 y 轴指定了两个刻度线值（5 和 15），并且图表上绘制的刻度线会交替显示这两个值。	chxt=x,y chxtc=   1,5,15

返回页首

背景填充 chf [所有图表]

您可以为图表数据区域和/或整个图表背景指定填充颜色和样式。填充类型包括单色填充、条纹填充和渐变填充。您可以为不同区域（例如整个图表区域或仅数据区域）指定不同的填充。图表区域填充会覆盖背景填充。所有填充均使用 chf 参数指定，您可以通过使用竖线字符 ( | ) 分隔各个值，在同一图表中混合使用不同的填充类型（单色、条纹、渐变）。图表区域填充会覆盖图表背景填充。

实心填充 chf [所有图表]

您可以为背景和/或图表区域指定纯色填充，也可以为整个图表指定透明度值。您可以使用竖线字符 (|) 指定多种填充。（Maps：仅限背景）。

语法

chf=<fill_type>,s,<color>|...

<fill_typefill_type>

要填充的图表部分。指定以下某个值：

• bg - 背景填充
• c - 图表区域填充。不支持地图图表。
• a - 将整个图表（包括背景）设为透明。 系统会忽略 <color> 的前六位数，而仅后两位数（透明度值）会应用于整个图表和所有填充。
• b<index> - 条形纯色填充（仅限条形图）。 将 <index> 替换为条形的数据系列索引，以纯色填充条形。此效果类似于在条形图中指定 chco。有关示例，请参阅条形图系列颜色。

秒

表示单色或透明填充。

<color>

填充颜色，采用 RRGGBB 十六进制格式。对于透明度，系统会忽略前 6 位数字，但无论如何都必须将其包含在内。

 

示例

说明	示例
此示例用浅灰色 (EFEFEF) 填充了图表背景。	chf=bg,s,EFEFEF
此示例用浅灰色 (EFEFEF) 填充了图表背景，用黑色 (000000) 填充了图表区域。	chf=c,s,000000| bg,s,EFEFEF
此示例将 50% 的透明度应用于整个图表（80 在十六进制中为 128，即约为 50% 的透明度）。请注意，表格单元格背景透过图表显示出来。	chf=a,s,00000080

返回页首

渐变填充 chf [线条、条形图、Google-O-Meter、雷达、散点、维恩]

您可以对图表区域或背景应用一种或多种渐变填充。渐变填充是指从一种颜色淡化为另一种颜色。（饼图、Google-O-Meter 图表：仅限背景。）

每个渐变填充都会指定一个角度，以及锚定到指定位置的两种或更多颜色。颜色会随着锚点从一个锚点移动到另一个锚点而发生变化。您必须至少有两种颜色，它们的 <color_centerpoint> 值不同，这样才能让一种颜色淡入另一种。每个额外的渐变均由 <color>,<color_centerpoint> 对指定。

语法

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>

<fill_typefill_type>

要填充的图表区域。以下其中一列：

• bg - 背景填充
• c - 图表区域填充。
• b<index> - 条形渐变填充（仅限条形图）。 将 <index> 替换为条形的系列索引，以便用渐变效果进行填充。有关示例，请参阅条形图系列颜色。

lg

指定渐变填充。

<angle>

一个数字，用于指定渐变的角度，范围为 0（水平）到 90（垂直）。

<color>

填充颜色，采用 RRGGBB 十六进制格式。

<color_centerpoint>

指定颜色的定位点。颜色将从该点开始随着接近另一个锚点而逐渐淡化。值范围为 0.0（下边缘或左边缘）到 1.0（上边缘或右边缘），并以 <angle> 指定的角度倾斜。

 

示例

说明	示例
图表区域具有角度指定为零 (0) 的水平线性渐变。 颜色为居中位于左侧（位置 0.0）的桃红色 (FFE7C6) 和居中位于右侧（位置 1.0）的蓝色 (76A4FB)。 图表背景用灰色 (EFEFEF) 绘制。	chf=   c,lg,0,   FFE7C6,0,（桃红色）   76A4FB,1（蓝色）
图表区域具有角度指定为四十五度 (45) 的对角线（从左下角到右上角）线性渐变。 第一个指定的颜色是桃红色 (FFE7C6)。图表的左下角是纯桃红色。 第二个指定的颜色是蓝色 (6A4FB)。图表的右上角是纯蓝色。请注意我们如何指定 0.75 的偏移量，以提供向右上角逐渐消失的蓝色峰值。 图表背景用灰色 (EFEFEF) 绘制。	chf=   c,lg,45,   FFE7C6,0, （桃红色）   76A4FB,0.75（蓝色）
此图表区域带有角度指定为九十度 (90) 的垂直（从顶部到底部）线性渐变。 第一个指定的颜色是蓝色 (76A4FB)。图表的顶部是纯蓝色。 第二个指定的颜色是桃红色 (FFE7C6)。图表的底部是纯桃红色。 图表背景用灰色 (EFEFEF) 绘制。	chf=   c,lg,90,   FFE7C6,0, （桃红色）   76A4FB,0.5（蓝色）

返回页首

 

条纹填充 chf [折线图、条形图、Google-o-meter、雷达图、散点图、维恩]

您可以为图表区域或整个图表指定条纹背景填充。（饼图和 Google-O-Meter 图表：仅限背景）。

语法

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>

<fill_typefill_type>

要填充的图表区域。以下其中一列：

• bg - 背景填充
• c - 图表区域填充
• b<index> - 条形条纹填充（仅限条形图）。 将 <index> 替换为条形的数据系列索引，即可用条纹填充条形。有关示例，请参阅条形图系列颜色。

ls

指定线性条纹填充。

<angle>

所有条纹相对于 y 轴的角度。对于垂直条纹，请使用 0；对于水平条纹，请使用 90。

<color>

条纹的颜色，采用 RRGGBB 十六进制格式。对其他每个条纹重复 <color> 和 <width>。你必须至少有两条条纹。条纹会交替显示，直到将图表填满。

<width>

此条带的宽度，从 0 到 1，其中 1 是图表的全宽。系统会重复使用条纹，直到将图表填满。 对其他每个条纹重复 <color> 和 <width>。你必须至少有两条条纹。条纹会交替显示，直到将图表填满。

 

示例

说明	示例
bg,ls,0 - 背景条纹填充，其中条纹与 y 轴（平行于 y 轴）夹角为 0 度。条纹会填充图表背景以及图表区域。 CCCCCC,0.15 - 第一种条纹是深灰色的，宽度为图表的 15%。 FFFFFF,0.1 - 第二条条纹是白色的，宽度为图表的 10%。	chf=   bg,ls,0,   CCCCCC,0.15,   FFFFFF,0.1
c,ls,90 - 带有与 y 轴成九十度角的水平条纹的图表区域。条纹填充了图表区域，但省略了图表背景。 999999,0.25 - 第一种条纹是深灰色的，宽度为图表的 25%。 CCCCCC,0.25 - 与第一种条纹相同，但为浅灰色。 FFFFFF,0.25 - 与第一种条纹相同，但为白色。	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

返回页首

数据函数 chfd [所有 chd 图表]

您可以使用 muParser 函数语法指定要在图表数据上运行的自定义函数。函数中使用的数据可出自以下两个来源：

• 来自 chd 的数据系列 - 此数据提取自 chd 中指定的系列。
• 在 chfd 参数本身中声明的一系列值 - 您可以为任意数据范围声明起始值、停止值和步进值。

请务必注意，在任何情况下，您都必须将输出分配给 chd 中的现有系列；函数输出会覆盖该系列。只有在处理完所有函数后，图表才会呈现，因此，如果您将多个函数输出到同一数据系列，这些函数将按指定顺序运行，但只会在图表上绘制最终函数的输出。请注意，您可以串联多个函数，以便一个函数可以将上一个函数输出的系列作为输入。

如需为函数行分配颜色或 chm 标记，请将颜色或标记分配给函数的系列索引。请注意，在函数操作数据后，系统会根据数据放置标记。

语法

chfd=
  <output_series_index>,<function_data>,<function_string>
    |...|
  <output_series_index>,<function_data>,<function_string>

<output_series_index>output_series_index

函数输出将写入的 chd 中数据系列的索引（从零开始）。函数输出将完全覆盖任何现有数据。如果某个系列未用作函数的输入，则最佳做法是为该系列分配一个虚拟值。

<function_data>

要绘制的变量和数据。数据可以来自您定义的范围，也可以来自 chd 数据系列之一。您可以为每个函数指定多个变量，使用 ;（分号）分隔符分隔多个变量。请注意，如果您为单个函数定义多个变量，而这些变量的点数量不同，则该函数会在到达第一个端点时停止。例如，如果某个函数同时定义了 x=1—5 step 1 和 y=1—10 step 1，则该函数将在到达第五个点时结束。
    <variable_name>,<input_series_index>
         或
    <variable_name>,<start>,<end>,<step>

• variable_name - 变量的任意字符串名称。 请在由 function_string 定义的函数中使用。
• input_series_index - 要用作输入数据的 chd 数据系列的索引。
• start - 范围的数值起始值。
• end - 范围的结束数值。
• step - 从 start 到 end 的数值步进值。 正值或负值均可，但不可为零。

示例 ：x,0,100,1 声明了一个名为 x 的变量，其值为 0、1、2 ... 100。x,0,100,1;r,0,3.1,.1 声明同一 x 变量以及一个名为 r 且值为 0、0.1、0.2、...、3.0、3.1 的变量。x,0 会声明一个名为 x 的变量，该变量使用第一个 chd 系列中的数据。这些变量将由 function_string 使用。 除非您在 function_string 中指定这些变量，否则系统不会将其绘制在图表上。阶值越小，图表越平滑。

<函数字符串>function_string

使用 muParser 语法编写的函数。该函数会应用于 variable_data 中指定的变量和数据。 您只能引用此本地函数集中声明的变量，而不能引用另一组以竖线分隔的 chfd 参数中声明的变量。不支持 muParser 摘要函数（最小值、最大值、平均值）。重要提示：切记在您的函数中使用 %2B 而不是 +！

 

示例

说明	示例
简单的正弦波。需要注意以下几点： chd=t:-1 - 我们对图表数据使用虚拟变量，因为我们的数据是在 chfd 参数中声明的。 chco=FF0000 - 为第一个数据系列指定了红色。即使我们不使用 chd 中的数据，系统也会为该绘制函数使用该系列的相应颜色。 chfd=0,x,0,11,0.1,sin(x)*50%2B50 - 我们声明一个名为 x 的变量，其值为 0—11，递增 0.1。它分配给第一个数据系列，这意味着它将获得第一个数据系列颜色 (FF0000)。 对 x 应用的函数是 sin(x) * 50 + 50。请注意，我们必须如何对该函数中的 + 进行编码。	cht=lc chd=t:-1 chco=FF0000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chxt=x,y
此行使用了来自 chd 参数的数据。	chd=t:5,10 chfd=0,x,0,x*4
函数线和非函数线混合。 请注意颜色是如何通过系列颜色参数 chco 指定的。 注意标记在函数输出上的位置；数据点是通过 start、end 和 step 计算得出的。因此，如果您的范围是 0—11 step 0.1，则点 0 为 0，点 1 为 0.1，以此类推，直到点 110，其值为 11。	chd=t:   -1   15,45 chco=   FF0000,000000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chm=   c,00A5C6,0,110,10   a,00A5C6,0,60,10
要在二维空间中定义函数，请使用 lxy 图表，分配两个虚拟系列，并为每个系列分配一个函数。 0,x,0,10,0.1,sin(x)*50%2B50 - 数据系列 0（x 轴值）包含一个名为 x 的变量，其值介于 0—10、step 0.1 之间，以及函数 sin(x)*50 + 50 0,y,0,10,0.1,sin(y)*50%2B50 - 数据系列 0（y 轴值）包含一个名为 y 的变量，其值介于 0—10、step 0.1 之间，还有一个函数 sin(x)*50 + 50	cht=lxy chd=t:-1|-1 chfd=   0,x,0,10,0.1,sin(x)*50%2B50|   1,y,0,10,0.1,cos(y)*50%2B50
chfd 参数可让您尽情挥洒创意。 尝试点击这些图片，以在图表园地中打开并试用它们；您一定会着迷！

返回页首