Class TableChartBuilder

Trình tạobiểu đồbảng

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

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

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 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ố lượng hàng trong mỗi trang và trang bảng đầu tiên sẽ hiển thị (số trang dựa trên số 0).
enableRtlTable(rtlEnabled)TableChartBuilderThêm tính năng hỗ trợ cơ bản cho các ngôn ngữ 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 DataTableBuilder.
setDataTable(table)TableChartBuilderĐặt bảng dữ liệu chứa các đường cho biểu đồ, cũng như 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ố thứ tự của hàng đầu tiên trong bảng dữ liệu.
setInitialSortingAscending(column)TableChartBuilderĐặt chỉ mục của cột theo thứ tự bảng sẽ được sắp xếp ban đầu (tăng dần).
setInitialSortingDescending(column)TableChartBuilderĐặt chỉ mục của cột theo đó 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ố thứ tự của 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ẽ cho hàng lẻ và hàng chẵn của biểu đồ dạng bảng.

Tài liệu chi tiết

build()

Tạo biểu đồ.

Cầu thủ trả bóng

Chart – Đố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 hình ảnh tĩnh.

enablePaging(enablePaging)

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

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

Tham số

TênLoạiMô tả
enablePagingBooleantrue nếu bạn nên bật tính năng phân trang, 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.

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.
const 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ố lượng hàng trong mỗi trang và trang bảng đầu tiên sẽ hiển thị (số trang dựa trên số 0).

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

Tham số

TênLoạiMô tả
pageSizeIntegerSố hàng trong mỗi trang của bảng.
startPageIntegerTrang bảng đầu tiên sẽ hiển thị (số trang bắt đầu từ 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 tính năng hỗ trợ cơ bản cho các ngôn ngữ 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.

Việc này không ảnh hưởng đến chỉ mục cột trong dữ liệu cơ bản mà chỉ ảnh hưởng đến thứ tự hiển thị. Chế độ hiển thị ngôn ngữ hai chiều đầy đủ (BiDi) không được hỗ trợ trong hình ảnh trực quan của bảng ngay cả khi bạn chọn tuỳ chọn này. Tuỳ chọn này 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ó thanh cuộn vì bạn đã chỉ định các tuỳ 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 tính năng hỗ trợ RTL.

Tham số

TênLoạiMô tả
rtlEnabledBooleantrue nếu bạn nên bật tính năng 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ạn 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 được sắp xếp. Hành vi mặc định là bật tính năng sắp xếp.

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ì là 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 bạn 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 Charts.

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 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 sẽ được tạo ngay lập tức trong lệnh gọi này, vì vậy, mọi nội dung cập nhật khác cho 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)

Đặt bảng dữ liệu chứa các đường cho biểu đồ, cũng như nhãn trục X. Cột đầu tiên phải là một chuỗi và chứa nhãn trục hoành. Có thể có số lượng cột bất kỳ, tất cả đều phải là số. Mỗi cột 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 chế độ xem dữ liệu xác định chế độ xem sẽ được lấy từ nguồn dữ liệu đã cho để 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ố thứ tự của 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.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Tham số

TênLoạiMô tả
numberIntegerSố thứ tự của 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)

Đặt chỉ mục của cột theo thứ tự bảng sẽ được sắp xếp ban đầu (tăng dần).

Cột này đượ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).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Tham số

TênLoạiMô tả
columnIntegerSố của cột mà theo đó 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)

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

Cột này đượ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).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Tham số

TênLoạiMô tả
columnIntegerSố của cột mà theo đó 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 tuỳ 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.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const 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ố thứ tự của 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ẽ cho hàng lẻ và hàng chẵn của biểu đồ dạng bảng.

Hành vi mặc định là các hàng có kiểu màu luân phiên.

Tham số

TênLoạiMô tả
alternateBooleantrue nếu kiểu màu phải xen kẽ, 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.