مخطط صورة الشموع

مهم: لقد تم جزء رسمي من جزء مخططات الصور في أدوات مخطط Google اعتبارًا من 20 نيسان (أبريل) 2012. وسيستمر العمل بموجب سياسة الإيقاف.

  1. نظرة عامة
  2. مثال
  3. جارٍ التحميل
  4. تنسيق البيانات
  5. خيارات الإعداد
  6. الطُرق
  7. الأحداث
  8. سياسة البيانات

نظرة عامة

مخطط شمعدان يتم عرضه كصورة باستخدام واجهة برمجة تطبيقات مخططات Google.

يستخدم مخطط الشموع لعرض القيمة الافتتاحية والختامية متراكبة على إجمالي الفارق. غالبًا ما يتم استخدام مخططات الشموع لعرض سلوك قيمة المخزون. في هذا المخطط، يتم رسم العناصر التي تقل فيها قيمة الفتح عن القيمة الختامية باللون الأخضر، كما يتم رسم العناصر التي تكون القيمة الافتتاحية فيها أكبر من القيمة الختامية باللون الأحمر. اطّلع على مستندات الشموع في واجهة برمجة تطبيقات مخططات Google للحصول على مزيد من المعلومات.

مثال

 
<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: سلسلة مستخدمة كتصنيف لهذه العلامة على المحور "س".
  • رقم 1: عدد يحدد القيمة الأدنى/الدنيا لهذه العلامة. هذه هي قاعدة الخط الأسود.
  • رقم 2: عدد يحدد القيمة الافتتاحية/الأولية لهذه العلامة. ويكون هذا حدًا عموديًا واحدًا للشمعة. إذا كان أقل من قيمة العمود 3، فستكون الشمعة خضراء، وإلا فستكون حمراء.
  • رقم 3: رقم يحدد قيمة الإغلاق/النهائية لهذه العلامة. هذا هو الحد العمودي الثاني للشمعة. إذا كان أقل من قيمة العمود 2، فستكون الشمعة حمراء، وإلا فستكون خضراء.
  • رقم 4: عدد يحدد القيمة المرتفعة/القصوى لهذه العلامة. هذا هو الجزء العلوي من السطر الأسود.

خيارات الضبط

بالإضافة إلى الخيارات المتاحة في مخطط الصور العام، فإن مخطط الشموع يتيح الخيارات التالية:

الاسم النوع القيمة التلقائية الوصف
لون الخلفية سلسلة '#FFFFFF' (أبيض) لون الخلفية للرسم البياني. هذه سلسلة #RRGGBB، بما في ذلك العلامة #.
إظهار خطوط المحور منطقي صواب لتحديد ما إذا كان سيتم إظهار خطوط المحور أم لا. وفي حال ضبطها على "خطأ"، لن يتم أيضًا عرض تصنيفات المحور.
الارتفاع number ارتفاع العنصر المتضمِّن ارتفاع المخطط بالبكسل. إذا كان 30 < height أو height > 1000، سيتم ضبط هذه القيمة تلقائيًا على 200.
الحد الأقصى number الحد الأقصى لقيمة البيانات الحد الأقصى لقيمة المحور "ص"
دقيقة number الحد الأدنى لقيمة البيانات الحد الأدنى لقيمة المحور "ص"
showCategoryLabels منطقي صواب في حال اختيار القيمة "false"، يتم إخفاء تصنيفات المحور "س".
showValueLabels منطقي صواب في حال اختيار القيمة "false"، يتم إخفاء تصنيفات المحور "ص".
showValueLabelsInternal number تلقائي التباعد بين تصنيفات المحور "ص"، بالبكسل.
العنوان سلسلة '' النص المطلوب عرضه أعلى المخطط.
width number عرض العنصر المضمن عرض المخطط بالبكسل. إذا كان width أقل من 30 أو أكبر من 1000، فسيتم تعيين width إلى 300.

الطرق

الطريقة نوع القيمة التي يتم عرضها الوصف
draw(data, options) لا ينطبق لرسم المخطط.

الأحداث

يمكنك التسجيل لسماع الأحداث الموضحة على صفحة مخطط الصور العامة.

سياسة البيانات

يُرجى الرجوع إلى سياسة تسجيل واجهة برمجة التطبيقات للرسم البياني.