Class TableChartBuilder

TableChartBuilder

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

テーブルグラフを作成する方法を示す例を次に示します。データは 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	ページングを有効にし、各ページの行数と表示する最初のテーブル ページを設定します（ページ番号は 0 から始まります）。
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 - ドキュメントや UI 要素に埋め込んだり、静的画像として使用したりできる Chart オブジェクト。

---

enablePaging(enablePaging)

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

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

パラメータ

名前	タイプ	説明
enablePaging	Boolean	ページングを有効にする必要がある場合は 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);

パラメータ

名前	タイプ	説明
pageSize	Integer	テーブルの各ページの行数。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

enablePaging(pageSize, startPage)

ページングを有効にし、各ページの行数と表示する最初のテーブル ページを設定します（ページ番号は 0 から始まります）。

デフォルトのページサイズは 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);

パラメータ

名前	タイプ	説明
pageSize	Integer	テーブルの各ページの行数。
startPage	Integer	表示する最初のテーブル ページ（ページ番号は 0 から始まります）。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

enableRtlTable(rtlEnabled)

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

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

パラメータ

名前	タイプ	説明
rtlEnabled	Boolean	右から左へのサポートを有効にする場合は true、それ以外の場合は false。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

enableSorting(enableSorting)

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

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

パラメータ

名前	タイプ	説明
enableSorting	Boolean	true 列ヘッダーをクリックして並べ替えを有効にする場合、false それ以外の場合。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

setDataSourceUrl(url)

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

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

パラメータ

名前	タイプ	説明
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.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

パラメータ

名前	タイプ	説明
number	Integer	データテーブルの最初の行の行番号。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

setInitialSortingAscending(column)

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

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

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

パラメータ

名前	タイプ	説明
column	Integer	テーブルの初期並べ替えに使用する列の番号。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

setInitialSortingDescending(column)

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

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

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

パラメータ

名前	タイプ	説明
column	Integer	テーブルの初期並べ替えに使用する列の番号。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

setOption(option, value)

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

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

パラメータ

名前	タイプ	説明
option	String	設定するオプション。
value	Object	設定する値。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

showRowNumberColumn(showRowNumber)

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

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

パラメータ

名前	タイプ	説明
showRowNumber	Boolean	テーブルの最初の列に行番号を表示する場合は true、それ以外の場合は false。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。

---

useAlternatingRowStyle(alternate)

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

デフォルトの動作は、行の色が交互に変わるスタイルです。

パラメータ

名前	タイプ	説明
alternate	Boolean	色スタイルを交互にする場合は true、それ以外の場合は false。

戻る

TableChartBuilder - このビルダー。チェーン処理に便利です。