סקירה כללית
היסטוגרמה היא תרשים שמקבץ נתונים מספריים לאשפה, ומציג את התאים כעמודות מפולחות. הם משמשים לתיאור ההתפלגות של מערך נתונים: באיזו תדירות הערכים שייכים לטווחים.
מערכת Google Charts בוחרת בשבילכם את מספר התאים באופן אוטומטי. כל התאים מכילים רוחב שווה והגובה שלהם פרופורציונלי למספר נקודות הנתונים בסל. מבחינות אחרות, ההיסטוגרמות דומות לתרשימי עמודות.
דוגמה
הנה היסטוגרמה של אורכי הדינוזאורים:
ההיסטוגרמה אומרת לנו שהתא הנפוץ ביותר הוא פחות מ-10 מטרים, ושיש רק דינוזאור אחד בגובה של יותר מ-40 מטר. אנחנו יכולים להעביר את העכבר מעל הסרגל כדי לגלות שהוא הסיימוזאורוס (שיכול להיות דיפלודוקוס גדול מאוד. פליאונטולוגים לא בטוחים).
הקוד ליצירת ההיסטוגרמה מוצג למטה. אחרי הגדרת הנתונים (כאן, עם google.visualization.arrayToDataTable
), התרשים מוגדר באמצעות קריאה ל-google.visualization.Histogram
ומשורטט באמצעות ה-method draw
.
<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([ ['Dinosaur', 'Length'], ['Acrocanthosaurus (top-spined lizard)', 12.2], ['Albertosaurus (Alberta lizard)', 9.1], ['Allosaurus (other lizard)', 12.2], ['Apatosaurus (deceptive lizard)', 22.9], ['Archaeopteryx (ancient wing)', 0.9], ['Argentinosaurus (Argentina lizard)', 36.6], ['Baryonyx (heavy claws)', 9.1], ['Brachiosaurus (arm lizard)', 30.5], ['Ceratosaurus (horned lizard)', 6.1], ['Coelophysis (hollow form)', 2.7], ['Compsognathus (elegant jaw)', 0.9], ['Deinonychus (terrible claw)', 2.7], ['Diplodocus (double beam)', 27.1], ['Dromicelomimus (emu mimic)', 3.4], ['Gallimimus (fowl mimic)', 5.5], ['Mamenchisaurus (Mamenchi lizard)', 21.0], ['Megalosaurus (big lizard)', 7.9], ['Microvenator (small hunter)', 1.2], ['Ornithomimus (bird mimic)', 4.6], ['Oviraptor (egg robber)', 1.5], ['Plateosaurus (flat lizard)', 7.9], ['Sauronithoides (narrow-clawed lizard)', 2.0], ['Seismosaurus (tremor lizard)', 45.7], ['Spinosaurus (spiny lizard)', 12.2], ['Supersaurus (super lizard)', 30.5], ['Tyrannosaurus (tyrant lizard)', 15.2], ['Ultrasaurus (ultra lizard)', 30.5], ['Velociraptor (swift robber)', 1.8]]); var options = { title: 'Lengths of dinosaurs, in meters', legend: { position: 'none' }, }; var chart = new google.visualization.Histogram(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
אפשר להשמיט את התוויות (כאן, שמות הדינוזאורים), ובמקרה כזה ההסברים הקצרים יציגו רק את הערך המספרי.
שליטה בצבעים
הנה היסטוגרמה של אוכלוסיות לאומיות:
יש יותר מ-200 מדינות עם אוכלוסיות של פחות ממאה מיליון, ואחר כך מצטמצם מאוד.
ההיסטוגרמה הזו משתמשת באפשרות colors
כדי לשרטט את הנתונים בירוק:
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['green'], };
כמו בכל תרשימים ב-Google, אפשר לציין צבעים כשמות באנגלית או כערכים הקסדצימליים.
שליטה בקטגוריות
כברירת מחדל, מערכת Google Charts תבחר את גודל הקטגוריה באופן אוטומטי, באמצעות אלגוריתם ידוע להיסטוגרמות. עם זאת, לפעמים תרצו לשנות זאת, והתרשים שלמעלה הוא דוגמה. מאחר שבקטגוריה הראשונה יש כל כך הרבה מדינות, קשה לבחון אותן בקבוצות אחרות.
במצבים כאלה, תרשים ההיסטוגרמה כולל שתי אפשרויות: histogram.bucketSize
, שמבטלת את האלגוריתם ומקלידים את גודל הקטגוריה בתוך הקוד; ו-histogram.lastBucketPercentile
. האפשרות השנייה מחייבת הסבר נוסף: היא משנה את החישוב של גודל הקטגוריות, כך שמתעלמים מהערכים הגבוהים או נמוכים יותר מהערכים הנותרים לפי האחוז שציינתם. הערכים עדיין כלולים בהיסטוגרמה, אבל אין להם השפעה על אופן הסיווג שלהם. האפשרות הזו שימושית כשלא רוצים שחריגים חריגים יופיעו בקטגוריות שלהם – במקום זאת הם יקובצו לפי הקטגוריה הראשונה או האחרונה.
בתרשים שלמעלה, כשמחשבים את גודל הקטגוריה, התעלמנו מ-5 האחוזים המובילים ומ-5 האחוזים התחתונים. הערכים עדיין מוצגים בתרשים. הדבר היחיד שהשתנה הוא גודל הקטגוריה, אבל הדבר מהווה היסטוגרמה קריאה יותר.
הדוגמה הזו גם ממחישה איך אפשר לשנות את קנה המידה של הציר האנכי כדי להשתמש בסולם 'יומן שיקוף', שגם עוזר ליצור תרשימים של נתונים שיש להם זנב ארוך של ערכים קטנים.
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['#e7711c'], histogram: { lastBucketPercentile: 5 }, vAxis: { scaleType: 'mirrorLog' } };
כמו שאפשר לראות, הסרת חמשת האחוזים העליונים והתחתונים מהחישוב הובילה לגודל של 10,000,000 קטגוריה במקום את 100,000,000, במקום אחר. אם ידעתם לאורך זמן שגודל קטגוריה של 10,000,000 הוא מה שאתם רוצים, הייתם יכולים להשתמש ב-histogram.bucketSize
כדי לעשות זאת:
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['#e7711c'], histogram: { bucketSize: 10000000 } };
בדוגמה הבאה אנחנו מראים איך להרחיב את טווח הקטגוריות ולהציג עוד קטגוריות רבות ללא פער ביניהן. אפשר להשתמש באפשרות maxNumBuckets
כדי להגדיל את מספר הקטגוריות שמוגדר כברירת מחדל. האפשרויות histogram.minValue
ו-histogram.maxValue
ירחיבו את טווח הקטגוריות, אבל חשוב לזכור שאם יש נתונים מחוץ לטווח הזה, האפשרויות האלה לא יכווץו את הטווח.
הדוגמה הזו גם מראה שאפשר לציין את הסימונים שיוצגו לכל אחת מהקטגוריות באמצעות האפשרות המפורשת ticks
של hAxis
. הפעולה הזו לא משפיעה על הקטגוריות עצמן, אלא רק על האופן שבו הסימונים מוצגים.
חשוב גם לציין את chartArea.width
כך שמספר הקטגוריות יתאים בצורה מדויקת יותר ללא
ארטיפקטים ויזואליים. אלו האפשרויות לדוגמה.
var options = { title: 'Approximating Normal Distribution', legend: { position: 'none' }, colors: ['#4285F4'], chartArea: { width: 405 }, hAxis: { ticks: [-1, -0.75, -0.5, -0.25, 0, 0.25, 0.5, 0.75, 1] }, bar: { gap: 0 }, histogram: { bucketSize: 0.01, maxNumBuckets: 400, minValue: -1, maxValue: 1 } };
כמה סדרות
הנה היסטוגרמה של המטענים של חלקיקים תת-אטומיים, לפי המודל הסטנדרטי:
לתרשים שלמעלה יש סדרה אחת שמכילה את כל החלקיקים. אפשר לחלק חלקיקים תת-אטומיים לארבע קבוצות: קווארקים, לפטונים ובונים. נתייחס לכל אחת מהן כסדרה משלה:
בתרשים הזה אנחנו משתמשים בסדרה שונה (ולפיכך בצבע) לכל אחד מארבעת הסוגים של החלקיק התת-אטומי. אנחנו מגדירים במפורש את interpolateNulls
כ-false
כדי לוודא שערכי ה-null (נדרש כי הסדרות הן באורך לא שווה) לא מופיעים בתרשים. אנחנו מגדירים גם את legend.maxLines
כדי להוסיף עוד שורה למקרא:
var data = google.visualization.arrayToDataTable([ ['Quarks', 'Leptons', 'Gauge Bosons', 'Scalar Bosons'], [2/3, -1, 0, 0], [2/3, -1, 0, null], [2/3, -1, 0, null], [-1/3, 0, 1, null], [-1/3, 0, -1, null], [-1/3, 0, null, null], [-1/3, 0, null, null] ]); var options = { title: 'Charges of subatomic particles', legend: { position: 'top', maxLines: 2 }, colors: ['#5C3292', '#1A8763', '#871B47', '#999999'], interpolateNulls: false, };
בטעינה
שם החבילה google.charts.load
הוא "corechart"
.
google.charts.load("current", {packages: ["corechart"]});
שם הכיתה של התצוגה החזותית הוא google.visualization.Histogram
:
var visualization = new google.visualization.Histogram(container);
פורמט נתונים
יש שתי דרכים לאכלוס טבלת נתונים היסטוגרמה. כשיש רק סדרה אחת:
var data = google.visualization.arrayToDataTable([ ['Name', 'Number'], ['Name 1', number1], ['Name 2', number2], ['Name 3', number3], ... ]);
...וכשיש כמה סדרות:
var data = google.visualization.arrayToDataTable([ ['Series Name 1', 'Series Name 2', 'Series Name 3', ...], [series1_number1, series2_number1, series3_number1, ...], [series1_number2, series2_number2, series3_number2, ...], [series1_number3, series2_number3, series3_number3, ...], ... ]);
בשלב הזה, אין תמיכה בתפקידים אופציונליים של עמודות להיסטוגרמות.
אפשרויות הגדרה
שם | |
---|---|
animation.duration |
משך האנימציה, באלפיות השנייה. למידע נוסף, אפשר לעיין במשאבי העזרה בנושא אנימציה. סוג: מספר
ברירת מחדל: 0
|
animation.easing |
פונקציית ההתאמה לצפייה שמוחלת על האנימציה. אלו האפשרויות הזמינות:
סוג: מחרוזת
ברירת מחדל: 'לינארי'
|
animation.startup |
המדיניות קובעת אם התרשים יכלול אנימציה בשרטוט הראשוני. אם הערך שלו הוא סוג: בוליאני
ברירת מחדל – False
|
axisTitlesPosition |
המיקום של כותרות הצירים בהשוואה לאזור התרשים. ערכים נתמכים:
סוג: מחרוזת
ברירת מחדל: 'out'
|
backgroundColor |
צבע הרקע של האזור הראשי בתרשים. יכולה להיות מחרוזת צבע פשוטה של HTML, לדוגמה: סוג: מחרוזת או אובייקט
ברירת מחדל: 'לבן'
|
backgroundColor.stroke |
הצבע של גבול התרשים, כמחרוזת של צבע HTML. סוג: מחרוזת
ברירת מחדל: '#666'
|
backgroundColor.strokeWidth |
רוחב הגבול, בפיקסלים. סוג: מספר
ברירת מחדל: 0
|
backgroundColor.fill |
צבע המילוי של התרשים, כמחרוזת של צבע HTML. סוג: מחרוזת
ברירת מחדל: 'לבן'
|
bar.groupWidth |
הרוחב של קבוצת עמודות, שמצוין באחד מהפורמטים הבאים:
סוג: מספר או מחרוזת
ברירת מחדל:
יחס הזהב,
בערך '61.8%'.
|
chartArea |
אובייקט עם חברים להגדרת המיקום והגודל של האזור בתרשים (שבו התרשים עצמו משורטט, לא כולל צירים ומקראים). יש שני פורמטים נתמכים: מספר או מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים, ומספר ואחריו % הוא אחוז. דוגמה: Type: object (סוג אובייקט)
ברירת מחדל: null
|
chartArea.backgroundColor |
צבע רקע של אזור התרשים. כשמשתמשים במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, '#fdc') או שם של צבע באנגלית. כשמשתמשים באובייקט, אפשר לספק את המאפיינים
הבאים:
סוג: מחרוזת או אובייקט
ברירת מחדל: 'לבן'
|
chartArea.left |
המרחק מהגבול השמאלי לשרטוט התרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
chartArea.top |
המרחק מהגבול העליון לשרטוט התרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
chartArea.width |
רוחב שטח התרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
chartArea.height |
גובה השטח של התרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
צבעים |
הצבעים של הרכיבים בתרשים. מערך מחרוזות, כאשר כל רכיב הוא מחרוזת של צבע HTML, לדוגמה: סוג: מערך של מחרוזות
ברירת מחדל: צבעי ברירת מחדל
|
dataOpacity |
השקיפות של נקודות נתונים, כאשר 1.0 הוא אטום לחלוטין ו-0.0 שקוף לחלוטין. בתרשימי פיזור, בהיסטוגרמה, בעמודות ובתרשימי עמודות זהו הנתונים הגלויים: נקודות בתרשים הפיזור ומלבנים בשאר. בתרשימים שבהם בחירת נתונים יוצרת נקודה, כמו תרשימי קו ושטח, העיגולים מופיעים כשמציבים את סמן העכבר מעל העיגול או אחרי הבחירה. בתרשים המשולב מוצגות שתי ההתנהגויות, ולאפשרות הזו אין השפעה על תרשימים אחרים. (כדי לשנות את האטימות של קו מגמה, אפשר לעיין ב שקיפות קו המגמה ). סוג: מספר
ברירת מחדל: 1.0
|
enableInteractivity |
האם התרשים כולל אירועים מבוססי-משתמשים או מגיב לאינטראקציה של משתמשים? אם הערך הוא False, התרשים לא יציג אירועים מסוג 'בחירה' או אירועים אחרים המבוססים על אינטראקציה (אלא יגרום להצגה של אירועי שגיאה או אירועים מוכנים) ולא יציג טקסט מרחף או שינוי אחר בהתאם לקלט של המשתמשים. סוג: בוליאני
ברירת מחדל: True
|
focusTarget |
סוג הישות שהמיקוד בה הוא על העברת העכבר. כמו כן, המדיניות הזו משפיעה על הישות שנבחרה על ידי לחיצה על העכבר ואיזה רכיב בטבלת הנתונים ישויך לאירועים. יכול להיות אחת מהאפשרויות הבאות:
בקטע FocusTarget 'category', ההסבר הקצר מציג את כל ערכי הקטגוריות. האפשרות הזו יכולה להיות שימושית להשוואת ערכים של סדרות שונות. סוג: מחרוזת
ברירת מחדל: 'datum'
|
fontSize |
גודל ברירת המחדל של הגופן, בפיקסלים, של כל הטקסט בתרשים. אפשר לשנות את זה באמצעות מאפיינים לרכיבים ספציפיים בתרשים. סוג: מספר
ברירת מחדל: אוטומטי
|
fontName |
גופן ברירת המחדל של כל הטקסט בתרשים. אפשר לשנות את זה באמצעות מאפיינים לרכיבים ספציפיים בתרשים. סוג: מחרוזת
ברירת מחדל: 'CPRA'
|
forceIFrame |
משרטטים את התרשים בתוך מסגרת בתוך מסגרת. (שימו לב שב-IE8 המערכת מתעלמת מהאפשרות הזו. כל התרשימים של IE8 משורטטים במסגרות i-frames). סוג: בוליאני
ברירת מחדל: false
|
hAxis |
אובייקט עם חברים להגדיר רכיבים שונים של ציר אופקי. כדי לציין מאפיינים של האובייקט הזה, אפשר להשתמש בסימון מילולי של אובייקטים, כפי שמוצג כאן: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Type: object (סוג אובייקט)
ברירת מחדל: null
|
hAxis.gridlines |
אובייקט עם מאפיינים להגדרת קווי הרשת בציר האופקי. שימו לב שקווי הרשת של הציר האופקי משורטטים לאורך. כדי לציין מאפיינים של האובייקט, אפשר להשתמש בסימון מילולי של האובייקטים, כפי שמוצג כאן: {color: '#333', minSpacing: 20} Type: object (סוג אובייקט)
ברירת מחדל: null
|
hAxis.gridlines.color |
הצבע של קווי הרשת האופקיים בתוך שטח התרשים. מציינים מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: '#CCC'
|
hAxis.gridlines.count |
המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים.
אם מציינים מספר חיובי ל- סוג: מספר
ברירת המחדל: 1-
|
hAxis.gridlines.interval |
מערך של גדלים (כערכי נתונים, לא פיקסלים) בין קווי רשת סמוכים. בשלב הזה האפשרות הזו רלוונטית רק לצירים מספריים, אבל היא מקבילה לאפשרויות של
סוג: מספר בין 1 ל-10, לא כולל 10.
ברירת מחדל: מחושב
|
hAxis.gridlines.minSpacing |
השטח המינימלי של המסך, בפיקסלים, בין קווי רשת ראשיים של ציר ראשי.
ברירת המחדל לקווי הרשת הראשיים היא סוג: מספר
ברירת מחדל: מחושב
|
hAxis.gridlines.multiple |
כל הערכים של קווי הרשת והסימונים חייבים להיות כפולה של הערך של האפשרות הזו. חשוב לשים לב, שבניגוד למרווחי זמן, חזקות של 10
כפולות לא נלקחות בחשבון.
כך אפשר לאלץ סימונים שהם מספרים שלמים על ידי ציון
סוג: מספר
ברירת מחדל: 1
|
hAxis.gridlines.units |
ההגדרה הזו מחליפה את פורמט ברירת המחדל של היבטים שונים של סוגי הנתונים 'תאריך/שעה'/'שעה', כשמשתמשים בהם עם קווי רשת שמחושבים בתרשים. מאפשר עיצוב של שנים, חודשים, ימים, שעות, דקות, שניות ואלפיות שנייה. הפורמט הכללי הוא: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } מידע נוסף זמין בקטע תאריכים ושעות. Type: object (סוג אובייקט)
ברירת מחדל: null
|
hAxis.minorGridlines |
אובייקט עם חברים להגדרת קווי הרשת המשניים בציר האופקי, בדומה לאפשרות hAxis.gridlines. Type: object (סוג אובייקט)
ברירת מחדל: null
|
hAxis.minorGridlines.color |
הצבע של קווי הרשת המשניים האופקיים בתוך שטח התרשים. מציינים מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: שילוב של צבעי קו הרשת ורקע
|
hAxis.minorGridlines.count |
האפשרות סוג: מספר
ברירת מחדל:1
|
hAxis.minorGridlines.interval |
האפשרות MinGridlines.interval דומה לאפשרות המרווח של קווי רשת ראשיים, אבל המרווח שנבחר יהיה תמיד
מחלק שווה של הרווח של קו הרשת הראשי.
מרווח הזמן שמוגדר כברירת מחדל לסולמות לינאריים הוא סוג: מספר
ברירת מחדל:1
|
hAxis.minorGridlines.minSpacing |
השטח המינימלי הנדרש, בפיקסלים, בין קווי רשת משניים סמוכים ובין קווי רשת משניים וראשיים. ערך ברירת המחדל הוא 1/2 מהרווח המינימלי של קווי הרשת הראשיים בסולמות לינאריים, ו-1/5 מהרווח המינימלי בסולמות יומן. סוג: מספר
ברירת מחדל: מחושב
|
hAxis.minorGridlines.multiple |
זהה לזה של סוג: מספר
ברירת מחדל: 1
|
hAxis.minorGridlines.units |
ההגדרה הזאת משנה את פורמט ברירת המחדל של היבטים שונים של סוגי הנתונים של תאריך/תאריך ושעה, כשמשתמשים בהם עם קווי רשת מינוריים שמחושבים בתרשים. מאפשר עיצוב של שנים, חודשים, ימים, שעות, דקות, שניות ואלפיות שנייה. הפורמט הכללי הוא: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } מידע נוסף זמין בקטע תאריכים ושעות. Type: object (סוג אובייקט)
ברירת מחדל: null
|
hAxis.textPosition |
מיקום הטקסט של הציר האופקי, ביחס לשטח התרשים. ערכים נתמכים: 'out', 'in', 'none'. סוג: מחרוזת
ברירת מחדל: 'out'
|
hAxis.textStyle |
אובייקט שמציין את סגנון הטקסט של הציר האופקי. זהו הפורמט של האובייקט: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
הערך Type: object (סוג אובייקט)
ברירת המחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.title |
מאפיין סוג: מחרוזת
ברירת מחדל: null
|
hAxis.titleTextStyle |
אובייקט שמציין את סגנון הטקסט של כותרת הציר האופקי. זהו הפורמט של האובייקט: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
הערך Type: object (סוג אובייקט)
ברירת המחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.allowContainerBoundaryTextCutoff |
אם הערך הוא False, התוויות החיצוניות ביותר יוסתרו ולא באמצעות מאגר התרשים. אם הערך הוא True, יתאפשר חיתוך של תוויות. סוג: בוליאני
ברירת מחדל: false
|
hAxis.slantedText |
אם הערך הוא True, משרטטים את הטקסט של הציר האופקי בזווית כדי להתאים יותר טקסט לאורך הציר. אם הערך הוא False, משרטטים את הטקסט של הציר האופקי ישר. התנהגות ברירת המחדל היא להטות טקסט אם אי אפשר
להתאים את כל הטקסט למצב זקוף. חשוב לשים לב שהאפשרות הזו זמינה רק כאשר
סוג: בוליאני
ברירת מחדל: אוטומטי
|
hAxis.slantedTextAngle |
זווית הטקסט של הציר האופקי, אם הוא משופע. המערכת תתעלם אם
הערך של סוג: מספר, -90-90
ברירת מחדל: 30
|
hAxis.maxAlternation |
מספר הרמות המקסימלי של טקסט בציר האופקי. אם תוויות הטקסט של הצירים נהיות עמוסות מדי, השרת עשוי להזיז למעלה או למטה את התוויות השכנות כדי למקם את התוויות בצורה קרובה יותר זו לזו. הערך הזה מציין את מספר הרמות המקסימלי שבו צריך להשתמש. השרת יכול להשתמש בפחות רמות, אם תוויות יכולות להתאים ללא חפיפה. לתאריכים ושעות, ברירת המחדל היא 1. סוג: מספר
ברירת מחדל: 2
|
hAxis.maxTextLines |
מספר השורות המקסימלי המותר לתוויות הטקסט. התוויות יכולות להתפרש על פני כמה שורות אם הן ארוכות מדי, וכברירת מחדל, מספר השורות מוגבל על ידי גובה השטח הזמין. סוג: מספר
ברירת מחדל: אוטומטי
|
hAxis.minTextSpacing |
מותר ריווח אופקי מינימלי בפיקסלים בין שתי תוויות טקסט סמוכות. אם התוויות צפופות מדי או שהן ארוכות מדי, הריווח יכול לרדת מתחת לסף הזה, ובמקרה הזה יוחל אחד מהאמצעים לשמירה על ארגון תוויות (למשל, חיתוך התוויות או הסרת חלק מהן). סוג: מספר
ברירת מחדל: הערך של
hAxis.textStyle.fontSize |
hAxis.showTextEvery |
כמה תוויות של צירים אופקיים להציג, כאשר 1 פירושו להציג כל תווית, 2 פירושו הצגה של כל תווית אחרת וכן הלאה. ברירת המחדל היא לנסות להציג כמה שיותר תוויות בלי חפיפה. סוג: מספר
ברירת מחדל: אוטומטי
|
hAxis.viewWindowMode |
מציינת איך לשנות את קנה המידה של הציר האופקי כדי לעבד את הערכים שנמצאים בשטח התרשים. ערכי המחרוזת הבאים נתמכים:
סוג: מחרוזת
ברירת מחדל:
זהה ל-'pretty', אבל
haxis.viewWindow.min ו-haxis.viewWindow.max מקבלים עדיפות אם משתמשים בה.
|
hAxis.viewWindow |
מציינת את טווח החיתוך של הציר האופקי. Type: object (סוג אובייקט)
ברירת מחדל: null
|
hAxis.viewWindow.max |
אינדקס השורות המבוסס על אפס, שבו מסתיים חלון החיתוך. נקודות על הגרף באינדקס הזה
ומעלה ייחתכו. בשילוב עם המערכת מתעלמת ממנו כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
hAxis.viewWindow.min |
אינדקס השורות המבוסס על אפס, שבו מתחיל חלון החיתוך. נקודות על הגרף במדדים נמוכים
מהערך הזה ייחתכו. בשילוב עם המערכת מתעלמת ממנו כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
histogram.bucketSize |
כותבים בתוך הקוד את הגודל של כל עמודת היסטוגרמה, ולא מאפשרים לקבוע את הגודל באמצעות אלגוריתם. סוג: מספר
ברירת מחדל: אוטומטי
|
histogram.hideBucketItems |
משמיטים את המחיקות הדחוסות שבין הבלוקים של ההיסטוגרמה, כדי ליצור סדרה של עמודות מוצקות. סוג: בוליאני
ברירת מחדל: false
|
histogram.lastBucketPercentile |
כשמחשבים את גודל הקטגוריה של ההיסטוגרמה, צריך להתעלם מהאחוזים העליונים והתחתונים של סוג: מספר
ברירת מחדל: 0
|
histogram.minValue |
צריך להרחיב את טווח הקטגוריות כדי לכלול את הערך הזה. סוג: מספר
ברירת מחדל: אוטומטי – שימוש במינימום נתונים
|
histogram.maxValue |
צריך להרחיב את טווח הקטגוריות כדי לכלול את הערך הזה. סוג: מספר
ברירת מחדל: אוטומטי – שימוש בחבילת הגלישה לכל היותר
|
histogram.numBucketsRule |
איך מחשבים את מספר ברירת המחדל של הקטגוריות. הערכים האפשריים הם:
סוג: מחרוזת
ברירת המחדל:
'sqrt' |
גובה |
גובה התרשים, בפיקסלים. סוג: מספר
ברירת מחדל: גובה הרכיב שמכיל
|
interpolateNulls |
האם לנחש את הערך של נקודות חסרות. אם הערך הוא True, הוא יבצע ניחוש של הערך של נתונים חסרים על סמך נקודות קרובות. אם הערך הוא False, הוא ייצור רווח בשורה בנקודה לא ידועה.
האפשרות הזו לא נתמכת בתרשימי אזור עם האפשרות סוג: בוליאני
ברירת מחדל: false
|
isStacked |
אם המדיניות מוגדרת כ-True, הרכיבים עויפים את הרכיבים לכל הסדרות בכל ערך דומיין. הערה: בתרשימים Column, Area ו-SteppedArea, Google Charts הופך את הסדר של פריטי המקרא להתאמה טובה יותר לערימה של רכיבי הסדרה (למשל, סדרה 0 תהיה הפריט האחרון במקרא). הפריט הזה לא רלוונטי לתרשימי עמודות.
האפשרות האפשרויות עבור
בערימה של 100%, הערך המחושב לכל רכיב יופיע בהסבר הקצר אחרי הערך בפועל.
כברירת מחדל, ערכי ציר היעד מחושבים על סמך סולם יחסי של 0-1 כשברים של 1 ל-
סידור בערימה ב-100% תומך רק בערכי נתונים מסוג סוג: בוליאני/מחרוזת
ברירת מחדל: false
|
מקרא |
אובייקט עם חברים להגדיר אספקטים שונים של המקרא. כדי לציין מאפיינים של האובייקט הזה, אפשר להשתמש בסימון מילולי של אובייקטים, כפי שמוצג כאן: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type: object (סוג אובייקט)
ברירת מחדל: null
|
legend.alignment |
יישור המקרא. יכול להיות אחת מהאפשרויות הבאות:
התחלה, מרכז וסיום יחסיים לסגנון – האנכי או האופקי – של המקרא. לדוגמה, במקרא 'ימין', 'התחלה' ו 'סוף' מופיעים בחלק העליון ובחלק התחתון, בהתאמה. במקרא 'ראש הדף', הערכים 'התחלה' ו-'end' מופיעים משמאל ו-ימין של האזור, בהתאמה. ערך ברירת המחדל תלוי במיקום של המקרא. במקראים 'תחתונים', ברירת המחדל היא 'מרכז'. מקראים אחרים הם 'התחלה' כברירת מחדל. סוג: מחרוזת
ברירת מחדל: אוטומטי
|
legend.maxLines |
מספר השורות המקסימלי במקרא. כדי להוסיף שורות למקרא, צריך להגדיר אותו למספר גדול מ-1. הערה: הלוגיקה המדויקת שמשמשת לקביעת מספר השורות בפועל שעבר רינדור עדיין קיימת. האפשרות הזו פועלת כרגע רק כשה- {1/}G.position הוא 'top'. סוג: מספר
ברירת מחדל: 1
|
legend.pageIndex |
אינדקס הדפים הראשון שנבחר מבוסס אפס של המקרא. סוג: מספר
ברירת מחדל: 0
|
legend.position |
המיקום של המקרא. יכול להיות אחת מהאפשרויות הבאות:
סוג: מחרוזת
ברירת מחדל: 'right'
|
legend.textStyle |
אובייקט שמציין את סגנון הטקסט של המקרא. זהו הפורמט של האובייקט: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
הערך Type: object (סוג אובייקט)
ברירת המחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
כיוון |
כיוון התרשים. אם המדיניות מוגדרת לערך סוג: מחרוזת
ברירת המחדל: 'אופקי'
|
reverseCategories |
אם הוא מוגדר כ-True, הסדרה תצייר מימין לשמאל. ברירת המחדל היא לצייר משמאל לימין. סוג: בוליאני
ברירת מחדל: false
|
סדרה |
מערך של אובייקטים, שכל אחד מהם מתאר את הפורמט של הסדרה המתאימה בתרשים. כדי להשתמש בערכי ברירת מחדל לסדרה, צריך לציין אובייקט ריק {}. אם לא מציינים סדרה או ערך, המערכת תשתמש בערך הגלובלי. כל אובייקט תומך במאפיינים הבאים:
ניתן לציין מערך של אובייקטים שכל אחד מהם חל על הסדרה לפי הסדר הנתון, או לציין אובייקט שבו לכל צאצא יש מפתח מספרי שמציין לאיזו סדרה הוא חל. לדוגמה, שתי ההצהרות הבאות זהות, ומצהירים שהסדרה הראשונה שחורה ונעדרת מהמקרא, והרביעית היא אדומה וחסרה במקרא: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } סוג: מערך של אובייקטים או אובייקטים עם אובייקטים בתצוגת עץ
ברירת מחדל: {}
|
עיצוב |
עיצוב הוא קבוצה של ערכי אפשרויות מוגדרים מראש, שפועלים יחד כדי ליצור התנהגות ספציפית או אפקט חזותי ספציפי בתרשים. כרגע רק עיצוב אחד זמין:
סוג: מחרוזת
ברירת מחדל: null
|
title |
טקסט להצגה מעל התרשים. סוג: מחרוזת
ברירת מחדל: ללא שם
|
titlePosition |
המיקום של כותרת התרשים, בהשוואה לאזור התרשים. ערכים נתמכים:
סוג: מחרוזת
ברירת מחדל: 'out'
|
titleTextStyle |
אובייקט שמציין את סגנון טקסט הכותרת. זהו הפורמט של האובייקט: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
הערך Type: object (סוג אובייקט)
ברירת המחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
הסבר קצר |
אובייקט עם חברים להגדיר רכיבים שונים של הסבר קצר. כדי לציין את המאפיינים של האובייקט אפשר להשתמש בסימון מילולי של האובייקטים, כפי שמוצג כאן: {textStyle: {color: '#FF0000'}, showColorCode: true} Type: object (סוג אובייקט)
ברירת מחדל: null
|
tooltip.isHtml |
אם המדיניות מוגדרת כ-True, צריך להשתמש בהסבר קצר על עיבוד HTML (ולא ב-SVG). למידע נוסף, אפשר לקרוא את המאמר התאמה אישית של תוכן הסבר קצר. הערה: התאמה אישית של התוכן בהסבר הקצר ב-HTML דרך תפקיד הנתונים בעמודה של הסבר קצר לא נתמכת בהמחשה החזותית של תרשים הבועות. סוג: בוליאני
ברירת מחדל: false
|
tooltip.showColorCode |
אם הערך הוא True, יוצגו ריבועים צבעוניים לצד פרטי הסדרה בהסבר הקצר. ברירת המחדל היא
True אם הערך של סוג: בוליאני
ברירת מחדל: אוטומטי
|
tooltip.textStyle |
אובייקט שמציין את סגנון הטקסט של ההסבר הקצר. זהו הפורמט של האובייקט: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
הערך Type: object (סוג אובייקט)
ברירת המחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.trigger |
האינטראקציה של המשתמש שגורמת להצגת ההסבר הקצר:
סוג: מחרוזת
ברירת מחדל: 'focus'
|
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
|
vAxis |
אובייקט עם חברים להגדיר רכיבים שונים של ציר אנכי. כדי לציין מאפיינים של האובייקט הזה, אפשר להשתמש בסימון מילולי של אובייקטים, כפי שמוצג כאן: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Type: object (סוג אובייקט)
ברירת מחדל: null
|
vAxis.baseline |
מאפיין סוג: מספר
ברירת מחדל: אוטומטי
|
vAxis.baselineColor |
קובעים את הצבע של קו הבסיס של הציר האנכי. הוא יכול להיות כל מחרוזת של צבע HTML, לדוגמה: סוג: מספר
ברירת מחדל: 'שחור'
|
vAxis.direction |
הכיוון שבו הערכים לאורך הציר האנכי. כברירת מחדל, ערכים נמוכים
מופיעים בתחתית התרשים. מציינים סוג: 1 או 1-
ברירת מחדל: 1
|
vAxis.format |
מחרוזת עיצוב לתוויות של צירים מספריים. זו קבוצת משנה של
קבוצת דפוסי ה-ICU
.
לדוגמה,
הפורמט בפועל שהוחל על התווית נגזר מהמיקום שבו ה-API נטען. למידע נוסף, ראו טעינת תרשימים עם לוקאל ספציפי .
בחישוב של ערכי שנתות וקווי רשת, המערכת תתייחס לכמה שילובים חלופיים של כל האפשרויות הרלוונטיות של קווי הרשת, והחלופות יידחו אם התוויות המעוצבות יהיו כפולות או חופפות.
לכן אפשר לציין את הערך סוג: מחרוזת
ברירת מחדל: אוטומטי
|
vAxis.gridlines |
אובייקט עם חברים להגדרת קווי הרשת בציר האנכי. שימו לב שקווי הרשת של הציר האנכי משורטטים לרוחב. כדי לציין מאפיינים של האובייקט הזה, אפשר להשתמש בסימון מילולי של אובייקטים, כפי שמוצג כאן: {color: '#333', minSpacing: 20} Type: object (סוג אובייקט)
ברירת מחדל: null
|
vAxis.gridlines.color |
הצבע של קווי הרשת האנכיים בתוך אזור התרשים. צריך לציין מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: '#CCC'
|
vAxis.gridlines.count |
המספר המשוער של קווי רשת אופקיים בתוך אזור התרשים.
אם מציינים מספר חיובי ל- סוג: מספר
ברירת המחדל: 1-
|
vAxis.gridlines.interval |
מערך של גדלים (כערכי נתונים, לא פיקסלים) בין קווי רשת סמוכים. בשלב הזה האפשרות הזו רלוונטית רק לצירים מספריים, אבל היא מקבילה לאפשרויות של
סוג: מספר בין 1 ל-10, לא כולל 10.
ברירת מחדל: מחושב
|
vAxis.gridlines.minSpacing |
השטח המינימלי של המסך, בפיקסלים, בין קווי רשת ראשיים של ציר ראשי.
ברירת המחדל לקווי הרשת הראשיים היא סוג: מספר
ברירת מחדל: מחושב
|
vAxis.gridlines.multiple |
כל הערכים של קווי הרשת והסימונים חייבים להיות כפולה של הערך של האפשרות הזו. חשוב לשים לב, שבניגוד למרווחי זמן, חזקות של 10
כפולות לא נלקחות בחשבון.
כך אפשר לאלץ סימונים שהם מספרים שלמים על ידי ציון
סוג: מספר
ברירת מחדל: 1
|
vAxis.gridlines.units |
ההגדרה הזו מחליפה את פורמט ברירת המחדל של היבטים שונים של סוגי הנתונים 'תאריך/שעה'/'שעה', כשמשתמשים בהם עם קווי רשת שמחושבים בתרשים. מאפשר עיצוב של שנים, חודשים, ימים, שעות, דקות, שניות ואלפיות שנייה. הפורמט הכללי הוא: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]}, hours: {format: [/*format strings here*/]}, minutes: {format: [/*format strings here*/]}, seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]} } } מידע נוסף זמין בקטע תאריכים ושעות. Type: object (סוג אובייקט)
ברירת מחדל: null
|
vAxis.minorGridlines |
אובייקט עם חברים להגדרת קווי הרשת המשניים בציר האנכי, בדומה לאפשרות vAxis.gridlines. Type: object (סוג אובייקט)
ברירת מחדל: null
|
vAxis.minorGridlines.color |
הצבע של קווי הרשת המשניים האנכיים בתוך אזור התרשים. מציינים מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: שילוב של צבעי קו הרשת ורקע
|
vAxis.minorGridlines.count |
האפשרות MinGridlines.count הוצאה משימוש ברובה, חוץ מהבדל אחד: משביתים את קווי הרשת המשניים על ידי הגדרת הספירה ל-0. מספר קווי הרשת המשניים תלוי במרווח בין קווי הרשת הראשיים (ראו vAxis.gridlines.interval) ובשטח המינימלי הנדרש (ראו vAxis.minorGridlines.minSpacing). סוג: מספר
ברירת מחדל: 1
|
vAxis.minorGridlines.interval |
האפשרות MinGridlines.interval דומה לאפשרות המרווח של קווי רשת ראשיים, אבל המרווח שנבחר יהיה תמיד
מחלק שווה של הרווח של קו הרשת הראשי.
מרווח הזמן שמוגדר כברירת מחדל לסולמות לינאריים הוא סוג: מספר
ברירת מחדל:1
|
vAxis.minorGridlines.minSpacing |
השטח המינימלי הנדרש, בפיקסלים, בין קווי רשת משניים סמוכים ובין קווי רשת משניים וראשיים. ערך ברירת המחדל הוא 1/2 מהרווח המינימלי של קווי הרשת הראשיים בסולמות לינאריים, ו-1/5 מהרווח המינימלי בסולמות יומן. סוג: מספר
ברירת מחדל: מחושב
|
vAxis.minorGridlines.multiple |
זהה לזה של סוג: מספר
ברירת מחדל: 1
|
vAxis.minorGridlines.units |
ההגדרה הזאת משנה את פורמט ברירת המחדל של היבטים שונים של סוגי הנתונים של תאריך/תאריך ושעה, כשמשתמשים בהם עם קווי רשת מינוריים שמחושבים בתרשים. מאפשר עיצוב של שנים, חודשים, ימים, שעות, דקות, שניות ואלפיות שנייה. הפורמט הכללי הוא: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } מידע נוסף זמין בקטע תאריכים ושעות. Type: object (סוג אובייקט)
ברירת מחדל: null
|
vAxis.logScale |
אם True, הציר האנכי הוא קנה מידה לוגריתמי. הערה: כל הערכים חייבים להיות חיוביים. סוג: בוליאני
ברירת מחדל: false
|
vAxis.scaleType |
המאפיין
סוג: מחרוזת
ברירת מחדל: null
|
vAxis.textPosition |
מיקום הטקסט של הציר האנכי, ביחס לשטח התרשים. ערכים נתמכים: 'out', 'in', 'none'. סוג: מחרוזת
ברירת מחדל: 'out'
|
vAxis.textStyle |
אובייקט שמציין את סגנון הטקסט של הציר האנכי. זהו הפורמט של האובייקט: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
הערך Type: object (סוג אובייקט)
ברירת המחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.ticks |
מחליפה את סימונים של ציר ה-Y שנוצרו באופן אוטומטי במערך שצוין. כל רכיב במערך צריך להיות ערך סימון תקין (כמו מספר, תאריך, תאריך ושעה או שעה ביום), או אובייקט. אם מדובר באובייקט, צריך להיות לו המאפיין
התצוגה המקדימה תורחב אוטומטית כך שתכלול את סימני המינימום והמקסימום, אלא אם מציינים
דוגמאות:
סוג: מערך של רכיבים
ברירת מחדל: אוטומטי
|
vAxis.title |
מאפיין סוג: מחרוזת
ברירת מחדל: ללא שם
|
vAxis.titleTextStyle |
אובייקט שמציין את סגנון הטקסט של כותרת הציר האנכי. זהו הפורמט של האובייקט: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
הערך Type: object (סוג אובייקט)
ברירת המחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.maxValue |
מעביר את הערך המקסימלי של הציר האנכי לערך שצוין. ברוב התרשימים הערך יהיה כלפי מעלה. המערכת תתעלם מערך זה אם מוגדר לערך הקטן מערך ה-y המקסימלי של הנתונים.
המאפיין סוג: מספר
ברירת מחדל: אוטומטי
|
vAxis.minValue |
מעביר את הערך המינימלי של הציר האנכי לערך שצוין. הוא יהיה ירידה ברוב התרשימים. המערכת תתעלם ממנו אם הערך הזה מוגדר לערך שגדול מערך ה-y המינימלי של הנתונים.
המאפיין סוג: מספר
ברירת מחדל: null
|
vAxis.viewWindowMode |
מציינת איך לשנות את קנה המידה של הציר האנכי כדי להציג את הערכים שנמצאים בשטח התרשים. ערכי המחרוזת הבאים נתמכים:
סוג: מחרוזת
ברירת מחדל:
זהה ל-'pretty', אבל
vaxis.viewWindow.min ו-vaxis.viewWindow.max מקבלים עדיפות אם משתמשים בה.
|
vAxis.viewWindow |
מציין את טווח החיתוך של הציר האנכי. Type: object (סוג אובייקט)
ברירת מחדל: null
|
vAxis.viewWindow.max |
הערך המקסימלי של נתונים אנכיים שיש לעבד. המערכת מתעלמת ממנו כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
vAxis.viewWindow.min |
הערך המינימלי של נתונים אנכיים לעיבוד. המערכת מתעלמת ממנו כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
רוחב |
רוחב התרשים, בפיקסלים. סוג: מספר
ברירת מחדל: רוחב הרכיב שמכיל
|
שיטות
שיטה | |
---|---|
draw(data, options) |
מצייר את התרשים. בתרשים יתקבלו קריאות נוספות ל-method, רק אחרי שהאירוע סוג החזרה: ללא
|
getAction(actionID) |
הפונקציה מחזירה את אובייקט הפעולה של ההסבר הקצר עם Return Type (סוג החזרה): אובייקט
|
getBoundingBox(id) |
מחזירה אובייקט שמכיל את הרכיבים השמאליים, החלק העליון, הרוחב והגובה של רכיב התרשים
הערכים הם יחסיים למאגר התגים של התרשים. קוראים לפונקציה אחרי הצגת התרשים. Return Type (סוג החזרה): אובייקט
|
getChartAreaBoundingBox() |
מחזירה אובייקט שמכיל את השדות השמאליים, החלק העליון, הרוחב והגובה של תוכן התרשים (כלומר, לא כולל תוויות ומקרא):
הערכים הם יחסיים למאגר התגים של התרשים. קוראים לפונקציה אחרי הצגת התרשים. Return Type (סוג החזרה): אובייקט
|
getChartLayoutInterface() |
מחזירה אובייקט שמכיל מידע על המיקום של התרשים והרכיבים שלו. אפשר לקרוא ל-methods הבאות באובייקט שמוחזר:
קוראים לפונקציה אחרי הצגת התרשים. Return Type (סוג החזרה): אובייקט
|
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) |
הגדרת פעולת הסבר קצר שתבוצע כשהמשתמש ילחץ על הטקסט של הפעולה.
ה-method
צריך להגדיר את כל הפעולות של ההסבר הקצר לפני קריאה ל-method של סוג החזרה:
none |
setSelection() |
בחירת ישויות התרשים שצוינו. ביטול הבחירה הקודמת.
ישויות שניתן לבחור הן עמודות, רשומות מקרא וקטגוריות.
בתרשים הזה ניתן לבחור רק ישות אחת בכל פעם.
סוג החזרה: ללא
|
clearChart() |
ניקוי התרשים וכל המשאבים שהוקצו לו. סוג החזרה: ללא
|
אירועים
מידע נוסף על אופן השימוש באירועים האלה זמין במאמרים אינטראקטיביות בסיסית, טיפול באירועים והפעלת אירועים.
שם | |
---|---|
animationfinish |
מופעל כשאנימציית המעבר מסתיימת. מאפיינים:ללא
|
click |
מופעל כשהמשתמש לוחץ על התרשים. יכול לשמש כדי לזהות מתי לוחצים על הכותרת, רכיבי הנתונים, רשומות המקרא, הצירים, קווי הרשת או התוויות. נכסים: targetID
|
error |
מופעל כשמתרחשת שגיאה בניסיון לעבד את התרשים. מאפיינים: מזהה, הודעה
|
legendpagination |
מופעל כשהמשתמש לוחץ על חיצי העימוד של המקרא. מחזיר את אינדקס הדפים הנוכחי המבוסס על אפס ואת מספר הדפים הכולל. מאפיינים: currentPageIndex, total Pages
|
onmouseover |
מופעל כשהמשתמש מעביר את העכבר מעל ישות חזותית. מחזיר את האינדקסים של השורה והעמודה של הרכיב התואם בטבלת הנתונים. עמודה קשורה לתא בטבלת הנתונים, רשומת מקרא לעמודה (אינדקס השורות הוא null) וקטגוריה לשורה (אינדקס העמודה הוא null). מאפיינים: שורה, עמודה
|
onmouseout |
מופעל כשהמשתמש מזיז את העכבר מישות חזותית. מחזיר את האינדקסים של השורה והעמודה של הרכיב התואם בטבלת הנתונים. עמודה קשורה לתא בטבלת הנתונים, רשומת מקרא לעמודה (אינדקס השורות הוא null) וקטגוריה לשורה (אינדקס העמודה הוא null). מאפיינים: שורה, עמודה
|
ready |
התרשים מוכן לקריאות method חיצוניות. כדי לבצע אינטראקציה עם התרשים, ושל שיטות קריאה אחרי שרטוט, צריך להגדיר האזנה לאירוע הזה לפני
שמפעילים את ה-method מאפיינים:ללא
|
select |
מופעל כשהמשתמש לוחץ על ישות חזותית. כדי לבדוק אילו קבוצות נבחרו, אפשר להתקשר למספר
מאפיינים:ללא
|
המדיניות בנושא נתונים
כל הקוד והנתונים מעובדים ומעובדים בדפדפן. לא נשלחים נתונים לאף שרת.