Class ScatterChartBuilder

ScatterChartBuilder

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

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

פרמטרים

שםסוגתיאור
cssValueStringערך ה-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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

פרמטרים

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

חזרה

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


setDataSourceUrl(url)

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

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

פרמטרים

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

חזרה

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


setDataTable(tableBuilder)

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

פרמטרים

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

חזרה

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


setDataTable(table)

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

פרמטרים

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

חזרה

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


setDataViewDefinition(dataViewDefinition)

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

פרמטרים

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

חזרה

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


setDimensions(width, height)

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

פרמטרים

שםסוגתיאור
widthIntegerרוחב התרשים, בפיקסלים.
heightIntegerגובה התרשים, בפיקסלים.

חזרה

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


setLegendPosition(position)

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

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

פרמטרים

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

חזרה

ScatterChartBuilder – ה-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);

פרמטרים

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

חזרה

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


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

פרמטרים

שםסוגתיאור
optionStringהאפשרות להגדיר.
valueObjectהערך שיש להגדיר.

חזרה

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


setPointStyle(style)

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

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

פרמטרים

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

חזרה

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

ראה גם


setTitle(chartTitle)

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

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

פרמטרים

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

חזרה

ScatterChartBuilder – ה-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);

פרמטרים

שםסוגתיאור
textStyleTextStyleסגנון הטקסט שיופיע בכותרת התרשים. אפשר ליצור אובייקט TextStyleBuilder באמצעות קריאה ל-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.
var builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

פרמטרים

שםסוגתיאור
startNumberהערך של קו הרשת הנמוך ביותר של הציר האופקי.
endNumberהערך של קו הרשת הגבוה ביותר של הציר האופקי.

חזרה

ScatterChartBuilder – ה-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);

פרמטרים

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

חזרה

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


setXAxisTitle(title)

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

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

פרמטרים

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

חזרה

ScatterChartBuilder – ה-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);

פרמטרים

שםסוגתיאור
textStyleTextStyleסגנון הטקסט לשימוש בכותרת של הציר האופקי. אפשר ליצור אובייקט TextStyleBuilder באמצעות קריאה ל-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.
var builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

פרמטרים

שםסוגתיאור
startNumberהערך של קו הרשת הנמוך ביותר של הציר האנכי.
endNumberהערך של קו הרשת הגבוה ביותר של הציר האנכי.

חזרה

ScatterChartBuilder – ה-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);

פרמטרים

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

חזרה

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


setYAxisTitle(title)

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

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

פרמטרים

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

חזרה

ScatterChartBuilder – ה-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);

פרמטרים

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

חזרה

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