סקירה כללית
תרשים שטח מדורג שעבר רינדור בדפדפן באמצעות SVG או VML. הצגת טיפים בהעברת העכבר מעל לשלבים.
דוגמה פשוטה
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('current', {'packages':['corechart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Director (Year)', 'Rotten Tomatoes', 'IMDB'], ['Alfred Hitchcock (1935)', 8.4, 7.9], ['Ralph Thomas (1959)', 6.9, 6.5], ['Don Sharp (1978)', 6.5, 6.4], ['James Hawes (2008)', 4.4, 6.2] ]); var options = { title: 'The decline of \'The 39 Steps\'', vAxis: {title: 'Accumulated Rating'}, isStacked: true }; var chart = new google.visualization.SteppedAreaChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
אפשרויות נפוצות
כמו בכל התרשימים של Google, תרשימי שטח מדורגים כוללים אפשרויות רבות, שמוצגות כאן. הנה דוגמה שממחישה חלק מהנפוצות ביותר:
בתרשים שלמעלה, שינינו את צבע הרקע עם backgroundColor
, העברנו את המקרא לתחתית עם legend.position
, הסרנו את הקווים האנכיים על ידי הגדרת connectSteps
ל-false והתאמתם את הצבעים. כך זה נעשה:
var options = { backgroundColor: '#ddd', legend: { position: 'bottom' }, connectSteps: false, colors: ['#4374E0', '#53A8FB', '#F1CA3A', '#E49307'], isStacked: true, };
תרשימי שטח מדורגים בערימה
תרשימי שטח מדורגים תומכים גם בערימה, כולל ערימה של 100%. תרשים שטח מדורג ומוערם הוא תרשים שטח מדורג שמציב ערכים קשורים זה לצד זה. אם קיימים ערכים שליליים, הם מסודרים אחד אחרי השני מתחת לקו הבסיס של התרשים. עבור 100% ערימה, הערימות של הרכיבים בכל ערך של דומיין מותאמות ל-100%, כך שהן מסתכמות. האפשרות היא isStacked: 'percent'
, שמציגה כל ערך
כ-100%, ו-isStacked: 'relative'
שמגדיר כל ערך כשבר של אחד. יש גם אפשרות isStacked: 'absolute'
, שהיא שוות-ערך ל-isStacked: true
.
הערה בתרשים ערימה של 100% בצד שמאל, ערכי הסימון נכתבים על בסיס קנה המידה היחסי של 0-1 כשברים של 1.
var options_stacked = { isStacked: true, height: 300, legend: {position: 'top', maxLines: 3}, vAxis: {minValue: 0} };
var options_fullStacked = { isStacked: 'relative', height: 300, legend: {position: 'top', maxLines: 3}, vAxis: { minValue: 0, ticks: [0, .3, .6, .9, 1] } };
בטעינה
שם החבילה של google.charts.load
הוא "corechart"
.
google.charts.load("current", {packages: ["corechart"]});
שם הכיתה הוא google.visualization.SteppedAreaChart
.
var visualization = new google.visualization.SteppedAreaChart(container);
פורמט נתונים
שורות: כל שורה בטבלה מייצגת קבוצה של עמודות.
עמודות:
עמודה 0 | עמודה 1 | ... | עמודה N | |
---|---|---|---|---|
מטרה: | תוויות של קבוצות ציר X | עמודה 1 כוללת ערכים בקבוצה הזו | ... | עמודות N בקבוצה הזו |
סוג הנתונים: | string | number | ... | number |
תפקיד: | דומיין | נתונים | ... | נתונים |
תפקידי עמודות אופציונליים: | ... |
אפשרויות הגדרה
שם | |
---|---|
יעד צבירה |
איך בחירות מרובות של נתונים משולבות בהסברים קצרים:
הרבה פעמים משתמשים ב-
aggregationTarget במקביל ל-selectionMode ול-tooltip.trigger , למשל:
var options = { // Allow multiple // simultaneous selections. selectionMode: 'multiple', // Trigger tooltips // on selections. tooltip: {trigger: 'selection'}, // Group selections // by x-value. aggregationTarget: 'category', }; סוג: מחרוזת
ברירת מחדל: 'אוטומטי'
|
אנימציה.משך |
משך האנימציה, באלפיות השנייה. פרטים נוספים זמינים במסמכי האנימציה. סוג: מספר
ברירת מחדל: 0
|
אנימציה. |
פונקציית ההתאמה לצפייה על האנימציה. אלו האפשרויות הזמינות:
סוג: מחרוזת
ברירת מחדל: 'לינארי'
|
אנימציה.התחלה |
קובע אם התרשים יונפש בהגרלה הראשונית. אם הערך סוג: בוליאני
ברירת המחדל לא
|
אזור שקיפות |
שקיפות ברירת המחדל של האזור שמתחת לשלב, כאשר 0.0 מציין שקיפות מלאה ו-1.0 מציין אטימות מלאה. לא משפיע על השקיפות של הקו המדורג. כדי ליצור תרשים קו מדורג, צריך להגדיר את הערך כ-0. כדי לציין שקיפות עבור סדרה ספציפית, יש להגדיר את הערך סוג: מספר, 0.0–1.0
ברירת מחדל: 0.3
|
ציר_כותרת |
איפה למקם את כותרות הציר, בהשוואה לאזור התרשים. ערכים נתמכים:
סוג: מחרוזת
ברירת מחדל: 'מחוץ'
|
צבע רקע |
צבע הרקע של האזור הראשי בתרשים. הוא יכול להיות מחרוזת צבע פשוטה ב-HTML, לדוגמה: Type: מחרוזת או אובייקט
ברירת מחדל: 'לבן'
|
הפעלה ברקע |
צבע הגבול של התרשים, כמחרוזת צבע של HTML. סוג: מחרוזת
ברירת מחדל: '#666'
|
colorColor.stringWidth |
רוחב הגבול, בפיקסלים. סוג: מספר
ברירת מחדל: 0
|
backgroundColor.fill |
צבע המילוי של התרשים, כמחרוזת צבע של HTML. סוג: מחרוזת
ברירת מחדל: 'לבן'
|
תרשים גבולות |
אובייקט עם חברי קבוצה כדי להגדיר את המיקום והגודל של אזור התרשים (שבו התרשים
עצמו משורטט, מלבד הציר והאגדות). ניתן להשתמש בשני פורמטים: מספר, או
מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים; מספר ואחריו % הוא אחוז. לדוגמה: Type: אובייקט
ברירת מחדל: null
|
ChartArea.backgroundColor |
צבע הרקע של אזור התרשים. כשמשתמשים במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, ' #fdc') או בשם של צבע אנגלי. כשאובייקט נמצא בשימוש, אפשר לספק את המאפיינים הבאים:
Type: מחרוזת או אובייקט
ברירת מחדל: 'לבן'
|
ChartArea.left |
מה המרחק מהתרשים מהגבול השמאלי? סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
התרשיםArea.top |
מה המרחק מהתרשים מהגבול העליון? סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
ChartArea.width |
רוחב האזור בתרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
ChartArea.height |
גובה שטח התרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
צבעים |
הצבעים שיש להשתמש בהם ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת צבע HTML. לדוגמה: סוג: מערך של מחרוזות
ברירת מחדל: צבעי ברירת מחדל
|
connectsteps |
אם המדיניות מוגדרת כ-True, יתבצע חיבור בין השלבים ליצירת קו מדורג. אחרת, תופיע רק שורה עליונה. ברירת המחדל היא לחבר את השלבים. סוג: בוליאני
ברירת מחדל: נכון
|
enableInteractive |
האם התרשים כולל אירועים מבוססי-משתמשים או מגיב לאינטראקציה של משתמש. אם ההעדפה מקבלת את הערך False, התרשים לא יציג אירועי 'select' או אירועים אחרים מבוססי-אינטראקציות (אבל יגרום לתיעוד של אירועי הכנה או שגיאות), ולא יציג טקסט מרחף או ישתנה בדרך אחרת בהתאם לקלט של המשתמשים. סוג: בוליאני
ברירת מחדל: נכון
|
מיקוד |
סוג הישות שמקבלת התמקדות באמצעות העברת העכבר. ההגדרה משפיעה גם על הישות שנבחרה בלחיצה על העכבר ועל הרכיב של טבלת הנתונים המשויך לאירועים. יכול להיות אחת מהאפשרויות הבאות:
ב-targetTarget 'קטגוריה', ההסבר הקצר מציג את כל ערכי הקטגוריות. האפשרות הזו יכולה להיות שימושית לצורך השוואת ערכים של סדרות שונות. סוג: מחרוזת
ברירת מחדל: 'דאטום'
|
גודל גופן |
גודל הגופן המוגדר כברירת מחדל, בפיקסלים, של כל הטקסט בתרשים. אפשר לשנות זאת באמצעות המאפיינים של רכיבי תרשים ספציפיים. סוג: מספר
ברירת מחדל: אוטומטי
|
שם גופן |
תצוגת ברירת המחדל של הגופן של כל הטקסט בתרשים. אפשר לשנות זאת באמצעות המאפיינים של רכיבי תרשים ספציפיים. סוג: מחרוזת
ברירת מחדל: 'xls'
|
forceIFrame |
משרטט את התרשים בתוך מסגרת מוטבעת. (שימו לב שב-IE8 המערכת מתעלמת מהאפשרות הזו. כל התרשימים של IE8 מצוירים ב-i-frames). סוג: בוליאני
ברירת מחדל: False
|
ציר |
אובייקט עם חברים כדי להגדיר אלמנטים שונים של הציר האופקי. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Type: אובייקט
ברירת מחדל: null
|
hAxis.direction |
הכיוון שבו גדלים הערכים לאורך הציר האופקי. אפשר לציין סוג: 1- או
ברירת מחדל: 1
|
hAxis.textPosition |
המיקום של טקסט הציר האופקי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'. סוג: מחרוזת
ברירת מחדל: 'מחוץ'
|
hAxis.textStyle |
אובייקט שמציין את סגנון הטקסט של הציר האופקי. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.ticks |
מחליף את הסימונים של ציר ה-X שנוצר באופן אוטומטי במערך שצוין. כל רכיב במערך צריך להיות ערך שנתן חוקי (למשל מספר, תאריך, תאריך ושעה או שעה) או אובייקט. אם זהו אובייקט, הוא צריך לכלול מאפיין
ה-viewWindow יורחב באופן אוטומטי כדי לכלול את ערכי המינימום והמקסימום, אלא אם יצוינו דוגמאות:
סוג: מערך של רכיבים
ברירת מחדל: אוטומטי
|
hAxis.title |
מאפיין סוג: מחרוזת
ברירת מחדל: null
|
hAxis.titleTextStyle |
אובייקט שמציין את סגנון הטקסט של כותרת הציר האופקי. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.allowContainerBoundaryTextCutoff |
אם FALSE, מסתיר תוויות חיצוניות במקום לאפשר חיתוך שלהן על ידי מאגר התרשים. אם הערך הוא true, מותר לחתוך תוויות. סוג: בוליאני
ברירת מחדל: False
|
hAxis.slantedText |
אם True, יש לשרטט את הטקסט של הציר האופקי בזווית כדי לסייע בהוספת טקסט נוסף לאורך הציר. אם שגוי, יש לשרטט את הטקסט של הציר האופקי למעלה. התנהגות ברירת המחדל היא להטות את הטקסט אם לא ניתן להתאים את כולן בזמן השרטוט במצב אנכי. חשוב לשים לב שהאפשרות הזו זמינה רק אם המדיניות סוג: בוליאני
ברירת מחדל: אוטומטי
|
hAxis.slantedTextAngle |
זווית הטקסט של הציר האופקי, אם משורטטים בו השיפוע. המערכת מתעלמת מהשדה אם
סוג: מספר, -90–90
ברירת מחדל: 30
|
hAxis.maxAlternation |
מספר הרמות המקסימלי של טקסט בציר האופקי. אם תוויות הטקסט של הציר יהיו עמוסות מדי, השרת עשוי להעביר תוויות סמוכות למעלה או למטה כדי להתאים תוויות ככל האפשר. הערך הזה מציין את מספר הרמות המקסימלי לשימוש. השרת יכול להשתמש בפחות רמות, אם התוויות יכולות להתאים ללא חפיפה. בתאריכים ושעות, ברירת המחדל היא 1. סוג: מספר
ברירת מחדל: 2
|
hAxis.maxTextLines |
מספר השורות המקסימלי המותר בתוויות טקסט. תוויות יכולות להתפרס על פני מספר שורות אם הן ארוכות מדי, ומספר השורות מוגבל, כברירת מחדל, בגובה של השטח הזמין. סוג: מספר
ברירת מחדל: אוטומטי
|
hAxis.minTextSpacing |
ריווח אופקי מינימלי, בפיקסלים, מותר בין שתי תוויות טקסט סמוכות. אם יש יותר מדי רווחים בין התוויות, או שהן ארוכות מדי, הריווח יכול לרדת מתחת לסף הזה.במקרה כזה, ייושם אחד מאמצעי ההסרה של התוויות (למשל, חיתוך התוויות או שחרור חלק מהן). סוג: מספר
ברירת מחדל: הערך של
hAxis.textStyle.fontSize |
hAxis.showTextEvery |
כמה תוויות של הציר האופקי יש להציג, כאשר 1 מייצג כל תווית, 2 פירושו הצגה של כל תווית אחרת, וכן הלאה. ברירת המחדל היא לנסות להציג כמה שיותר תוויות בלי חפיפה. סוג: מספר
ברירת מחדל: אוטומטי
|
hAxis.viewWindow |
קביעת טווח החיתוך של הציר האופקי. Type: אובייקט
ברירת מחדל: null
|
hAxis.viewWindow.max |
אינדקס השורות שלא מבוסס על המספר שבו חלון החיתוך מסתיים. נקודות נתונים באינדקס הזה
ומספר גבוה יותר ייחתכו. בשילוב עם המערכת מתעלמת מהמאפיין הזה כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
hAxis.viewWindow.min |
אינדקס השורות שמבוססות על אפס שבו מתחיל חלון החיתוך. נקודות הנתונים באינדקסים הנמוכים
יקוצרו. בשילוב עם המערכת מתעלמת מהמאפיין הזה כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
גובה |
גובה התרשים, בפיקסלים. סוג: מספר
ברירת מחדל: הגובה של הרכיב שמכיל את הסרטון
|
בערימה |
אם היא מוגדרת כ-true, האלמנטים בכל הסדרות נערמות בכל ערך של דומיין. הערה: בתרשימים עמודה, שטח ו סדרה משודרגת, Google Podcasts מבטלת את הסדר של פריטי מקרא כדי להתאים טוב יותר לערימה של רכיבי הסדרה (לדוגמה, סדרה 0 תהיה הפריט התחתון ביותר במקרא). זה לא רלוונטי לתרשימי Bar.
האפשרות האפשרויות של
עבור 100% ערימה, הערך המחושב של כל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.
כברירת מחדל, המערכת תציב ערכים של ציר הזמן לסמן ערכים על בסיס הסולם היחסי מ-0 עד 1 בתור שברים
של 1 עבור
100% בערימה נתמכת רק של ערכי נתונים מסוג סוג: בוליאני/מחרוזת
ברירת מחדל: False
|
מקרא |
אובייקט עם חברים כדי להגדיר היבטים שונים של המקרא. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type: אובייקט
ברירת מחדל: null
|
האגדה |
היישור של המקרא. יכול להיות אחת מהאפשרויות הבאות:
ההתחלה, המרכז והסוף הם יחסיים לסגנון של המקרא - אנכי או אופקי. לדוגמה, במקרא 'right', 'start' ו-'end' נמצאים בחלק העליון ובחלק התחתון בהתאמה, עבור המקרא 'top', 'start' ו-'end' יופיעו בפינה הימנית ובפינה השמאלית של האזור, בהתאמה. ערך ברירת המחדל תלוי במיקום המקרא. עבור אגדות 'תחתיות', ברירת המחדל היא 'center', ואילו אגדות אחרות מוגדרות כברירת מחדל ל-'start'. סוג: מחרוזת
ברירת מחדל: אוטומטי
|
האגדה.maxLines |
מספר השורות המרבי במקרא. אפשר להגדיר את המספר למספר גדול יותר כדי להוסיף קווים למקרא. הערה: הלוגיקה המדויקת ששימשה לקביעת מספר הקווים שעברו עיבוד עדיין עדיין משתנה. האפשרות הזו פועלת כרגע רק כש-אגד.position הוא 'top' (למעלה). סוג: מספר
ברירת מחדל: 1
|
אגדה |
מיקום המקרא. יכול להיות אחת מהאפשרויות הבאות:
סוג: מחרוזת
ברירת מחדל: 'ימין'
|
style.textStyle |
אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
קו סגנון |
דפוס ההפעלה והכיבוי עבור קווים מקווקווים. לדוגמה, הפונקציה סוג: מערך של מספרים
ברירת מחדל: null
|
הפוך קטגוריות |
אם המדיניות מוגדרת כ-True, היא תציג את הסדרה מימין לשמאל. הגדרת ברירת המחדל היא ציור משמאל לימין. סוג: בוליאני
ברירת מחדל: False
|
אפשרויות בחירה |
אם הערך של סוג: מחרוזת
ברירת מחדל: 'סינגל'
|
סדרה |
מערך אובייקטים, כאשר כל אחד מהם מתאר את הפורמט של הסדרה המתאימה בתרשים. כדי להשתמש בערכי ברירת מחדל של סדרה, מציינים אובייקט ריק {}. אם לא מציינים סדרה או ערך, המערכת תשתמש בערך הגלובלי. כל אובייקט תומך במאפיינים הבאים:
ניתן לציין מערך של אובייקטים, כשכל אחד מהם חל על הסדרה לפי הסדר הנתון, או לציין אובייקט כאשר לכל ילד יש מפתח מספרי שמציין באיזו סדרה הוא חל. לדוגמה, שתי ההצהרות הבאות זהות, ומצהירות על הסדרה הראשונה כשחורה וחסרה במקרא, והרביעית כאדום וחסרה במקרא: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } Type: מערך של אובייקטים, או אובייקט עם אובייקטים בתוך רכיב
ברירת מחדל: {}
|
עיצוב |
עיצוב הוא קבוצה של ערכי אפשרויות שהוגדרו מראש, והם פועלים יחד כדי להשיג התנהגות ספציפית בתרשים או אפקט חזותי. נכון לעכשיו, אפשר להשתמש רק בעיצוב אחד:
סוג: מחרוזת
ברירת מחדל: null
|
שם פריט |
טקסט להצגה מעל לתרשים. סוג: מחרוזת
ברירת מחדל: ללא שם
|
כותרת |
איפה למקם את כותרת התרשים, בהשוואה לאזור התרשים. ערכים נתמכים:
סוג: מחרוזת
ברירת מחדל: 'מחוץ'
|
סגנון טקסט |
אובייקט שמציין את סגנון הטקסט של הכותרת. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
הסבר קצר |
אובייקט עם חברים להגדרת אלמנטים שונים של הסבר קצר. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמתואר כאן: {textStyle: {color: '#FF0000'}, showColorCode: true} Type: אובייקט
ברירת מחדל: null
|
description.ignoreBounds |
אם המדיניות מוגדרת כ- הערה:האפשרות הזו רלוונטית רק להסברים קצרים ב-HTML. אם אפשרות זו מופעלת עם הסברים בפורמט SVG, גלישת הנתונים מעבר לגבולות התרשים תיחתך. פרטים נוספים זמינים במאמר התאמה אישית של תוכן של הסברים קצרים. סוג: בוליאני
ברירת מחדל: False
|
overview.isHtml |
אם היא מוגדרת כ-true, משתמשים בהסברים קצרים על HTML (ולא ברינדור SVG) פרטים נוספים זמינים במאמר התאמה אישית של תוכן של הסברים קצרים. הערה: ההתאמה האישית של תוכן ההסבר הקצר ב-HTML באמצעות תפקיד נתוני העמודה של ההסבר הקצר לא נתמכת על ידי התצוגה החזותית תרשים בועות. סוג: בוליאני
ברירת מחדל: False
|
Description.showColorCode |
אם True, יש להציג ריבועים צבעוניים ליד פרטי הסדרה בהסבר הקצר. ברירת המחדל
היא הערך True כאשר סוג: בוליאני
ברירת מחדל: אוטומטי
|
overview.textStyle |
אובייקט שמציין את סגנון הטקסט של ההסבר הקצר. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
overview.trigger |
האינטראקציה של המשתמש שגרמה להצגת ההסבר הקצר:
סוג: מחרוזת
ברירת מחדל: 'התמקדות'
|
vAxes |
קביעת המאפיינים של צירים אנכיים בודדים, אם התרשים כולל מספר צירים אנכיים.
כל אובייקט צאצא הוא אובייקט
כדי לציין תרשים עם מספר צירים אנכיים, קודם צריך להגדיר ציר חדש באמצעות { series: { 2: { targetAxisIndex:1 } }, vAxes: { 1: { title:'Losses', textStyle: {color: 'red'} } } }
המאפיין הזה יכול להיות אובייקט או מערך: האובייקט הוא אוסף של אובייקטים, ולכל אחד יש תווית מספרית המציינת את הציר שהוא מגדיר – זהו הפורמט שמוצג למעלה; המערך הוא מערך של אובייקטים, אחד לכל ציר. לדוגמה, הסימון הבא בסגנון מערך
זהה לאובייקט vAxes: [ {}, // Nothing specified for axis 0 { title:'Losses', textStyle: {color: 'red'} // Axis 1 } ] סוג: מערך של אובייקט או אובייקט עם אובייקטים צאצאים
ברירת מחדל: null
|
צירים |
אובייקט עם חברים כדי להגדיר רכיבים שונים בציר האנכי. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Type: אובייקט
ברירת מחדל: null
|
0 |
מאפיין סוג: מספר
ברירת מחדל: אוטומטי
|
vAxis.webkitColor |
קביעת צבע הבסיס של הציר האנכי. ניתן להשתמש בכל מחרוזת צבע בפורמט HTML, לדוגמה: סוג: מספר
ברירת מחדל: 'שחור'
|
vAxis.direction |
הכיוון שבו גדלים הערכים לאורך הציר האנכי. כברירת מחדל, הערכים הנמוכים נמצאים בתחתית התרשים. אפשר לציין סוג: 1- או
ברירת מחדל: 1
|
vAxis.format |
מחרוזת פורמט עבור תוויות ציר מספרי. זו קבוצת משנה של
קבוצת דפוסי ICU
.
למשל, הערכים "1,000%",
"750%" ו-"50%" יוצגו עבור
העיצוב בפועל שהוחלו על התווית נגזר מהלוקאל שבו ה-API נטען. לפרטים נוספים, אפשר לקרוא את המאמר טעינת תרשימים עם שפה או אזור ספציפיים .
כשהמערכת קובעת את ערכי הסימון ואת קווי הרשת, מביאים בחשבון כמה שילובים
חלופיים של כל האפשרויות הרלוונטיות.
כך שאפשר לציין את הערך סוג: מחרוזת
ברירת מחדל: אוטומטי
|
vAxis.gridlines |
אובייקט עם חברים להגדרת קווי הרשת בציר האנכי. שימו לב שקווי הרשת של הציר האנכי משורטטים אופקית. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {color: '#333', minSpacing: 20} Type: אובייקט
ברירת מחדל: null
|
vAxis.gridlines.color |
הצבע של קווי הרשת האנכיים בתוך אזור התרשים. יש לציין מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: ' #CCC'
|
vAxis.gridlines.count |
המספר המשוער של קווי רשת אופקיים בתוך האזור בתרשים.
אם מציינים מספר חיובי לציון סוג: מספר
ברירת מחדל: -1
|
vAxis.minorGridlines |
אובייקט עם חברים להגדרת קווי הרשת המשניים בציר האנכי, באופן דומה לאפשרות vAxis.gridlines. Type: אובייקט
ברירת מחדל: null
|
vAxis.minorGridlines.color |
הצבע של קווי הרשת המשניים האנכיים בתוך אזור התרשים. יש לציין מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: שילוב של צבעי הרשת והרקע
|
vAxis.minorGridlines.count |
האפשרות minGridlines.count הוצאה משימוש ברובה, מלבד השבתה של קווי רשת משניים על ידי הגדרת הספירה כ-0. מספר קווי הרשת המזעריים תלוי במרווחי הזמן של קווי רשת ראשיים (כדאי לעיין בקטע vAxis.gridlines.interval) וברווח המינימלי הנדרש (מידע נוסף זמין בקטע vAxis.minorGridlines.minSpacing). סוג: מספר
ברירת מחדל: 1
|
vAxis.logScale |
אם True, הציר האנכי מוגדר בקנה מידה לוגריתמי. הערה: כל הערכים צריכים להיות חיוביים. סוג: בוליאני
ברירת מחדל: False
|
vAxis.scaleType |
מאפיין
סוג: מחרוזת
ברירת מחדל: null
|
vAxis.textPosition |
המיקום של טקסט הציר האנכי, ביחס לאזור התרשים. ערכים נתמכים: 'out', 'in', 'none'. סוג: מחרוזת
ברירת מחדל: 'מחוץ'
|
vAxis.textStyle |
אובייקט שמציין את סגנון הטקסט של הציר האנכי. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.ticks |
מחליף את הסימונים של ציר ה-Y שנוצר באופן אוטומטי במערך שצוין. כל רכיב במערך צריך להיות ערך שנתן חוקי (למשל מספר, תאריך, תאריך ושעה או שעה) או אובייקט. אם זהו אובייקט, הוא צריך לכלול מאפיין
ה-viewWindow יורחב באופן אוטומטי כדי לכלול את ערכי המינימום והמקסימום, אלא אם יצוינו דוגמאות:
סוג: מערך של רכיבים
ברירת מחדל: אוטומטי
|
vAxis.title |
מאפיין סוג: מחרוזת
ברירת מחדל: ללא שם
|
vAxis.titleTextStyle |
אובייקט שמציין את סגנון הטקסט של הכותרת של הציר האנכי. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.maxValue |
הפונקציה מעבירה את הערך המקסימלי של הציר האנכי לערך שצוין, והוא יהיה למעלה
ברוב התרשימים. המערכת מתעלמת מהשדה אם הוא מוגדר לערך קטן מערך ה-y המקסימלי של הנתונים.
הנכס סוג: מספר
ברירת מחדל: אוטומטי
|
vAxis.minValue |
הפונקציה מעבירה את הערך המינימלי של הציר האנכי לערך שצוין, והוא יהיה למטה ברוב התרשימים. המערכת מתעלמת מהמאפיין הזה אם הוא מוגדר לערך גדול מערך ה-y המינימלי של הנתונים.
הנכס סוג: מספר
ברירת מחדל: null
|
vAxis.viewWindowMode |
מפרט את קנה המידה של הציר האנכי כדי לעבד את הערכים בתוך אזור התרשים. יש תמיכה בערכי המחרוזת הבאים:
סוג: מחרוזת
ברירת מחדל:
שווה ערך ל-'יפה', אבל
vaxis.viewWindow.min ו-vaxis.viewWindow.max מקבלים עדיפות.
|
vAxis.viewWindow |
קביעת טווח החיתוך של הציר האנכי. Type: אובייקט
ברירת מחדל: null
|
vAxis.viewWindow.max |
הערך המקסימלי של נתונים אנכיים לעיבוד. המערכת מתעלמת מהמאפיין הזה כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
vAxis.viewWindow.min |
הערך המינימלי של נתונים אנכיים לעיבוד. המערכת מתעלמת מהמאפיין הזה כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
רוחב |
רוחב התרשים, בפיקסלים. סוג: מספר
ברירת מחדל: הרוחב של הרכיב שמכיל
|
שיטות
שיטה | |
---|---|
draw(data, options) |
משרטט את התרשים. התרשים מקבל קריאות נוספות לשיטה רק אחרי
האירוע סוג החזרה: אין
|
getAction(actionID) |
מחזירה את אובייקט הפעולה של ההסבר הקצר עם סוג החזרה: אובייקט
|
getBoundingBox(id) |
מחזירה אובייקט שמכיל את החלק השמאלי, העליון, הרוחב והגובה של רכיב התרשים
הערכים יחסיים למאגר של התרשים. כדאי לקרוא לזה אחרי שהתרשים משורטט. סוג החזרה: אובייקט
|
getChartAreaBoundingBox() |
החזרת אובייקט שמכיל את תוכן התרשים, החלק השמאלי, העליון, הרוחב והגובה שלו (כלומר, לא כולל תוויות ומקרא):
הערכים יחסיים למאגר של התרשים. כדאי לקרוא לזה אחרי שהתרשים משורטט. סוג החזרה: אובייקט
|
getChartLayoutInterface() |
מחזירה אובייקט שמכיל מידע על המיקום של התרשים ועל הרכיבים שלו. אפשר לקרוא לשיטות הבאות על האובייקט שהוחזר:
כדאי לקרוא לזה אחרי שהתרשים משורטט. סוג החזרה: אובייקט
|
getHAxisValue(xPosition, optional_axis_index) |
מחזירה את הערך של הנתונים האופקיים ב- דוגמה: כדאי לקרוא לזה אחרי שהתרשים משורטט. סוג החזרה: מספר
|
getImageURI() |
מחזירה את התרשים בהמשכים כ-URI של תמונה. כדאי לקרוא לזה אחרי שהתרשים משורטט. מידע נוסף זמין במאמר הדפסה של תרשימי PNG. סוג החזרה: מחרוזת
|
getSelection() |
היא מחזירה מערך של ישויות התרשים שנבחרו.
ישויות שניתנות לבחירה הן שלבים, רשומות מקרא וקטגוריות.
שלב מתאים לתא בטבלת הנתונים, ערך מקרא לעמודה (אינדקס השורה הוא ריק) וקטגוריה לשורה (אינדקס העמודה הוא ריק).
בתרשים הזה אפשר לבחור רק ישות אחת בכל רגע נתון.
סוג החזרה: מערך של רכיבי בחירה
|
getVAxisValue(yPosition, optional_axis_index) |
הפונקציה מחזירה את ערך הנתונים האנכיים ב- דוגמה: כדאי לקרוא לזה אחרי שהתרשים משורטט. סוג החזרה: מספר
|
getXLocation(dataValue, optional_axis_index) |
מחזירה את קואורדינטת ה-x של הפיקסל ( דוגמה: כדאי לקרוא לזה אחרי שהתרשים משורטט. סוג החזרה: מספר
|
getYLocation(dataValue, optional_axis_index) |
מחזירה את קואורדינטת ה-y הפיקסל של דוגמה: כדאי לקרוא לזה אחרי שהתרשים משורטט. סוג החזרה: מספר
|
removeAction(actionID) |
פעולה זו תסיר מהתרשים את פעולת ההסבר הקצר עם סוג החזרה:
none |
setAction(action) |
מגדירה פעולת הסבר קצר שהמשתמש יבצע לאחר לחיצה על טקסט הפעולה.
השיטה
צריך להגדיר את כל הפעולות בהסבר הקצר לפני הקריאה לשיטה סוג החזרה:
none |
setSelection() |
בחירת ישויות התרשים שצוינו. ביטול כל בחירה קודמת.
ישויות שניתנות לבחירה הן שלבים, רשומות מקרא וקטגוריות.
שלב מתאים לתא בטבלת הנתונים, ערך מקרא לעמודה (אינדקס השורה הוא ריק) וקטגוריה לשורה (אינדקס העמודה הוא ריק).
בתרשים הזה אפשר לבחור רק ישות אחת בכל פעם.
סוג החזרה: אין
|
clearChart() |
ניקוי התרשים ושחרור כל המשאבים שהוקצו לו. סוג החזרה: אין
|
אירועים
מידע נוסף על השימוש באירועים האלה מפורט במאמרים אינטראקטיביות בסיסית, אירועי טיפול ואירועי הפעלה.
שם | |
---|---|
animationfinish |
מופעל כשהאנימציה של המעבר מסתיימת. מאפיינים: ללא
|
click |
מופעל כשהמשתמש לוחץ על התרשים. ניתן להשתמש בו כדי לזהות את הלחיצות על הכותרת, רכיבי הנתונים, הערכים במקרא, הציר, קווי הרשת או התוויות. נכסים: targetID
|
error |
מופעל כשמתרחשת שגיאה במהלך הניסיון לעבד את התרשים. מאפיינים: מזהה, הודעה
|
legendpagination |
מופעל כשהמשתמש לוחץ על מקשי העימוד של האגדות. מחזיר את האינדקס הנוכחי של הדפים המבוססים על אפסים ואת המספר הכולל של הדפים. נכסים: currentPageIndex, totalPages
|
onmouseover |
מופעל כשהמשתמש מעביר את העכבר מעל ליישות חזותית. מחזירה את האינדקסים של השורה והעמודה של הרכיב המתאים בטבלת הנתונים. מאפיינים: שורה, עמודה
|
onmouseout |
מופעל כשהמשתמש מעביר את העכבר מעל ליישות ויזואלית. מחזירה את האינדקסים של השורה והעמודה של הרכיב המתאים בטבלת הנתונים. מאפיינים: שורה, עמודה
|
ready |
התרשים מוכן לקריאות חיצוניות לשיטה אם רוצים ליצור אינטראקציה עם התרשים ועם
שיטות השיחה אחרי ששרטטים אותו, צריך להגדיר למאזינים אירוע זה לפני שמתקשרים אל השיטה מאפיינים: ללא
|
select |
מופעל כשהמשתמש לוחץ על ישות חזותית. כדי לראות מה נבחר, צריך להתקשר למספר מאפיינים: ללא
|
מדיניות נתונים
כל הנתונים והקוד מעובדים ומעובדים בדפדפן. לא יישלחו נתונים לאף שרת.