דף זה תורגם על ידי Cloud Translation API.

המחשה: תרשים עוגה (תמונה)

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

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

סקירה כללית

תרשים עוגה שעבר רינדור כמו תמונה באמצעות 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:["imagepiechart"]});
      google.charts.setOnLoadCallback(drawChart);

      function drawChart() {
        var data = google.visualization.arrayToDataTable([
          ['Task', 'Hours per Day'],
          ['Work',        11],
          ['Eat',         2],
          ['Commute',     2],
          ['Watch TV',    2],
          ['Sleep',       7]
        ]);

        var chart = new google.visualization.ImagePieChart(document.getElementById('chart_div'));

        chart.draw(data, {width: 430, height: 240, title: 'My Daily Activities'});
      }
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 400px; height: 240px;"></div>
  </body>
</html>

בטעינה

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

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

שם הכיתה הוא google.visualization.ImagePieChart

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

פורמט נתונים

שתי עמודות. העמודה הראשונה צריכה להיות מחרוזת ולהכיל את תווית הפלח. העמודה השנייה צריכה להיות מספר ולהכיל את ערך הפלח.

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

ניתן לציין את האפשרויות הבאות כחלק מאובייקט options המועבר בשיטה draw() של התצוגה החזותית.

שם	סוג	ברירת מחדל	תיאור
צבע רקע	string	' #FFFFFF' (לבן)	צבע הרקע של התרשים בפורמט צבעים של תרשים API.
color [צבע]	string	אוטומטית	מציין צבע בסיס לשימוש עבור כל הסדרות. כל סדרה תשמש לציון הדרגתי של הצבע שצוין. הצבעים מצוינים בפורמט הצבעים של תרשים ה-API. המערכת תתעלם מהמאפיין אם `colors` צוין.
צבעים	מערך<string>	אוטומטית	אפשר להשתמש בשיטה הזו כדי להקצות צבעים ספציפיים לכל סדרת נתונים. הצבעים מצוינים בפורמט הצבעים של תרשים ה-API. הצבע i משמש לעמודה i data, ועוטף את הערך בהתחלה, אם יש יותר עמודות נתונים מאשר צבעים. אם וריאציות של צבע אחד קבילות בכל הסדרות, יש להשתמש באפשרות `color` במקום זאת.
enableEvent	boolean	לא נכון	גורם לתרשימים להשליך אירועים שהופעלו על ידי משתמשים, כגון קליק או העברת עכבר. האפשרות נתמכת רק עבור סוגים ספציפיים של תרשימים. עיינו בקטע אירועים בהמשך.
גובה	number	גובה הקונטיינר	גובה התרשים בפיקסלים.
שווה ל-3 י'	boolean	לא נכון	אם המדיניות מוגדרת כ-True, מוצג תרשים תלת-מימדי.
labels	string	'ללא'	איזו תווית, אם יש, להצגה לכל פרוסה. יש לבחור מבין הערכים הבאים: 'none' – ללא תוויות. 'value' – שימוש בערך הפלח כתווית. 'name' - משתמשים בשם הפלח (שם העמודה).
מקרא	string	'right'	המיקום של המקרא בתרשים. יש לבחור באחד מהערכים הבאים: 'top', 'bottom', 'left', 'right' ו-'none'.
שם פריט	string	ללא שם	טקסט להצגה מעל לתרשים.
רוחב	number	רוחב הקונטיינר	רוחב התרשים בפיקסלים.

שיטות

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

אירועים

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

מדיניות נתונים

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