Class TableChartBuilder

グラフビルダー

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

以下は、表形式のグラフを作成する方法の例です。データは Google スプレッドシートからインポートされます。

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

メソッド

メソッド戻り値の型概要
build()Chartグラフを作成します。
enablePaging(enablePaging)TableChartBuilderデータのページングを有効にするかどうかを設定します。
enablePaging(pageSize)TableChartBuilderページングを有効にして、各ページの行数を設定します。
enablePaging(pageSize, startPage)TableChartBuilderページ設定を有効にし、各ページの行数と表示する最初のテーブル ページを設定します(ページ番号はゼロベースです)。
enableRtlTable(rtlEnabled)TableChartBuilder表の列の順序を逆にして、列 0 が右端の列、最後の列が左端の列になるようにすることで、右から左の言語(アラビア語やヘブライ語など)の基本的なサポートを追加しました。
enableSorting(enableSorting)TableChartBuilderユーザーが列見出しをクリックしたときに列を並べ替えるかどうかを設定します。
setDataSourceUrl(url)TableChartBuilderGoogle スプレッドシートなどの外部ソースからデータを取得するために使用されるデータソース URL を設定します。
setDataTable(tableBuilder)TableChartBuilderDataTableBuilder を使用して、グラフに使用するデータテーブルを設定します。
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 - ドキュメントや UI 要素に埋め込んだり、静的な画像として使用したりできるグラフ オブジェクト。


enablePaging(enablePaging)

データのページングを有効にするかどうかを設定します。

デフォルトの動作では、ページングは無効になっています。ページングが有効な場合、デフォルトのページサイズは 10 です。

パラメータ

名前説明
enablePagingBooleanページングを有効にする場合は true、それ以外の場合は false

戻る

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


enablePaging(pageSize)

ページングを有効にして、各ページの行数を設定します。

デフォルトのページサイズは 10 です。

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

パラメータ

名前説明
pageSizeIntegerテーブルの各ページの行数。

戻る

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


enablePaging(pageSize, startPage)

ページ設定を有効にし、各ページの行数と表示する最初のテーブル ページを設定します(ページ番号はゼロベースです)。

デフォルトのページサイズは 10、デフォルトの開始ページは 0 です。

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

パラメータ

名前説明
pageSizeIntegerテーブルの各ページの行数。
startPageInteger表示する最初の表ページ(ページ番号は 0 ベース)。

戻る

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


enableRtlTable(rtlEnabled)

表の列の順序を逆にして、列 0 が右端の列、最後の列が左端の列になるようにすることで、右から左の言語(アラビア語やヘブライ語など)の基本的なサポートを追加しました。

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

パラメータ

名前説明
rtlEnabledBoolean右から左のサポートを有効にする場合は true、それ以外の場合は false

戻る

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


enableSorting(enableSorting)

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

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

パラメータ

名前説明
enableSortingBooleantrue: 列見出しをクリックして並べ替えを有効にします。それ以外の場合は false です。

戻る

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


setDataSourceUrl(url)

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

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

パラメータ

名前説明
urlStringクエリ パラメータを含むデータソースの URL。

戻る

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


setDataTable(tableBuilder)

DataTableBuilder を使用して、グラフに使用するデータテーブルを設定します。これは、build() を呼び出すことなくデータテーブルを設定する便利なメソッドです。

パラメータ

名前説明
tableBuilderDataTableBuilderデータテーブル ビルダー。この呼び出しの一部として新しいデータ表が即座に作成されるため、ビルダーの更新はグラフに反映されません。

戻る

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


setDataTable(table)

グラフの線と X 軸ラベルを含むデータ表を設定します。最初の列は文字列で、横軸のラベルを含める必要があります。その後に任意の数の列を追加できます。すべての列は数値にする必要があります。各列は個別の行として表示されます。

パラメータ

名前説明
tableDataTableSourceグラフに使用するデータ表。

戻る

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


setDataViewDefinition(dataViewDefinition)

グラフに使用するデータビューの定義を設定します。

パラメータ

名前説明
dataViewDefinitionDataViewDefinitionグラフの描画に使用するデータソースから派生させるビューを定義するデータビュー定義オブジェクト。

戻る

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


setDimensions(width, height)

グラフのディメンションを設定します。

パラメータ

名前説明
widthIntegerグラフの幅(ピクセル単位)。
heightIntegerグラフの高さ(ピクセル単位)。

戻る

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


setFirstRowNumber(number)

データ表の最初の行の行番号を設定します。

最初の行のデフォルトの行番号は 1 です。

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

パラメータ

名前説明
numberIntegerデータ表の最初の行の行番号。

戻る

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


setInitialSortingAscending(column)

テーブルの最初の並べ替え(昇順)に使用する列のインデックスを設定します。

列は昇順で並べ替えられており、そのことを示す小さな矢印が付いています。

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

パラメータ

名前説明
columnIntegerテーブルの最初の並べ替えに使用する列番号。

戻る

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


setInitialSortingDescending(column)

テーブルの最初の並べ替え(降順)に使用する列のインデックスを設定します。

列は降順で並べ替えられており、そのことを示す小さな矢印が付いています。

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

パラメータ

名前説明
columnIntegerテーブルの最初の並べ替えに使用する列番号。

戻る

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


setOption(option, value)

このグラフの詳細オプションを設定します。このグラフで使用可能なオプションをご覧ください。指定されたオプションが無効な場合、このメソッドは効果を生じさせません。

// Build a table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

パラメータ

名前説明
optionString設定するオプション。
valueObject設定する値。

戻る

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


showRowNumberColumn(showRowNumber)

行番号をテーブルの最初の列として表示するかどうかを設定します。

デフォルトでは、行番号は表示されません。

パラメータ

名前説明
showRowNumberBoolean表の最初の列に行番号を表示する場合は true、それ以外の場合は false

戻る

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


useAlternatingRowStyle(alternate)

表グラフの奇数行と偶数行に交互の色スタイルを割り当てるかどうかを設定します。

デフォルトの動作では、行の色スタイルが交互になります。

パラメータ

名前説明
alternateBoolean色のスタイルを交互に表示する場合は true、それ以外の場合は false

戻る

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