Class LineChartBuilder

LineChartBuilder

Builder לתרשימי קו. מידע נוסף זמין במסמכי התיעוד של Google Charts.

הדוגמה הבאה ממחישה איך ליצור תרשים קו. הנתונים מיובאים מגיליון אלקטרוני של Google.

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

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

  var chart = chartBuilder.build();

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
build()	Chart	יצירת התרשים.
reverseCategories()	LineChartBuilder	הופך את השרטוט של הסדרות בציר הדומיין.
setBackgroundColor(cssValue)	LineChartBuilder	הגדרת צבע הרקע של התרשים.
setColors(cssValues)	LineChartBuilder	הגדרת הצבעים של הקווים בתרשים.
setCurveStyle(style)	LineChartBuilder	מגדיר את הסגנון שבו צריך להשתמש לעקומות בתרשים.
setDataSourceUrl(url)	LineChartBuilder	מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google גיליונות
setDataTable(tableBuilder)	LineChartBuilder	מגדירה את טבלת הנתונים שתשמש את התרשים באמצעות DataTableBuilder.
setDataTable(table)	LineChartBuilder	מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, ואת התוויות של ציר ה-X.
setDataViewDefinition(dataViewDefinition)	LineChartBuilder	מגדיר את ההגדרה של תצוגת הנתונים שתשמש את התרשים.
setDimensions(width, height)	LineChartBuilder	מגדיר את המימדים של התרשים.
setLegendPosition(position)	LineChartBuilder	מגדיר את המיקום של המקרא ביחס לתרשים.
setLegendTextStyle(textStyle)	LineChartBuilder	מגדיר את סגנון הטקסט של מקרא התרשים.
setOption(option, value)	LineChartBuilder	מגדיר אפשרויות מתקדמות לתרשים הזה.
setPointStyle(style)	LineChartBuilder	מגדיר את הסגנון של נקודות בקו.
setRange(start, end)	LineChartBuilder	מגדיר את הטווח של התרשים.
setTitle(chartTitle)	LineChartBuilder	מגדיר את שם התרשים.
setTitleTextStyle(textStyle)	LineChartBuilder	מגדיר את סגנון הטקסט של כותרת התרשים.
setXAxisTextStyle(textStyle)	LineChartBuilder	מגדיר את סגנון הטקסט של הציר האופקי.
setXAxisTitle(title)	LineChartBuilder	הוספת כותרת לציר האופקי.
setXAxisTitleTextStyle(textStyle)	LineChartBuilder	מגדיר את סגנון הטקסט של הכותרת של הציר האופקי.
setYAxisTextStyle(textStyle)	LineChartBuilder	הגדרת סגנון הטקסט של הציר האנכי.
setYAxisTitle(title)	LineChartBuilder	הוספת כותרת לציר האנכי.
setYAxisTitleTextStyle(textStyle)	LineChartBuilder	הגדרת סגנון הטקסט של הכותרת של הציר האנכי.
useLogScale()	LineChartBuilder	הופך את ציר הטווח לסולם לוגריתמי (כל הערכים צריכים להיות חיוביים).

מסמכי תיעוד מפורטים

build()

יצירת התרשים.

חזרה

Chart - אובייקט תרשים שאפשר להטמיע במסמכים, ברכיבי ממשק משתמש או להשתמש בו כאובייקט סטטי תמונה.

---

reverseCategories()

הופך את השרטוט של הסדרות בציר הדומיין. בתרשימים מטווח אנכי (כמו קו, תרשימי שטח או תרשימי עמודות אנכיים), כלומר הציר האופקי משורטט מימין לשמאל. עבור תרשימי טווח אופקיים (כמו תרשימי עמודות), כלומר הציר האנכי נמשך מלמעלה למטה למטה. בתרשימי עוגה, המשמעות היא שהפרוסות משורטטות נגד כיוון השעון.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setBackgroundColor(cssValue)

הגדרת צבע הרקע של התרשים.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

פרמטרים

שם	סוג	תיאור
cssValue	String	ערך ה-CSS של הצבע (למשל "blue" או "#00f").

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setColors(cssValues)

הגדרת הצבעים של הקווים בתרשים.

// 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"]);

פרמטרים

שם	סוג	תיאור
cssValues	String[]	מערך של ערכי CSS של צבעים, כמו ["red", "#acf"]. רכיב ה-n במערך מייצג את הצבע של קו ה-n בתרשים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setCurveStyle(style)

מגדיר את הסגנון שבו צריך להשתמש לעקומות בתרשים. אפשר לראות עקומה מותרת ב-CurveStyle

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

פרמטרים

שם	סוג	תיאור
style	CurveStyle	הסגנון של העקומות בתרשים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

ראה גם

• CurveStyle

---

setDataSourceUrl(url)

מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google גיליונות אם סופקו כתובת URL של מקור נתונים ו-DataTable, המערכת מתעלמת מכתובת ה-URL של מקור הנתונים.

מידע נוסף על שליחת שאילתות למקורות נתונים זמין במסמכי התיעוד של Google Charts.

פרמטרים

שם	סוג	תיאור
url	String	כתובת ה-URL של מקור הנתונים, כולל הפרמטרים של השאילתה.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setDataTable(tableBuilder)

מגדירה את טבלת הנתונים שתשמש את התרשים באמצעות DataTableBuilder. זוהי שיטה נוחה להגדרת טבלת הנתונים בלי שתצטרכו לקרוא ל-build().

פרמטרים

שם	סוג	תיאור
tableBuilder	DataTableBuilder	כלי לבניית טבלאות נתונים טבלת נתונים חדשה נוצרת באופן מיידי כחלק כך שעדכונים נוספים ב-builder לא יבואו לידי ביטוי בתרשים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setDataTable(table)

מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, ואת התוויות של ציר ה-X. העמודה הראשונה צריכה להיות מחרוזת ולהכיל את התוויות של הציר האופקי. כל מספר של עמודות יכולים לעקוב, וכולם חייבים להיות מספריים. כל עמודה מוצגת כשורה נפרדת.

פרמטרים

שם	סוג	תיאור
table	DataTableSource	טבלת הנתונים שבה ייעשה שימוש עבור התרשים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setDataViewDefinition(dataViewDefinition)

מגדיר את ההגדרה של תצוגת הנתונים שתשמש את התרשים.

פרמטרים

שם	סוג	תיאור
dataViewDefinition	DataViewDefinition	אובייקט של הגדרה של תצוגת נתונים שמגדיר את התצוגה שאמורה להיות נגזר ממקור הנתונים הנתון של שרטוט התרשים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setDimensions(width, height)

מגדיר את המימדים של התרשים.

פרמטרים

שם	סוג	תיאור
width	Integer	רוחב התרשים, בפיקסלים.
height	Integer	גובה התרשים, בפיקסלים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setLegendPosition(position)

מגדיר את המיקום של המקרא ביחס לתרשים. כברירת מחדל, אין מקרא.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

פרמטרים

שם	סוג	תיאור
position	Position	המיקום של המקרא.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setLegendTextStyle(textStyle)

מגדיר את סגנון הטקסט של מקרא התרשים.

// 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);

פרמטרים

שם	סוג	תיאור
textStyle	TextStyle	סגנון הטקסט לשימוש במקרא של התרשים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setOption(option, value)

מגדיר אפשרויות מתקדמות לתרשים הזה. אלה האפשרויות הזמינות עבור מהתרשים הזה. לשיטה הזו אין השפעה אם האפשרות הנתונה לא חוקית.

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

פרמטרים

שם	סוג	תיאור
option	String	האפשרות להגדיר.
value	Object	הערך שיש להגדיר.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setPointStyle(style)

מגדיר את הסגנון של נקודות בקו. כברירת מחדל, לנקודות אין סגנונות מסוימים, ורק הקו גלוי.

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

פרמטרים

שם	סוג	תיאור
style	PointStyle	הסגנון לשימוש בנקודות בשורה.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

ראה גם

• PointStyle

---

setRange(start, end)

מגדיר את הטווח של התרשים.

אם יש נקודות נתונים שנמצאות מחוץ לטווח, הטווח יורחב כך שיכלול את הנתונים האלה נקודות.

פרמטרים

שם	סוג	תיאור
start	Number	הערך של קו הרשת הנמוך ביותר של ציר הטווח.
end	Number	הערך של קו הרשת הגבוה ביותר בציר הטווח.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setTitle(chartTitle)

מגדיר את שם התרשים. הכותרת מוצגת במרכז מעל התרשים.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

פרמטרים

שם	סוג	תיאור
chartTitle	String	כותרת התרשים.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setTitleTextStyle(textStyle)

מגדיר את סגנון הטקסט של כותרת התרשים.

// 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);

פרמטרים

שם	סוג	תיאור
textStyle	TextStyle	סגנון הטקסט שיופיע בכותרת התרשים. אפשר ליצור אובייקט TextStyleBuilder באמצעות קריאה ל-Charts.newTextStyle().

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setXAxisTextStyle(textStyle)

מגדיר את סגנון הטקסט של הציר האופקי.

// 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);

פרמטרים

שם	סוג	תיאור
textStyle	TextStyle	סגנון הטקסט לשימוש בכותרת של הציר האופקי. אפשר ליצור אובייקט TextStyleBuilder באמצעות קריאה ל-Charts.newTextStyle().

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setXAxisTitle(title)

הוספת כותרת לציר האופקי. הכותרת ממורכזת ומופיעה מתחת לערך של הציר תוויות.

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

פרמטרים

שם	סוג	תיאור
title	String	הכותרת של ציר ה-X.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setXAxisTitleTextStyle(textStyle)

מגדיר את סגנון הטקסט של הכותרת של הציר האופקי.

// 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);

פרמטרים

שם	סוג	תיאור
textStyle	TextStyle	סגנון הטקסט לשימוש בכותרת של הציר האופקי. אפשר ליצור אובייקט TextStyleBuilder באמצעות קריאה ל-Charts.newTextStyle().

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setYAxisTextStyle(textStyle)

הגדרת סגנון הטקסט של הציר האנכי.

// 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);

פרמטרים

שם	סוג	תיאור
textStyle	TextStyle	סגנון הטקסט לשימוש בכותרת של הציר האופקי. אפשר ליצור אובייקט TextStyleBuilder באמצעות קריאה ל-Charts.newTextStyle().

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setYAxisTitle(title)

הוספת כותרת לציר האנכי. הכותרת ממורכזת ומופיעה מימין לערך תוויות.

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

פרמטרים

שם	סוג	תיאור
title	String	הכותרת של ציר ה-Y.

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

setYAxisTitleTextStyle(textStyle)

הגדרת סגנון הטקסט של הכותרת של הציר האנכי.

// 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);

פרמטרים

שם	סוג	תיאור
textStyle	TextStyle	סגנון הטקסט לשימוש בכותרת של הציר האופקי. אפשר ליצור אובייקט TextStyleBuilder באמצעות קריאה ל-Charts.newTextStyle().

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

---

useLogScale()

הופך את ציר הטווח לסולם לוגריתמי (כל הערכים צריכים להיות חיוביים). הטווח הם הציר האנכי של תרשימים אנכיים (כמו קו, שטח או עמודות) ציר אופקי לתרשימים אופקיים (כמו עמודות).

חזרה

LineChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.