Class ScatterChartBuilder

ScatterChartBuilder

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 đồ.

Dưới đây là ví dụ minh hoạ 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.
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ứcLoại dữ liệu trả vềMô tả ngắn
build()ChartTạ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Đặt bảng dữ liệu để sử dụng cho biểu đồ bằng cách sử dụng DataTableBuilder.
setDataTable(table)ScatterChartBuilderThiết lập bảng dữ liệu 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 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 của phần chú thích 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 đề của biểu đồ.
setTitleTextStyle(textStyle)ScatterChartBuilderĐặt kiểu văn bản cho tiêu đề biểu đồ.
setXAxisLogScale()ScatterChartBuilderChuyển trục hoành thành thang đo logarit (yêu cầu tất cả các giá trị phải 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)ScatterChartBuilderThê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()ScatterChartBuilderChuyển trục tung thành thang đo logarit (yêu cầu tất cả các giá trị phải 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)ScatterChartBuilderThê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 – Một đố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 đối tượng tĩnh hình ả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");

Tham số

TênLoạiMô tả
cssValueStringGiá 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"]);

Tham số

TênLoạiMô tả
cssValuesString[]Một mảng 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 dò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 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 Biểu đồ.

Tham số

TênLoạiMô tả
urlStringURL 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)

Đặt bảng dữ liệu để sử dụng cho biểu đồ bằng cách sử dụ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ênLoạiMô tả
tableBuilderDataTableBuilderTrì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 quá trình này nên mọi thông tin 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)

Thiết lập bảng dữ liệu chứa các đường cho biểu đồ, cũng như các nhãn trục X. Chiến lược phát hành đĩa đơn cột đầu tiên phải là một chuỗi và chứa các nhãn trục hoành. Số lượng cột bất kỳ có thể theo, 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.

Tham số

TênLoạiMô tả
tableDataTableSourceBả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 chế độ xem dữ liệu để sử dụng cho biểu đồ.

Tham số

TênLoạiMô tả
dataViewDefinitionDataViewDefinitionĐối tượng định nghĩa khung hiển thị dữ liệu xác định khung hiển thị cần được bắt nguồn từ nguồn dữ liệu đã cho cho bản 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 đồ.

Tham số

TênLoạiMô tả
widthIntegerChiều rộng của biểu đồ, tính bằng pixel.
heightIntegerChiề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);

Tham số

TênLoạiMô tả
positionPositionVị 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 của phần chú thích 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);

Tham số

TênLoạiMô tả
textStyleTextStyleKiểu văn bản sử dụng cho chú thích 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. Xem các lựa 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.
var builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Tham số

TênLoạiMô tả
optionStringTuỳ chọn để đặt.
valueObjectGiá 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ỉ dòng có thể nhìn thấy.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Tham số

TênLoạiMô tả
stylePointStyleKiể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 đề của biểu đồ. Tiêu đề được hiển thị ở chính 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')

Tham số

TênLoạiMô tả
chartTitleStringtiê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);

Tham số

TênLoạiMô tả
textStyleTextStyleKiể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ả các giá trị phải 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);

Tham số

TênLoạiMô tả
startNumberGiá trị cho đường lưới thấp nhất trên trục hoành.
endNumberGiá 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);

Tham số

TênLoạiMô tả
textStyleTextStyleKiể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 giá trị trục .

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

Tham số

TênLoạiMô tả
titleStringTiê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);

Tham số

TênLoạiMô tả
textStyleTextStyleKiể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()

Chuyển trục tung thành thang đo logarit (yêu cầu tất cả các giá trị phải 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);

Tham số

TênLoạiMô tả
startNumberGiá trị cho đường lưới thấp nhất của trục tung.
endNumberGiá 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);

Tham số

TênLoạiMô tả
textStyleTextStyleKiể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 của giá trị .

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Tham số

TênLoạiMô tả
titleStringTiê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);

Tham số

TênLoạiMô tả
textStyleTextStyleKiể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.