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 đồ.
Sau đây là ví dụ cho thấy cách tạo biểu đồ bảng. Dữ liệu được nhập 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ức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
build() | Chart | Tạo biểu đồ. |
enablePaging(enablePaging) | TableChartBuilder | Đặt có bật tính năng phân trang thông qua dữ liệu hay không. |
enablePaging(pageSize) | TableChartBuilder | Bật tính năng phân trang và đặt số hàng trong mỗi trang. |
enablePaging(pageSize, startPage) | TableChartBuilder | Bật tính năng phân trang, đặt số hàng trong mỗi trang và trang bảng đầu tiên sẽ hiển thị (số trang có giá trị bằng 0). |
enableRtlTable(rtlEnabled) | TableChartBuilder | Thêm tuỳ chọn hỗ trợ cơ bản cho các ngôn ngữ đọc 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, để 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 | Thiết lập 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 | Thiết lập bảng dữ liệu cần sử dụng cho biểu đồ bằng DataTableBuilder. |
setDataTable(table) | TableChartBuilder | Đặt bảng dữ liệu có 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 về 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ố hiệu cho hàng đầu tiên trong bảng dữ liệu. |
setInitialSortingAscending(column) | TableChartBuilder | Đặt 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) | TableChartBuilder | Đặt chỉ mục của cột theo thứ tự 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 | Thiết lập 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 | Thiết lập xem có chỉ định kiểu màu xen kẽ 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 – Đối tượng Biểu đồ có thể được nhúng vào tài liệu, các 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 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 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.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
enablePaging | Boolean | true nếu phải bật tính năng phân trang, nếu không phải 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.
enablePaging(pageSize)
Bật tính năng 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. var builder = Charts.newTableChart(); builder.enablePaging(5);
Các tham số
| Tên | Loại | Nội dung 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 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 bảng đầu tiên sẽ hiển thị (số trang có giá trị bằng 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. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
pageSize | Integer | Số hàng trong mỗi trang của bảng. |
startPage | Integer | Trang đầu tiên hiển thị trong bảng (số trang có giá trị bằng 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 tuỳ chọn hỗ trợ cơ bản cho các ngôn ngữ đọc 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, để 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ị mà không ảnh hưởng đến chỉ mục cột trong dữ liệu cơ bản. Hình ảnh trực quan dạng bảng không hỗ trợ hiển thị ngôn ngữ hai chiều đầy đủ (BiDi) ngay cả 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ó 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.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
rtlEnabled | Boolean | true nếu bạn bật chế độ hỗ trợ từ phải sang trái, nếu không phải 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.
enableSorting(enableSorting)
Thiết lập 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 tính năng sắp xếp được bật, thì khi người dùng nhấp vào tiêu đề cột, các hàng sẽ được sắp xếp tự động. Hành vi mặc định là bật tính năng sắp xếp.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
enableSorting | Boolean | true để bật tính năng sắp xếp bằng cách nhấp vào các tiêu đề cột, 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.
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 của Google Biểu đồ.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
url | String | URL 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)
Thiết lập bảng dữ liệu cần sử dụng cho biểu đồ bằng DataTableBuilder. Đây là một phương thức thuận tiện để đặt bảng dữ liệu mà không cần gọi build().
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
tableBuilder | DataTableBuilder | Trì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 lệnh gọi này, do đó, mọi nội dung 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)
Đặt bảng dữ liệu có chứa các đường cho biểu đồ, cũng như các 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. Theo sau là số lượng cột bất kỳ, 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.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
table | DataTableSource | Bả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 về chế độ xem dữ liệu để sử dụng cho biểu đồ.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
dataViewDefinition | DataViewDefinition | Đối tượng định nghĩa chế độ xem dữ liệu xác định chế độ xem cần được lấy từ nguồn dữ liệu nhất định để 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 đồ.
Các tham số
| Tên | Loại | Nội dung 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 tạo chuỗi.
setFirstRowNumber(number)
Đặt số hiệu 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
number | Integer | Số 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 mà bảng sẽ được sắp xếp ban đầu (tăng dần).
Hệ điều hành 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
column | Integer | Số 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)
Đặt chỉ mục của cột theo thứ tự mà bảng sẽ được sắp xếp ban đầu (giảm dần).
Hệ điều hành 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
column | Integer | Số 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. Hã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 lựa chọn được cung cấp 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();
Các tham số
| Tên | Loại | Nội dung 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 tạo chuỗi.
showRowNumberColumn(showRowNumber)
Thiết lập 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 không hiển thị số hàng.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
showRowNumber | Boolean | true nếu cột đầu tiên của bảng hiển thị số hàng, 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.
useAlternatingRowStyle(alternate)
Thiết lập xem có chỉ định kiểu màu xen kẽ 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ẽ.
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
alternate | Boolean | true nếu kiểu màu thay thế, nếu không phải 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.