תרשים תמונת פמוט

חשוב: החלק של 'תרשימי תמונות' בכלים של Google Charts הוצא משימוש באופן רשמי ב-20 באפריל 2012. הוא ימשיך לפעול בהתאם למדיניות ההוצאה משימוש שלנו.

  1. סקירה כללית
  2. דוגמה
  3. בטעינה
  4. פורמט נתונים
  5. אפשרויות הגדרה
  6. שיטות
  7. אירועים
  8. המדיניות בנושא נתונים

סקירה כללית

תרשים פמוט שמוצג כתמונה באמצעות Google Charts API.

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

דוגמה

 
<html>
  <head>
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      google.charts.load("current", {packages:["imagechart"]});
      google.charts.setOnLoadCallback(drawChart);

      function drawChart() {

        var options = {};
        dataTable = google.visualization.arrayToDataTable([
          ['Gainers',10,30,45,60],
          ['Losers',20,35,25,45],
          ], true);

       var chart = new google.visualization.ImageCandlestickChart(document.getElementById('chart_div'));
       chart.draw(dataTable, options);
      }
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 400px; height: 240px;"></div>
  </body>
</html>

בטעינה

שם החבילה של google.charts.load הוא "imagechart". 

  google.charts.load('current', {packages: [imagechart]});

שם הכיתה של התצוגה החזותית הוא google.visualization.ImageCandlestickChart. 

  var visualization = new google.visualization.ImageCandlestickChart(container);

פורמט נתונים

חמש עמודות, כאשר כל שורה מתארת סמן של פמוט אחד:

  • Col 0: מחרוזת המשמשת כתווית של הסמן הזה בציר ה-X.
  • קול 1: מספר שמציין את הערך הנמוך/המינימלי של הסמן הזה. זהו הבסיס של הקו השחור.
  • קול 2: מספר שמציין את ערך הפתיחה/הראשי של הסמן. זהו גבול אנכי אחד של הנר. אם הערך בעמודה 3 קטן מהערך בעמודה 3, הנר יהיה ירוק. אחרת, הנר יהיה אדום.
  • קול 3: מספר שמציין את ערך הסגירה/הסופי של הסמן הזה. זהו הגבול האנכי השני של הנר. אם הערך בעמודה 2 קטן מהערך בעמודה 2, הנר יהיה אדום. אחרת, הנר יהיה ירוק.
  • קול 4: מספר שמציין את הערך הגבוה/המקסימלי של הסמן הזה. זהו החלק העליון של הקו השחור.

אפשרויות הגדרה

בנוסף לאפשרויות שנתמכות בתרשים תמונות גנרי, תרשים פמוט תומך באפשרויות הבאות:

שם סוג ברירת המחדל תיאור
backgroundColor string '#FFFFFF' (לבן) צבע הרקע של התרשים. זוהי מחרוזת #RRGGBB, כולל הסימן #.
showAxisLines boolean true הגדרה שקובעת אם להציג את קווי הציר. אם המדיניות מוגדרת כ-False, גם תוויות הצירים לא יוצגו.
גובה number גובה הרכיב שמכיל גובה התרשים, בפיקסלים. אם 30 < height או height > 1,000, הערך הזה יוגדר כברירת מחדל ל-200.
מקסימלי number ערך נתונים מקסימלי הערך המקסימלי של ציר ה-Y.
דקה number ערך נתונים מינימלי הערך המינימלי של ציר ה-Y.
showCategoryLabels boolean true אם הערך הוא False, התוויות של ציר ה-X יוסתרו.
showValueLabels boolean true אם הערך הוא False, התוויות של ציר ה-Y יוסתרו.
showValueLabelsInternal number אוטומטי הריווח בין התוויות של ציר ה-Y, בפיקסלים.
title string '' טקסט להצגה מעל התרשים.
רוחב number רוחב הרכיב שמכיל רוחב התרשים, בפיקסלים. אם הערך של width קטן מ-30 או גדול מ-1,000, הערך של width יוגדר כ-300.

שיטות

שיטה סוג הערך המוחזר תיאור
draw(data, options) אין מצייר את התרשים.

אירועים

אפשר להירשם כדי לשמוע את האירועים שמתוארים בדף General Image Chart.

המדיניות בנושא נתונים

מידע נוסף על מדיניות הרישום ביומן של Chart API