表格图表的构建器。如需了解详情,请参阅 Google 图表文档。
以下示例展示了如何构建表格图表。数据是从 Google 电子表格导入的。
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; var chartBuilder = Charts.newTableChart() .setDimensions(600, 500) .enablePaging(20) .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
方法
详细文档
build()
enablePaging(enablePaging)
设置是否启用数据分页。
默认行为是停用分页。如果启用了分页,则默认页面大小为 10。
参数
名称 | 类型 | 说明 |
---|---|---|
enablePaging | Boolean | 如果应启用分页,则为 true ;否则为 false 。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
enablePaging(pageSize)
启用分页并设置每页中的行数。
默认页面大小为 10。
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
参数
名称 | 类型 | 说明 |
---|---|---|
pageSize | Integer | 表格每页中的行数。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
enablePaging(pageSize, startPage)
启用分页,设置每页中的行数和要显示的第一个表格页的行数(页码从零开始)。
默认页面大小为 10,默认初始页为 0。
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
参数
名称 | 类型 | 说明 |
---|---|---|
pageSize | Integer | 表格每页中的行数。 |
startPage | Integer | 要显示的第一个表格页(页码从 0 开始)。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
enableRtlTable(rtlEnabled)
通过反向排序表的列顺序,添加对从右到左书写的语言(例如阿拉伯语或希伯来语)的基本支持,使 0 列位于最右边的列,最后一列位于最左边的列。
这不会影响基础数据中的列索引,只会影响显示顺序。即使使用此选项,表格可视化图表也不支持完全双向 (BiDi) 语言显示。如果您启用分页(使用页面选项),或表具有滚动条(因为您指定了小于所需表大小的高度和宽度选项),则会忽略此选项。默认行为是停用 RTL 支持。
参数
名称 | 类型 | 说明 |
---|---|---|
rtlEnabled | Boolean | 如果应启用从右到左支持,则为 true ;否则,为 false 。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
enableSorting(enableSorting)
设置是否在用户点击列标题时对列进行排序。
如果启用了排序功能,当用户点击列标题时,系统会自动对行进行排序。默认行为是启用排序。
参数
名称 | 类型 | 说明 |
---|---|---|
enableSorting | Boolean | true ,点击列标题即可启用排序,否则为 false 。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setDataSourceUrl(url)
设置数据源网址,用于从外部来源(如 Google 表格)拉取数据。如果提供了数据源网址和 DataTable,系统会忽略数据源网址。
如需详细了解如何查询数据源,请参阅 Google 图表文档。
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据源网址,包括任何查询参数。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setDataTable(tableBuilder)
使用 DataTableBuilder 设置要用于图表的数据表。这是一种无需调用 build()
即可设置数据表的便捷方法。
参数
名称 | 类型 | 说明 |
---|---|---|
tableBuilder | DataTableBuilder | 数据表构建器。在此调用中,系统会立即创建新的数据表,因此对构建器的任何后续更新都不会反映在图表中。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setDataTable(table)
设置数据表,其中包含图表的线条以及 X 轴标签。第一列应为字符串,并包含横轴标签。后面可跟随任意数量的列,且所有列都必须是数字。每一列都显示为单独的一行。
参数
名称 | 类型 | 说明 |
---|---|---|
table | DataTableSource | 要用于图表的数据表。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setDataViewDefinition(dataViewDefinition)
设置要用于图表的数据视图定义。
参数
名称 | 类型 | 说明 |
---|---|---|
dataViewDefinition | DataViewDefinition | 一个数据视图定义对象,用于定义应从图表绘图的给定数据源派生的视图。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setDimensions(width, height)
设置图表的尺寸。
参数
名称 | 类型 | 说明 |
---|---|---|
width | Integer | 图表的宽度(以像素为单位)。 |
height | Integer | 图表的高度(以像素为单位)。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setFirstRowNumber(number)
设置数据表中第一行的行号。
第一行的默认行号为 1。
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
参数
名称 | 类型 | 说明 |
---|---|---|
number | Integer | 数据表中第一行的行号。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setInitialSortingAscending(column)
设置最初对表进行排序(升序)时所依据的列的索引。
列 os 按升序排序,并标有小箭头指示。
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
参数
名称 | 类型 | 说明 |
---|---|---|
column | Integer | 对表进行初始排序时应依据的列的编号。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setInitialSortingDescending(column)
设置最初对表进行排序(降序)所依据的列的索引。
列 os 按降序排序,并标有一个小箭头指示。
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
参数
名称 | 类型 | 说明 |
---|---|---|
column | Integer | 对表进行初始排序时应依据的列的编号。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
setOption(option, value)
设置此图表的高级选项。请参阅此图表的可用选项。如果指定的选项无效,此方法不会产生任何影响。
// Build a table chart which renders HTML. var builder = Charts.newTableChart(); builder.setOption('allowHtml', {@code true}); var chart = builder.build();
参数
名称 | 类型 | 说明 |
---|---|---|
option | String | 要设置的选项。 |
value | Object | 要设置的值。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
showRowNumberColumn(showRowNumber)
设置是否将行号显示为表格的第一列。
默认行为不显示行号。
参数
名称 | 类型 | 说明 |
---|---|---|
showRowNumber | Boolean | 如果表的第一列应显示行号,则为 true ;否则为 false 。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。
useAlternatingRowStyle(alternate)
设置是否将交替颜色样式分配给表格图表的奇数行和偶数行。
默认行为是采用交替颜色样式的行。
参数
名称 | 类型 | 说明 |
---|---|---|
alternate | Boolean | 如果颜色样式应该交替使用,则返回 true ;否则,返回 false 。 |
弃踢回攻
TableChartBuilder
- 此构建器,可用于链接。