本文档介绍了如何使用 Chart API 创建饼图。
目录
图表专属功能 |
标准功能 |
概览
饼图适合显示部分与整体之间的简单比例信息。 您可以创建单系列饼图(每个系列由多个切片组成),也可以创建多系列同心图表。
每个系列用于描述一个饼形,而每个数据值则指定一个切片。使用嵌套饼图(如下所述)时,请使用多个系列。
如需显示与切片关联的文本,您必须使用饼图标签或图表图例。饼图标签是图表周围的文本,线条指向相应切片。图例是按颜色关联的文本。
标签 | 图例 | 标签和图例 |
---|---|---|
chl=January|February|March|April |
chdl=January|February|March|April |
chl=January|February|March|April |
值是以彼此相对的相对方式显示:因此,值为 1,2,3 的图表与显示值为 100,200,300 的图表的效果相同。但是,当使用文本格式数据时,大于 100 的值会被削减为 100,因此您需要使用具有自定义缩放功能的文本格式来正确显示大于 100 的切片(使用 chds
参数,最小值/最大值为 chds=0,<max-slice-size>
)。
如果采用的是负值,那么相应尺寸的切片将显示为空。
图表类型
您可以创建三种常规类型的饼图:平面图、同心饼图或 3D 饼图。请使用以下语法指定一种饼形图表:
语法
cht=<chart_type>
其中,<chart_type>
是以下类型之一:
参数 | 说明 | 示例 |
---|---|---|
|
二维饼形图表。 仅提供一个数据系列;后续的数据系列会遭到忽略。 默认情况下,饼图细分颜色由插值从深橙色变为浅黄色。按照系列颜色中的说明指定其他颜色。 如饼图标签中所述,使用 Google Chart API 会根据图表大小 ( |
|
|
三维饼形图表。 指定数据和格式的方式与上述二维饼图相同。 如果您要在三维饼图中添加标签,则可能需要将宽度大小指定为高度大小的 2.5 倍,以确保您的标签完全可见。 |
|
|
同心圆饼形图表。 提供两个或以上的数据系列。 |
|
所有类型 | 如果在数据中使用负值,则会导致相应切片显示为“空白”。 | cht=pc |
系列颜色 chco
您可以使用 chco
参数指定所有值、每个值或某些值的颜色。
语法
chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>
- <color>
- 采用 RRGGBB 十六进制格式的切片颜色。指定单一系列颜色,该系列中的所有切片都将按照该颜色从最深(第一个数据成员)到最浅(最后一个数据成员)的渐变进行着色。指定两个或更多个颜色(以 | 分隔),以描述各个切片颜色。如果您有多个系列(即包含多个同心环的图表),则可以用英文逗号分隔各个值,为不同的系列指定值。如果提供的切片/系列颜色少于显示的切片/系列,则图表将从系列的切片列表或图表的系列列表的开头循环。您无法为多系列图表中的每个系列指定不同的渐变。
说明 | 示例 |
---|---|
指定一种颜色,即可从最深(第一个切片)到最浅(最后一个切片)渐变。 |
|
定义一种渐变色;此示例中由黄色渐变为红色。 |
|
定义各个切片颜色;每个切片指定一种颜色。 | chd=t:10,20,30 |
此图表包含两个数据系列,但将颜色指定为所有切片的颜色为从黄色到红色 (BBBB00—BB0000) 的单一渐变。 | chco=BBBB00,BB0000 |
下面是一个同心图表,其中包含系列颜色和单独的切片颜色。该图表包含两个同心数据系列。 这些颜色以易于用户理解的形式为 chco=绿色|红色,蓝色|黄色。逗号将其分为两个系列:
|
chd=s:eYY,ORVM |
饼图标签 chl
您可以使用 chl
参数为各个饼图切片指定标签。您还可以显示具有相同或不同值的图例,每个切片对应一个图例条目。
有关字符串值的说明:标签字符串中仅允许使用安全的网址字符。为安全起见,如果字符串中包含不在字符集 0-9a-zA-Z
中的字符,您应对此类字符串进行网址编码。
您可以在此处找到网址编码器。
语法
chl= <label_value>| ... <label_value>
- <label_value>
- 要应用于切片的字符串值。标签会连续应用于
chd
中的数据点。如果您有多个系列(例如,对于同心饼图),系统会按照chd
中指定的顺序将标签应用于所有序列中的所有点。在每个标签之间使用竖线分隔符 (|
)。使用两个连续的竖线字符(中间不留空格)指定缺少的中间值:||
。您无需为所有切片添加标签。
示例
说明 | 示例 |
---|---|
适用于三维饼形图表的标签。 |
|
使用 通常,为了正确显示标签,二维饼图需要的宽度大约是高度的两倍,三维饼图需要的宽度大约是高度的 2.5 倍。 在第一个示例中,由于图表不够宽,仅部分显示了标签。 第二个示例显示,图表的宽度需为 280 像素,才能完整显示标签。(明确向 |
|
饼图旋转 chp
默认情况下,第一个数据系列从 3:00 开始绘制,并沿顺时针方向继续围绕图表绘制,但您可以使用 chp
参数指定自定义旋转角度。
语法
chp=<radians>
- <radians>
- 一个浮点值,用于描述图表顺时针旋转的弧度。一整圈为 2π(2 pi - 约 6.28)弧度。
示例
说明 | 示例 |
---|---|
要更改饼图的方向,请使用 |
|
下面是另一个饼图旋转示例。这些标记可与图表形状标记结合使用,以创建一些有趣的效果。 |
标准功能
此网页上的其他功能均为标准图表功能。
图表标题 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”。
示例
说明 | 示例 |
---|---|
标题、默认颜色和字体大小的图表。 使用加号 ( 使用竖线字符 ( 此处未指定 |
chtt=Site+visitors+by+month| |
标题颜色为蓝色,右侧对齐,20 点的图表。 |
chtt=Site+visitors |
图表图例文字和样式 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>
- 图例条目的文本。每个标签都会应用于
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
chdl=First|Second|Third |
第一个图表演示水平图例条目( |
|
此示例演示了如何更改字体大小。 |
|
图表边距 chma
[所有图表]
您可以指定图表边距的大小(以像素为单位)。从指定的图表尺寸 (chs
) 向内计算外边距;增加外边距不会增加总图表尺寸,而是会根据需要缩小图表区域。
默认情况下,边距为计算图表大小后剩余的外边距。此默认值因图表类型而异。您指定的外边距是一个最小值;如果图表区域为外边距留出了空间,则外边距大小将为剩余大小;您不能挤压小于任何图例和标签所要求的外边距。下图显示了图表的基本组成部分:
图表外边距包括轴标签和图例区域。除非您使用 提示:在条形图中,如果条形具有固定大小(默认设置),则图表区域宽度无法缩小。您必须使用 |
语法
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 像素,因此右侧的外边距会设置为图表图例的宽度,并且与其他外边距不同。 轴标签位于图表区域之外,因此在边缘空间内绘制。 |
|
如需在图例周围添加外边距,请为 在本例中,图例的宽度约为 60 像素。如果您将 |
|
轴样式和标签 [线条、条形图、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。 请注意,默认情况下,顶部轴和底部轴不会显示标签旁的刻度线。 |
|
您可以通过多次添加同一值来为每个轴添加多组标签。本示例显示了两组 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&chs=200x1" />x1"} |
此示例展示了一个水平条形图,包含一条 x 轴、一条 y 轴、一条顶部 t 轴和一条右侧 r 轴。 由于省略了轴标签,因此 Chart API 为 x 轴和 t 轴显示了 0 到 100 的范围。 y 轴和 r 轴的范围取决于条形的数量。本例中有五个条形,因此 Chart API 显示了 0 到 4 的范围。第一个标签位于第一个条形底部的中心,第二个标签位于第二个条形底部的中心,以此类推。 |
|
您可以通过在图表类型后面指定 :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
指定的轴数组中的从零开始的索引。例如,在chxt=x,r,y
中,r 轴为 1。 - <start_val>
- 一个数字,用于定义此轴的最低值。
- <end_val>
- 一个数字,用于定义此轴的最大值。
- <opt_step>
- [可选] 轴上刻度之间的计数步骤。没有默认的步长值;计算步长以尝试显示一组间隔合理的标签。
示例
说明 | 示例 |
---|---|
此示例显示了左右 y 轴( 每条轴都有一个定义的范围。由于未指定标签或位置,因此值将取自指定范围,并在该范围内以相等的间距排列。在该折线图表中,这些值以相等的间距沿 x 轴排列。 r 轴的方向相反(索引 |
|
此例已为 x 轴指定了值。 轴标签以相等的间距沿轴排列。<opt_step> 参数的值指定为五 ( |
|
自定义轴标签 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
参数中的最后一个标签之后放置竖线。
示例
说明 | 示例 |
---|---|
此图表展示了如何向两条轴添加自定义标签。请注意这些值是如何均匀分布的,以及最后一个 |
chxt=x,y |
此示例包含左右 y 轴的轴标签( |
|
此示例包含左侧和右侧 y 轴上的轴标签( 此例左侧 y 轴上的轴标签采用了默认值。 |
|
如果您想添加一个通用标签来描述整个轴(例如,将一条轴标记为“费用”,另一条轴标记为“学生”),请使用 |
chxt=x,x,y,y |
轴标签位置 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 轴标签。标签文本使用 指定位置为 指定位置为 |
|
此示例演示了如何仅在指定位置显示默认标签值。
|
chxt=x,y
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_string>opt_format_string
- [可选] 这是一个可选的格式字符串,如果使用,紧跟在轴索引编号后面,中间不加英文逗号。它以字母 N 开头,后面都是可选值:
N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
每个元素的含义如下:<preceding_text>
- 每个值前面的字面量文本。*...*
- 用星号括起来的可选块,您可以在该块中指定数字的格式详细信息。以下值均受支持且均为可选:<number_type>
- 数值的数字格式。选择以下任一选项:f
- [默认] 浮点格式。 也可以考虑使用 <小数位数> 值指定精度。decimal_placesp
- 百分比格式。系统会自动附加 % 符号。注意:使用此格式时,从 0.0 到 1.0 的数据值会映射到 0 到 100%(例如,0.43 将显示为 43%)。e
- 科学记数法格式。c<CUR>
- 使用相应的货币标记将数字设置为指定的货币格式。将<CUR>
替换为由三个字母组成的货币代码。示例:cEUR
表示欧元。 您可以在 ISO 网站上找到一系列代码,不过并非所有符号都受支持。
<decimal_places>
- 一个整数,用于指定要显示的小数位数。该值会四舍五入(非截断)到此长度。默认值为 2。z
- 显示尾随零。默认值为“否”。s
- 显示组分隔符。默认值为“否”。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_color>opt_axis_color
- [可选] 此轴线的颜色,采用 RRGGBB 十六进制格式。默认值为灰色。
示例
说明 | 示例 |
---|---|
为第二条 x 轴(1 月、2 月、3 月)指定了字体大小和颜色。 |
|
为右侧 y 轴指定了字体大小、颜色和对齐方式。已绘制刻度线,但未绘制轴线。 |
|
此图表包含三个数据集,并显示了三组轴标签,每个系列一个。每组标签都使用自定义格式字符串设置格式,如下所述:
轴标签范围是使用 |
chd=s: |
轴刻度线样式 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 为 y 轴指定了两个刻度线长度值(5 和 15),图表上绘制的刻度线会在这两个值之间切换。 |
chxt=x,y |
背景填充 chf
[所有图表]
您可以为图表数据区域和/或整个图表背景指定填充颜色和样式。填充类型包括纯色填充、条纹填充和渐变。
您可以为不同区域(例如整个图表区域,或仅数据区域)指定不同的填充。图表区域填充会覆盖背景填充。所有填充均使用 chf
参数指定,您可以在同一图表中混合使用不同的填充类型(纯色、条纹、渐变),只需用竖线字符 ( | ) 分隔值即可。图表区域填充会覆盖图表背景填充。
纯色填充 chf
[所有图表]
您可以为背景和/或图表区域指定纯色填充,或者为整个图表指定透明度值。您可以使用竖线字符 (|
) 指定多种填充。(地图:仅限背景)。
语法
chf=<fill_type>,s,<color>|...
- <fill_type>fill_type
- 要填充的图表部分。指定以下某个值:
bg
- 背景填充c
- 图表区域填充。不支持地图图表。a
- 将整个图表(包括背景)设为透明。<color>
的前六位数会被忽略,只有最后两位数(透明度值)会应用到整个图表和所有填充。b<index>
- 条形纯色填充(仅限条形图)。 将 <index> 替换为条形的系列索引,即可以纯色填充条形。其效果类似于在条形图中指定chco
。有关示例,请参阅条形图系列颜色。
- 秒
- 表示纯色或透明填充。
- <color>
- 填充颜色,采用 RRGGBB 十六进制格式。对于透明度,前六位数会被忽略,但无论如何都必须将其包含在内。
示例
说明 | 示例 |
---|---|
此示例使用浅灰色 ( |
|
下例用浅灰色 ( |
|
此示例将整个图表的透明度设为 50%(十六进制格式的 80 表示 128,即约为 50% 的透明度)。请注意,表格单元格背景透过图表显示出来。 |
|
渐变填充 chf
[线条、柱形、Google-o-meter、雷达、散点、维恩]
您可以对图表区域或背景应用一种或多种渐变填充。渐变填充是从一种颜色淡出到另一种颜色。(饼图、Google-O-Me 图表:仅限背景。)
每个渐变填充都指定一个角度,然后指定两种或更多颜色锚定到指定位置。颜色会随着从一个锚点移动到另一个锚点而变化。您必须至少具有两种具有不同 <color_centerpoint> 值的颜色,以便一种可以淡入另一种。每个额外的渐变均由 <color>,<color_centerpoint> 对指定。
语法
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_type>fill_type
- 要填充的图表区域。以下其中一列:
bg
- 背景填充c
- 图表区域填充。b<index>
- 条形渐变填充(仅限条形图)。 将 <index> 替换为条形的系列索引,以便用渐变色进行填充。有关示例,请参阅条形图系列颜色。
- lg
- 指定渐变填充。
- <angle>
- 一个数字,用于指定从 0(横向)到 90(纵向)的渐变角度。
- <color>
- 填充的颜色,采用 RRGGBB 十六进制格式。
- <color_centerpoint>
- 指定颜色的定位点。当该锚点接近另一个锚点时,颜色将从该点开始淡出。值范围是从 0.0(底部或左侧边缘)到 1.0(顶部或右侧边缘),按 <angle> 指定的角度倾斜。
示例
说明 | 示例 |
---|---|
图表区域采用角度为零 ( 颜色为桃色 ( 图表背景以灰色 ( |
|
图表区域采用角度为四十五度 ( 第一个指定的颜色是粉红色 ( 第二个指定的颜色是蓝色 ( 图表背景以灰色 ( |
|
图表区域采用角度为九十度 ( 第一个指定的颜色是蓝色 ( 第二个指定的颜色是桃红色 ( 图表背景以灰色 ( |
|
条纹填充 chf
[线条、条形图、Google-o-meter、雷达、散点图、维恩]
您可以为图表区域或整个图表指定条纹背景填充。(饼图、Google-O-Meter 图表:仅限背景。)
语法
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_type>fill_type
- 要填充的图表区域。以下其中一列:
bg
- 背景填充c
- 图表区域填充b<index>
- 条形条纹填充(仅限条形图)。 将 <index> 替换为条形的系列索引,以便用条纹填充。有关示例,请参阅条形图系列颜色。
- ls
- 指定线性条纹填充。
- <angle>
- 所有条纹相对于 y 轴的角度。对竖条纹使用
0
,或针对横向条纹使用90
。 - <color>
- 此条纹的颜色,采用 RRGGBB 十六进制格式。再为每一个其他条纹重复 <color> 和 <width>。您必须至少有两种条纹。条纹会交替显示,直到图表填满。
- <width>
- 此条纹的宽度,介于
0
到1
之间,其中1
为图表的全宽。系统会重复使用条纹,直到将图表填满。 再为每一个其他条纹重复 <color> 和 <width>。您必须至少有两种条纹。条纹会交替显示,直到图表填满。
示例
说明 | 示例 |
---|---|
|
chf= |
|
chf= |
数据函数 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_indexoutput_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>function_string
- 您的函数,使用 muParser 语法编写。该函数会应用于 variable_data 中指定的变量和数据。
您只能引用此本地函数集中声明的变量,而不能引用另一个以管道形式表示的
chfd
参数集中的变量。不支持 Summary muParser 函数(min、maxsum、avg)。重要提示:请务必在函数中使用%2B
,而不是+
!
示例
说明 | 示例 |
---|---|
简单的正弦波。需要注意以下几点:
|
cht=lc |
此行使用 chd 参数中的数据。 |
chd=t:5,10 |
函数线和非函数线的组合。 请注意颜色是通过系列颜色参数 请注意函数输出中标记的放置;数据点是根据 start、end 和 step 计算得出的,因此,如果您的范围是 0—11 step 0.1,则点 0 为 0,点 1 为 0.1,以此类推,直到点 110,其值为 11。 |
chd=t: |
如需在二维空间中定义函数,请使用
|
cht=lxy |
试着点击这些图片,在图表园地中将其打开并玩一玩;您一定会爱上它! |