Trình tạo cho biểu đồ tán xạ. Để biết thêm thông tin, hãy xem tài liệu về Google Biểu đồ.
Dưới đây là ví dụ về cách tạo biểu đồ tán xạ. Dữ liệu được nhập từ một bảng tính Google.
// Get sample data from a spreadsheet. const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=C1%3AD' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; const 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); const chart = chartBuilder.build();
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
build() | Chart | Tạo biểu đồ. |
set | Scatter | Đặt màu nền cho biểu đồ. |
set | Scatter | Đặt màu cho các đường trong biểu đồ. |
set | Scatter | Đặ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. |
set | Scatter | Đặt bảng dữ liệu để sử dụng cho biểu đồ bằng DataTableBuilder. |
set | Scatter | Đặt bảng dữ liệu chứa các đường cho biểu đồ, cũng như nhãn trục X. |
set | Scatter | Đặt định nghĩa chế độ xem dữ liệu để sử dụng cho biểu đồ. |
set | Scatter | Đặt phương diện cho biểu đồ. |
set | Scatter | Đặt vị trí của chú giải so với biểu đồ. |
set | Scatter | Đặt kiểu văn bản của chú giải biểu đồ. |
set | Scatter | Đặt các tuỳ chọn nâng cao cho biểu đồ này. |
set | Scatter | Đặt kiểu cho các điểm trong đường thẳng. |
set | Scatter | Đặt tiêu đề của biểu đồ. |
set | Scatter | Đặt kiểu văn bản của tiêu đề biểu đồ. |
set | Scatter | Chuyển trục hoành thành thang logarit (yêu cầu tất cả các giá trị đều dương). |
set | Scatter | Đặt phạm vi cho trục hoành của biểu đồ. |
set | Scatter | Đặt kiểu văn bản cho trục hoành. |
set | Scatter | Thêm tiêu đề vào trục hoành. |
set | Scatter | Đặt kiểu văn bản cho tiêu đề trục hoành. |
set | Scatter | Chuyển trục dọc thành thang logarit (yêu cầu tất cả các giá trị đều dương). |
set | Scatter | Đặt phạm vi cho trục tung của biểu đồ. |
set | Scatter | Đặt kiểu văn bản cho trục tung. |
set | Scatter | Thêm tiêu đề vào trục tung. |
set | Scatter | Đặt kiểu văn bản cho 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, thành phần trên giao diện người dùng hoặc dùng làm hình ảnh tĩnh.
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');
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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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']);
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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Data Source Url(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 về Google Charts.
Tham số
Tên | Loại | 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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Data Table(tableBuilder)
Đặt bảng dữ liệu để sử dụng cho biểu đồ bằng DataTableBuilder. Đây là một phương thức thuận tiện để thiết lập bảng dữ liệu mà không cần gọi build()
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
table | Data | Trình tạo bảng dữ liệu. Một bảng dữ liệu mới sẽ được tạo ngay lập tức trong lệnh gọi này, vì vậy, mọi nội dung cập nhật khác cho trình tạo sẽ không được phản ánh trong biểu đồ. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Data Table(table)
Đặt bảng dữ liệu chứa các đường cho biểu đồ, cũng như 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. Có thể có số lượng cột bất kỳ, tất cả đều phải là số. Mỗi cột hiển thị dưới dạng một dòng riêng biệt.
Tham số
Tên | Loại | Mô tả |
---|---|---|
table | Data | Bảng dữ liệu để sử dụng cho biểu đồ. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Data View Definition(dataViewDefinition)
Đặt định nghĩa chế độ xem dữ liệu để sử dụng cho biểu đồ.
Tham số
Tên | Loại | Mô tả |
---|---|---|
data | Data | Đối tượng định nghĩa chế độ xem dữ liệu xác định chế độ xem sẽ được lấy từ nguồn dữ liệu đã cho để vẽ biểu đồ. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Dimensions(width, height)
Đặt phương diện cho biểu đồ.
Tham số
Tên | Loại | 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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
position | Position | Vị trí của chú giải. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Legend Text Style(textStyle)
Đặ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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Option(option, value)
Đặt các tuỳ chọn nâng cao cho biểu đồ nà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 tuỳ chọn đã cho không hợp lệ.
// Build a scatter chart with a 1-second animation duration. const builder = Charts.newScatterChart(); builder.setOption('animation.duration', 1000); const chart = builder.build();
Tham số
Tên | Loại | Mô tả |
---|---|---|
option | String | Tuỳ chọn để đặt. |
value | Object | Giá trị cần đặt. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Point Style(style)
Đặt kiểu cho các điểm trong đường thẳng. Theo mặc định, các điểm không có kiểu cụ thể và chỉ có đường kẻ xuất hiện.
// Creates a line chart builder and sets large point style. const builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
Tham số
Tên | Loại | Mô tả |
---|---|---|
style | Point | Kiểu để sử dụng cho các điểm trong đường thẳng. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
Xem thêm
set Title(chartTitle)
Đặ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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set Title Text Style(textStyle)
Đặ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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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 dương).
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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, 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. const builder = Charts.newTableChart(); builder.setXAxisRange(0, 100);
Tham số
Tên | Loại | 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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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);
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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | Tiêu đề của trục X. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set XAxis Title Text Style(textStyle)
Đặ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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set YAxis Log Scale()
Chuyển trục dọc thành thang logarit (yêu cầu tất cả các giá trị đều dương).
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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, 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. const builder = Charts.newTableChart(); builder.setYAxisRange(0, 100);
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ọc. |
end | Number | Giá trị cho đường lưới cao nhất của trục dọc. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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);
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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | Tiêu đề của trục Y. |
Cầu thủ trả bóng
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.
set YAxis Title Text Style(textStyle)
Đặ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
Scatter
– Trình tạo này hữu ích cho việc tạo chuỗi.