Class LineChartBuilder

LineChartBuilder

Trình tạo cho biểu đồ dạng đường. Để biết thêm thông tin chi tiết, hãy xem tài liệu về Google Biểu đồ.

Sau đây là ví dụ minh hoạ cách tạo biểu đồ dạng đường. 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=A1%3AG5' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=2&headers=-1';

const chartBuilder = Charts.newLineChart()
                         .setTitle('Yearly Rainfall')
                         .setXAxisTitle('Month')
                         .setYAxisTitle('Rainfall (in)')
                         .setDimensions(600, 500)
                         .setCurveStyle(Charts.CurveStyle.SMOOTH)
                         .setPointStyle(Charts.PointStyle.MEDIUM)
                         .setDataSourceUrl(dataSourceUrl);

const 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 đồ.
reverseCategories()	LineChartBuilder	Đảo ngược việc vẽ chuỗi trong trục miền.
setBackgroundColor(cssValue)	LineChartBuilder	Đặt màu nền cho biểu đồ.
setColors(cssValues)	LineChartBuilder	Đặt màu cho các đường trong biểu đồ.
setCurveStyle(style)	LineChartBuilder	Đặt kiểu để dùng cho các đường cong trong biểu đồ.
setDataSourceUrl(url)	LineChartBuilder	Đặt URL nguồn dữ liệu được dùng để kéo dữ liệu từ một nguồn bên ngoài, chẳng hạn như Google Trang tính.
setDataTable(tableBuilder)	LineChartBuilder	Đặt bảng dữ liệu cần dùng cho biểu đồ bằng DataTableBuilder.
setDataTable(table)	LineChartBuilder	Đặt bảng dữ liệu chứa các đường cho biểu đồ, cũng như nhãn trục X.
setDataViewDefinition(dataViewDefinition)	LineChartBuilder	Đặt định nghĩa khung hiển thị dữ liệu để dùng cho biểu đồ.
setDimensions(width, height)	LineChartBuilder	Đặt kích thước cho biểu đồ.
setLegendPosition(position)	LineChartBuilder	Đặt vị trí của chú giải so với biểu đồ.
setLegendTextStyle(textStyle)	LineChartBuilder	Đặt kiểu văn bản cho chú giải biểu đồ.
setOption(option, value)	LineChartBuilder	Đặt các lựa chọn nâng cao cho biểu đồ này.
setPointStyle(style)	LineChartBuilder	Đặt kiểu cho các điểm trong đường kẻ.
setRange(start, end)	LineChartBuilder	Đặt phạm vi cho biểu đồ.
setTitle(chartTitle)	LineChartBuilder	Đặt tiêu đề cho biểu đồ.
setTitleTextStyle(textStyle)	LineChartBuilder	Đặt kiểu văn bản cho tiêu đề biểu đồ.
setXAxisTextStyle(textStyle)	LineChartBuilder	Đặt kiểu văn bản cho trục hoành.
setXAxisTitle(title)	LineChartBuilder	Thêm tiêu đề vào trục hoành.
setXAxisTitleTextStyle(textStyle)	LineChartBuilder	Đặt kiểu văn bản tiêu đề trục hoành.
setYAxisTextStyle(textStyle)	LineChartBuilder	Đặt kiểu văn bản cho trục tung.
setYAxisTitle(title)	LineChartBuilder	Thêm tiêu đề vào trục tung.
setYAxisTitleTextStyle(textStyle)	LineChartBuilder	Đặt kiểu văn bản tiêu đề trục tung.
useLogScale()	LineChartBuilder	Chuyển trục phạm vi thành thang logarit (yêu cầu tất cả các giá trị đều phải là số dương).

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 giao diện người dùng hoặc dùng làm hình ảnh tĩnh.

---

reverseCategories()

Đảo ngược việc vẽ chuỗi trong trục miền. Đối với biểu đồ phạm vi 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 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ắ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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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 biểu thị màu của đường thứ n trong biểu đồ.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setCurveStyle(style)

Đặt kiểu để dùng cho các đường cong trong biểu đồ. Hãy xem CurveStyle để biết các kiểu đường cong được phép.

// Creates a line chart builder and curves the lines in the chart.
const builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH);

Tham số

Tên	Loại	Mô tả
style	CurveStyle	Kiểu cho các đường cong trong biểu đồ.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

Xem thêm

• CurveStyle

---

setDataSourceUrl(url)

Đặt URL nguồn dữ liệu được dùng để kéo 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 một URL nguồn dữ liệu và một 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ên	Loại	Mô tả
url	String	URL của nguồn dữ liệu, bao gồm cả mọi tham số truy vấn.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setDataTable(tableBuilder)

Đặt bảng dữ liệu cần 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 quá trình gọi này, vì vậy, mọi nội dung cập nhật tiếp theo cho trình tạo sẽ không được phản ánh trong biểu đồ.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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 ngang. Bạn có thể thêm bao nhiêu cột tuỳ ý, tất cả đều phải là dạng số. Mỗi cột hiển thị dưới dạng một đường riêng biệt.

Tham số

Tên	Loại	Mô tả
table	DataTableSource	Bảng dữ liệu dùng cho biểu đồ.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setDataViewDefinition(dataViewDefinition)

Đặt định nghĩa khung hiển thị dữ liệu để dùng cho biểu đồ.

Tham số

Tên	Loại	Mô tả
dataViewDefinition	DataViewDefinition	Một đối tượng định nghĩa khung hiển thị dữ liệu xác định khung hiển thị cần được lấy từ nguồn dữ liệu đã cho để vẽ biểu đồ.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setDimensions(width, height)

Đặt kích thước 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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setLegendPosition(position)

Đặt vị trí của chú giải so với biểu đồ. Theo mặc định, không có chú thích.

// 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ú thích.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setLegendTextStyle(textStyle)

Đặt kiểu văn bản cho 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ú thích biểu đồ.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setOption(option, value)

Đặt các lựa 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 lựa chọn đã cho không hợp lệ.

// Build a line chart with a 1-second animation duration.
const builder = Charts.newLineChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Tham số

Tên	Loại	Mô tả
option	String	Lựa chọn để đặt.
value	Object	Giá trị cần đặt.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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 kẻ là hiển thị.

// 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	PointStyle	Kiểu dùng cho các điểm trong đường kẻ.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

Xem thêm

• PointStyle

---

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, thì phạm vi đó sẽ được mở rộng để bao gồm những đ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 phạm vi.
end	Number	Giá trị cho đường lưới cao nhất của trục phạm vi.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setTitle(chartTitle)

Đặt tiêu đề cho biểu đồ. Tiêu đề xuất hiện ở 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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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 đề cho trục X.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

setYAxisTitle(title)

Thêm tiêu đề vào trục tung. Tiêu đề nằm ở 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 đề cho trục Y.

Cầu thủ trả bóng

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.

---

useLogScale()

Chuyển trục phạm vi thành thang logarit (yêu cầu tất cả các giá trị đều phải là số dương). Trục phạm vi là trục tung 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

LineChartBuilder – Trình tạo này, hữu ích cho việc liên kết.