תרשים שטח מדורג

• 'category': קיבוץ הנתונים שנבחרו לפי ערך x.
• 'series': קיבוץ הנתונים שנבחרו לפי סדרה.
• 'auto': קיבוץ הנתונים שנבחרו לפי x-value אם לכל הבחירות יש ערך x זהה. אחרת, לפי סדרה.
• 'none': הצגה של הסבר קצר אחד בלבד לכל בחירה.

var options = {
  // Allow multiple
  // simultaneous selections.
  selectionMode: 'multiple',
  // Trigger tooltips
  // on selections.
  tooltip: {trigger: 'selection'},
  // Group selections
  // by x-value.
  aggregationTarget: 'category',
};
    

משך האנימציה, באלפיות השנייה. למידע נוסף, אפשר לעיין במשאבי העזרה בנושא אנימציה.

פונקציית ההתאמה לצפייה שמוחלת על האנימציה. אלו האפשרויות הזמינות:

• 'לינארי' - מהירות קבועה.
• 'in' – התאמה קלה – הפעלה איטית והגברת מהירות.
• 'out' – עשיית סדר – מתחילים מהר ומאטים.
• 'inAndOut' – להיכנס ולצאת בקלות – מתחילים לאט, מגבירים ואז מאטים.

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

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

המיקום של כותרות הצירים בהשוואה לאזור התרשים. ערכים נתמכים:

• in - ציירו את כותרות הצירים בתוך אזור התרשים.
• חוץ - משרטטים את כותרות הצירים מחוץ לשטח התרשים.
• ללא - השמטת כותרות הצירים.

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

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

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

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

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

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

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

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

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

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

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

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

האם התרשים כולל אירועים מבוססי-משתמשים או מגיב לאינטראקציה של משתמשים? אם הערך הוא False, התרשים לא יציג אירועים מסוג 'בחירה' או אירועים אחרים המבוססים על אינטראקציה (אלא יגרום להצגה של אירועי שגיאה או אירועים מוכנים) ולא יציג טקסט מרחף או שינוי אחר בהתאם לקלט של המשתמשים.

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

• 'datum' – התמקדות בנקודה על הגרף. תואם לתא בטבלת הנתונים.
• 'category' – התמקדות בקיבוץ של כל נקודות הנתונים לאורך הציר הראשי. תואם לשורה בטבלת הנתונים.

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

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

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

משרטטים את התרשים בתוך מסגרת בתוך מסגרת. (שימו לב שב-IE8 המערכת מתעלמת מהאפשרות הזו. כל התרשימים של IE8 משורטטים במסגרות i-frames).

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    

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

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

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

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

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

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

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

דוגמאות:

• hAxis: { ticks: [5,10,15,20] }
• hAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• hAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• hAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

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

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

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

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

אם הערך הוא False, התוויות החיצוניות ביותר יוסתרו ולא באמצעות מאגר התרשים. אם הערך הוא True, יתאפשר חיתוך של תוויות.

אם הערך הוא True, משרטטים את הטקסט של הציר האופקי בזווית כדי להתאים יותר טקסט לאורך הציר. אם הערך הוא False, משרטטים את הטקסט של הציר האופקי ישר. התנהגות ברירת המחדל היא להטות טקסט אם אי אפשר להתאים את כל הטקסט למצב זקוף. חשוב לשים לב שהאפשרות הזו זמינה רק כאשר hAxis.textPosition מוגדר כ-'out' (ברירת המחדל). ברירת המחדל היא false לתאריכים ושעות.

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

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

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

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

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

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

אינדקס השורות המבוסס על אפס, שבו מסתיים חלון החיתוך. נקודות על הגרף באינדקס הזה ומעלה ייחתכו. בשילוב עם vAxis.viewWindowMode.min, הוא מגדיר טווח פתוח למחצה [min, max) שמציין את האינדקסים של הרכיב שיוצגו. כלומר, כל אינדקס ש-min <= index < max יוצג.

המערכת מתעלמת ממנו כאשר הערך של hAxis.viewWindowMode הוא 'יפה' או 'מקסימלי'.

אינדקס השורות המבוסס על אפס, שבו מתחיל חלון החיתוך. נקודות על הגרף במדדים נמוכים מהערך הזה ייחתכו. בשילוב עם vAxis.viewWindowMode.max, הוא מגדיר טווח פתוח למחצה [min, max) שמציין את האינדקסים של הרכיב שיוצגו. במילים אחרות, כל אינדקס ש-min <= index < max יוצג.

המערכת מתעלמת ממנו כאשר הערך של hAxis.viewWindowMode הוא 'יפה' או 'מקסימלי'.

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

אם המדיניות מוגדרת כ-True, הרכיבים עויפים את הרכיבים לכל הסדרות בכל ערך דומיין. הערה: בתרשימים Column, Area ו-SteppedArea, Google Charts הופך את הסדר של פריטי המקרא להתאמה טובה יותר לערימה של רכיבי הסדרה (למשל, סדרה 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, ובסיס הנתונים שלו צריך להיות אפס.

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}

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

• 'start' - מיושר לתחילת האזור שהוקצה למקרא.
• 'center' (מרכז) – במרכז האזור שהוקצה למקרא.
• 'end' - מיושר לסוף השטח שהוקצה למקרא.

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

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

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

האפשרות הזו פועלת כרגע רק כשה- {1/}G.position הוא 'top'.

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

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

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

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

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

דפוס ההפעלה והכיבוי של קווים מקווקווים. לדוגמה, הפונקציה [4, 4] תחזור על עצמה על מקפים באורך 4 ולאחר מכן פערים באורך 4, ו-[5, 1, 3] יחזור על מקף באורך 5, פער באורך אחד, מקף באורך 3, פער באורך 5, מקף באורך אחד ופער של 3 אורך. למידע נוסף, אפשר לעיין במאמר Dashed Lines.

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

אם הערך של selectionMode הוא 'multiple', משתמשים יכולים לבחור כמה נקודות על הגרף.

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

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

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    

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

• 'maximized' – הגדלת השטח של התרשים ושרטוט של המקרא וכל התוויות בתוך האזור בתרשים. מגדיר את האפשרויות הבאות:

  chartArea: {width: '100%', height: '100%'},
  legend: {position: 'in'},
  titlePosition: 'in', axisTitlesPosition: 'in',
  hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
          

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

המיקום של כותרת התרשים, בהשוואה לאזור התרשים. ערכים נתמכים:

• in - משרטטים את הכותרת בתוך אזור התרשים.
• חוץ – משרטטים את הכותרת מחוץ לשטח התרשים.
• none - השמטת את הכותרת.

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

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

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

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

{textStyle: {color: '#FF0000'}, showColorCode: true}

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

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

אם המדיניות מוגדרת כ-True, צריך להשתמש בהסבר קצר על עיבוד HTML (ולא ב-SVG). למידע נוסף, אפשר לקרוא את המאמר התאמה אישית של תוכן הסבר קצר.

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

אם הערך הוא True, יוצגו ריבועים צבעוניים לצד פרטי הסדרה בהסבר הקצר. ברירת המחדל היא True אם הערך של focusTarget מוגדר כ-'category', אחרת ברירת המחדל היא False.

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

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

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

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

• 'focus' – ההסבר הקצר יוצג כשהמשתמש מעביר את העכבר מעל הרכיב.
• 'ללא' – ההסבר הקצר לא יוצג.
• 'בחירה' – ההסבר הקצר יוצג כשהמשתמש יבחר את הרכיב.

מציינת מאפיינים של צירים אנכיים ספציפיים, אם בתרשים יש כמה צירים אנכיים. כל אובייקט צאצא הוא אובייקט 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
  }
]
    

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}

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

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

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

מחרוזת עיצוב לתוויות של צירים מספריים. זו קבוצת משנה של קבוצת דפוסי ה-ICU . לדוגמה, {format:'#,###%'} יציג את הערכים 1,000%, 750% ו-50% לערכים 10, 7.5 ו-0.5. אפשר גם לספק את הפרטים הבאים:

• {format: 'none'}: הצגת מספרים ללא עיצוב (למשל, 8000000)
• {format: 'decimal'}: הצגת מספרים עם מפריד אלפים (למשל, 8,000,000)
• {format: 'scientific'}: הצגת מספרים בסימון מדעי (למשל, 8e6)
• {format: 'currency'}: הצגת מספרים במטבע המקומי (למשל, $8,000,000.00)
• {format: 'percent'}: הצגת מספרים כאחוזים (למשל, 800,000,000%)
• {format: 'short'}: הצגת מספרים מקוצרים (למשל, 8 חודשים)
• {format: 'long'}: הצגת מספרים כמילים שלמות (למשל, 8 מיליון)

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

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

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

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

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

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

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

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

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

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

המאפיין vAxis שהופך את הציר האנכי לקנה מידה לוגריתמי. יכול להיות אחת מהאפשרויות הבאות:

• null - לא מתבצעת קנה מידה לוגריתמי.
• 'log' - קנה מידה לוגריתמי. לא מוצגים ערכים שליליים וערכי אפס. האפשרות הזו זהה להגדרה vAxis: { logscale: true }.
• 'mirrorLog' - קנה מידה לוגריתמי שבו מוצגים ערכים שליליים וערכים של אפס. הערך בתרשים של מספר שלילי הוא מספר שלילי של היומן של הערך המוחלט. ערכים הקרובים ל-0 מוצגים בסולם ליניארי.

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

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

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

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

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

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

דוגמאות:

• vAxis: { ticks: [5,10,15,20] }
• vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

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

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

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

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

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

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

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

• 'pretty' – שינוי קנה המידה של הערכים האנכיים כך שערכי הנתונים המקסימליים והמינימליים יעובדו מעט בתוך האזור התחתון והחלק העליון של התרשים. התצוגה 'חלון' מורחבת לקו הרשת הראשי הקרוב ביותר למספרים, או לקו הרשת המשני הקרוב ביותר לתאריכים ושעות.
• 'maximized' – שינוי הגודל של הערכים האנכיים כך שערכי הנתונים המקסימליים והמינימליים נוגעים בחלק העליון והתחתון של אזור התרשים. כתוצאה מכך, המערכת תתעלם מ-vaxis.viewWindow.min ומ-vaxis.viewWindow.max.
• 'explicit' – אפשרות שהוצאה משימוש, שמאפשרת לציין את הערכים של קנה המידה העליון והתחתון של שטח התרשים. (הוצאה משימוש כי היא מיותרת כשמשתמשים ב-vaxis.viewWindow.min וב-vaxis.viewWindow.max. ערכי נתונים שמחוץ לערכים האלה ייחתכו. צריך לציין אובייקט vAxis.viewWindow שמתאר את ערכי המקסימום והמינימום להצגה.

מציין את טווח החיתוך של הציר האנכי.

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

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

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

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

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

מצייר את התרשים. בתרשים יתקבלו קריאות נוספות ל-method, רק אחרי שהאירוע ready מופעל. Extended description.

הפונקציה מחזירה את אובייקט הפעולה של ההסבר הקצר עם actionID המבוקש.

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

var cli = chart.getChartLayoutInterface();

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

cli.getBoundingBox('chartarea').height

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

cli.getBoundingBox('bar#0#2').width

תיבה תוחמת של מתקן התלייה החמישי בתרשים עוגה

cli.getBoundingBox('slice#4')

תיבת קישור של נתוני התרשים של תרשים אנכי (למשל, עמודה):

cli.getBoundingBox('vAxis#0#gridline')

תיבת קישור של נתוני התרשים של תרשים אופקי (למשל, עמודות):

cli.getBoundingBox('hAxis#0#gridline')

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

מחזירה אובייקט שמכיל את השדות השמאליים, החלק העליון, הרוחב והגובה של תוכן התרשים (כלומר, לא כולל תוויות ומקרא):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left

cli.getChartAreaBoundingBox().top

cli.getChartAreaBoundingBox().height

cli.getChartAreaBoundingBox().width

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

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

אפשר לקרוא ל-methods הבאות באובייקט שמוחזר:

• getBoundingBox
• getChartAreaBoundingBox
• getHAxisValue
• getVAxisValue
• getXLocation
• getYLocation

קוראים לפונקציה אחרי הצגת התרשים.

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

דוגמה: chart.getChartLayoutInterface().getHAxisValue(400)

קוראים לפונקציה אחרי הצגת התרשים.

מחזירה את התרשים שעבר סריאליזציה ל-URI של תמונה.

קוראים לפונקציה אחרי הצגת התרשים.

ראו הדפסת תרשימי PNG.

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

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

דוגמה: chart.getChartLayoutInterface().getVAxisValue(300)

קוראים לפונקציה אחרי הצגת התרשים.

הפונקציה מחזירה את קואורדינטת ה-x של dataValue ביחס לקצה השמאלי של הקונטיינר בתרשים.

דוגמה: chart.getChartLayoutInterface().getXLocation(400)

קוראים לפונקציה אחרי הצגת התרשים.

הפונקציה מחזירה את קואורדינטת ה-y של dataValue ביחס לקצה העליון של הקונטיינר בתרשים.

דוגמה: chart.getChartLayoutInterface().getYLocation(300)

קוראים לפונקציה אחרי הצגת התרשים.

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

הגדרת פעולת הסבר קצר שתבוצע כשהמשתמש ילחץ על הטקסט של הפעולה.

ה-method setAction מתייחסת לאובייקט כפרמטר הפעולה שלו. האובייקט הזה צריך לציין 3 מאפיינים: id – מזהה הפעולה שהוגדרה, text – הטקסט שצריך להופיע בהסבר הקצר על הפעולה ו-action – הפונקציה שצריכה לפעול כשמשתמש לוחץ על הטקסט של הפעולה.

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

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

ניקוי התרשים וכל המשאבים שהוקצו לו.

מופעל כשאנימציית המעבר מסתיימת.

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

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

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

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

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

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

מופעל כשהמשתמש לוחץ על ישות חזותית. כדי לבדוק אילו קבוצות נבחרו, אפשר להתקשר למספר getSelection().