이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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`	페이지로 나누기를 사용 설정하고 각 페이지의 행 수와 표시할 첫 번째 표 페이지를 설정합니다 (페이지 번호는 0부터 시작).
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	0번 열이 가장 오른쪽 열이고 마지막 열이 가장 왼쪽 열이 되도록 표의 열 순서를 반대로 하여 오른쪽에서 왼쪽으로 쓰는 언어 (예: 아랍어, 히브리어)에 대한 기본 지원을 추가합니다.
`enableSorting(enableSorting)`	`TableChartBuilder`	사용자가 열 제목을 클릭할 때 열을 정렬할지 여부를 설정합니다.
`setDataSourceUrl(url)`	`TableChartBuilder`	Google Sheets와 같은 외부 소스에서 데이터를 가져오는 데 사용되는 데이터 소스 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 요소에 삽입하거나 정적 이미지로 사용할 수 있는 차트 객체입니다.

`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) 언어 표시가 지원되지 않습니다. 페이징을 사용 설정 (페이지 옵션 사용)하거나 필요한 표 크기보다 작은 높이 및 너비 옵션을 지정하여 표에 스크롤 막대가 있는 경우에는 이 옵션이 무시됩니다. 기본 동작은 RTL 지원이 사용 중지된 것입니다.

매개변수

이름	유형	설명
`rtlEnabled`	`Boolean`	오른쪽에서 왼쪽 지원을 사용 설정해야 하는 경우 `true`, 그렇지 않으면 `false`입니다.

리턴

TableChartBuilder: 체이닝에 유용한 빌더입니다.

`enableSorting(enableSorting)`

사용자가 열 제목을 클릭할 때 열을 정렬할지 여부를 설정합니다.

정렬이 사용 설정된 경우 사용자가 열 헤더를 클릭하면 행이 자동으로 정렬됩니다. 기본 동작은 정렬이 사용 설정되어 있습니다.

매개변수

이름	유형	설명
`enableSorting`	`Boolean`	`true`: 열 헤더를 클릭하여 정렬을 사용 설정합니다. 그렇지 않으면 `false`입니다.

리턴

TableChartBuilder: 체이닝에 유용한 빌더입니다.

`setDataSourceUrl(url)`

Google Sheets와 같은 외부 소스에서 데이터를 가져오는 데 사용되는 데이터 소스 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.
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: 체이닝에 유용한 빌더입니다.