Class TableChartBuilder

TableChartBuilder

Trình tạo biểu đồ bảng. Để biết thêm chi tiết, hãy xem tài liệu về Google Biểu đồ.

Dưới đây là ví dụ minh hoạ cách tạo biểu đồ bảng. Dữ liệu được nhập từ một bảng tính 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();

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
build()ChartTạo biểu đồ.
enablePaging(enablePaging)TableChartBuilderĐặt xem có bật tính năng phân trang thông qua dữ liệu hay không.
enablePaging(pageSize)TableChartBuilderBật tính năng phân trang và đặt số lượng hàng trong mỗi trang.
enablePaging(pageSize, startPage)TableChartBuilderBật tính năng phân trang, đặt số hàng trong mỗi trang và trang đầu tiên trong bảng để hiển thị (trang các số có giá trị bằng 0).
enableRtlTable(rtlEnabled)TableChartBuilderThêm hỗ trợ cơ bản cho các ngôn ngữ viết từ phải sang trái (chẳng hạn như tiếng Ả Rập hoặc tiếng Do Thái) bằng cách đảo ngược thứ tự cột của bảng, sao cho cột 0 là cột ngoài cùng bên phải và cột cuối cùng là cột ngoài cùng bên trái.
enableSorting(enableSorting)TableChartBuilderĐặt xem có sắp xếp cột khi người dùng nhấp vào tiêu đề cột hay không.
setDataSourceUrl(url)TableChartBuilderĐặt URL nguồn dữ liệu dùng để lấy dữ liệu từ một nguồn bên ngoài, chẳng hạn như Google Trang tính.
setDataTable(tableBuilder)TableChartBuilderĐặt bảng dữ liệu để sử dụng cho biểu đồ bằng cách sử dụng DataTableBuilder.
setDataTable(table)TableChartBuilderThiết lập bảng dữ liệu chứa các đường cho biểu đồ, cũng như các nhãn trục X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderĐặt định nghĩa chế độ xem dữ liệu để sử dụng cho biểu đồ.
setDimensions(width, height)TableChartBuilderĐặt phương diện cho biểu đồ.
setFirstRowNumber(number)TableChartBuilderĐặt số hàng cho hàng đầu tiên trong bảng dữ liệu.
setInitialSortingAscending(column)TableChartBuilderThiết lập chỉ mục của cột theo mà bảng sẽ được sắp xếp ban đầu (tăng dần).
setInitialSortingDescending(column)TableChartBuilderThiết lập chỉ mục của cột theo mà bảng sẽ được sắp xếp ban đầu (giảm dần).
setOption(option, value)TableChartBuilderĐặt các tuỳ chọn nâng cao cho biểu đồ này.
showRowNumberColumn(showRowNumber)TableChartBuilderĐặt xem có hiển thị số hàng dưới dạng cột đầu tiên của bảng hay không.
useAlternatingRowStyle(alternate)TableChartBuilderĐặt kiểu màu xen kẽ có được chỉ định cho các hàng lẻ và hàng chẵn của biểu đồ bảng hay không.

Tài liệu chi tiết

build()

Tạo biểu đồ.

Cầu thủ trả bóng

Chart – Một đối tượng Biểu đồ có thể được nhúng vào tài liệu, thành phần trên giao diện người dùng hoặc dùng làm đối tượng tĩnh hình ảnh.

enablePaging(enablePaging)

Đặt xem có bật tính năng phân trang thông qua dữ liệu hay không.

Hành vi mặc định là phân trang bị tắt. Nếu tính năng phân trang được bật, thì kích thước trang mặc định là 10.

Tham số

TênLoạiMô tả
enablePagingBooleantrue nếu phải bật tính năng phân trang, nếu không thì false.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

enablePaging(pageSize)

Bật tính năng phân trang và đặt số lượng hàng trong mỗi trang.

Kích thước trang mặc định là 10. 

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Tham số

TênLoạiMô tả
pageSizeIntegerSố hàng trong mỗi trang của bảng.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

enablePaging(pageSize, startPage)

Bật tính năng phân trang, đặt số hàng trong mỗi trang và trang đầu tiên trong bảng để hiển thị (trang các số có giá trị bằng 0).

Kích thước trang mặc định là 10 và trang chủ mặc định là 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);

Tham số

TênLoạiMô tả
pageSizeIntegerSố hàng trong mỗi trang của bảng.
startPageIntegerTrang đầu tiên của bảng sẽ hiển thị (số trang được tính dựa trên số 0).

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

enableRtlTable(rtlEnabled)

Thêm hỗ trợ cơ bản cho các ngôn ngữ viết từ phải sang trái (chẳng hạn như tiếng Ả Rập hoặc tiếng Do Thái) bằng cách đảo ngược thứ tự cột của bảng, sao cho cột 0 là cột ngoài cùng bên phải và cột cuối cùng là cột ngoài cùng bên trái.

Điều này chỉ ảnh hưởng đến thứ tự hiển thị chứ không ảnh hưởng đến chỉ mục cột trong dữ liệu cơ bản. Hình ảnh theo bảng không hỗ trợ chế độ hiển thị ngôn ngữ đầy đủ hai chiều (BiDi) ngay cả khi với tuỳ chọn này. Tuỳ chọn này sẽ bị bỏ qua nếu bạn bật tính năng phân trang (sử dụng tuỳ chọn trang) hoặc nếu bảng có các thanh cuộn do bạn đã chỉ định các tùy chọn chiều cao và chiều rộng nhỏ hơn kích thước bảng bắt buộc. Hành vi mặc định là tắt chế độ hỗ trợ RTL.

Tham số

TênLoạiMô tả
rtlEnabledBooleantrue nếu cần bật chế độ hỗ trợ từ phải sang trái, false nếu không.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

enableSorting(enableSorting)

Đặt xem có sắp xếp cột khi người dùng nhấp vào tiêu đề cột hay không.

Nếu bật tính năng sắp xếp, khi người dùng nhấp vào tiêu đề cột, các hàng sẽ tự động đã sắp xếp. Chế độ mặc định là sắp xếp được bật.

Tham số

TênLoạiMô tả
enableSortingBooleantrue để bật tính năng sắp xếp bằng cách nhấp vào tiêu đề cột, nếu không thì nhấp vào false.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setDataSourceUrl(url)

Đặt URL nguồn dữ liệu dùng để lấy dữ liệu từ một nguồn bên ngoài, chẳng hạn như Google Trang tính. Nếu cung cấp URL nguồn dữ liệu và DataTable, thì URL nguồn dữ liệu sẽ bị bỏ qua.

Để biết thêm thông tin về cách truy vấn nguồn dữ liệu, hãy xem tài liệu về Google Biểu đồ.

Tham số

TênLoạiMô tả
urlStringURL nguồn dữ liệu, bao gồm mọi tham số truy vấn.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setDataTable(tableBuilder)

Đặt bảng dữ liệu để sử dụng cho biểu đồ bằng cách sử dụng DataTableBuilder. Đây là một phương thức thuận tiện để thiết lập bảng dữ liệu mà không cần gọi build().

Tham số

TênLoạiMô tả
tableBuilderDataTableBuilderTrình tạo bảng dữ liệu. Một bảng dữ liệu mới được tạo ngay lập tức trong quá trình này nên mọi thông tin cập nhật khác đối với trình tạo sẽ không được phản ánh trong biểu đồ.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setDataTable(table)

Thiết lập bảng dữ liệu chứa các đường cho biểu đồ, cũng như các nhãn trục X. Chiến lược phát hành đĩa đơn cột đầu tiên phải là một chuỗi và chứa các nhãn trục hoành. Số lượng cột bất kỳ có thể theo, tất cả đều phải là số. Mỗi cột được hiển thị dưới dạng một dòng riêng biệt.

Tham số

TênLoạiMô tả
tableDataTableSourceBảng dữ liệu để sử dụng cho biểu đồ.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setDataViewDefinition(dataViewDefinition)

Đặt định nghĩa chế độ xem dữ liệu để sử dụng cho biểu đồ.

Tham số

TênLoạiMô tả
dataViewDefinitionDataViewDefinitionĐối tượng định nghĩa khung hiển thị dữ liệu xác định khung hiển thị cần được bắt nguồn từ nguồn dữ liệu đã cho cho bản vẽ biểu đồ.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setDimensions(width, height)

Đặt phương diện cho biểu đồ.

Tham số

TênLoạiMô tả
widthIntegerChiều rộng của biểu đồ, tính bằng pixel.
heightIntegerChiều cao của biểu đồ, tính bằng pixel.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setFirstRowNumber(number)

Đặt số hàng cho hàng đầu tiên trong bảng dữ liệu.

Số hàng mặc định của hàng đầu tiên là 1. 

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Tham số

TênLoạiMô tả
numberIntegerSố hàng cho hàng đầu tiên trong bảng dữ liệu.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setInitialSortingAscending(column)

Thiết lập chỉ mục của cột theo mà bảng sẽ được sắp xếp ban đầu (tăng dần).

Hệ điều hành của cột được sắp xếp theo thứ tự tăng dần và được đánh dấu bằng một mũi tên nhỏ cho biết điều đó. 

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

Tham số

TênLoạiMô tả
columnIntegerSố cột mà bảng sẽ được sắp xếp ban đầu.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setInitialSortingDescending(column)

Thiết lập chỉ mục của cột theo mà bảng sẽ được sắp xếp ban đầu (giảm dần).

Hệ điều hành của cột được sắp xếp theo thứ tự giảm dần và được đánh dấu bằng một mũi tên nhỏ cho biết điều đó. 

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

Tham số

TênLoạiMô tả
columnIntegerSố cột mà bảng sẽ được sắp xếp ban đầu.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

setOption(option, value)

Đặt các tuỳ chọn nâng cao cho biểu đồ này. Xem các lựa chọn có sẵn cho biểu đồ này. Phương thức này không có hiệu lực nếu tuỳ chọn đã cho không hợp lệ. 

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

Tham số

TênLoạiMô tả
optionStringTuỳ chọn để đặt.
valueObjectGiá trị cần đặt.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

showRowNumberColumn(showRowNumber)

Đặt xem có hiển thị số hàng dưới dạng cột đầu tiên của bảng hay không.

Hành vi mặc định là không hiển thị số hàng.

Tham số

TênLoạiMô tả
showRowNumberBooleantrue nếu cột đầu tiên của bảng hiển thị số hàng, false nếu không.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.

useAlternatingRowStyle(alternate)

Đặt kiểu màu xen kẽ có được chỉ định cho các hàng lẻ và hàng chẵn của biểu đồ bảng hay không.

Hành vi mặc định là các hàng có kiểu màu xen kẽ.

Tham số

TênLoạiMô tả
alternateBooleantrue nếu kiểu màu phải xen kẽ, nếu không thì false.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.