סקירה כללית
היסטוגרמה היא תרשים שמקבץ נתונים מספריים מסודרים לפי bin, ומציג את האשפה בתור עמודות מפולחות. הן משמשות לתיאור ההתפלגות של מערך נתונים: באיזו תדירות הערכים נופלים לטווחים.
Google Chart בוחר בשבילכם את מספר הסלים באופן אוטומטי. כל הסלים הם ברוחב זהה ויש להם גובה יחסי ביחס למספר נקודות הסל בסל. מבחינות אחרות, היסטוגרמה דומה לתרשימי עמודות.
דוגמה
היסטוגרמה של אורכים של דינוזאורים:
על פי ההיסטוגרמה, הקופסה הנפוצה ביותר היא פחות מ-10 מטרים, ושיש רק דינוזאור אחד מעל 40 מטרים. אפשר להעביר את העכבר מעל הסרגל כדי לגלות שמדובר בסיסמוזאורוס (שיכול להיות דיפלודוקוס מאוד; פלאונטולוגים לא בטוחים).
הקוד ליצירת ההיסטוגרמה מוצג למטה. אחרי שמגדירים את הנתונים (כאן, באמצעות google.visualization.arrayToDataTable
), התרשים מוגדר באמצעות קריאה ל-google.visualization.Histogram
והוא משורטט בשיטת 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>
אפשר להשמיט את התוויות (כאן, שמות הדינוזאורים) ובמקרה כזה הסבר קצר יציג רק את הערך המספרי.
שליטה בצבעים
היסטוגרמה של אוכלוסיות לאומיות:
יש יותר ממאתיים מדינות עם פחות ממאה מיליון, ואחריה מצב קיצוני.
בהיסטוגרמה משתמשים באפשרות colors
כדי לשרטט את הנתונים בירוק:
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['green'], };
כמו בכל תרשים של Google, צבעים יכולים להופיע כשמות באנגלית או כערכים הקסדצימליים.
קטגוריות בקרה
כברירת מחדל, התרשימים בוחרים את גודל הקטגוריה באופן אוטומטי באמצעות אלגוריתם ידוע להיסטוגרמה. עם זאת, לפעמים תרצו לבטל את זה והתרשים שלמעלה הוא דוגמה. עם כל כך הרבה מדינות בקטגוריה הראשונה, קשה לציין אותן במדינות אחרות.
במצבים כאלה, היסטוגרמה מספקת שתי אפשרויות: histogram.bucketSize
, שעוקפת את האלגוריתם ומקודדת באופן קשיח את גודל הקטגוריה; ו-histogram.lastBucketPercentile
. האפשרות השנייה מחייבת הסבר נוסף: היא משנה את החישוב של גודלי הקטגוריות כדי להתעלם מהערכים הגבוהים או הנמוכים יותר מהערכים שמציינים באחוזים. הערכים עדיין כלולים בהיסטוגרמה, אבל לא משפיעים על אופן הקיבוץ שלהם. האפשרות הזו שימושית כשלא רוצים שדפים קטנים יכנסו לקטגוריה שלהם. במקום זאת הם יקובצו בקטגוריה הראשונה או האחרונה.
בתרשים שלמעלה, התעלמנו מחמשת הערכים המובילים וחמשת האחוזים התחתונים בעת חישוב גודל הקטגוריה. הערכים עדיין בתרשימים. הדבר היחיד שהשתנה הוא גודל הקטגוריה, אך היא הופכת להיסטוגרמה קריאה יותר.
הדוגמה הזו גם מראה איך אנחנו יכולים לשנות את קנה המידה של הציר האנכי כדי להשתמש בקנה מידה של "יומן מראה", שעוזר גם בפילוח נתונים עם זנב ארוך של ערכים קטנים.
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
כדי להבטיח שהערכים ריקים (יש צורך מפני שהסדרה באורך לא שווה) לא יופיעו בתרשים. הגדרנו גם את 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, ...], ... ]);
בשלב זה אין תמיכה בתפקידי עמודות אופציונליים להיסטוגרמה.
אפשרויות הגדרה
שם | |
---|---|
אנימציה.משך |
משך האנימציה, באלפיות השנייה. פרטים נוספים זמינים במסמכי האנימציה. סוג: מספר
ברירת מחדל: 0
|
אנימציה. |
פונקציית ההתאמה לצפייה על האנימציה. אלו האפשרויות הזמינות:
סוג: מחרוזת
ברירת מחדל: 'לינארי'
|
אנימציה.התחלה |
קובע אם התרשים יונפש בהגרלה הראשונית. אם הערך סוג: בוליאני
ברירת המחדל לא
|
ציר_כותרת |
איפה למקם את כותרות הציר, בהשוואה לאזור התרשים. ערכים נתמכים:
סוג: מחרוזת
ברירת מחדל: 'מחוץ'
|
צבע רקע |
צבע הרקע של האזור הראשי בתרשים. הוא יכול להיות מחרוזת צבע פשוטה ב-HTML, לדוגמה: Type: מחרוזת או אובייקט
ברירת מחדל: 'לבן'
|
הפעלה ברקע |
צבע הגבול של התרשים, כמחרוזת צבע של HTML. סוג: מחרוזת
ברירת מחדל: '#666'
|
colorColor.stringWidth |
רוחב הגבול, בפיקסלים. סוג: מספר
ברירת מחדל: 0
|
backgroundColor.fill |
צבע המילוי של התרשים, כמחרוזת צבע של HTML. סוג: מחרוזת
ברירת מחדל: 'לבן'
|
בר.groupWidth |
הרוחב של קבוצה של עמודות, המצוין בכל אחד מהפורמטים הבאים:
סוג: מספר או מחרוזת
ברירת מחדל:
יחס הזהב,
בערך '61.8%'.
|
תרשים גבולות |
אובייקט עם חברי קבוצה כדי להגדיר את המיקום והגודל של אזור התרשים (שבו התרשים
עצמו משורטט, מלבד הציר והאגדות). ניתן להשתמש בשני פורמטים: מספר, או
מספר ואחריו %. מספר פשוט הוא ערך בפיקסלים; מספר ואחריו % הוא אחוז. לדוגמה: Type: אובייקט
ברירת מחדל: null
|
ChartArea.backgroundColor |
צבע הרקע של אזור התרשים. כשמשתמשים במחרוזת, היא יכולה להיות מחרוזת הקסדצימלית (למשל, ' #fdc') או בשם של צבע אנגלי. כשאובייקט נמצא בשימוש, אפשר לספק את המאפיינים הבאים:
Type: מחרוזת או אובייקט
ברירת מחדל: 'לבן'
|
ChartArea.left |
מה המרחק מהתרשים מהגבול השמאלי? סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
התרשיםArea.top |
מה המרחק מהתרשים מהגבול העליון? סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
ChartArea.width |
רוחב האזור בתרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
ChartArea.height |
גובה שטח התרשים. סוג: מספר או מחרוזת
ברירת מחדל: אוטומטי
|
צבעים |
הצבעים שיש להשתמש בהם ברכיבי התרשים. מערך של מחרוזות, כאשר כל רכיב הוא מחרוזת צבע HTML. לדוגמה: סוג: מערך של מחרוזות
ברירת מחדל: צבעי ברירת מחדל
|
שקיפות נתונים |
השקיפות של נקודות נתונים, כש-1.0 אטומה לחלוטין ו-0.0 שקופה לחלוטין. בתרשימי פיזור, היסטוגרמה, עמודות ועמודות, כל הנתונים מתייחסים לנתונים הגלויים: נקודות בתרשים הפיזור ומלבנים במבנים האחרים. בתרשימים שבהם בחירת נתונים נוצרת נקודה, כמו תרשימי הקו והשטח, היא מופיעה באמצעות המעגלים שמופיעים כשמעבירים את העכבר מעל או בוחרים אפשרות. התרשים המשולב מציג את שתי ההתנהגויות, ולאפשרות הזו אין השפעה על תרשימים אחרים. (כדי לשנות את השקיפות של קו מגמה, יש לעיין במאמר שקיפות של קו מגמה ). סוג: מספר
ברירת מחדל: 1.0
|
enableInteractive |
האם התרשים כולל אירועים מבוססי-משתמשים או מגיב לאינטראקציה של משתמש. אם ההעדפה מקבלת את הערך False, התרשים לא יציג אירועי 'select' או אירועים אחרים מבוססי-אינטראקציות (אבל יגרום לתיעוד של אירועי הכנה או שגיאות), ולא יציג טקסט מרחף או ישתנה בדרך אחרת בהתאם לקלט של המשתמשים. סוג: בוליאני
ברירת מחדל: נכון
|
מיקוד |
סוג הישות שמקבלת התמקדות באמצעות העברת העכבר. ההגדרה משפיעה גם על הישות שנבחרה בלחיצה על העכבר ועל הרכיב של טבלת הנתונים המשויך לאירועים. יכול להיות אחת מהאפשרויות הבאות:
ב-targetTarget 'קטגוריה', ההסבר הקצר מציג את כל ערכי הקטגוריות. האפשרות הזו יכולה להיות שימושית לצורך השוואת ערכים של סדרות שונות. סוג: מחרוזת
ברירת מחדל: 'דאטום'
|
גודל גופן |
גודל הגופן המוגדר כברירת מחדל, בפיקסלים, של כל הטקסט בתרשים. אפשר לשנות זאת באמצעות המאפיינים של רכיבי תרשים ספציפיים. סוג: מספר
ברירת מחדל: אוטומטי
|
שם גופן |
תצוגת ברירת המחדל של הגופן של כל הטקסט בתרשים. אפשר לשנות זאת באמצעות המאפיינים של רכיבי תרשים ספציפיים. סוג: מחרוזת
ברירת מחדל: 'xls'
|
forceIFrame |
משרטט את התרשים בתוך מסגרת מוטבעת. (שימו לב שב-IE8 המערכת מתעלמת מהאפשרות הזו. כל התרשימים של IE8 מצוירים ב-i-frames). סוג: בוליאני
ברירת מחדל: False
|
ציר |
אובייקט עם חברים כדי להגדיר אלמנטים שונים של הציר האופקי. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Type: אובייקט
ברירת מחדל: null
|
hAxis.gridlines |
אובייקט עם מאפיינים להגדרת קווי הרשת בציר האופקי. שימו לב שהקווי הרשת של הציר האופקי משורטטים באופן אנכי. כדי לציין מאפיינים של אובייקט זה, ניתן להשתמש בסימון מילולי של אובייקט, כפי שמוצג כאן: {color: '#333', minSpacing: 20} Type: אובייקט
ברירת מחדל: null
|
hAxis.gridlines.color |
צבע קווי הרשת האופקיים בתוך שטח התרשים. יש לציין מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: ' #CCC'
|
hAxis.gridlines.count |
המספר המשוער של קווי רשת אופקיים בתוך האזור בתרשים.
אם מציינים מספר חיובי לציון סוג: מספר
ברירת מחדל: -1
|
hAxis.gridlines.interval |
מערך גדלים (כערכי נתונים, לא פיקסלים) בין קווי רשת סמוכים. כרגע האפשרות הזו זמינה רק לצירים מספריים,
היא דומה לאפשרויות של
סוג: מספר בין 1 ל-10, לא כולל 10.
ברירת מחדל: מחושב
|
hAxis.gridlines.minSpacing |
הגודל המינימלי של המסך, בפיקסלים, בין קווי הרשת הראשיים של hAxis.
ברירת המחדל לקווי רשת ראשיים היא סוג: מספר
ברירת מחדל: מחושב
|
hAxis.gridlines.multiple |
כל הערכים של קווי הרשת והסימונים חייבים להיות מכפלה בערך של האפשרות הזו. חשוב לשים לב שבניגוד למרווחי זמן, העוצמה של פי 10
לא כפולה.
כך אפשר לאלץ טיקים במספרים שלמים על ידי ציון
סוג: מספר
ברירת מחדל: 1
|
hAxis.gridlines.unit |
המדיניות הזו עוקפת את פורמט ברירת המחדל של היבטים שונים של סוגי נתונים לפי תאריך/תאריך ושעה/שעה של היום, כי היא בשימוש עם קווי רשת מחושבים בתרשים. עיצוב לפי שנים, חודשים, ימים, שעות, דקות, שניות ואלפיות שנייה. הפורמט הכללי הוא: 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: אובייקט
ברירת מחדל: null
|
hAxis.minorGridlines |
אובייקט עם חברים להגדרת קווי הרשת המשניים בציר האופקי, בדומה לאפשרות hAxis.gridlines. Type: אובייקט
ברירת מחדל: null
|
hAxis.minorGridlines.color |
צבע קווי הרשת המשניים האופקיים בתוך אזור התרשים. יש לציין מחרוזת חוקית של צבע HTML. סוג: מחרוזת
ברירת מחדל: שילוב של צבעי הרשת והרקע
|
hAxis.minorGridlines.count |
האפשרות סוג: מספר
ברירת מחדל: 1
|
hAxis.minorGridlines.interval |
האפשרות של minGridlines.interval דומה לאפשרות של מרווחי רשת גדולים, אבל המרווח שייבחר יהיה תמיד קו מפריד של המרווח הראשי של רשת.
מרווח ברירת המחדל עבור מאזניים לינאריים הוא סוג: מספר
ברירת מחדל: 1
|
hAxis.minorGridlines.minSpacing |
הרווחים המינימליים הנדרשים, בפיקסלים, בין קווי רשת משניים סמוכים ובין קווי רשת משניים ראשיים לרשתיים. ערך ברירת המחדל הוא 1/2 ה-minSpacing של קווי רשת ראשיים לסולם לינארי, ו-1/5 ה-minSpacing בקני מידה של יומנים. סוג: מספר
ברירת מחדל: מחושב
|
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: אובייקט
ברירת מחדל: null
|
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.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.viewWindowMode |
ההגדרה קובעת איך משנים את קנה המידה של הציר האופקי כדי לעבד את הערכים בתוך אזור התרשים. יש תמיכה בערכי המחרוזת הבאים:
סוג: מחרוזת
ברירת מחדל:
שווה ערך ל-'יפה', אבל
haxis.viewWindow.min ו-haxis.viewWindow.max מקבלים עדיפות.
|
hAxis.viewWindow |
קביעת טווח החיתוך של הציר האופקי. Type: אובייקט
ברירת מחדל: null
|
hAxis.viewWindow.max |
אינדקס השורות שלא מבוסס על המספר שבו חלון החיתוך מסתיים. נקודות נתונים באינדקס הזה
ומספר גבוה יותר ייחתכו. בשילוב עם המערכת מתעלמת מהמאפיין הזה כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
hAxis.viewWindow.min |
אינדקס השורות שמבוססות על אפס שבו מתחיל חלון החיתוך. נקודות הנתונים באינדקסים הנמוכים
יקוצרו. בשילוב עם המערכת מתעלמת מהמאפיין הזה כאשר הערך של סוג: מספר
ברירת מחדל: אוטומטי
|
Hitogram.bucketSize |
קוד בתוך הקוד של כל עמודה בהיסטוגרמה, במקום לאפשר לקבוע אותו באמצעות אלגוריתם. סוג: מספר
ברירת מחדל: אוטומטי
|
Hitogram.hideBucketItems |
משמיטים את החלוקות הדקות בין אבני ההיסטוגרמה, כך שהן הופכות לסדרה של פסים מוצקים. סוג: בוליאני
ברירת מחדל: False
|
Hitogram.lastBucketPercentile |
כשמחשבים את גודל הקטגוריה של ההיסטוגרמה, מתעלמים מהחלק העליון
והתחתון של
סוג: מספר
ברירת מחדל: 0
|
Hitogram.minValue |
צריך להרחיב את טווח הקטגוריות כדי לכלול את הערך הזה. סוג: מספר
ברירת מחדל: אוטומטי – שימוש בחבילת הגלישה
|
Hitogram.maxValue |
צריך להרחיב את טווח הקטגוריות כדי לכלול את הערך הזה. סוג: מספר
ברירת מחדל: אוטומטי – שימוש בנתונים מקסימליים
|
hitogram.numBucketsRule |
איך מחשבים את מספר ברירת המחדל של קטגוריות הערכים האפשריים הם:
סוג: מחרוזת
ברירת מחדל:
'sqrt' |
גובה |
גובה התרשים, בפיקסלים. סוג: מספר
ברירת מחדל: הגובה של הרכיב שמכיל את הסרטון
|
אינטרפולאט |
האם לנחש את הערך של נקודות חסרות. אם היא מקבלת את הערך true, היא מנחשת את הערך של הנתונים החסרים על סמך הנקודות הסמוכות. אם False, הוא יגרום להפסקה של שורה בנקודה הלא ידועה.
האפשרות הזו לא נתמכת בתרשימי שטח שכוללים את האפשרות סוג: בוליאני
ברירת מחדל: False
|
בערימה |
אם היא מוגדרת כ-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
|
Index.pageIndex |
אינדקס הדף הראשון שנבחר מבוסס אפס. סוג: מספר
ברירת מחדל: 0
|
אגדה |
מיקום המקרא. יכול להיות אחת מהאפשרויות הבאות:
סוג: מחרוזת
ברירת מחדל: 'ימין'
|
style.textStyle |
אובייקט שמציין את סגנון הטקסט של המקרא. לאובייקט יש את הפורמט הבא: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
השדה Type: אובייקט
ברירת מחדל:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
כיוון |
כיוון התרשים. אם הערך הוא סוג: מחרוזת
ברירת מחדל: 'אופקית'
|
הפוך קטגוריות |
אם המדיניות מוגדרת כ-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
|
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.gridlines.interval |
מערך גדלים (כערכי נתונים, לא פיקסלים) בין קווי רשת סמוכים. כרגע האפשרות הזו זמינה רק לצירים מספריים,
היא דומה לאפשרויות של
סוג: מספר בין 1 ל-10, לא כולל 10.
ברירת מחדל: מחושב
|
vAxis.gridlines.minSpacing |
הגודל המינימלי של המסך, בפיקסלים, בין קווי הרשת הראשיים של hAxis.
ברירת המחדל לקווי רשת ראשיים היא סוג: מספר
ברירת מחדל: מחושב
|
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: אובייקט
ברירת מחדל: null
|
vAxis.minorGridlines |
אובייקט עם חברים להגדרת קווי הרשת המשניים בציר האנכי, באופן דומה לאפשרות vAxis.gridlines. Type: אובייקט
ברירת מחדל: 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 ה-minSpacing של קווי רשת ראשיים לסולם לינארי, ו-1/5 ה-minSpacing בקני מידה של יומנים. סוג: מספר
ברירת מחדל: מחושב
|
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: אובייקט
ברירת מחדל: null
|
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 |
מופעל כשהמשתמש לוחץ על ישות חזותית. כדי לראות מה נבחר, צריך להתקשר למספר מאפיינים: ללא
|
מדיניות נתונים
כל הנתונים והקוד מעובדים ומעובדים בדפדפן. לא יישלחו נתונים לאף שרת.