Class TableChartBuilder

TableChartBuilder

표 차트 빌더입니다. 자세한 내용은 Google 차트 문서를 참고하세요.

다음은 표 차트를 만드는 방법을 보여주는 예입니다. 데이터는 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();

방법

메서드반환 유형간략한 설명
build()Chart차트를 작성합니다.
enablePaging(enablePaging)TableChartBuilder데이터를 통해 페이징을 사용할지 여부를 설정합니다.
enablePaging(pageSize)TableChartBuilder페이징을 사용 설정하고 각 페이지의 행 수를 설정합니다.
enablePaging(pageSize, startPage)TableChartBuilder페이징을 사용 설정하고, 각 페이지와 표시할 첫 번째 테이블 페이지의 행 수를 설정합니다 (페이지 번호는 0 기반).
enableRtlTable(rtlEnabled)TableChartBuilder0열이 가장 오른쪽 열이 되고 마지막 열이 가장 왼쪽 열이 되도록 테이블의 열 순서를 반대로 하여 오른쪽에서 왼쪽으로 쓰는 언어 (예: 아랍어, 히브리어)에 대한 기본 지원을 추가합니다.
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.
var builder = Charts.newTableChart();
builder.enablePaging(5);

매개변수

이름유형설명
pageSizeInteger표의 각 페이지에 있는 행 수입니다.

리턴

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.
var 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.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

매개변수

이름유형설명
numberInteger데이터 표에서 첫 번째 행의 행 번호입니다.

리턴

TableChartBuilder - 이 빌더로, 연결하는 데 유용합니다.


setInitialSortingAscending(column)

테이블을 처음에 정렬해야 하는(오름차순) 열의 색인을 설정합니다.

열이 오름차순으로 정렬되어 있으며 이를 나타내는 작은 화살표가 표시되어 있습니다.

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

매개변수

이름유형설명
columnInteger표를 처음에 정렬해야 하는 열의 번호입니다.

리턴

TableChartBuilder - 이 빌더로, 연결하는 데 유용합니다.


setInitialSortingDescending(column)

테이블을 처음 정렬해야 하는 기준(내림차순)에 따라 열의 색인을 설정합니다.

열이 내림차순으로 정렬되어 있으며 이를 나타내는 작은 화살표가 표시되어 있습니다.

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

매개변수

이름유형설명
columnInteger표를 처음에 정렬해야 하는 열의 번호입니다.

리턴

TableChartBuilder - 이 빌더로, 연결하는 데 유용합니다.


setOption(option, value)

이 차트의 고급 옵션을 설정합니다. 이 차트에 사용할 수 있는 옵션을 참고하세요. 이 메서드는 지정된 옵션이 유효하지 않으면 아무런 효과가 없습니다.

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

매개변수

이름유형설명
optionString설정할 옵션입니다.
valueObject설정할 값입니다.

리턴

TableChartBuilder - 이 빌더로, 연결하는 데 유용합니다.


showRowNumberColumn(showRowNumber)

행 번호를 표의 첫 번째 열로 표시할지 여부를 설정합니다.

기본 동작은 행 번호를 표시하지 않습니다.

매개변수

이름유형설명
showRowNumberBoolean테이블의 첫 번째 열에 행 번호가 표시되어야 하는 경우 true, 그렇지 않은 경우 false입니다.

리턴

TableChartBuilder - 이 빌더로, 연결하는 데 유용합니다.


useAlternatingRowStyle(alternate)

표 차트의 홀수 및 짝수 행에 교차 색상 스타일을 할당할지를 설정합니다.

기본 동작은 교차 색상 스타일을 사용하는 행입니다.

매개변수

이름유형설명
alternateBoolean색상 스타일이 교차되어야 하는 경우 true, 그렇지 않으면 false입니다.

리턴

TableChartBuilder - 이 빌더로, 연결하는 데 유용합니다.