Trình tạo biểu đồ tán xạ. Để biết thêm chi tiết, hãy xem tài liệu về Google Biểu đồ.
Sau đây là ví dụ về cách tạo biểu đồ tán xạ. 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=C1%3AD' +
'&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';
var chartBuilder = Charts.newScatterChart()
.setTitle('Adjusted GDP & U.S. Population')
.setXAxisTitle('U.S. Population (millions)')
.setYAxisTitle('Adjusted GDP ($ billions)')
.setDimensions(600, 500)
.setLegendPosition(Charts.Position.NONE)
.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 đồ. |
setBackgroundColor(cssValue) | ScatterChartBuilder | Đặt màu nền cho biểu đồ. |
setColors(cssValues) | ScatterChartBuilder | Đặt màu cho các đường trong biểu đồ. |
setDataSourceUrl(url) | ScatterChartBuilder | Đặ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) | ScatterChartBuilder | Thiết lập bảng dữ liệu cần sử dụng cho biểu đồ bằng DataTableBuilder. |
setDataTable(table) | ScatterChartBuilder | Đặ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) | ScatterChartBuilder | Đặt định nghĩa về chế độ xem dữ liệu để sử dụng cho biểu đồ. |
setDimensions(width, height) | ScatterChartBuilder | Đặt phương diện cho biểu đồ. |
setLegendPosition(position) | ScatterChartBuilder | Đặt vị trí của chú giải tương ứng với biểu đồ. |
setLegendTextStyle(textStyle) | ScatterChartBuilder | Đặt kiểu văn bản cho chú giải của biểu đồ. |
setOption(option, value) | ScatterChartBuilder | Đặt các tuỳ chọn nâng cao cho biểu đồ này. |
setPointStyle(style) | ScatterChartBuilder | Đặt kiểu cho các điểm trong đường kẻ. |
setTitle(chartTitle) | ScatterChartBuilder | Đặt tiêu đề cho biểu đồ. |
setTitleTextStyle(textStyle) | ScatterChartBuilder | Đặt kiểu văn bản cho tiêu đề biểu đồ. |
setXAxisLogScale() | ScatterChartBuilder | Chuyển trục hoành thành thang đo logarit (yêu cầu tất cả giá trị đều là số dương). |
setXAxisRange(start, end) | ScatterChartBuilder | Đặt phạm vi cho trục hoành của biểu đồ. |
setXAxisTextStyle(textStyle) | ScatterChartBuilder | Đặt kiểu văn bản trục hoành. |
setXAxisTitle(title) | ScatterChartBuilder | Thêm tiêu đề vào trục hoành. |
setXAxisTitleTextStyle(textStyle) | ScatterChartBuilder | Đặt kiểu văn bản tiêu đề trục hoành. |
setYAxisLogScale() | ScatterChartBuilder | Biến trục tung thành thang đo lôgarit (yêu cầu tất cả giá trị đều là số dương). |
setYAxisRange(start, end) | ScatterChartBuilder | Đặt phạm vi cho trục tung của biểu đồ. |
setYAxisTextStyle(textStyle) | ScatterChartBuilder | Đặt kiểu văn bản trục tung. |
setYAxisTitle(title) | ScatterChartBuilder | Thêm tiêu đề vào trục tung. |
setYAxisTitleTextStyle(textStyle) | ScatterChartBuilder | Đặt kiểu văn bản tiêu đề trục tung. |
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.
setBackgroundColor(cssValue)
Đặt màu nền cho biểu đồ.
// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
cssValue | String | Giá trị CSS cho màu sắc (chẳng hạn như "blue" hoặc "#00f"). |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setColors(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. var builder = Charts.newLineChart(); builder.setColors(["green", "red"]);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
cssValues | 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 thể hiện màu của đường thứ n trong biểu đồ. |
Cầu thủ trả bóng
ScatterChartBuilder – 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
ScatterChartBuilder – 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
ScatterChartBuilder – 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
ScatterChartBuilder – 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
ScatterChartBuilder – 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
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setLegendPosition(position)
Đặt vị trí của chú giải tương ứng 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. var builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
position | Position | Vị trí của chú giải. |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setLegendTextStyle(textStyle)
Đặt kiểu văn bản cho chú giải của biểu đồ.
// Creates a line chart builder and sets it up for a blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho chú giải biểu đồ. |
Cầu thủ trả bóng
ScatterChartBuilder – 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 scatter chart with a 1-second animation duration.
var builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
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
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setPointStyle(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 đó hiển thị.
// Creates a line chart builder and sets large point style. var builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
style | PointStyle | Kiểu sử dụng cho các điểm trong đường kẻ. |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
Xem thêm
setTitle(chartTitle)
Đặt tiêu đề cho biểu đồ. Tiêu đề hiển thị ở giữa phía trên biểu đồ.
// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
chartTitle | String | tiêu đề biểu đồ. |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setTitleTextStyle(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.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho tiêu đề biểu đồ. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle(). |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisLogScale()
Chuyển trục hoành thành thang đo logarit (yêu cầu tất cả giá trị đều là số dương).
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisRange(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, phạm vi sẽ được mở rộng để bao gồm các điểm dữ liệu đó.
// Creates a scatter chart builder and sets the X-axis range to be 0 to 100. var builder = Charts.newTableChart(); builder.setXAxisRange(0, 100);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
start | Number | Giá trị cho đường lưới thấp nhất của trục hoành. |
end | Number | Giá trị cho đường lưới cao nhất của trục hoành. |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisTextStyle(textStyle)
Đặt kiểu văn bản trục hoành.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
textStyle | TextStyle | Kiểu văn bản để sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle(). |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisTitle(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.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
title | String | Tiêu đề cho trục X. |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisTitleTextStyle(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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
textStyle | TextStyle | Kiểu văn bản để sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle(). |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisLogScale()
Biến trục tung thành thang đo lôgarit (yêu cầu tất cả giá trị đều là số dương).
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisRange(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, phạm vi sẽ được mở rộng để bao gồm các điểm dữ liệu đó.
// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100. var builder = Charts.newTableChart(); builder.setYAxisRange(0, 100);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
start | Number | Giá trị cho đường lưới thấp nhất của trục tung. |
end | Number | Giá trị cho đường lưới cao nhất của trục tung. |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisTextStyle(textStyle)
Đặt kiểu văn bản trục tung.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
textStyle | TextStyle | Kiểu văn bản để sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle(). |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisTitle(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.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
title | String | Tiêu đề cho trục Y. |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisTitleTextStyle(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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
textStyle | TextStyle | Kiểu văn bản để sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle(). |
Cầu thủ trả bóng
ScatterChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.