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)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 - 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과 데이터 테이블이 제공되는 경우 데이터 소스 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)

표의 초기 정렬에 따라 열의 색인을 설정합니다. (오름차순)

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

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

매개변수

이름유형설명
columnInteger표의 초기 정렬 기준으로 삼을 열의 번호입니다.

리턴

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


setInitialSortingDescending(column)

표의 초기 정렬에 따라 열의 색인을 설정합니다. (내림차순).

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

// 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 - 체이닝에 유용한 빌더입니다.