图表（Chart）宏

图表的显示类型。XY 图表含有素质的 x- 和 y- 坐标轴。x 值可能是可选项，如果 x 是作为时间轴的话，请查看时间序列参数。

Standard — pie, bar, line, area

XY Plots — xyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeries

Other — gantt

在区域图，饼图和折线图中可以使用。

• • vertical — y-轴是垂直的
  • horizontal — x-轴是垂直的

在区域图，饼图和折线图中可以使用。

• 3D 图使用 75% 的透明率
• 非堆叠图使用 50% 的透明率
• 所有其他图使用 100% 的透明率

设置如何在宏中显示格式化数据（通常在数据表格中）。默认得的情况，表格数据是不会被处理的。

• • before — 数据将会在图表之前显示。
  • after — 数据将会在图表之后显示。

图表中使用的图片格式。

• • png
  • jpg

y 轴的标签（range)。

标题 id 使用的逗号分隔符号的列表 和/或 数字（从 1 开始）包含有宏内的数据，这个数据可以被用作为图表进行显示。

如果数据表被嵌入到其他表格中，那么表格的选择是必须的。这种情况多半是在页面有复杂架构的时候发生，例如你在页面中使用了块和列进行了页面布局。

为图表的数据使用的逗号分隔符标签 和/或 标题 和/或 列数量

这个对所有表格都会处理。列的树立从 1 开始，列的标签文字为列的头行。列标题是标题行中的列（HTML）标题属性。

• • vertical — 数据表的列将会被作为 X 轴（序列轴）。
  • horizontal — 数据表的列将会被作为 Y 轴（序列轴）。

• • true — x 值在 XY 坐标汇通中将会被视为时间序列数据，然后会根据日期格式进行格式化。

针对时间序列数据，日期格式允许为日期值进行更多的自定义配置。如果日期格式被指定的话，这个值将会被首先被用于进行日期格式化。

指定的值必须满足时间序列数据，请查看  简单日期格式 中的说明。

从本地参数配置中来对确定语言参数。附加的数字和日期格式将会使用默认的语言配置进行格式化。

 请参考 ISO 639-1 2 字符代码表  中的说明。

• • true — 宏将会对数字和日期进行格式化，这个格式化有可能与默认值或者用户指定的值对不上。
  • false — 将会对数字和日期进行强制格式化。当这个格式化过程中有错误的话，那么图表是不会被显示的。

坐标轴标签文字的类别。

• • up45 — 向上45度
  • up90 — 向上90度
  • down45 — 向下45度
  • down90 — 向下90度

日期刻度参数的位置

• • start — 刻度标记在日期区间开始
  • middle — 刻度标记在日期区间中间 
  • end — 刻度标记在日期区间结束

• • %0% 用 Key 替代饼图的 。
    %1% 用数字值替代饼图。
  • %2% 用百分比替代饼图。

例子 1: "%0% = %1%" 将会显示下面的内容 "Independent = 20"
例子 2: "%0% (%2%)" 将会显示下面的内容 "Independent (20%)"

图表将会作为附件保存的附件的名字和位置。用户必须在指定的页面中具有附件操作的权限。

•  ^attachmentName.png — 图表将会在当前页面中作为附件保存。
• page^attachmentName.png — 图表将会在提供的页面名字的页面中作为附件保存。
• space:page^attachmentName.png — 图表将会在指定的空间提供的页面名字的页面中作为附件保存。

定义保存的图表使用的版本。

• • new — 创建附件的新版本。
  • replace — 替换图表的前一个版本。如果希望替换已有的一个附件，用户必须在指定的页面中具有附件操作的权限。
  • keep — 当指定的同一个名字的附件不存在的时候，保存为一个新的附件。已经存在的附件将不会被修改或者更新。

• •  true — 图表附件将会使用缩略图显示

<ac:structured-macro ac:name="chart">
  <ac:parameter ac:name="title">Fish Sold</ac:parameter>
  <ac:parameter ac:name="type">pie</ac:parameter>
  <ac:rich-text-body>
    <table>
      <tbody>
        <tr>
          <th>
            <p>Fish Type</p>
          </th>
          <th>
            <p>2004</p>
          </th>
          <th>
            <p>2005</p>
          </th>
        </tr>
        <tr>
          <th>
            <p>Herring</p>
          </th>
          <td>
            <p>9,500</p>
          </td>
          <td>
            <p>8,300</p>
          </td>
        </tr>
        <tr>
          <th>
            <p>Salmon</p>
          </th>
          <td>
            <p>2,900</p>
          </td>
          <td>
            <p>4,200</p>
          </td>
        </tr>
        <tr>
          <th>
            <p>Tuna</p>
          </th>
          <td>
            <p>1,500</p>
          </td>
          <td>
            <p>1,500</p>
          </td>
        </tr>
      </tbody>
    </table>
  </ac:rich-text-body>
</ac:structured-macro>

{chart:type=pie|title=Fish Sold}
|| Fish Type || 2004 || 2005 ||
|| Herring | 9,500 | 8,300 |
|| Salmon | 2,900 | 4,200 |
|| Tuna | 1,500 | 1,500 |
{chart}