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) 언어 표시가 지원되지 않습니다. 페이지로 나누기 (page 옵션 사용)를 사용 설정한 경우 또는 필요한 표 크기보다 작은 높이 및 너비 옵션을 지정하여 표에 스크롤 막대가 있는 경우 이 옵션은 무시됩니다. 기본 동작은 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 - 이 빌더(연결에 유용)

Class TableChartBuilder 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

메서드

자세한 문서

build()

리턴

enablePaging(enablePaging)

매개변수

리턴

enablePaging(pageSize)

매개변수

리턴

enablePaging(pageSize, startPage)

매개변수

리턴

enableRtlTable(rtlEnabled)

매개변수

리턴

enableSorting(enableSorting)

매개변수

리턴

setDataSourceUrl(url)

매개변수

리턴

setDataTable(tableBuilder)

매개변수

리턴

setDataTable(table)

매개변수

리턴

setDataViewDefinition(dataViewDefinition)

매개변수

리턴

setDimensions(width, height)

매개변수

리턴

setFirstRowNumber(number)

매개변수

리턴

setInitialSortingAscending(column)

매개변수

리턴

setInitialSortingDescending(column)

매개변수

리턴

setOption(option, value)

매개변수

리턴

showRowNumberColumn(showRowNumber)

매개변수

리턴

useAlternatingRowStyle(alternate)

매개변수

리턴

Class TableChartBuilder

`build()`

`enablePaging(enablePaging)`

`enablePaging(pageSize)`

`enablePaging(pageSize, startPage)`

`enableRtlTable(rtlEnabled)`

`enableSorting(enableSorting)`

`setDataSourceUrl(url)`

`setDataTable(tableBuilder)`

`setDataTable(table)`

`setDataViewDefinition(dataViewDefinition)`

`setDimensions(width, height)`

`setFirstRowNumber(number)`

`setInitialSortingAscending(column)`

`setInitialSortingDescending(column)`

`setOption(option, value)`

`showRowNumberColumn(showRowNumber)`

`useAlternatingRowStyle(alternate)`