אפשרויות תצורה של תרשים

סוגי תרשים

אפשרויות תצורה של תרשים הערות

שם
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
displayRangeSelector

האם להציג את אזור בחירת הטווח של מרחק התצוגה (האזור בתחתית התרשים), כאשר false פירושו לא.

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

סוג: boolean
ברירת מחדל: true
displayZoomButtons

האם להציג את לחצני הזום ("1d 5d 1m" וכן הלאה), כאשר false פירושו לא.

סוג: boolean
ברירת מחדל: true
מקסימלי

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

הנתון הזה דומה לmaxValue בתרשימי הליבה.

סוג: number
ברירת מחדל:אוטומטי
דקה

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

הנתון הזה דומה לminValue בתרשימי הליבה.

סוג: number
ברירת מחדל:אוטומטי

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

שם
areaOpacity

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

סוג: number, 0.0- 1.0
ברירת מחדל: 0.3
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
interpolateNulls

האם לנחש את הערך של נקודות חסרות. אם מזינים את הערך true, המערכת תנחש את הערך של הנתונים החסרים על סמך נקודות שכנות. אם מזינים false, תשאיר מעבר של הקו בנקודה הלא ידועה.

האפשרות הזו לא נתמכת בתרשימי Area עם האפשרות isStacked: true/'percent'/'relative'/'absolute'.

סוג: boolean
ברירת מחדל: false
isStacked

אם המדיניות מוגדרת כ-true, הרכיבים מקובצים במקבצים לכל הסדרות בכל ערך בדומיין. הערה: בתרשימים מסוג Column (עמודה), Area ו-SteppedArea, ב-GoogleCharts הופכים את הסדר של הפריטים המקראיים כך שיתאימו יותר לסידור של רכיבי הסדרה (למשל, סדרה 0 תהיה הפריט המקרא הכי נמוך). האפשרות הזו לא חלה על תרשימי עמודות.

האפשרות isStacked תומכת גם בערימה של 100%, שבה ערימות הרכיבים בכל ערך בדומיין מותאמות מחדש כך שיצטברו עד 100%.

האפשרויות של isStacked הן:

  • false - רכיבים לא יקובצו. זוהי ברירת המחדל.
  • true – מקבץ רכיבים לכל הסדרות בכל ערך דומיין.
  • 'percent' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ב-100%, כאשר הערך של כל רכיב מחושב כאחוז של 100%.
  • 'relative' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ל-1, כאשר הערך של כל רכיב מחושב כשבר של 1.
  • 'absolute' — מתפקדת באופן זהה ל-isStacked: true.

במקרה של סידור בערימה של 100%, הערך המחושב של כל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.

ברירת המחדל של ציר היעד היא לסמן ערכים בהתבסס על הסולם היחסי של 0-1 בשברים של 1 עבור 'relative', ו-0-100% עבור 'percent' (הערה: כשמשתמשים באפשרות 'percent', ערכי הציר/הסימונים מוצגים באחוזים, אבל הערכים בפועל הם ערכי קנה המידה היחסיים של 0-1. הסיבה לכך היא שהסימונים של הציר באחוזים הם תוצאה של החלת הפורמט "#.##%" על ערכי הסולם היחסיים של 0-1. כשמשתמשים בפונקציה isStacked: 'percent', חשוב לציין סימונים/קווי רשת באמצעות ערכי הסולם היחסיים של 0-1). אפשר להתאים אישית את הערכים של קווי הרשת/הסימונים באמצעות האפשרויות המתאימות של hAxis/vAxis.

ערימה של 100% תומכת רק בערכי נתונים מסוג number, וחייבת להיות ערך בסיס של אפס.

סוג: boolean/string
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויך לציר הימני series. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

סוג: number
ברירת מחדל: 2
pointShape

הצורה של רכיבי נתונים בודדים: 'circle', 'triangle', 'square', 'diamond', 'star' או 'polygon'. לקבלת דוגמאות, עיינו במסמכי התיעוד בנושא נקודות .

סוג: string
ברירת מחדל: 'circle'
pointSize

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

סוג: number
ברירת מחדל: 0
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • annotations - אובייקט שיוחל על הערות עבור הסדרה הזו. ניתן להשתמש בו כדי לשלוט, למשל, ב-textStyle של הסדרה: 

    series: {
  0: {
    annotations: {
      textStyle: {fontSize: 12, color: 'red' }
    }
  }
}

    כדי לקבל רשימה מלאה יותר של האפשרויות להתאמה אישית, אפשר לעיין באפשרויות השונות של annotations.

  • areaOpacity - מבטל את areaOpacity הגלובלי עבור הסדרה הזו.
  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • lineDashStyle - מבטל את הערך הגלובלי של lineDashStyle לסדרה הזו.
  • lineWidth – מבטל את הערך הגלובלי של lineWidth לסדרה הזו.
  • pointShape - מבטל את הערך הגלובלי של pointShape לסדרה הזו.
  • pointSize – מבטל את הערך הגלובלי של pointSize לסדרה הזו.
  • pointsVisible - מבטל את הערך הגלובלי של pointsVisible לסדרה הזו.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

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

סוג: boolean
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

אפשרויות הגדרה של תרשים עמודות

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג:string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: מספר או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
hAxes

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

כדי ליצור תרשים עם כמה צירים אופקיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex ואז מגדירים את הציר באמצעות hAxes. הדוגמה הבאה מקצה את סדרה 1 לציר התחתון ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית:

series:{1:{targetAxisIndex:1}}, hAxes:{1:{title:'Losses', textStyle:{color: 'red'}}}

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

hAxes: {
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {
      color: 'red'
    }
  } // Axis 1
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
isStacked

אם המדיניות מוגדרת כ-true, הרכיבים מקובצים במקבצים לכל הסדרות בכל ערך בדומיין. הערה: בתרשימים מסוג Column (עמודה), Area ו-SteppedArea, ב-GoogleCharts הופכים את הסדר של הפריטים המקראיים כך שיתאימו יותר לסידור של רכיבי הסדרה (למשל, סדרה 0 תהיה הפריט המקרא הכי נמוך). האפשרות הזו לא חלה על תרשימי עמודות.

האפשרות isStacked תומכת גם בערימה של 100%, שבה ערימות הרכיבים בכל ערך בדומיין מותאמות מחדש כך שיצטברו עד 100%.

האפשרויות של isStacked הן:

  • false - רכיבים לא יקובצו. זוהי ברירת המחדל.
  • true – מקבץ רכיבים לכל הסדרות בכל ערך דומיין.
  • 'percent' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ב-100%, כאשר הערך של כל רכיב מחושב כאחוז של 100%.
  • 'relative' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ל-1, כאשר הערך של כל רכיב מחושב כשבר של 1.
  • 'absolute' — מתפקדת באופן זהה ל-isStacked: true.

במקרה של סידור בערימה של 100%, הערך המחושב של כל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.

ברירת המחדל של ציר היעד היא לסמן ערכים בהתבסס על הסולם היחסי של 0-1 בשברים של 1 עבור 'relative', ו-0-100% עבור 'percent' (הערה: כשמשתמשים באפשרות 'percent', ערכי הציר/הסימונים מוצגים באחוזים, אבל הערכים בפועל הם ערכי קנה המידה היחסיים של 0-1. הסיבה לכך היא שהסימונים של הציר באחוזים הם תוצאה של החלת הפורמט "#.##%" על ערכי הסולם היחסיים של 0-1. כשמשתמשים בפונקציה isStacked: 'percent', חשוב לציין סימונים/קווי רשת באמצעות ערכי הסולם היחסיים של 0-1). אפשר להתאים אישית את הערכים של קווי הרשת/הסימונים באמצעות האפשרויות המתאימות של hAxis/vAxis.

ערימה של 100% תומכת רק בערכי נתונים מסוג number, וחייבת להיות ערך בסיס של אפס.

סוג: boolean/string
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • annotations - אובייקט שיוחל על הערות עבור הסדרה הזו. ניתן להשתמש בו כדי לשלוט, למשל, ב-textStyle של הסדרה: 

    series: {
  0: {
    annotations: {
      textStyle: {fontSize: 12, color: 'red' }
    }
  }
}

    כדי לקבל רשימה מלאה יותר של האפשרויות להתאמה אישית, אפשר לעיין באפשרויות השונות של annotations.

  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
קווי מגמה

הצגת קווי מגמות בתרשימים שתומכים בהם. כברירת מחדל, נעשה שימוש בקווי מגמות של linear, אבל אפשר להתאים אותם אישית באמצעות האפשרות trendlines.n.type.

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

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
סוג: object
ברירת מחדל: null
trendlines.n.color

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

סוג: string
ברירת מחדל: צבע ברירת המחדל של הסדרה
trendlines.n.degree

עבור קווי מגמה של type: 'polynomial', דרגה של הפולינום (2 לקווי מגמה, 3 למרובע וכן הלאה).

סוג: number
ברירת מחדל: 3
trendlines.n.labelInLegend

אם הוא מוגדר, קו המגמה יופיע במקרא בתור המחרוזת הזו.

סוג: string
ברירת מחדל: null
trendlines.n.lineWidth

רוחב הקו של קו המגמה, בפיקסלים.

סוג: number
ברירת מחדל: 2
trendlines.n.type

האם קווי המגמה הם 'linear' (ברירת המחדל), 'exponential' או 'polynomial'.

סוג: string
ברירת מחדל: linear
trendlines.n.visibleInLegend

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

סוג: boolean
ברירת מחדל: false
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

אפשרויות הגדרה של תרשים בועות

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
בועה

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

סוג: object
ברירת מחדל: null
bubble.opacity

שקיפות הבועות, כאשר 0 הוא שקוף לחלוטין ו-1 אטום לחלוטין.

סוג: מספר בין 0.0 ל-1.0
ברירת מחדל: 0.8
bubble.stroke

צבע הקו של הבועות.

סוג: string
ברירת מחדל: '#ccc'
bubble.textStyle

אובייקט שמציין את סגנון הטקסט של הבועה. לאובייקט יש את הפורמט הבא:

{color: <string>, fontName: <string>, fontSize: <number>}

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
סדרה

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

  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.
דוגמה: 
series: {'Europe': {color: 'green'}}
סוג: אובייקט עם אובייקטים מקוננים
ברירת מחדל: {}
sizeAxis

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

 {minValue: 0,  maxSize: 20}
סוג: object
ברירת מחדל: null
sizeAxis.maxSize

הרדיוס המקסימלי של הבועה הגדולה ביותר, בפיקסלים.

סוג: number
ברירת מחדל: 30
sizeAxis.minSize

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

סוג: number
ברירת מחדל: 5
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

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

סוג: boolean
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

אפשרויות תצורה של יומן

שם
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
רוחב

רוחב התרשים בפיקסלים.

סוג: number
ברירת מחדל: רוחב הרכיב שמכיל את הסרטון

אפשרויות תצורה של תרשים פמוט

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • fallingColor.fill - מבטל את הערך הגלובלי candlestick.fallingColor.fill עבור הסדרה הזו.
  • fallingColor.stroke - מבטל את הערך הגלובלי candlestick.fallingColor.stroke עבור הסדרה הזו.
  • fallingColor.strokeWidth - מבטל את הערך הגלובלי candlestick.fallingColor.strokeWidth עבור הסדרה הזו.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • risingColor.fill - מבטל את הערך הגלובלי candlestick.risingColor.fill עבור הסדרה הזו.
  • risingColor.stroke - מבטל את הערך הגלובלי candlestick.risingColor.stroke עבור הסדרה הזו.
  • risingColor.strokeWidth - מבטל את הערך הגלובלי candlestick.risingColor.strokeWidth עבור הסדרה הזו.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

אפשרויות הגדרה של תרשים עמודות אנכי

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
isStacked

אם המדיניות מוגדרת כ-true, הרכיבים מקובצים במקבצים לכל הסדרות בכל ערך בדומיין. הערה: בתרשימים מסוג Column (עמודה), Area ו-SteppedArea, ב-GoogleCharts הופכים את הסדר של הפריטים המקראיים כך שיתאימו יותר לסידור של רכיבי הסדרה (למשל, סדרה 0 תהיה הפריט המקרא הכי נמוך). האפשרות הזו לא חלה על תרשימי עמודות.

האפשרות isStacked תומכת גם בערימה של 100%, שבה ערימות הרכיבים בכל ערך בדומיין מותאמות מחדש כך שיצטברו עד 100%.

האפשרויות של isStacked הן:

  • false - רכיבים לא יקובצו. זוהי ברירת המחדל.
  • true – מקבץ רכיבים לכל הסדרות בכל ערך דומיין.
  • 'percent' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ב-100%, כאשר הערך של כל רכיב מחושב כאחוז של 100%.
  • 'relative' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ל-1, כאשר הערך של כל רכיב מחושב כשבר של 1.
  • 'absolute' — מתפקדת באופן זהה ל-isStacked: true.

במקרה של סידור בערימה של 100%, הערך המחושב של כל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.

ברירת המחדל של ציר היעד היא לסמן ערכים בהתבסס על הסולם היחסי של 0-1 בשברים של 1 עבור 'relative', ו-0-100% עבור 'percent' (הערה: כשמשתמשים באפשרות 'percent', ערכי הציר/הסימונים מוצגים באחוזים, אבל הערכים בפועל הם ערכי קנה המידה היחסיים של 0-1. הסיבה לכך היא שהסימונים של הציר באחוזים הם תוצאה של החלת הפורמט "#.##%" על ערכי הסולם היחסיים של 0-1. כשמשתמשים בפונקציה isStacked: 'percent', חשוב לציין סימונים/קווי רשת באמצעות ערכי הסולם היחסיים של 0-1). אפשר להתאים אישית את הערכים של קווי הרשת/הסימונים באמצעות האפשרויות המתאימות של hAxis/vAxis.

ערימה של 100% תומכת רק בערכי נתונים מסוג number, וחייבת להיות ערך בסיס של אפס.

סוג: boolean/string
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • annotations - אובייקט שיוחל על הערות עבור הסדרה הזו. ניתן להשתמש בו כדי לשלוט, למשל, ב-textStyle של הסדרה: 

    series: {
  0: {
    annotations: {
      textStyle: {fontSize: 12, color: 'red' }
    }
  }
}

    כדי לקבל רשימה מלאה יותר של האפשרויות להתאמה אישית, אפשר לעיין באפשרויות השונות של annotations.

  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
קווי מגמה

הצגת קווי מגמות בתרשימים שתומכים בהם. כברירת מחדל, נעשה שימוש בקווי מגמות של linear, אבל אפשר להתאים אותם אישית באמצעות האפשרות trendlines.n.type.

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

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
סוג: object
ברירת מחדל: null
trendlines.n.color

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

סוג: string
ברירת מחדל: צבע ברירת המחדל של הסדרה
trendlines.n.degree

עבור קווי מגמה של type: 'polynomial', דרגה של הפולינום (2 לקווי מגמה, 3 למרובע וכן הלאה).

סוג: number
ברירת מחדל: 3
trendlines.n.labelInLegend

אם הוא מוגדר, קו המגמה יופיע במקרא בתור המחרוזת הזו.

סוג: string
ברירת מחדל: null
trendlines.n.lineWidth

רוחב הקו של קו המגמה, בפיקסלים.

סוג: number
ברירת מחדל: 2
trendlines.n.type

האם קווי המגמה הם 'linear' (ברירת המחדל), 'exponential' או 'polynomial'.

סוג: string
ברירת מחדל: linear
trendlines.n.visibleInLegend

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

סוג: boolean
ברירת מחדל: false
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

אפשרויות תצורה לתרשים משולב

שם
areaOpacity

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

סוג: number, 0.0- 1.0
ברירת מחדל: 0.3
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
curveType

קובעת את עקומת הקווים כשרוחב הקו אינו אפס. יכול להיות אחת מהאפשרויות הבאות:

  • 'none' - קווים ישרים ללא עקומה.
  • 'function' - הזוויות של הקו יוחלקו.
סוג:string
ברירת מחדל: 'None'
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
interpolateNulls

האם לנחש את הערך של נקודות חסרות. אם מזינים את הערך true, המערכת תנחש את הערך של הנתונים החסרים על סמך נקודות שכנות. אם מזינים false, תשאיר מעבר של הקו בנקודה הלא ידועה.

האפשרות הזו לא נתמכת בתרשימי Area עם האפשרות isStacked: true/'percent'/'relative'/'absolute'.

סוג: boolean
ברירת מחדל: false
isStacked

אם המדיניות מוגדרת כ-true, הרכיבים מקובצים במקבצים לכל הסדרות בכל ערך בדומיין. הערה: בתרשימים מסוג Column (עמודה), Area ו-SteppedArea, ב-GoogleCharts הופכים את הסדר של הפריטים המקראיים כך שיתאימו יותר לסידור של רכיבי הסדרה (למשל, סדרה 0 תהיה הפריט המקרא הכי נמוך). האפשרות הזו לא חלה על תרשימי עמודות.

האפשרות isStacked תומכת גם בערימה של 100%, שבה ערימות הרכיבים בכל ערך בדומיין מותאמות מחדש כך שיצטברו עד 100%.

האפשרויות של isStacked הן:

  • false - רכיבים לא יקובצו. זוהי ברירת המחדל.
  • true – מקבץ רכיבים לכל הסדרות בכל ערך דומיין.
  • 'percent' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ב-100%, כאשר הערך של כל רכיב מחושב כאחוז של 100%.
  • 'relative' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ל-1, כאשר הערך של כל רכיב מחושב כשבר של 1.
  • 'absolute' — מתפקדת באופן זהה ל-isStacked: true.

במקרה של סידור בערימה של 100%, הערך המחושב של כל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.

ברירת המחדל של ציר היעד היא לסמן ערכים בהתבסס על הסולם היחסי של 0-1 בשברים של 1 עבור 'relative', ו-0-100% עבור 'percent' (הערה: כשמשתמשים באפשרות 'percent', ערכי הציר/הסימונים מוצגים באחוזים, אבל הערכים בפועל הם ערכי קנה המידה היחסיים של 0-1. הסיבה לכך היא שהסימונים של הציר באחוזים הם תוצאה של החלת הפורמט "#.##%" על ערכי הסולם היחסיים של 0-1. כשמשתמשים בפונקציה isStacked: 'percent', חשוב לציין סימונים/קווי רשת באמצעות ערכי הסולם היחסיים של 0-1). אפשר להתאים אישית את הערכים של קווי הרשת/הסימונים באמצעות האפשרויות המתאימות של hAxis/vAxis.

ערימה של 100% תומכת רק בערכי נתונים מסוג number, וחייבת להיות ערך בסיס של אפס.

סוג: boolean/string
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

סוג: number
ברירת מחדל: 2
pointShape

הצורה של רכיבי נתונים בודדים: 'circle', 'triangle', 'square', 'diamond', 'star' או 'polygon'. לקבלת דוגמאות, עיינו במסמכי התיעוד בנושא נקודות .

סוג: string
ברירת מחדל: 'circle'
pointSize

קוטר הנקודות המוצגות בפיקסלים. משתמשים באפס כדי להסתיר את כל הנקודות. אפשר לשנות את הערכים של סדרה בודדת באמצעות המאפיין series. אם משתמשים בקו מגמה, האפשרות pointSize תשפיע על הרוחב של קו המגמה, אלא אם מחליפים אותו באמצעות האפשרות trendlines.n.pointsize.

סוג: number
ברירת מחדל: 0
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • annotations - אובייקט שיוחל על הערות עבור הסדרה הזו. ניתן להשתמש בו כדי לשלוט, למשל, ב-textStyle של הסדרה: 

    series: {
  0: {
    annotations: {
      textStyle: {fontSize: 12, color: 'red' }
    }
  }
}

    כדי לקבל רשימה מלאה יותר של האפשרויות להתאמה אישית, אפשר לעיין באפשרויות השונות של annotations.

  • areaOpacity - מבטל את areaOpacity הגלובלי עבור הסדרה הזו.
  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • curveType – מבטל את הערך הגלובלי של curveType לסדרה הזו.
  • fallingColor.fill - מבטל את הערך הגלובלי candlestick.fallingColor.fill עבור הסדרה הזו.
  • fallingColor.stroke - מבטל את הערך הגלובלי candlestick.fallingColor.stroke עבור הסדרה הזו.
  • fallingColor.strokeWidth - מבטל את הערך הגלובלי candlestick.fallingColor.strokeWidth עבור הסדרה הזו.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • lineDashStyle - מבטל את הערך הגלובלי של lineDashStyle לסדרה הזו.
  • lineWidth – מבטל את הערך הגלובלי של lineWidth לסדרה הזו.
  • pointShape - מבטל את הערך הגלובלי של pointShape לסדרה הזו.
  • pointSize – מבטל את הערך הגלובלי של pointSize לסדרה הזו.
  • pointsVisible - מבטל את הערך הגלובלי של pointsVisible לסדרה הזו.
  • risingColor.fill - מבטל את הערך הגלובלי candlestick.risingColor.fill עבור הסדרה הזו.
  • risingColor.stroke - מבטל את הערך הגלובלי candlestick.risingColor.stroke עבור הסדרה הזו.
  • risingColor.strokeWidth - מבטל את הערך הגלובלי candlestick.risingColor.strokeWidth עבור הסדרה הזו.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.
  • type - סוג הסמן לסדרה הזו. הערכים החוקיים הם 'line', 'area', 'bars' ו-'steppedArea'. חשוב לשים לב שעמודות הן למעשה עמודות אנכיות (עמודות). ערך ברירת המחדל מצוין על ידי האפשרות seriesType של התרשים.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

אפשרויות תצורה של מונה

שם
greenColor

הצבע שיש להשתמש בו עבור הקטע הירוק בסימון צבעים של HTML.

סוג: string
ברירת מחדל: '#109618'
greenFrom

הערך הנמוך ביותר עבור טווח שמסומן בצבע ירוק.

סוג: number
ברירת מחדל: אין
greenTo

הערך הגבוה ביותר עבור טווח שמסומן בצבע ירוק.

סוג: number
ברירת מחדל: אין
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת המחדל: רוחב הקונטיינר
מקסימלי

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

הנתון הזה דומה לmaxValue בתרשימי הליבה.

סוג: number
ברירת מחדל:אוטומטי
דקה

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

הנתון הזה דומה לminValue בתרשימי הליבה.

סוג: number
ברירת מחדל:אוטומטי
redColor

הצבע שיש להשתמש בו עבור הקטע האדום בסימון צבעים של HTML.

סוג: string
ברירת מחדל: '#DC3912'
redFrom

הערך הנמוך ביותר עבור טווח שמסומן בצבע אדום.

סוג: number
ברירת מחדל: אין
redTo

הערך הגבוה ביותר עבור טווח שמסומן בצבע אדום.

סוג: number
ברירת מחדל: אין
רוחב

רוחב התרשים בפיקסלים.

סוג: number
ברירת המחדל: רוחב הקונטיינר
yellowColor

הצבע שיש להשתמש בו בקטע הצהוב בסימון צבעים של HTML.

סוג: string
ברירת מחדל: '#FF9900'
yellowFrom

הערך הנמוך ביותר עבור טווח שמסומן בצבע צהוב.

סוג: number
ברירת מחדל: אין
yellowTo

הערך הגבוה ביותר עבור טווח שמסומן בצבע צהוב.

סוג: number
ברירת מחדל: אין

אפשרויות תצורה ב-Geochart

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
datalessRegionColor

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

סוג: string
ברירת מחדל: '#F5F5F5'
defaultColor

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

סוג: string
ברירת מחדל: '#267114'
displayMode

איזה סוג של תרשים גיאוגרפי זה. הפורמט של DataTable חייב להתאים לערך שצוין. יש תמיכה בערכים הבאים:

  • 'auto' - בחירה בהתאם לפורמט של טבלת ה-DataTable.
  • 'regions' - צבע את האזורים בתרשים הגיאוגרפי.
  • 'markers' - הצבת סמנים באזורים.
  • 'text' - הוספת תוויות לאזורים באמצעות טקסט מטבלת הנתונים.
סוג: string
ברירת מחדל: 'auto'
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
region

האזור להצגה בתרשים הגיאוגרפי. יוצגו גם האזורים שמסביב. יכול להיות אחת מהאפשרויות הבאות:

  • 'world' – תרשים גיאוגרפי של העולם כולו.
  • יבשת או תת-יבשת, כפי שצוין בקוד בן 3 ספרות שלהם, למשל, '011' למערב אפריקה.
  • מדינה, שמצוינת בקוד ISO 3166-1 alpha-2, לדוגמה, 'AU' לאוסטרליה.
  • מדינה בארה"ב, שמצוינת בקוד ISO 3166-2:US שלה, למשל, 'US-AL' לאלבמה. חשוב לשים לב שצריך להגדיר את האפשרות resolution לערך 'provinces' או 'metros'.
סוג: string
ברירת מחדל: 'world'
רוחב

רוחב התרשים בפיקסלים.

סוג: number
ברירת מחדל: רוחב הרכיב שמכיל את הסרטון

אפשרויות תצורה של היסטוגרמה

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object/div>
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
histogram.bucketSize

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

סוג: number
ברירת מחדל: אוטומטי
histogram.hideBucketItems

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

סוג: boolean
ברירת מחדל: false
histogram.lastBucketPercentile

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

סוג: number
ברירת מחדל: 0
interpolateNulls

האם לנחש את הערך של נקודות חסרות. אם מזינים את הערך true, המערכת תנחש את הערך של הנתונים החסרים על סמך נקודות שכנות. אם מזינים false, תשאיר מעבר של הקו בנקודה הלא ידועה.

האפשרות הזו לא נתמכת בתרשימי Area עם האפשרות isStacked: true/'percent'/'relative'/'absolute'.

סוג: boolean
ברירת מחדל: false
isStacked

אם המדיניות מוגדרת כ-true, הרכיבים מקובצים במקבצים לכל הסדרות בכל ערך בדומיין. הערה: בתרשימים מסוג Column (עמודה), Area ו-SteppedArea, ב-GoogleCharts הופכים את הסדר של הפריטים המקראיים כך שיתאימו יותר לסידור של רכיבי הסדרה (למשל, סדרה 0 תהיה הפריט המקרא הכי נמוך). האפשרות הזו לא חלה על תרשימי עמודות.

האפשרות isStacked תומכת גם בערימה של 100%, שבה ערימות הרכיבים בכל ערך בדומיין מותאמות מחדש כך שיצטברו עד 100%.

האפשרויות של isStacked הן:

  • false - רכיבים לא יקובצו. זוהי ברירת המחדל.
  • true – מקבץ רכיבים לכל הסדרות בכל ערך דומיין.
  • 'percent' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ב-100%, כאשר הערך של כל רכיב מחושב כאחוז של 100%.
  • 'relative' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ל-1, כאשר הערך של כל רכיב מחושב כשבר של 1.
  • 'absolute' — מתפקדת באופן זהה ל-isStacked: true.

במקרה של סידור בערימה של 100%, הערך המחושב של כל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.

ברירת המחדל של ציר היעד היא לסמן ערכים בהתבסס על הסולם היחסי של 0-1 בשברים של 1 עבור 'relative', ו-0-100% עבור 'percent' (הערה: כשמשתמשים באפשרות 'percent', ערכי הציר/הסימונים מוצגים באחוזים, אבל הערכים בפועל הם ערכי קנה המידה היחסיים של 0-1. הסיבה לכך היא שהסימונים של הציר באחוזים הם תוצאה של החלת הפורמט "#.##%" על ערכי הסולם היחסיים של 0-1. כשמשתמשים בפונקציה isStacked: 'percent', חשוב לציין סימונים/קווי רשת באמצעות ערכי הסולם היחסיים של 0-1). אפשר להתאים אישית את הערכים של קווי הרשת/הסימונים באמצעות האפשרויות המתאימות של hAxis/vAxis.

ערימה של 100% תומכת רק בערכי נתונים מסוג number, וחייבת להיות ערך בסיס של אפס.

סוג: boolean/string
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
רוחב

רוחב התרשים בפיקסלים.

סוג: number
ברירת מחדל: רוחב הרכיב שמכיל את הסרטון

אפשרויות תצורה של תרשים קו

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
curveType

קובעת את עקומת הקווים כשרוחב הקו אינו אפס. יכול להיות אחת מהאפשרויות הבאות:

  • 'none' - קווים ישרים ללא עקומה.
  • 'function' - הזוויות של הקו יוחלקו.
סוג: string
ברירת מחדל: 'None'
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג:string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
interpolateNulls

האם לנחש את הערך של נקודות חסרות. אם מזינים את הערך true, המערכת תנחש את הערך של הנתונים החסרים על סמך נקודות שכנות. אם מזינים false, תשאיר מעבר של הקו בנקודה הלא ידועה.

האפשרות הזו לא נתמכת בתרשימי Area עם האפשרות isStacked: true/'percent'/'relative'/'absolute'.

סוג: boolean
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

סוג: number
ברירת מחדל: 2
pointShape

הצורה של רכיבי נתונים בודדים: 'circle', 'triangle', 'square', 'diamond', 'star' או 'polygon'. לקבלת דוגמאות, עיינו במסמכי התיעוד בנושא נקודות .

סוג: string
ברירת מחדל: 'circle'
pointSize

קוטר הנקודות המוצגות בפיקסלים. משתמשים באפס כדי להסתיר את כל הנקודות. אפשר לשנות את הערכים של סדרה בודדת באמצעות המאפיין series. אם משתמשים בקו מגמה, האפשרות pointSize תשפיע על הרוחב של קו המגמה, אלא אם מחליפים אותו באמצעות האפשרות trendlines.n.pointsize.

סוג: number
ברירת מחדל: 0
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • annotations - אובייקט שיוחל על הערות עבור הסדרה הזו. ניתן להשתמש בו כדי לשלוט, למשל, ב-textStyle של הסדרה: 

    series: {
  0: {
    annotations: {
      textStyle: {fontSize: 12, color: 'red' }
    }
  }
}

    כדי לקבל רשימה מלאה יותר של האפשרויות להתאמה אישית, אפשר לעיין באפשרויות השונות של annotations.

  • type - סוג הסמן לסדרה הזו. הערכים החוקיים הם 'line', 'area', 'bars' ו-'steppedArea'. חשוב לשים לב שעמודות הן למעשה עמודות אנכיות (עמודות). ערך ברירת המחדל מצוין על ידי האפשרות seriesType של התרשים.
  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • curveType – מבטל את הערך הגלובלי של curveType לסדרה הזו.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • lineDashStyle - מבטל את הערך הגלובלי של lineDashStyle לסדרה הזו.
  • lineWidth – מבטל את הערך הגלובלי של lineWidth לסדרה הזו.
  • pointShape - מבטל את הערך הגלובלי של pointShape לסדרה הזו.
  • pointSize – מבטל את הערך הגלובלי של pointSize לסדרה הזו.
  • pointsVisible - מבטל את הערך הגלובלי של pointsVisible לסדרה הזו.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

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

סוג: boolean
קווי מגמה

הצגת קווי מגמות בתרשימים שתומכים בהם. כברירת מחדל, נעשה שימוש בקווי מגמות של linear, אבל אפשר להתאים אותם אישית באמצעות האפשרות trendlines.n.type.

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

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
סוג: object
ברירת מחדל: null
trendlines.n.color

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

סוג: string
ברירת מחדל: צבע ברירת המחדל של הסדרה
trendlines.n.degree

עבור קווי מגמה של type: 'polynomial', דרגה של הפולינום (2 לקווי מגמה, 3 למרובע וכן הלאה).

סוג: number
ברירת מחדל: 3
trendlines.n.labelInLegend

אם הוא מוגדר, קו המגמה יופיע במקרא בתור המחרוזת הזו.

סוג: string
ברירת מחדל: null
trendlines.n.lineWidth

רוחב הקו של קו המגמה , בפיקסלים.

סוג: number
ברירת מחדל: 2
trendlines.n.type

האם קווי המגמה הם 'linear' (ברירת המחדל), 'exponential' או 'polynomial'.

סוג: string
ברירת מחדל: linear
trendlines.n.visibleInLegend

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

סוג: boolean
ברירת מחדל: false
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

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

שם
color [צבע]

צבע הרקע של הרכיבים בתרשים הארגוני.

סוג: string
ברירת מחדל: '#edf7ff'
selectionColor

צבע הרקע של הרכיבים שנבחרו בתרשים הארגוני.

סוג: string
ברירת מחדל: '#d6e9f8'
גודל

הגודל הכולל של התרשים. האפשרויות כוללות 'small', 'medium' או 'large'.

סוג: string
ברירת מחדל: 'medium'

אפשרויות תצורה של תרשים עוגה

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
is3D

אם מציבים true, יוצג תרשים תלת-ממדי.

סוג: boolean
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
pieHole

אם בין 0 ל-1, יוצג תרשים טבעת. הרדיוס של החור הוא number כפול רדיוס התרשים.

סוג: number
ברירת מחדל: 0
pieSliceBorderColor

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

סוג: string
ברירת מחדל: 'white'
pieSliceText

תוכן הטקסט שמוצג בקטע. יכול להיות אחת מהאפשרויות הבאות:

  • 'percentage' - האחוז מתוך הגודל הכולל של הפרוסה.
  • 'value' - הערך הכמותי של הפלח.
  • 'label' - שם הקטע.
  • 'none' - לא מוצג טקסט.
סוג: string
ברירת מחדל: 'percentage'
pieSliceTextStyle

אובייקט שמציין את סגנון הטקסט לפרוסה. לאובייקט יש את הפורמט הבא:

{color: <string>, fontName: <string>, fontSize: <number>}

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
slices.color

הצבע לשימוש בחלק הזה.

סוג: string
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}

אפשרויות תצורה של תרשים פיזור

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג:string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
curveType

קובעת את עקומת הקווים כשרוחב הקו אינו אפס. יכול להיות אחת מהאפשרויות הבאות:

  • 'none' - קווים ישרים ללא עקומה.
  • 'function' - הזוויות של הקו יוחלקו.
סוג:string
ברירת מחדל: 'None'
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.gridlines.color

הצבע של קווי הרשת האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
hAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
hAxis.logScale

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: boolean
ברירת מחדל: false
hAxis.maxValue

העברת הערך המקסימלי של הציר האופקי לערך שצוין. ברוב התרשימים יופיע בצד ימין. המערכת תתעלם מערך ברירת המחדל אם הערך מוגדר לערך שקטן מערך ה-x המקסימלי של הנתונים. hAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.minorGridlines

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

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
hAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האופקיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
hAxis.minorGridlines.count

האפשרות minorGridlines.count בדרך כלל הוצאה משימוש, אלא אם היא משביתה קווי רשת משניים על ידי הגדרת הספירה ל-0. המספר של קווי הרשת המשניים תלוי לחלוטין במרווח בין קווי הרשת הראשיים (מידע נוסף: hAxis.gridlines.interval) ובשטח המינימלי הנדרש (מידע נוסף ב-hAxis.minorGridlines.minSpacing).

סוג: number
ברירת מחדל: 1
hAxis.minValue

העברת הערך המינימלי של הציר האופקי לערך שצוין. ברוב התרשימים הוא יופיע שמאלה. המערכת תתעלם מערך ברירת המחדל אם ערך ה-x גדול מערך ה-x המינימלי של הנתונים. hAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top'- מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

סוג: number
ברירת מחדל: 2
pointShape

הצורה של רכיבי נתונים בודדים: 'circle', 'triangle', 'square', 'diamond', 'star' או 'polygon'. לקבלת דוגמאות, עיינו במסמכי התיעוד בנושא נקודות .

סוג: string
ברירת מחדל: 'circle'
pointSize

קוטר הנקודות המוצגות בפיקסלים. משתמשים באפס כדי להסתיר את כל הנקודות. אפשר לשנות את הערכים של סדרה בודדת באמצעות המאפיין series. אם משתמשים בקו מגמה, האפשרות pointSize תשפיע על הרוחב של קו המגמה, אלא אם מחליפים אותו באמצעות האפשרות trendlines.n.pointsize.

סוג: number
ברירת מחדל: 0
סדרה

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

  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • lineWidth – מבטל את הערך הגלובלי של lineWidth לסדרה הזו.
  • pointShape - מבטל את הערך הגלובלי של pointShape לסדרה הזו.
  • pointSize – מבטל את הערך הגלובלי של pointSize לסדרה הזו.
  • pointsVisible - מבטל את הערך הגלובלי של pointsVisible לסדרה הזו.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

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

סוג: boolean
קווי מגמה

הצגת קווי מגמות בתרשימים שתומכים בהם. כברירת מחדל, נעשה שימוש בקווי מגמות של linear, אבל אפשר להתאים אותם אישית באמצעות האפשרות trendlines.n.type.

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

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
סוג: object
ברירת מחדל: null
trendlines.n.color

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

סוג: string
ברירת מחדל: צבע ברירת המחדל של הסדרה
trendlines.n.degree

עבור קווי מגמה של type: 'polynomial', דרגה של הפולינום (2 לקווי מגמה, 3 למרובע וכן הלאה).

סוג: number
ברירת מחדל: 3
trendlines.n.labelInLegend

אם הוא מוגדר, קו המגמה יופיע במקרא בתור המחרוזת הזו.

סוג: string
ברירת מחדל: null
trendlines.n.lineWidth

רוחב הקו של קו המגמה , בפיקסלים.

סוג: number
ברירת מחדל: 2
trendlines.n.type

האם קווי המגמה הם 'linear' (ברירת המחדל), 'exponential' או 'polynomial'.

סוג: string
ברירת מחדל: linear
trendlines.n.visibleInLegend

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

סוג: boolean
ברירת מחדל: false
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי

אפשרויות הגדרה של תרשים שטח מדורג

שם
areaOpacity

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

סוג: number, 0.0- 1.0
ברירת מחדל: 0.3
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
backgroundColor.fill

צבע המילוי של התרשים, כמחרוזת צבע HTML.

סוג: string
ברירת מחדל: 'white'
chartArea

אובייקט עם חברים להגדרת המיקום והגודל של אזור התרשים (המקום שבו משורטטים התרשים עצמו, לא כולל צירים ומקרא). יש תמיכה בשני פורמטים: מספר, או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. לדוגמה: chartArea:{left:20,top:0,width:'50%',height:'75%'}

סוג: object
ברירת מחדל: null
chartArea.backgroundColor
צבע הרקע של אזור התרשים. כשנעשה שימוש במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כאשר משתמשים באובייקט, ניתן לספק את המאפיינים הבאים:
  • stroke: הצבע, כפי שמצוין במחרוזת הקסדצימלית או שם של צבע באנגלית.
  • strokeWidth: אם צוין, משרטט גבול מסביב לאזור התרשים של הרוחב הנתון (ובצבע של stroke).
סוג: string או object
ברירת מחדל: 'white'
chartArea.height

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.left

מאיזה מרחק יש לשרטט את התרשים מהגבול השמאלי.

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.top

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

סוג: number או string
ברירת מחדל: אוטומטי
chartArea.width

רוחב האזור בתרשים.

סוג: number או string
ברירת מחדל: אוטומטי
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
hAxis

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
סוג: object
ברירת מחדל: null
hAxis.direction

הכיוון שבו גדלים הערכים לאורך הציר האופקי. צריך לציין -1 כדי להפוך את סדר הערכים.

סוג: 1 או -1
ברירת מחדל: 1
hAxis.textPosition

המיקום של הטקסט בציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
hAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

מאפיין hAxis שמציין את הכותרת של הציר האופקי.

סוג: string
ברירת מחדל: null
hAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האופקי. לאובייקט יש את הפורמט הבא: 

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

טווח החיתוך של הציר האופקי.

סוג: object
ברירת מחדל: null
hAxis.viewWindow.max

הערך המקסימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
hAxis.viewWindow.min

הערך המינימלי של הנתונים האופקיים לעיבוד.

המערכת התעלמה מהמדיניות הזו כשהערך בשדה hAxis.viewWindowMode הוא 'pretty' או 'maximized'.

סוג: number
ברירת מחדל: אוטומטי
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
isStacked

אם המדיניות מוגדרת כ-true, הרכיבים מקובצים במקבצים לכל הסדרות בכל ערך בדומיין. הערה: בתרשימים מסוג Column (עמודה), Area ו-SteppedArea, ב-GoogleCharts הופכים את הסדר של הפריטים המקראיים כך שיתאימו יותר לסידור של רכיבי הסדרה (למשל, סדרה 0 תהיה הפריט המקרא הכי נמוך). האפשרות הזו לא חלה על תרשימי עמודות.

האפשרות isStacked תומכת גם בערימה של 100%, שבה ערימות הרכיבים בכל ערך בדומיין מותאמות מחדש כך שיצטברו עד 100%.

האפשרויות של isStacked הן:

  • false - רכיבים לא יקובצו. זוהי ברירת המחדל.
  • true – מקבץ רכיבים לכל הסדרות בכל ערך דומיין.
  • 'percent' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ב-100%, כאשר הערך של כל רכיב מחושב כאחוז של 100%.
  • 'relative' — מקבצים רכיבים לכל הסדרות בכל ערך של הדומיין ומתאימים אותם מחדש כך שיסתכמו ל-1, כאשר הערך של כל רכיב מחושב כשבר של 1.
  • 'absolute' — מתפקדת באופן זהה ל-isStacked: true.

במקרה של סידור בערימה של 100%, הערך המחושב של כל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.

ברירת המחדל של ציר היעד היא לסמן ערכים בהתבסס על הסולם היחסי של 0-1 בשברים של 1 עבור 'relative', ו-0-100% עבור 'percent' (הערה: כשמשתמשים באפשרות 'percent', ערכי הציר/הסימונים מוצגים באחוזים, אבל הערכים בפועל הם ערכי קנה המידה היחסיים של 0-1. הסיבה לכך היא שהסימונים של הציר באחוזים הם תוצאה של החלת הפורמט "#.##%" על ערכי הסולם היחסיים של 0-1. כשמשתמשים בפונקציה isStacked: 'percent', חשוב לציין סימונים/קווי רשת באמצעות ערכי הסולם היחסיים של 0-1). אפשר להתאים אישית את הערכים של קווי הרשת/הסימונים באמצעות האפשרויות המתאימות של hAxis/vAxis.

ערימה של 100% תומכת רק בערכי נתונים מסוג number, וחייבת להיות ערך בסיס של אפס.

סוג: boolean/ string
ברירת מחדל: false
מקרא

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
סוג: object
ברירת מחדל: null
legend.position

המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:

  • 'bottom' - מתחת לתרשים.
  • 'left' – משמאל לתרשים, בתנאי שלא משויכת לציר הימני סדרה. אם רוצים להשתמש במקרא מצד ימין, אפשר להשתמש באפשרות targetAxisIndex: 1.
  • 'in' - בתוך התרשים, בפינה הימנית העליונה.
  • 'none' – לא מוצג מקרא.
  • 'right' – משמאל לתרשים. לא תואם לאפשרות vAxes.
  • 'top' - מעל התרשים.
סוג: string
ברירת מחדל: 'right'
legendTextStyle

אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

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

האפשרות הזו נתמכת רק בציר discrete major.

סוג: boolean
ברירת מחדל: false
סדרה

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

  • areaOpacity - מבטל את areaOpacity הגלובלי עבור הסדרה הזו.
  • color - הצבע שיש להשתמש בו בסדרה הזו. צריך לציין מחרוזת חוקית של צבע HTML.
  • type - סוג הסמן לסדרה הזו. הערכים החוקיים הם 'line', 'area', 'bars' ו-'steppedArea'. חשוב לשים לב שעמודות הן למעשה עמודות אנכיות (עמודות). ערך ברירת המחדל מצוין על ידי האפשרות seriesType של התרשים.
  • labelInLegend - תיאור הסדרה שיופיע במקרא של התרשים.
  • lineDashStyle - מבטל את הערך הגלובלי של lineDashStyle לסדרה הזו.
  • targetAxisIndex – לאיזה ציר להקצות את הסדרה הזו, כאשר 0 הוא ציר ברירת המחדל ו-1 הוא הציר הנגדי. ערך ברירת המחדל הוא 0. כדי להגדיר תרשים שבו יוצגו סדרות שונות לפי צירים שונים, צריך להגדיר את הערך 1. יש להקצות לפחות סדרה אחת לציר ברירת המחדל. ניתן להגדיר קנה מידה שונה לצירים שונים.
  • visibleInLegend - ערך boolean, שבו true פירושו שהסדרה צריכה לכלול ערך מקרא, ו-false אומר שלא אמור להיות כך. ברירת המחדל היא true.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
סוג: מערך אובייקטים או אובייקט עם אובייקטים מקננים
ברירת מחדל: {}
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
עיצוב

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

  • 'maximized' - הגדלת השטח של התרשים, וציור של המקרא ושל כל התוויות בתוך אזור התרשים.
סוג: string
ברירת מחדל: null
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

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

סוג: boolean
useFirstColumnAsDomain

אם המדיניות מוגדרת כ-true, התרשים יתייחס לעמודה כדומיין.

סוג: boolean
vAxes

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

כדי להגדיר תרשים עם כמה צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות series.targetAxisIndex, ואז להגדיר את הציר באמצעות vAxes. הדוגמה הבאה מקצה את סדרה 2 לציר השמאלי ומציינת עבורה כותרת וסגנון טקסט מותאמים אישית: 

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
סוג: מערך של אובייקטים או אובייקט עם אובייקטי צאצא
ברירת מחדל: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
סוג: object
ברירת מחדל: null
vAxis.direction

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

סוג: 1 או -1
ברירת מחדל: 1
vAxis.gridlines

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

{color: '#333', minSpacing: 20}

האפשרות הזו נתמכת רק בציר continuous.

סוג: object
ברירת מחדל: null
vAxis.gridlines.color

הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: '#CCC'
vAxis.gridlines.count

המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים. אם תציינו מספר חיובי ל-gridlines.count, הוא ישמש לחישוב minSpacing בין קווי הרשת. אפשר לציין את הערך 1 כדי לשרטט רק קו רשת אחד, או 0 כדי לשרטט קווי רשת. האפשרות -1 היא ברירת המחדל, כדי לחשב אוטומטית את מספר קווי הרשת על סמך אפשרויות אחרות.

סוג: number
ברירת מחדל: -1
vAxis.logScale

אם מזינים true, אז הציר האנכי הוא קנה מידה לוגריתמי. הערה:כל הערכים חייבים להיות חיוביים.

סוג: boolean
ברירת מחדל: false
vAxis.maxValue

העברת הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים, הערך הזה יהיה כלפי מעלה. המערכת תתעלם מהמאפיין הזה אם הוא מוגדר לערך שקטן מערך ה-y המקסימלי של הנתונים. vAxis.viewWindow.max מבטל את המאפיין הזה.

סוג: number
ברירת מחדל:אוטומטי
vAxis.minorGridlines

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

סוג: object
ברירת מחדל: null
vAxis.minorGridlines.color

הצבע של קווי הרשת המינוריים האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML.

סוג: string
ברירת מחדל: שילוב של צבעי הרשת וצבע הרקע
vAxis.minorGridlines.count

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

סוג: number
ברירת מחדל: 1
vAxis.minValue

הזזת הערך המינימלי של הציר האנכי לערך שצוין. ברוב התרשימים הוא יהיה כלפי מטה. המערכת תתעלם אם ערך זה מוגדר לערך גדול מערך ה-y המינימלי של הנתונים. vAxis.viewWindow.min מבטל את המאפיין הזה.

סוג: number
ברירת מחדל: null
vAxis.textPosition

המיקום של הטקסט בציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'.

סוג: string
ברירת מחדל: 'out'
vAxis.textStyle

אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

מציין כותרת לציר האנכי.

סוג: string
ברירת מחדל: ללא כותרת
vAxis.titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת בציר האנכי. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

קובעת את טווח החיתוך של הציר האנכי.

סוג: object
ברירת מחדל: null
vAxis.viewWindow.max

הערך המקסימלי של נתונים אנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
vAxis.viewWindow.min

הערך המינימלי של הנתונים האנכיים לעיבוד.

המערכת מתעלמת מהמאפיין vAxis.viewWindowMode כשהוא 'יפה' או 'מקסימלי'.

סוג: number
ברירת מחדל: אוטומטי
רוחב

רוחב התרשים בפיקסלים.

סוג: number
ברירת מחדל: רוחב הרכיב שמכיל את הסרטון

אפשרויות הגדרה של תרשים טבלה

שם
alternatingRowStyle

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

סוג: boolean
ברירת מחדל: true
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
דף, עמוד

אם ואיך מפעילים דפדוף בנתונים. צריך לבחור אחד מהערכים הבאים של string:

  • 'enable' - הטבלה תכלול לחצנים להעברה לדף הקודם ולחזרה לדף הקודם. לחיצה על הלחצנים האלה תבצע את פעולת ההחלפה ותשנה את הדף המוצג. מומלץ להגדיר גם את האפשרות pageSize.
  • 'event' - הטבלה תכלול לחצנים למעבר לדף הבא ולחזרה לדף הקודם, אבל לחיצה עליהם תפעיל אירוע 'page' ולא תשנה את הדף המוצג. יש להשתמש באפשרות הזו כשהקוד מטמיע לוגיקה משלו להפיכת דפים. כדי לראות דוגמה לטיפול באירועי החלפה באופן ידני, אפשר לעיין בדוגמה של TableQueryWrapper.
  • 'disable' – [ברירת מחדל] אין תמיכה בהחלפה.
    • סוג: string
    ברירת מחדל: 'disable'
pageSize

מספר השורות בכל דף, כאשר החלוקה לדפים מופעלת עם אפשרות הדף.

סוג: number
ברירת מחדל: 10
showRowNumber

אם הערך שמוגדר הוא true, מספר השורה יוצג כעמודה הראשונה בטבלה.

סוג: boolean
ברירת מחדל: false
מיון

אם ואיך למיין עמודות כשהמשתמש לוחץ על כותרת של עמודה. אם המיון מופעל, כדאי להגדיר גם את המאפיינים sortAscending ו-sortColumn. צריך לבחור אחד מהערכים הבאים של string:

  • 'enable' - [ברירת מחדל] המשתמשים יכולים ללחוץ על כותרות של עמודות כדי למיין את הנתונים לפי העמודה שעליה לחצו. כשמשתמשים לוחצים על כותרת העמודה, השורות ממוינות באופן אוטומטי ומופעל אירוע 'sort'.
  • 'event' - כשמשתמשים לוחצים על כותרת העמודה, מופעל אירוע 'sort', אבל השורות לא ממוינות באופן אוטומטי. יש להשתמש באפשרות הזו כאשר בדף מוטמע מיון משלו. כדי לראות דוגמה לטיפול במיון אירועים באופן ידני, אפשר לעיין בדוגמה של TableQueryWrapper.
  • 'disable'- ללחיצה על כותרת עמודה אין השפעה.
סוג: string
ברירת מחדל: 'enable'
sortAscending

הסדר שבו ממוינת עמודת המיון הראשונית. True בסדר עולה, false לסדר יורד. המערכת תתעלם אם לא צוין sortColumn.

סוג: boolean
ברירת מחדל: true
sortColumn

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

סוג: number
ברירת מחדל: -1
רוחב

רוחב התרשים בפיקסלים.

סוג: number
ברירת מחדל: רוחב הרכיב שמכיל את הסרטון

אפשרויות ההגדרה של ציר הזמן

שם
backgroundColor

צבע הרקע של האזור הראשי בתרשים. הערך יכול להיות מחרוזת פשוטה של צבע HTML, לדוגמה: 'red' או '#00cc00', או אובייקט עם המאפיינים הבאים.

סוג: string או object
ברירת מחדל: 'white'
צבעים

הצבעים שבהם ייעשה שימוש ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: colors:['red','#004411'].

סוג: מערך מחרוזות
ברירת מחדל: צבעי ברירת המחדל
גובה

גובה התרשים בפיקסלים.

סוג: number
ברירת מחדל: הגובה של הרכיב שמכיל
רוחב

רוחב התרשים בפיקסלים.

סוג: number
ברירת מחדל: רוחב הרכיב שמכיל את הסרטון

אפשרויות תצורה של מפת עץ

שם
headerColor

הצבע של קטע הכותרת של כל צומת. יש לציין ערך HTML לצבע.

סוג: string
ברירת מחדל: #988f86
maxColor

הצבע של מלבן עם הערך maxColorValue בעמודה 3. מציינים ערך HTML לצבע.

סוג: string
ברירת מחדל: #00dd00
maxDepth

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

סוג: number
ברירת מחדל: 1
maxPostDepth

מספר הרמות של צמתים מעבר ל-maxDepth להציג באופן "רמז". צמתים חזויים מוצגים כמלבנים מוצללים בתוך צומת שנמצא בטווח של maxDepth.

סוג: number
ברירת מחדל: 0
midColor

הצבע של מלבן עם ערך של עמודה 3 באמצע בין maxColorValue ל-minColorValue. יש לציין ערך HTML לצבע.

סוג: string
ברירת מחדל: #000000
minColor

הצבע של מלבן עם הערך minColorValue בעמודה 3. מציינים ערך HTML לצבע.

סוג: string
ברירת מחדל: #dd0000
noColor

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

סוג: string
ברירת מחדל: #000000
כותרת משנה

טקסט שיוצג מתחת לכותרת התרשים.

סוג: string
ברירת מחדל: ללא כותרת
subtitleTextStyle

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

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
textStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. הצבע יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. ראה גם fontName ו-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
שם פריט

טקסט שיוצג מעל התרשים.

סוג: string
ברירת מחדל: ללא כותרת
titleTextStyle

אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }

הערך color יכול להיות כל מחרוזת של צבע HTML, לדוגמה: 'red' או '#00cc00'. כדאי לעיין גם ב-fontName וב-fontSize.

סוג: object
ברירת מחדל: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}