Class BarChartBuilder

Trình tạobiểu đồthanh

Trình tạo biểu đồ thanh. Để 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 đồ thanh. Dữ liệu được nhập từ bảng tính Google.

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=B1%3AC11' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=0&headers=-1';

const chartBuilder = Charts.newBarChart()
                         .setTitle('Top Grossing Films in US and Canada')
                         .setXAxisTitle('USD')
                         .setYAxisTitle('Film')
                         .setDimensions(600, 500)
                         .setLegendPosition(Charts.Position.BOTTOM)
                         .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 đồ.
reverseCategories()	BarChartBuilder	Đảo ngược bản vẽ của chuỗi trong trục miền.
reverseDirection()	BarChartBuilder	Đảo ngược hướng các thanh phát triển dọc theo trục hoành.
setBackgroundColor(cssValue)	BarChartBuilder	Đặt màu nền cho biểu đồ.
setColors(cssValues)	BarChartBuilder	Đặt màu cho các đường trong biểu đồ.
setDataSourceUrl(url)	BarChartBuilder	Đặ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)	BarChartBuilder	Đặt bảng dữ liệu để sử dụng cho biểu đồ bằng DataTableBuilder.
setDataTable(table)	BarChartBuilder	Đặt bảng dữ liệu chứa các đường cho biểu đồ, cũng như nhãn trục X.
setDataViewDefinition(dataViewDefinition)	BarChartBuilder	Đặt định nghĩa chế độ xem dữ liệu để sử dụng cho biểu đồ.
setDimensions(width, height)	BarChartBuilder	Đặt phương diện cho biểu đồ.
setLegendPosition(position)	BarChartBuilder	Đặt vị trí của chú giải so với biểu đồ.
setLegendTextStyle(textStyle)	BarChartBuilder	Đặt kiểu văn bản của chú giải biểu đồ.
setOption(option, value)	BarChartBuilder	Đặt các tuỳ chọn nâng cao cho biểu đồ này.
setRange(start, end)	BarChartBuilder	Đặt phạm vi cho biểu đồ.
setStacked()	BarChartBuilder	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ỹ).
setTitle(chartTitle)	BarChartBuilder	Đặt tiêu đề của biểu đồ.
setTitleTextStyle(textStyle)	BarChartBuilder	Đặt kiểu văn bản của tiêu đề biểu đồ.
setXAxisTextStyle(textStyle)	BarChartBuilder	Đặt kiểu văn bản cho trục hoành.
setXAxisTitle(title)	BarChartBuilder	Thêm tiêu đề vào trục hoành.
setXAxisTitleTextStyle(textStyle)	BarChartBuilder	Đặt kiểu văn bản cho tiêu đề trục hoành.
setYAxisTextStyle(textStyle)	BarChartBuilder	Đặt kiểu văn bản cho trục tung.
setYAxisTitle(title)	BarChartBuilder	Thêm tiêu đề vào trục tung.
setYAxisTitleTextStyle(textStyle)	BarChartBuilder	Đặt kiểu văn bản cho tiêu đề trục tung.
useLogScale()	BarChartBuilder	Chuyển trục dải ô thành thang logarit (yêu cầu tất cả các giá trị đều dương).

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.

---

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 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

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

---

reverseDirection()

Đảo ngược hướng các thanh phát triển dọc theo trục hoành. Theo mặc định, các giá trị tăng dần từ trái sang phải. Việc gọi phương thức này sẽ khiến các phần tử này phát triển từ phải sang trái.

Cầu thủ trả bóng

BarChartBuilder – 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
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

Tham số

Tên	Loại	Mô tả
cssValue	String	Giá trị CSS cho màu (chẳng hạn như "blue" hoặc "#00f").

Cầu thủ trả bóng

BarChartBuilder – 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.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

Tham số

Tên	Loại	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 đại diện cho màu của đường thứ n trong biểu đồ.

Cầu thủ trả bóng

BarChartBuilder – 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 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

BarChartBuilder – 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 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ả
tableBuilder	DataTableBuilder	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

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

---

setDataTable(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	DataTableSource	Bảng dữ liệu để sử dụng cho biểu đồ.

Cầu thủ trả bóng

BarChartBuilder – 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ên	Loại	Mô tả
dataViewDefinition	DataViewDefinition	Đố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

BarChartBuilder – 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ê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

BarChartBuilder – 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 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

BarChartBuilder – 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 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ả
textStyle	TextStyle	Kiểu văn bản dùng cho chú giải biểu đồ.

Cầu thủ trả bóng

BarChartBuilder – 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 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 bar chart with a 1-second animation duration.
const builder = Charts.newBarChart();
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

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

---

setRange(start, end)

Đặ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

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

---

setStacked()

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

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

---

setTitle(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ả
chartTitle	String	tiêu đề biểu đồ.

Cầu thủ trả bóng

BarChartBuilder – 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 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ả
textStyle	TextStyle	Kiểu văn bản 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

BarChartBuilder – 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 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ả
textStyle	TextStyle	Kiểu văn bản 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

BarChartBuilder – 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.
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

BarChartBuilder – 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 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ả
textStyle	TextStyle	Kiểu văn bản 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

BarChartBuilder – 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 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ả
textStyle	TextStyle	Kiểu văn bản 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

BarChartBuilder – 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.
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

BarChartBuilder – 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 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ả
textStyle	TextStyle	Kiểu văn bản 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

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

---

useLogScale()

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

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