Trình tạo cho các đối tượng Data.
Dưới đây là ví dụ về cách sử dụng trình tạo. Dữ liệu được nhập từ một bảng tính Google.
function doGet() {
// This example creates two table charts side by side. One uses a data view
// definition to restrict the number of displayed columns.
// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
'&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';
// Create a chart to display all of the data.
const originalChart = Charts.newTableChart()
.setDimensions(600, 500)
.setDataSourceUrl(dataSourceUrl)
.build();
// Create another chart to display a subset of the data (only columns 1 and
// 4).
const dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]);
const limitedChart = Charts.newTableChart()
.setDimensions(200, 500)
.setDataSourceUrl(dataSourceUrl)
.setDataViewDefinition(dataViewDefinition)
.build();
const htmlOutput = HtmlService.createHtmlOutput();
const originalChartData = Utilities.base64Encode(
originalChart.getAs('image/png').getBytes(),
);
const originalChartUrl =
`data:image/png;base64,${encodeURI(originalChartData)}`;
const limitedChartData = Utilities.base64Encode(
limitedChart.getAs('image/png').getBytes(),
);
const limitedChartUrl =
`data:image/png;base64,${encodeURI(limitedChartData)}`;
htmlOutput.append('<table><tr><td>');
htmlOutput.append(`<img border="1" src="${originalChartUrl}">`);
htmlOutput.append('</td><td>');
htmlOutput.append(`<img border="1" src="${limitedChartUrl}">`);
htmlOutput.append('</td></tr></table>');
return htmlOutput;
}
Phương thức
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
build() | Data | Tạo và trả về đối tượng định nghĩa chế độ xem dữ liệu được tạo bằng trình tạo này. |
set | Data | Đặt chỉ mục của các cột để đưa vào chế độ xem dữ liệu cũng như chỉ định thông tin về cột vai trò. |
Tài liệu chi tiết
build()
Tạo và trả về đối tượng định nghĩa chế độ xem dữ liệu được tạo bằng trình tạo này.
Cầu thủ trả bóng
Data – Đối tượng định nghĩa chế độ xem dữ liệu được tạo bằng trình tạo này.
set
Đặt chỉ mục của các cột để đưa vào chế độ xem dữ liệu cũng như chỉ định thông tin về cột vai trò. Tập hợp con này của chỉ mục cột đề cập đến các cột của nguồn dữ liệu mà thành phần hiển thị dữ liệu bắt nguồn từ đó.
Vai trò của cột mô tả mục đích của dữ liệu trong cột đó: ví dụ: một cột có thể chứa dữ liệu mô tả văn bản chú giải công cụ, chú thích điểm dữ liệu hoặc chỉ báo độ không chắc chắn. Để biết thêm chi tiết, hãy xem phần Vai trò của bảng
Giả sử một bảng tính có dữ liệu sau trong A1:C3:
'abc', 20, 'blue'; 'def', 30, 'red'; 'ghi', 40, 'orange';Mã sau đây tạo một biểu đồ thanh, trong đó mỗi thanh có một màu khác nhau. Màu sắc được chỉ định thông qua "cột vai trò" của kiểu.
const COLUMN_SPEC = [
0, // categories
1, // counts
{sourceColumn: 2, role: 'style'},
];
function roleColumnChart() {
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getActiveSheet();
const viewSpec =
Charts.newDataViewDefinition().setColumns(COLUMN_SPEC).build();
const chartBuilder = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.setDataViewDefinition(viewSpec)
.setOption('useFirstColumnAsDomain', true)
.setPosition(5, 1, 0, 0)
.setOption('hAxis', {title: 'Counts'})
.setOption('vAxis', {title: 'Categories'})
.addRange(sheet.getRange('A1:C3'));
sheet.insertChart(chartBuilder.build());
}
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
columns | Object[] | Một mảng gồm các chỉ mục cột hoặc nội dung mô tả cột (một đối tượng) để đưa vào chế độ xem dữ liệu. Nội dung mô tả cột xác định vai trò của cột. Bảng dữ liệu và danh sách liệt kê cho các cột thành phần hiển thị dữ liệu đều dựa trên số 0. |
Cầu thủ trả bóng
Data – Trình tạo này hữu ích cho việc tạo chuỗi.