Class ScatterChartBuilder

ScatterChartBuilder

כלי לבניית תרשימי פיזור. מידע נוסף זמין במשאבי העזרה של Google Tables.

לפניכם דוגמה שממחישה איך בונים תרשים פיזור. הנתונים מיובאים מגיליון אלקטרוני של 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();

שיטות

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

תיעוד מפורט

build()

בונה את התרשים.

החזרות

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

---

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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 בתרשים.

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setDataSourceUrl(url)

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

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setDataTable(tableBuilder)

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setDataTable(table)

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setDataViewDefinition(dataViewDefinition)

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setDimensions(width, height)

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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	המיקום של המקרא.

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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	סגנון הטקסט לשימוש במקרא של התרשים.

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setOption(option, value)

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

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setPointStyle(style)

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

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

כדאי לעיין גם בפרטים הבאים

• PointStyle

---

setTitle(chartTitle)

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

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

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setXAxisLogScale()

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setXAxisRange(start, end)

קביעת הטווח של הציר האופקי של התרשים.

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

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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.

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setYAxisLogScale()

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

setYAxisRange(start, end)

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

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

פרמטרים

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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.

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

---

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

החזרות

ScatterChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.