Class TableChartBuilder

TableChartBuilder

Trình tạo cho biểu đồ dạng bảng. Để biết thêm thông tin chi tiết, 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ức	Kiểu dữ liệu trả về	Mô tả ngắn
build()	Chart	Tạ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)	TableChartBuilder	Cho phép phân trang và đặt số hàng trong mỗi trang.
enablePaging(pageSize, startPage)	TableChartBuilder	Cho phép phân trang, đặt số hàng trong mỗi trang và trang bảng đầu tiên cần hiển thị (số trang dựa trên số 0).
enableRtlTable(rtlEnabled)	TableChartBuilder	Thêm chế độ 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ác cột hay không khi người dùng nhấp vào tiêu đề cột.
setDataSourceUrl(url)	TableChartBuilder	Đặt URL nguồn dữ liệu được dùng để kéo 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 cần 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 khung hiển thị dữ liệu để dùng cho biểu đồ.
setDimensions(width, height)	TableChartBuilder	Đặt kích thước cho biểu đồ.
setFirstRowNumber(number)	TableChartBuilder	Đặt số hàng cho hàng đầu tiên trong bảng dữ liệu.
setInitialSortingAscending(column)	TableChartBuilder	Đặt chỉ mục của cột mà theo đó 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 mà theo đó bảng sẽ được sắp xếp ban đầu (giảm dần).
setOption(option, value)	TableChartBuilder	Đặt các lựa chọn nâng cao cho biểu đồ này.
showRowNumberColumn(showRowNumber)	TableChartBuilder	Đặt xem có hiển thị số hàng làm cột đầu tiên của bảng hay không.
useAlternatingRowStyle(alternate)	TableChartBuilder	Đặt xem 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 đồ dạng 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 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 thông 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ên	Loại	Mô tả
enablePaging	Boolean	true 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 liên kết.

---

enablePaging(pageSize)

Cho phép phân trang và đặt số 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ên	Loại	Mô tả
pageSize	Integer	Số 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 liên kết.

---

enablePaging(pageSize, startPage)

Cho phép phân trang, đặt số hàng trong mỗi trang và trang bảng đầu tiên cần 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ên	Loại	Mô tả
pageSize	Integer	Số hàng trong mỗi trang của bảng.
startPage	Integer	Trang bảng đầu tiên cần 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 liên kết.

---

enableRtlTable(rtlEnabled)

Thêm chế độ 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ị. Hình ảnh trực quan dạng bảng không được hỗ trợ hiển thị ngôn ngữ hai chiều (BiDi) đầy đủ ngay cả khi bạn chọn chế độ này. Tuỳ chọn này sẽ bị bỏ qua nếu bạn bật tính năng phân trang (bằng cách 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ên	Loại	Mô tả
rtlEnabled	Boolean	true nếu bạn nê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 liên kết.

---

enableSorting(enableSorting)

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

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ên	Loại	Mô tả
enableSorting	Boolean	true để bật tính năng sắp xếp bằng cách nhấp vào tiêu đề cột, false nếu không.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setDataSourceUrl(url)

Đặt URL nguồn dữ liệu được dùng để kéo 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 một URL nguồn dữ liệu và một 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ên	Loại	Mô tả
url	String	URL của nguồn dữ liệu, bao gồm cả 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 liên kết.

---

setDataTable(tableBuilder)

Đặt bảng dữ liệu cần 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ên	Loại	Mô tả
tableBuilder	DataTableBuilder	Trì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 quá trình gọi này, vì vậy, mọi nội dung cập nhật tiếp theo 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 liên kết.

---

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 ngang. Bạn có thể thêm bao nhiêu cột tuỳ ý, tất cả đều phải là dạng số. Mỗi cột hiển thị dưới dạng một đường riêng biệt.

Tham số

Tên	Loại	Mô tả
table	DataTableSource	Bảng dữ liệu dùng cho biểu đồ.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setDataViewDefinition(dataViewDefinition)

Đặt định nghĩa khung hiển thị dữ liệu để dùng cho biểu đồ.

Tham số

Tên	Loại	Mô tả
dataViewDefinition	DataViewDefinition	Một đối tượng định nghĩa khung hiển thị dữ liệu xác định khung hiển thị cần đượ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 liên kết.

---

setDimensions(width, height)

Đặt kích thước cho biểu đồ.

Tham số

Tên	Loại	Mô tả
width	Integer	Chiều rộng của biểu đồ, tính bằng pixel.
height	Integer	Chiề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 liên kết.

---

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

Tham số

Tên	Loại	Mô tả
number	Integer	Số hàng 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 liên kết.

---

setInitialSortingAscending(column)

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

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

Tham số

Tên	Loại	Mô tả
column	Integer	Số cột mà bảng sẽ được sắp xếp ban đầu theo đó.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setInitialSortingDescending(column)

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

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

Tham số

Tên	Loại	Mô tả
column	Integer	Số cột mà bảng sẽ được sắp xếp ban đầu theo đó.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setOption(option, value)

Đặt các lựa 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 lựa 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ên	Loại	Mô tả
option	String	Lựa chọn để đặt.
value	Object	Giá trị cần đặt.

Cầu thủ trả bóng

TableChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

showRowNumberColumn(showRowNumber)

Đặt xem có hiển thị số hàng làm 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ên	Loại	Mô tả
showRowNumber	Boolean	true nếu cột đầu tiên của bảng phải cho biết 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 liên kết.

---

useAlternatingRowStyle(alternate)

Đặt xem 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 đồ dạng 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ên	Loại	Mô tả
alternate	Boolean	true 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 liên kết.