このページは Cloud Translation API によって翻訳されました。

Class TableChartBuilder

表グラフのビルダー。詳しくは、Google Chart のドキュメントをご覧ください。

以下に、表グラフの作成方法の例を示します。データが 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();

Methods

メソッド	戻り値の型	概要
`build()`	`Chart`	グラフを作成します。
`enablePaging(enablePaging)`	`TableChartBuilder`	データに対するページングを有効にするかどうかを設定します。
`enablePaging(pageSize)`	`TableChartBuilder`	ページングを有効にし、各ページの行数を設定します。
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	ページングを有効にし、各ページの行数と表示する最初の表ページの行数を設定します（ページ番号はゼロから始まる）。
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	テーブルの列の順序を逆にして、右から左に記述する言語（アラビア語やヘブライ語など）の基本的なサポートを追加します。これにより、列 0 が右端の列、最後の列が左端の列になります。
`enableSorting(enableSorting)`	`TableChartBuilder`	ユーザーが列見出しをクリックしたときに列を並べ替えるかどうかを設定します。
`setDataSourceUrl(url)`	`TableChartBuilder`	Google スプレッドシートなどの外部ソースからデータを取り込むために使用されるデータソースの URL を設定します。
`setDataTable(tableBuilder)`	`TableChartBuilder`	DataTableBuilder を使用して、グラフに使用するデータテーブルを設定します。
`setDataTable(table)`	`TableChartBuilder`	グラフの線と X 軸のラベルを含むデータ表を設定します。
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	グラフに使用するデータビュー定義を設定します。
`setDimensions(width, height)`	`TableChartBuilder`	グラフのディメンションを設定します。
`setFirstRowNumber(number)`	`TableChartBuilder`	データテーブルの最初の行の行番号を設定します。
`setInitialSortingAscending(column)`	`TableChartBuilder`	テーブルの最初の並べ替え（昇順）に使用する列のインデックスを設定します。
`setInitialSortingDescending(column)`	`TableChartBuilder`	列のインデックスを設定します。このインデックスに基づいてテーブルが最初に並べ替えられます（降順）。
`setOption(option, value)`	`TableChartBuilder`	このグラフの詳細オプションを設定します。
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	行番号を表の最初の列として表示するかどうかを設定します。
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	表グラフの奇数行と偶数行に交互の色のスタイルを割り当てるかどうかを設定します。

詳細なドキュメント

`build()`

グラフを作成します。

リターン

Chart - Chart オブジェクト。ドキュメントや UI 要素への埋め込み、静止画像としての使用が可能です。

`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`	最初に表示する表ページ（ページ番号はゼロから始まる）。

リターン

TableChartBuilder - このビルダー。チェーンに役立ちます。

`enableRtlTable(rtlEnabled)`

テーブルの列の順序を逆にして、右から左に記述する言語（アラビア語やヘブライ語など）の基本的なサポートを追加します。これにより、列 0 が右端の列、最後の列が左端の列になります。

これは、基になるデータの列インデックスには影響せず、表示の順序にのみ影響します。このオプションを使用した場合でも、テーブル可視化では完全な双方向（BiDi）言語表示はサポートされていません。ページオプションを使用してページングを有効にしている場合や、指定した高さと幅のオプションがテーブルに必要なサイズよりも小さいためにテーブルにスクロールバーがある場合、このオプションは無視されます。デフォルトの動作では、RTL サポートは無効になっています。

パラメータ

名前	型	説明
`rtlEnabled`	`Boolean`	右から左へのサポートを有効にする場合は `true`、そうでない場合は `false`。

リターン

TableChartBuilder - このビルダー。チェーンに役立ちます。

`enableSorting(enableSorting)`

ユーザーが列見出しをクリックしたときに列を並べ替えるかどうかを設定します。

並べ替えを有効にすると、ユーザーが列ヘッダーをクリックすると、行が自動的に並べ替えられます。デフォルトでは、並べ替えは有効になっています。

パラメータ

名前	型	説明
`enableSorting`	`Boolean`	`true`: 列ヘッダーをクリックして並べ替えを有効にします。それ以外の場合は `false`。

リターン

TableChartBuilder - このビルダー。チェーンに役立ちます。

`setDataSourceUrl(url)`

Google スプレッドシートなどの外部ソースからデータを取り込むために使用されるデータソースの URL を設定します。データソースの URL と DataTable を指定した場合、データソースの URL は無視されます。

データソースのクエリについて詳しくは、Google グラフのドキュメントをご覧ください。

パラメータ

名前	型	説明
`url`	`String`	データソースの URL（クエリパラメータを含む）。

リターン

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 - このビルダー。チェーンに役立ちます。