Class AreaChartBuilder

כליהיצירהשל תרשימישטח

כלי ליצירת תרשימי שטח. פרטים נוספים זמינים במסמכי העזרה של Google Charts.

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

// Create a data table with some sample data.
const sampleData = Charts.newDataTable()
                       .addColumn(Charts.ColumnType.STRING, 'Month')
                       .addColumn(Charts.ColumnType.NUMBER, 'Dining')
                       .addColumn(Charts.ColumnType.NUMBER, 'Total')
                       .addRow(['Jan', 60, 520])
                       .addRow(['Feb', 50, 430])
                       .addRow(['Mar', 53, 440])
                       .addRow(['Apr', 70, 410])
                       .addRow(['May', 80, 390])
                       .addRow(['Jun', 60, 500])
                       .addRow(['Jul', 100, 450])
                       .addRow(['Aug', 140, 431])
                       .addRow(['Sep', 75, 488])
                       .addRow(['Oct', 70, 521])
                       .addRow(['Nov', 58, 388])
                       .addRow(['Dec', 63, 400])
                       .build();

const chart = Charts.newAreaChart()
                  .setTitle('Yearly Spending')
                  .setXAxisTitle('Month')
                  .setYAxisTitle('Spending (USD)')
                  .setDimensions(600, 500)
                  .setStacked()
                  .setColors(['red', 'green'])
                  .setDataTable(sampleData)
                  .build();

Methods

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

מסמכים מפורטים

build()

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

חזרה

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

---

reverseCategories()

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

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setBackgroundColor(cssValue)

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

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-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']);

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setDataSourceUrl(url)

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

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setDataTable(tableBuilder)

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setDataTable(table)

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setDataViewDefinition(dataViewDefinition)

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setDimensions(width, height)

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

פרמטרים

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

חזרה

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

חזרה

AreaChartBuilder — ה-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);

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setOption(option, value)

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

// Build an area chart with a 1-second animation duration.
const builder = Charts.newAreaChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setPointStyle(style)

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

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

ראה גם

• PointStyle

---

setRange(start, end)

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

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setStacked()

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

setTitle(chartTitle)

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

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

פרמטרים

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

חזרה

AreaChartBuilder — ה-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);

פרמטרים

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

חזרה

AreaChartBuilder — ה-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);

פרמטרים

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

חזרה

AreaChartBuilder — ה-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.

חזרה

AreaChartBuilder — ה-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);

פרמטרים

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

חזרה

AreaChartBuilder — ה-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);

פרמטרים

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

חזרה

AreaChartBuilder — ה-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.

חזרה

AreaChartBuilder — ה-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);

פרמטרים

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.

---

useLogScale()

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

חזרה

AreaChartBuilder — ה-builder הזה שימושי לשרשור.