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ề Gviz.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
add | Embedded | Thêm một dải ô vào biểu đồ mà trình tạo này sửa đổi. |
as | Embedded | Đặt loại biểu đồ thành AreaChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành BarChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành ColumnChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành ComboChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành HistogramChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành LineChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành PieChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành ScatterChart và trả về một Embedded . |
as | Embedded | Đặt loại biểu đồ thành TableChart và trả về một Embedded . |
build() | Embedded | Tạo biểu đồ để phản ánh tất cả các thay đổi đã thực hiện đối với biểu đồ đó. |
clear | Embedded | Xoá tất cả các dải ô khỏi biểu đồ mà trình tạo này sửa đổi. |
enable | Embedded | Đặt xem có bật tính năng phân trang thông qua dữ liệu hay không. |
enable | Embedded | Cho phép phân trang và đặt số hàng trong mỗi trang. |
enable | Embedded | 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). |
enable | Embedded | 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. |
enable | Embedded | Đặ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. |
get | Chart | Trả về loại biểu đồ hiện tại. |
get | Container | Trả về Container biểu đồ, trong đó gói gọn vị trí biểu đồ xuất hiện trên trang tính. |
get | Range[] | Trả về bản sao của danh sách các dải ô hiện đang cung cấp dữ liệu cho biểu đồ này. |
remove | Embedded | Xoá dải ô đã chỉ định khỏi biểu đồ mà trình tạo này sửa đổi. |
set | Embedded | Thay đổi loại biểu đồ. |
set | Embedded | Đặt số hàng cho hàng đầu tiên trong bảng dữ liệu. |
set | Embedded | Đặt chiến lược sử dụng cho các hàng và cột bị ẩn. |
set | Embedded | Đặt chỉ mục của cột mà theo đó bảng sẽ được sắp xếp ban đầu (tăng dần). |
set | Embedded | Đặt chỉ mục của cột mà theo đó bảng sẽ được sắp xếp ban đầu (giảm dần). |
set | Embedded | Đặt chiến lược hợp nhất để sử dụng khi có nhiều dải ô. |
set | Embedded | Đặt số hàng hoặc cột của dải ô cần được coi là tiêu đề. |
set | Embedded | Đặt các lựa chọn nâng cao cho biểu đồ này. |
set | Embedded | Đặt vị trí, thay đổi vị trí xuất hiện của biểu đồ trên trang tính. |
set | Embedded | Đặt xem các hàng và cột của biểu đồ có được chuyển vị hay không. |
show | Embedded | Đặt xem có hiển thị số hàng làm cột đầu tiên của bảng hay không. |
use | Embedded | Đặ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
add Range(range)
Thêm một dải ô vào biểu đồ mà trình tạo này sửa đổi. Không thêm dải ô nếu dải ô đó đã được thêm vào biểu đồ.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
range | Range | Dải ô cần thêm. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
as Area Chart()
Đặt loại biểu đồ thành AreaChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ vùng.
as Bar Chart()
Đặt loại biểu đồ thành BarChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ dạng thanh.
as Column Chart()
Đặt loại biểu đồ thành ColumnChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ cột.
as Combo Chart()
Đặt loại biểu đồ thành ComboChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ kết hợp.
as Histogram Chart()
Đặt loại biểu đồ thành HistogramChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ tần suất.
as Line Chart()
Đặt loại biểu đồ thành LineChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ dạng đường.
as Pie Chart()
Đặt loại biểu đồ thành PieChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ hình tròn.
as Scatter Chart()
Đặt loại biểu đồ thành ScatterChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ phân tán.
as Table Chart()
Đặt loại biểu đồ thành TableChart và trả về một Embedded
.
Cầu thủ trả bóng
Embedded
– Trình tạo cho biểu đồ dạng bảng.
build()
Tạo biểu đồ để phản ánh tất cả các thay đổi đã thực hiện đối với biểu đồ đó.
Phương thức này không tự động vẽ biểu đồ lên trên bảng tính. Bạn phải chèn biểu đồ mới thông qua sheet.insertChart(chart)
và cập nhật biểu đồ hiện có thông qua sheet.updateChart(chart)
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Cầu thủ trả bóng
Embedded
– Biểu đồ đã tạo, vẫn phải được thêm vào bảng tính.
clear Ranges()
Xoá tất cả các dải ô khỏi biểu đồ mà trình tạo này sửa đổi.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This code updates the chart to use only the new ranges while preserving the // existing formatting of the chart. const chart = sheet.getCharts()[0]; const newChart = chart.modify() .clearRanges() .addRange(sheet.getRange('A1:A5')) .addRange(sheet.getRange('B1:B5')) .build(); sheet.updateChart(newChart);
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
enable Paging(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.
Thông số
Tên | Loại | Mô tả |
---|---|---|
enable | 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
enable Paging(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);
Thông số
Tên | Loại | Mô tả |
---|---|---|
page | Integer | Số hàng trong mỗi trang của bảng. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
enable Paging(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);
Thông số
Tên | Loại | Mô tả |
---|---|---|
page | Integer | Số hàng trong mỗi trang của bảng. |
start | 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
enable Rtl Table(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 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.
Thông số
Tên | Loại | Mô tả |
---|---|---|
rtl | 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
enable Sorting(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.
Thông số
Tên | Loại | Mô tả |
---|---|---|
enable | 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
get Chart Type()
get Container()
Trả về Container
biểu đồ, trong đó gói gọn vị trí biểu đồ xuất hiện trên trang tính.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); // This method returns the exact same data as Chart#getContainerInfo() const containerInfo = chartBuilder.getContainer(); // Logs the values used in setPosition() Logger.log( 'Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s', containerInfo.getAnchorColumn(), containerInfo.getAnchorRow(), containerInfo.getOffsetX(), containerInfo.getOffsetY(), );
Cầu thủ trả bóng
Container
– Một đối tượng chứa vị trí của vùng chứa biểu đồ.
get Ranges()
Trả về bản sao của danh sách các dải ô hiện đang cung cấp dữ liệu cho biểu đồ này. Sử dụng add
và remove
để sửa đổi danh sách này.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); const ranges = chartBuilder.getRanges(); // There's only one range as a data source for this chart, // so this logs "A1:B8" for (const i in ranges) { const range = ranges[i]; Logger.log(range.getA1Notation()); }
Cầu thủ trả bóng
Range[]
– Một mảng các dải ô đóng vai trò là nguồn dữ liệu của biểu đồ cần tạo.
remove Range(range)
Xoá dải ô đã chỉ định khỏi biểu đồ mà trình tạo này sửa đổi. Không báo lỗi nếu dải ô không có trong biểu đồ này.
Phạm vi bị xoá phải khớp với phạm vi được thêm thông qua add
; nếu không, biểu đồ sẽ không có gì thay đổi. Bạn không thể dùng phương thức này để xoá một phần giá trị khỏi một dải ô.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const firstRange = sheet.getRange('A1:B5'); const secondRange = sheet.getRange('A6:B8'); const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(firstRange) // This range renders in a different color .addRange(secondRange) .setPosition(5, 5, 0, 0); // Note that you can use either of these two formats, but the range // MUST match up with a range that was added via addRange(), or it // is not removed, and does not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange('A6:B8')); const chart = chartBuilder.build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
range | Range | Dải ô cần xoá. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
set Chart Type(type)
Thay đổi loại biểu đồ. Hiện tại, một số loại biểu đồ được nhúng không được hỗ trợ. Vui lòng xem Chart
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
type | Chart | Loại biểu đồ mà bạn muốn chuyển đổi. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
set First Row Number(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);
Thông 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set Hidden Dimension Strategy(strategy)
Đặt chiến lược sử dụng cho các hàng và cột bị ẩn. Giá trị mặc định là IGNORE_ROWS
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setHiddenDimensionStrategy( Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS, ) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
strategy | Chart | Chiến lược sử dụng cho các hàng và cột bị ẩn. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
set Initial Sorting Ascending(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);
Thông 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set Initial Sorting Descending(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);
Thông 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set Merge Strategy(mergeStrategy)
Đặt chiến lược hợp nhất để sử dụng khi có nhiều dải ô. Nếu MERGE_ROWS
, các hàng sẽ được hợp nhất; nếu MERGE_COLUMNS
, các cột sẽ được hợp nhất. Mặc định là MERGE_COLUMNS
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B10'); const range2 = sheet.getRange('C:C10'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
merge | Chart | Chiến lược hợp nhất cần sử dụng. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
set Num Headers(headers)
Đặt số hàng hoặc cột của dải ô cần được coi là tiêu đề.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setNumHeaders(1) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
headers | Integer | Số lượng hàng hoặc cột được coi là tiêu đề. Giá trị âm khiến tiêu đề được tự động phát hiện. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
set Option(option, value)
Đặt các lựa chọn nâng cao cho biểu đồ này. Để xem danh sách các lựa chọn có sẵn, hãy xem phần Các lựa chọn về cấu hình biểu đồ.
Phương thức này không xác thực liệu lựa chọn mà bạn chỉ định có hợp lệ cho loại biểu đồ này hay không, cũng như liệu giá trị có đúng định dạng/cấu trúc hay không.
Ví dụ này cho thấy cách thay đổi tiêu đề và đặt chú thích.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getSheets()[0]; const chart = sheet.newChart() .setOption('title', 'Earnings projections') .setOption('legend', { position: 'top', textStyle: { color: 'blue', fontSize: 16 }, }).build();
Thông số
Tên | Loại | Mô tả |
---|---|---|
option | String | Tên của lựa chọn. |
value | Object | Giá trị của lựa chọn. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Đặt vị trí, thay đổi vị trí xuất hiện của biểu đồ trên trang tính. anchor
và anchor
được lập chỉ mục từ 1.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
anchor | Integer | Phía trên cùng của biểu đồ được neo vào hàng này. |
anchor | Integer | Phía bên trái của biểu đồ được cố định trong cột này. |
offsetX | Integer | Góc trên cùng bên phải của biểu đồ bị lệch đi số pixel này. |
offsetY | Integer | Góc dưới cùng bên trái của biểu đồ bị lệch đi số pixel này. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
set Transpose Rows And Columns(transpose)
Đặt xem các hàng và cột của biểu đồ có được chuyển vị hay không. Nếu được đặt thành true
, các hàng và cột sẽ được chuyển đổi. Giá trị mặc định là false
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Thông số
Tên | Loại | Mô tả |
---|---|---|
transpose | Boolean | Nếu true , các hàng và cột dùng để tạo biểu đồ sẽ được chuyển vị. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, để liên kết.
show Row Number Column(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.
Thông số
Tên | Loại | Mô tả |
---|---|---|
show | 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
use Alternating Row Style(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ẽ.
Thông 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
Embedded
– Trình tạo này, hữu ích cho việc liên kết.