Class PieChartBuilder

PieChartBuilder

Trình tạo biểu đồ hình tròn. Để biết thêm chi tiết, hãy xem tài liệu về Google Biểu đồ.

Dưới đây là ví dụ về cách tạo biểu đồ hình tròn. 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=A1%3AB8' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

  var chartBuilder = Charts.newPieChart()
      .setTitle('World Population by Continent')
      .setDimensions(600, 500)
      .set3D()
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
build()ChartTạo biểu đồ.
reverseCategories()PieChartBuilderĐảo ngược bản vẽ của chuỗi trong trục miền.
set3D()PieChartBuilderĐặt biểu đồ thành biểu đồ ba chiều.
setBackgroundColor(cssValue)PieChartBuilderĐặt màu nền cho biểu đồ.
setColors(cssValues)PieChartBuilderĐặt màu cho các đường trong biểu đồ.
setDataSourceUrl(url)PieChartBuilderĐặ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)PieChartBuilderThiết lập bảng dữ liệu cần sử dụng cho biểu đồ bằng DataTableBuilder.
setDataTable(table)PieChartBuilderĐặ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)PieChartBuilderĐặt định nghĩa về chế độ xem dữ liệu để sử dụng cho biểu đồ.
setDimensions(width, height)PieChartBuilderĐặt phương diện cho biểu đồ.
setLegendPosition(position)PieChartBuilderĐặt vị trí của chú giải tương ứng với biểu đồ.
setLegendTextStyle(textStyle)PieChartBuilderĐặt kiểu văn bản cho chú giải của biểu đồ.
setOption(option, value)PieChartBuilderĐặt các tuỳ chọn nâng cao cho biểu đồ này.
setTitle(chartTitle)PieChartBuilderĐặt tiêu đề cho biểu đồ.
setTitleTextStyle(textStyle)PieChartBuilderĐặt kiểu văn bản cho tiêu đề biểu đồ.

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.


reverseCategories()

Đả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 ngang được vẽ từ phải sang trái. Đối với biểu đồ phạm vi ngang (chẳng hạn như biểu đồ thanh), điều này có nghĩa là trục tung đượ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.
var builder = Charts.newPieChart();
builder.reverseCategories();

Cầu thủ trả bóng

PieChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.


set3D()

Đặt biểu đồ thành biểu đồ ba chiều.

Cầu thủ trả bóng

PieChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.


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ênLoạiNội dung mô tả
cssValueStringGiá trị CSS cho màu sắc (chẳng hạn như "blue" hoặc "#00f").

Cầu thủ trả bóng

PieChartBuilder – 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ênLoạiNội dung mô tả
cssValuesString[]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

PieChartBuilder – 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ênLoạiNội dung mô tả
urlStringURL nguồn dữ liệu, bao gồm mọi tham số truy vấn.

Cầu thủ trả bóng

PieChartBuilder – 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ênLoạiNội dung mô 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 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

PieChartBuilder – 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ênLoạiNội dung mô tả
tableDataTableSourceBảng dữ liệu để sử dụng cho biểu đồ.

Cầu thủ trả bóng

PieChartBuilder – 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ênLoạiNội dung mô tả
dataViewDefinitionDataViewDefinitionĐố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

PieChartBuilder – 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ênLoạiNội dung mô 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

PieChartBuilder – 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ênLoạiNội dung mô tả
positionPositionVị trí của chú giải.

Cầu thủ trả bóng

PieChartBuilder – 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ênLoạiNội dung mô tả
textStyleTextStyleKiểu văn bản sử dụng cho chú giải biểu đồ.

Cầu thủ trả bóng

PieChartBuilder – 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 pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
var chart = builder.build();

Các tham số

TênLoạiNội dung mô tả
optionStringLựa chọn để đặt.
valueObjectGiá trị cần đặt.

Cầu thủ trả bóng

PieChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.


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ênLoạiNội dung mô tả
chartTitleStringtiêu đề biểu đồ.

Cầu thủ trả bóng

PieChartBuilder – 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ênLoạiNội dung mô 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

PieChartBuilder – Trình tạo này, hữu ích cho việc tạo chuỗi.