Trình tạo biểu đồ tán xạ. Để biết thêm thông tin chi tiết, hãy xem tài liệu về Gviz.
Phương thức
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.
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 Background Color(cssValue)
Đặt màu nền cho biểu đồ.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
Thông số
Tên | Loại | Mô tả |
---|---|---|
css | String | Giá trị CSS cho màu (chẳng hạn như "blue" hoặc "#00f" ). |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc 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 Colors(cssValues)
Đặt màu cho các đường trong biểu đồ.
// Creates a line chart builder and sets the first two lines to be drawn in // green and red, respectively. const builder = Charts.newLineChart(); builder.setColors(['green', 'red']);
Thông số
Tên | Loại | Mô tả |
---|---|---|
css | String[] | Một mảng các giá trị CSS màu, chẳng hạn như ["red", "#acf"] . Phần tử thứ n trong mảng biểu thị màu của đường thứ n trong biể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 Legend Position(position)
Đặt vị trí của chú giải so với biểu đồ. Theo mặc định, không có chú giải.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Thông số
Tên | Loại | Mô tả |
---|---|---|
position | Position | Vị trí của chú thích. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set Legend Text Style(textStyle)
Đặt kiểu văn bản cho chú giải biểu đồ.
// Creates a line chart builder and sets it up for a blue, 26-point legend. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setLegendTextStyle(style);
Thông số
Tên | Loại | Mô tả |
---|---|---|
text | Text | Kiểu văn bản dùng cho chú giải biể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 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 Point Style(style)
Đặt kiểu cho các điểm trong đường kẻ. Theo mặc định, các điểm không có kiểu cụ thể và chỉ có đường kẻ là hiển thị.
// Creates a line chart builder and sets large point style. const builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
Thông số
Tên | Loại | Mô tả |
---|---|---|
style | Point | Kiểu dùng cho các điểm trong đường kẻ. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
Xem thêm
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 Title(chartTitle)
Đặt tiêu đề cho biểu đồ. Tiêu đề xuất hiện ở giữa phía trên biểu đồ.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
Thông số
Tên | Loại | Mô tả |
---|---|---|
chart | String | tiêu đề biể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 Title Text Style(textStyle)
Đặt kiểu văn bản cho tiêu đề biểu đồ.
// Creates a line chart builder and sets it up for a blue, 26-point title. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
Thông số
Tên | Loại | Mô tả |
---|---|---|
text | Text | Kiểu văn bản dùng cho tiêu đề biểu đồ. Bạn có thể tạo đối tượng Text bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc 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.
set XAxis Log Scale()
Chuyển trục hoành thành thang logarit (yêu cầu tất cả các giá trị đều phải là số dương).
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set XAxis Range(start, end)
Đặt phạm vi cho trục hoành của biểu đồ.
Nếu có bất kỳ điểm dữ liệu nào nằm ngoài phạm vi, thì phạm vi sẽ được mở rộng để bao gồm những điểm dữ liệu đó.
// Creates a scatter chart builder and sets the X-axis range to be 0 to 100. const builder = Charts.newTableChart(); builder.setXAxisRange(0, 100);
Thông số
Tên | Loại | Mô tả |
---|---|---|
start | Number | Giá trị cho đường lưới thấp nhất của trục ngang. |
end | Number | Giá trị cho đường lưới cao nhất của trục ngang. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set XAxis Text Style(textStyle)
Đặt kiểu văn bản cho trục hoành.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTextStyle(textStyle);
Thông số
Tên | Loại | Mô tả |
---|---|---|
text | Text | Kiểu văn bản dùng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng Text bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set XAxis Title(title)
Thêm tiêu đề vào trục hoành. Tiêu đề được căn giữa và xuất hiện bên dưới nhãn giá trị trục.
// Creates a line chart builder and sets the X-axis title. const builder = Charts.newLineChart(); builder.setTitle('X-axis Title');
Thông số
Tên | Loại | Mô tả |
---|---|---|
title | String | Tiêu đề cho trục X. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set XAxis Title Text Style(textStyle)
Đặt kiểu văn bản tiêu đề trục hoành.
// Creates a line chart builder and sets the X-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTitleTextStyle(textStyle);
Thông số
Tên | Loại | Mô tả |
---|---|---|
text | Text | Kiểu văn bản dùng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng Text bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set YAxis Log Scale()
Chuyển trục tung thành thang logarit (yêu cầu tất cả các giá trị đều phải là số dương).
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set YAxis Range(start, end)
Đặt phạm vi cho trục tung của biểu đồ. Nếu có bất kỳ điểm dữ liệu nào nằm ngoài phạm vi, thì phạm vi sẽ được mở rộng để bao gồm những điểm dữ liệu đó.
// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100. const builder = Charts.newTableChart(); builder.setYAxisRange(0, 100);
Thông số
Tên | Loại | Mô tả |
---|---|---|
start | Number | Giá trị cho đường lưới thấp nhất của trục dọc. |
end | Number | Giá trị cho đường lưới cao nhất của trục dọc. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set YAxis Text Style(textStyle)
Đặt kiểu văn bản cho trục tung.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTextStyle(textStyle);
Thông số
Tên | Loại | Mô tả |
---|---|---|
text | Text | Kiểu văn bản dùng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng Text bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set YAxis Title(title)
Thêm tiêu đề vào trục tung. Tiêu đề được căn giữa và xuất hiện ở bên trái nhãn giá trị.
// Creates a line chart builder and sets the Y-axis title. const builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title');
Thông số
Tên | Loại | Mô tả |
---|---|---|
title | String | Tiêu đề cho trục Y. |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.
set YAxis Title Text Style(textStyle)
Đặt kiểu văn bản tiêu đề trục tung.
// Creates a line chart builder and sets the Y-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTitleTextStyle(textStyle);
Thông số
Tên | Loại | Mô tả |
---|---|---|
text | Text | Kiểu văn bản dùng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng Text bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
Embedded
– Trình tạo này, hữu ích cho việc liên kết.