Trình tạo biểu đồ cột. Để 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
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);
Tham 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, để tạo chuỗi
as
Đặt loại biểu đồ thành AreaChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – một trình tạo cho biểu đồ vùng
as
Đặt loại biểu đồ thành BarChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – một trình tạo cho biểu đồ thanh
as
Đặt loại biểu đồ thành ColumnChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – một trình tạo cho biểu đồ cột
as
Đặt loại biểu đồ thành ComboChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – trình tạo biểu đồ kết hợp
as
Đặt loại biểu đồ thành HistogramChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – một trình tạo cho biểu đồ dạng hình thang
as
Đặt loại biểu đồ thành LineChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – trình tạo biểu đồ dạng đường
as
Đặt loại biểu đồ thành PieChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – trình tạo biểu đồ hình tròn
as
Đặt loại biểu đồ thành ScatterChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – một trình tạo cho biểu đồ tán xạ
as
Đặt loại biểu đồ thành TableChart và trả về Embedded.
Cầu thủ trả bóng
Embedded – một trình tạo cho biểu đồ dạng bảng
build()
Tạo biểu đồ để phản ánh tất 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 đồ trên đầu 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
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, để tạo chuỗi
get
get
Trả về biểu đồ Container, bao gồm 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
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
Xoá phạm vi đã chỉ định khỏi biểu đồ mà trình tạo này sửa đổi. Không gửi lỗi nếu phạm vi không có trong biểu đồ này.
Phạm vi đã 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 thay đổi. Bạn không thể sử 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 will render 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
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));
const chart = chartBuilder.build();
sheet.insertChart(chart);
Tham 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, để tạo chuỗi
reverse
Đảo ngược bản vẽ của chuỗi trong trục miền. Đối với biểu đồ dải ô dọc (chẳng hạn như biểu đồ đường, biểu đồ vùng hoặc biểu đồ cột), điều này có nghĩa là trục hoành được vẽ từ phải sang trái. Đối với biểu đồ theo dải ô ngang (chẳng hạn như biểu đồ thanh), điều này có nghĩa là trục dọc được vẽ từ trên xuống dưới. Đối với biểu đồ hình tròn, điều này có nghĩa là các lát được vẽ ngược chiều kim đồng hồ.
// Creates a pie chart builder and sets drawing of the slices in a // counter-clockwise manner. const builder = Charts.newPieChart(); builder.reverseCategories();
Cầu thủ trả bóng
Embedded – Trình tạo này hữu ích cho việc tạo chuỗi.
set
Đặ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');
Tham 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 tạo chuỗi.
set
Thay đổi loại biểu đồ. Không phải tất cả các loại biểu đồ được nhúng đều đượ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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
type | Chart | Loại biểu đồ mà bạn muốn thay đổi biểu đồ này thành. |
Cầu thủ trả bóng
Embedded – trình tạo này, để tạo chuỗi
set
Đặ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']);
Tham 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 đại diện cho 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 tạo chuỗi.
set
Đặt chiến lược để sử dụng cho các hàng và cột ẩ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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
strategy | Chart | Chiến lược sử dụng cho các hàng và cột ẩn. |
Cầu thủ trả bóng
Embedded – trình tạo này, để tạo chuỗi
set
Đặ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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
position | Position | Vị trí của chú giải. |
Cầu thủ trả bóng
Embedded – Trình tạo này hữu ích cho việc tạo chuỗi.
set
Đặt kiểu văn bản của 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);
Tham 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 tạo chuỗi.
set
Đặt chiến lược hợp nhất để sử dụng khi có nhiều dải ô. Nếu là MERGE_ROWS, các hàng sẽ được hợp nhất; nếu là 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);
Tham 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, để tạo chuỗi
set
Đặt số lượng 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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
headers | Integer | Số lượng hàng hoặc cột cần coi là tiêu đề. Giá trị âm sẽ khiến tiêu đề được tự động phát hiện. |
Cầu thủ trả bóng
Embedded – trình tạo này, để tạo chuỗi
set
Đặt các tuỳ chọn nâng cao cho biểu đồ này. Để xem danh sách các tuỳ chọn hiện có, hãy xem phần Tuỳ chọn cấu hình biểu đồ.
Phương thức này không xác thực liệu tuỳ chọn 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 biết cách thay đổi tiêu đề và đặt chú giải.
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();
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
option | String | Tên của tuỳ chọn. |
value | Object | Giá trị của tuỳ chọn. |
Cầu thủ trả bóng
Embedded – Trình tạo này, để tạo chuỗi.
set
Đặt vị trí, thay đổi vị trí biểu đồ xuất hiện 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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
anchor | Integer | Cạnh trên cùng của biểu đồ được neo vào hàng này. |
anchor | Integer | Cột này là cột neo của bên trái biểu đồ. |
offsetX | Integer | Góc trên bên phải của biểu đồ bị lệch đi nhiều pixel. |
offsetY | Integer | Góc dưới bên trái của biểu đồ bị lệch đi một số pixel. |
Cầu thủ trả bóng
Embedded – trình tạo này, để tạo chuỗi
set
Đặt phạm vi cho biểu đồ.
Nếu có bất kỳ điểm dữ liệu nào nằm ngoài phạm vi, phạm vi sẽ được mở rộng để bao gồm các điểm dữ liệu đó.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
start | Number | Giá trị cho đường lưới thấp nhất của trục dải ô. |
end | Number | Giá trị cho đường lưới cao nhất của trục dải ô. |
Cầu thủ trả bóng
Embedded – Trình tạo này hữu ích cho việc tạo chuỗi.
set
Sử dụng các đường xếp chồng, nghĩa là các giá trị đường và thanh được xếp chồng (tích luỹ). Theo mặc định, không có tính năng xếp chồng.
Cầu thủ trả bóng
Embedded – Trình tạo này hữu ích cho việc tạo chuỗi.
set
Đặt tiêu đề của biểu đồ. Tiêu đề sẽ xuất hiện ở chính 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');
Tham 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 tạo chuỗi.
set
Đặt kiểu văn bản của 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);
Tham 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 tạo chuỗi.
set
Đặt xem 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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
transpose | Boolean | Nếu là true, các hàng và cột dùng để tạo biểu đồ sẽ được hoán vị. |
Cầu thủ trả bóng
Embedded – trình tạo này, để tạo chuỗi
set
Đặ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);
Tham 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 tạo chuỗi.
set
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');
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
title | String | Tiêu đề của trục X. |
Cầu thủ trả bóng
Embedded – Trình tạo này hữu ích cho việc tạo chuỗi.
set
Đặt kiểu văn bản cho 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);
Tham 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 tạo chuỗi.
set
Đặ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);
Tham 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 tạo chuỗi.
set
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');
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
title | String | Tiêu đề của trục Y. |
Cầu thủ trả bóng
Embedded – Trình tạo này hữu ích cho việc tạo chuỗi.
set
Đặt kiểu văn bản cho 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);
Tham 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 tạo chuỗi.
use
Chuyển trục dải ô thành thang logarit (yêu cầu tất cả các giá trị đều dương). Trục phạm vi là trục dọc cho biểu đồ dọc (chẳng hạn như đường, vùng hoặc cột) và trục hoành cho biểu đồ ngang (chẳng hạn như thanh).
Cầu thủ trả bóng
Embedded – Trình tạo này hữu ích cho việc tạo chuỗi.