Builder לתרשימי פיזור. פרטים נוספים מופיעים במאמרי העזרה בנושא Google Charts.
בדוגמה הבאה אפשר לראות איך יוצרים תרשים פיזור. הנתונים מיובאים מגיליון אלקטרוני של Google.
// Get sample data from a spreadsheet. const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=C1%3AD' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; const 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); const chart = chartBuilder.build();
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
build() | Chart | התרשים ייווצר. |
set | Scatter | הגדרת צבע הרקע של התרשים. |
set | Scatter | הגדרת הצבעים של הקווים בתרשים. |
set | Scatter | מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google Sheets. |
set | Scatter | מגדיר את טבלת הנתונים שתשמש לתרשים באמצעות DataTableBuilder. |
set | Scatter | מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, וגם את התוויות של ציר ה-X. |
set | Scatter | הגדרת ההגדרה של תצוגת הנתונים שתשמש לתרשים. |
set | Scatter | הגדרת המאפיינים של התרשים. |
set | Scatter | ההגדרה הזו קובעת את המיקום של המקרא ביחס לתרשים. |
set | Scatter | הגדרת סגנון הטקסט של מקרא התרשים. |
set | Scatter | הגדרת אפשרויות מתקדמות לתרשים הזה. |
set | Scatter | הגדרת הסגנון של הנקודות בקו. |
set | Scatter | הגדרת הכותרת של התרשים. |
set | Scatter | מגדיר את סגנון הטקסט של שם התרשים. |
set | Scatter | הופך את הציר האופקי לסולם לוגריתמי (נדרש שכל הערכים יהיו חיוביים). |
set | Scatter | ההגדרה הזו קובעת את הטווח של הציר האופקי בתרשים. |
set | Scatter | הגדרת סגנון הטקסט של הציר האופקי. |
set | Scatter | מוסיפה כותרת לציר האופקי. |
set | Scatter | הגדרת סגנון הטקסט של הכותרת של הציר האופקי. |
set | Scatter | הופך את הציר האנכי לסולם לוגריתמי (כל הערכים צריכים להיות חיוביים). |
set | Scatter | הגדרת הטווח של הציר האנכי בתרשים. |
set | Scatter | הגדרת סגנון הטקסט של הציר האנכי. |
set | Scatter | מוסיפים כותרת לציר האנכי. |
set | Scatter | הגדרת סגנון הטקסט של הכותרת של הציר האנכי. |
תיעוד מפורט
build()
התרשים ייווצר.
חזרה
Chart – אובייקט Chart, שאפשר להטמיע במסמכים או ברכיבי ממשק משתמש, או להשתמש בו כתמונה סטטית.
setBackgroundColor(cssValue)
הגדרת צבע הרקע של התרשים.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
css | String | ערך ה-CSS של הצבע (למשל "blue" או "#00f"). |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setColors(cssValues)
הגדרת הצבעים של הקווים בתרשים.
// 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']);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
css | String[] | מערך של ערכי CSS של צבעים, כמו ["red", "#acf"]. האלמנט ה-n במערך מייצג את הצבע של הקו ה-n בתרשים. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setDataSourceUrl(url)
מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google Sheets. אם מספקים כתובת URL של מקור נתונים ו-DataTable, המערכת מתעלמת מכתובת ה-URL של מקור הנתונים.
מידע נוסף על שאילתות של מקורות נתונים זמין במסמכי התיעוד של Google Charts.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
url | String | כתובת ה-URL של מקור הנתונים, כולל פרמטרים של שאילתה. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setDataTable(tableBuilder)
מגדיר את טבלת הנתונים שתשמש לתרשים באמצעות DataTableBuilder. זוהי שיטה נוחה להגדרת טבלת הנתונים בלי צורך לקרוא ל-build().
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
table | Data | כלי ליצירת טבלאות נתונים. טבלת נתונים חדשה נוצרת באופן מיידי כחלק מהקריאה הזו, כך שעדכונים נוספים בכלי ליצירת תרשימים לא יבואו לידי ביטוי בתרשים. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setDataTable(table)
מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, וגם את התוויות של ציר ה-X. העמודה הראשונה צריכה להיות מחרוזת, ולהכיל את התוויות של הציר האופקי. אחרי העמודה הזו אפשר להוסיף כל מספר עמודות שרוצים, והן כולן צריכות לכלול מספרים. כל עמודה מוצגת בשורה נפרדת.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
table | Data | טבלת הנתונים שמשמשת ליצירת התרשים. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setDataViewDefinition(dataViewDefinition)
הגדרת ההגדרה של תצוגת הנתונים שתשמש לתרשים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | Data | אובייקט הגדרה של תצוגת נתונים שמגדיר את התצוגה שצריכה להיות נגזרת ממקור הנתונים הנתון לציור התרשים. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setDimensions(width, height)
הגדרת המאפיינים של התרשים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
width | Integer | רוחב התרשים, בפיקסלים. |
height | Integer | גובה התרשים, בפיקסלים. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setLegendPosition(position)
ההגדרה הזו קובעת את המיקום של המקרא ביחס לתרשים. כברירת מחדל, לא מוצג מקרא.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
position | Position | המיקום של המקרא. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setLegendTextStyle(textStyle)
הגדרת סגנון הטקסט של מקרא התרשים.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | Text | סגנון הטקסט שבו רוצים להשתמש עבור מקרא התרשים. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setOption(option, value)
הגדרת אפשרויות מתקדמות לתרשים הזה. אפשרויות התרשים לשיטה הזו אין השפעה אם האפשרות שצוינה לא חוקית.
// Build a scatter chart with a 1-second animation duration. const builder = Charts.newScatterChart(); builder.setOption('animation.duration', 1000); const chart = builder.build();
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
option | String | האפשרות להגדרה. |
value | Object | הערך שצריך להגדיר. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setPointStyle(style)
הגדרת הסגנון של הנקודות בקו. כברירת מחדל, לנקודות אין סגנונות מיוחדים, ורק הקו גלוי.
// Creates a line chart builder and sets large point style. const builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
style | Point | הסגנון שבו צריך להשתמש בשביל הנקודות בקו. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
ראה גם
setTitle(chartTitle)
הגדרת הכותרת של התרשים. הכותרת מוצגת במרכז מעל התרשים.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
chart | String | כותרת התרשים. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setTitleTextStyle(textStyle)
מגדיר את סגנון הטקסט של שם התרשים.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | Text | סגנון הטקסט שבו יש להשתמש לכותרת התרשים. אפשר ליצור אובייקט Text על ידי קריאה ל-Charts.newTextStyle(). |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setXAxisLogScale()
הופך את הציר האופקי לסולם לוגריתמי (נדרש שכל הערכים יהיו חיוביים).
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setXAxisRange(start, end)
הגדרת הטווח של הציר האופקי בתרשים.
אם יש נקודות נתונים מחוץ לטווח, הטווח יורחב כדי לכלול את נקודות הנתונים האלה.
// Creates a scatter chart builder and sets the X-axis range to be 0 to 100. const builder = Charts.newTableChart(); builder.setXAxisRange(0, 100);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
start | Number | הערך של קו הרשת התחתון ביותר בציר האופקי. |
end | Number | הערך של קו הרשת העליון בציר האופקי. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setXAxisTextStyle(textStyle)
הגדרת סגנון הטקסט של הציר האופקי.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | Text | סגנון הטקסט שבו רוצים להשתמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text על ידי קריאה ל-Charts.newTextStyle(). |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setXAxisTitle(title)
מוסיפה כותרת לציר האופקי. הכותרת מיושרת למרכז ומופיעה מתחת לתוויות של ערכי הציר.
// Creates a line chart builder and sets the X-axis title. const builder = Charts.newLineChart(); builder.setTitle('X-axis Title');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
title | String | הכותרת של ציר ה-X. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setXAxisTitleTextStyle(textStyle)
הגדרת סגנון הטקסט של הכותרת של הציר האופקי.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | Text | סגנון הטקסט שבו רוצים להשתמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text על ידי קריאה ל-Charts.newTextStyle(). |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setYAxisLogScale()
הופך את הציר האנכי לסולם לוגריתמי (כל הערכים צריכים להיות חיוביים).
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setYAxisRange(start, end)
הגדרת הטווח של הציר האנכי בתרשים. אם יש נקודות נתונים מחוץ לטווח, הטווח יורחב כדי לכלול את נקודות הנתונים האלה.
// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100. const builder = Charts.newTableChart(); builder.setYAxisRange(0, 100);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
start | Number | הערך של קו הרשת התחתון בציר האנכי. |
end | Number | הערך של קו הרשת העליון בציר האנכי. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setYAxisTextStyle(textStyle)
הגדרת סגנון הטקסט של הציר האנכי.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | Text | סגנון הטקסט שבו רוצים להשתמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text על ידי קריאה ל-Charts.newTextStyle(). |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setYAxisTitle(title)
מוסיפים כותרת לציר האנכי. הכותרת ממורכזת ומופיעה מימין לתוויות של הערכים.
// Creates a line chart builder and sets the Y-axis title. const builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
title | String | הכותרת של ציר ה-Y. |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.
setYAxisTitleTextStyle(textStyle)
הגדרת סגנון הטקסט של הכותרת של הציר האנכי.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | Text | סגנון הטקסט שבו רוצים להשתמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text על ידי קריאה ל-Charts.newTextStyle(). |
חזרה
ScatterChartBuilder – ה-builder הזה שימושי לשרשור.