כלי לבניית תרשימי פיזור. מידע נוסף זמין במשאבי העזרה של 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)
הגדרת צבע הרקע של התרשים.
// 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
– הכלי הזה – שימושי ליצירת שרשורים.
כדאי לעיין גם בפרטים הבאים
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
– הכלי הזה – שימושי ליצירת שרשורים.