نظرة عامة
رسم بياني تفاعلي بالشموع
يُستخدم مخطط الشمعدان لعرض القيمة الافتتاحية والختامية متراكبة فوق تباين إجمالي. غالبًا ما يتم استخدام الرسوم البيانية بالشموع لإظهار سلوك قيمة الأسهم. في هذا الرسم البياني، يتم رسم العناصر التي تكون فيها القيمة الافتتاحية أقل من القيمة الختامية (الاكتساب) كمربّعات معبأة، ويتم رسم العناصر التي تكون فيها القيمة الافتتاحية أكبر من القيمة الختامية (الخسارة) كمربّعات مجوفة.
مثال
<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([ ['Mon', 20, 28, 38, 45], ['Tue', 31, 38, 55, 66], ['Wed', 50, 55, 77, 80], ['Thu', 77, 77, 66, 50], ['Fri', 68, 66, 22, 15] // Treat first row as data as well. ], true); var options = { legend:'none' }; var chart = new google.visualization.CandlestickChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
الرسوم البيانية الانحدارية
باستخدام المجموعة الصحيحة من الخيارات، يمكن إنشاء مخططات الشموع لتشبه المخططات الانحدارية البسيطة.
في التعليمة البرمجية أدناه، نتخلص من الويبات العليا من خلال وجود نفس القيم في العمودين الأول والثاني، والشرائط السفلية من خلال وجود القيم ذاتها في العمودين الثالث والرابع. وتم ضبط bar.groupWidth
على '100%'
لإزالة المسافة بين الأشرطة.
<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([ ['Mon', 28, 28, 38, 38], ['Tue', 38, 38, 55, 55], ['Wed', 55, 55, 77, 77], ['Thu', 77, 77, 66, 66], ['Fri', 66, 66, 22, 22] // Treat the first row as data. ], true); var options = { legend: 'none', bar: { groupWidth: '100%' }, // Remove space between bars. candlestick: { fallingColor: { strokeWidth: 0, fill: '#a52714' }, // red risingColor: { strokeWidth: 0, fill: '#0f9d58' } // green } }; var chart = new google.visualization.CandlestickChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
ولا توجد حاليًا طريقة سهلة لتسمية الأشرطة. الخيار الأفضل هو استخدام التراكبات.
جارٍ التحميل
اسم حزمة "google.charts.load
" هو "corechart"
.
google.charts.load('current', {packages: ['corechart']});
اسم فئة العرض المرئي هو
google.visualization.CandlestickChart.
.
var visualization = new google.visualization.CandlestickChart(container);
تنسيق البيانات
خمسة أعمدة أو أكثر يحدد فيها العمود الأول قيم المحور "س" أو تصنيفات المجموعات، ويحدد كل مضاعف من أربعة أعمدة بيانات بعد ذلك سلسلة مختلفة.
- العمود 0: سلسلة (منفصلة) تُستخدَم كتصنيف مجموعة على المحور "س"، أو رقم أو تاريخ أو تاريخ أو وقت في اليوم (مستمر) تُستخدَم كقيمة على المحور "س".
- العمود 1: رقم يحدّد القيمة الأدنى/الأدنى لهذه العلامة. ويكون هذا هو قاعدة خط مركز الشمعة. يتم استخدام تصنيف العمود كتصنيف سلسلة في وسيلة الإيضاح (بينما يتم تجاهل تصنيفات الأعمدة الأخرى).
- العمود 2: رقم يحدّد القيمة الافتتاحية/الأولية لهذه العلامة. ويكون هذا حدًا عموديًا واحدًا للشمعة. إذا كانت قيمة العمود 3 أقل من قيمة العمود 3، ستكون الشمعة مملوءة، وإلا ستكون فارغة.
- العمود 3: رقم يحدّد القيمة الختامية/النهائية لهذه العلامة. هذا هو الحد العمودي الثاني للشمعة. إذا كانت قيمة العمود 2 أقل من قيمة العمود 2، ستكون الشمعة مفرغة، وإلا ستتم ملئها.
- العمود 4: رقم يحدّد القيمة العالية/الأقصى لهذه العلامة. ويكون هذا هو أعلى خط مركز الشمعة.
- العمود 5 [اختياري]: تلميح أو عمود نمط للشموع
خيارات الإعداد
الاسم | |
---|---|
aggregationTarget |
كيفية تجميع اختيارات البيانات المتعددة في تلميحات:
سيتم غالبًا استخدام
aggregationTarget جنبًا إلى جنب مع selectionMode
وtooltip.trigger ، على سبيل المثال:
var options = { // Allow multiple // simultaneous selections. selectionMode: 'multiple', // Trigger tooltips // on selections. tooltip: {trigger: 'selection'}, // Group selections // by x-value. aggregationTarget: 'category', }; النوع: سلسلة
تلقائي: "تلقائي"
|
animation.duration |
مدة الحركة بالمللي ثانية. لمعرفة التفاصيل، يمكنك الاطّلاع على مستندات الصور المتحركة. النوع: رقم
القيمة التلقائية: 0
|
animation.easing |
دالة التخفيف المطبقة على الصورة المتحركة. تتوفّر الخيارات التالية:
النوع: سلسلة
تلقائي: "خطي"
|
animation.startup |
تحدِّد هذه السياسة ما إذا كان الرسم البياني سيتم تحريكه عند الرسم الأولي. إذا كانت القيمة النوع: قيمة منطقية
خطأ تلقائي
|
axisTitlesPosition |
مكان وضع عناوين المحاور، مقارنة بمساحة الرسم البياني. القيم المسموح بها:
النوع: سلسلة
القيمة التلقائية: "out"
|
backgroundColor |
لون الخلفية للمنطقة الرئيسية من الرسم البياني. يمكن أن تكون إما سلسلة لون HTML بسيطة، على سبيل المثال: النوع: سلسلة أو كائن
الوضع التلقائي: "أبيض"
|
backgroundColor.stroke |
لون حد الرسم البياني، كسلسلة لون HTML. النوع: سلسلة
تلقائي: '#666'
|
backgroundColor.strokeWidth |
عرض الحدود بالبكسل. النوع: رقم
القيمة التلقائية: 0
|
backgroundColor.fill |
لون تعبئة الرسم البياني، كسلسلة لون HTML. النوع: سلسلة
الوضع التلقائي: "أبيض"
|
bar.groupWidth |
عرض مجموعة من الشموع، يتم تحديدها بأي من التنسيقين التاليين:
النوع: رقم أو سلسلة
تلقائي:
النسبة الذهبية،
حوالي "61.8%".
|
candlestick.hollowIsRising |
إذا كان "صحيحًا"، ستظهر الشموع الصاعدة مجوفة وستبدو الشموع المتساقطة صلبة، وإلا العكس. النوع: قيمة منطقية
تلقائي: خطأ (سيتم تغييره لاحقًا إلى "صحيح")
|
candlestick.fallingColor.fill |
لون تعبئة الشموع المتساقطة، كسلسلة لون HTML النوع: سلسلة
الخيار التلقائي: تلقائي (يعتمد على لون السلسلة وسمة helowIsRizing)
|
candlestick.fallingColor.stroke |
لون خط الشموع المتساقطة، كسلسلة لون HTML النوع: سلسلة
تلقائي: تلقائي (لون السلسلة)
|
candlestick.fallingColor.strokeWidth |
عرض خط الشموع المتساقطة، كسلسلة لون HTML النوع: 2
تلقائي: رقم
|
candlestick.risingColor.fill |
لون تعبئة الشموع الصاعدة، كسلسلة لون HTML النوع: سلسلة
الإعداد التلقائي: تلقائي (أبيض أو لون السلسلة، حسب holowIsRizing)
|
candlestick.risingColor.stroke |
لون خط الشموع الصاعدة، كسلسلة لون HTML النوع: سلسلة
الخيار التلقائي: تلقائي (لون السلسلة أو الأبيض، حسب holowIsRizing)
|
candlestick.risingColor.strokeWidth |
عرض خط الشموع الصاعدة، كسلسلة لون HTML النوع: رقم
الخيار التلقائي: 2
|
chartArea |
كائن يحتوي على أعضاء لضبط موضع مساحة الرسم البياني وحجمها (حيث يتم رسم الرسم البياني نفسه، باستثناء المحور ووسائل الإيضاح). يمكنك استخدام تنسيقَين: رقم أو
رقم متبوعًا بنسبة مئوية. والرقم البسيط هو قيمة بالبكسل، بينما يمثّل الرقم متبوعًا بنسبة مئوية
نسبة مئوية. مثلاً: Type: كائن
الإعداد التلقائي: قيمة خالية
|
chartArea.backgroundColor |
لون خلفية الرسم البياني عند استخدام سلسلة، يمكن أن تكون إما سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون إنجليزي. وعند استخدام كائن، يمكن توفير السمات التالية:
النوع: سلسلة أو كائن
الوضع التلقائي: "أبيض"
|
chartArea.left |
مقدار المسافة لرسم الرسم البياني من الحد الأيسر. النوع: رقم أو سلسلة
الإعداد التلقائي: تلقائي
|
chartArea.top |
مقدار المسافة لرسم الرسم البياني من الحد العلوي. النوع: رقم أو سلسلة
الإعداد التلقائي: تلقائي
|
chartArea.width |
عرض مساحة الرسم البياني النوع: رقم أو سلسلة
الإعداد التلقائي: تلقائي
|
chartArea.height |
ارتفاع مساحة الرسم البياني النوع: رقم أو سلسلة
الإعداد التلقائي: تلقائي
|
الألوان |
الألوان المراد استخدامها لعناصر الرسم البياني تمثّل هذه السمة مصفوفة من السلاسل يكون فيها كل عنصر سلسلة لون HTML، على سبيل المثال: النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
|
enableInteractivity |
ما إذا كان الرسم البياني يعرض أحداثًا مستندة إلى المستخدمين أو يتفاعل مع تفاعل المستخدم إذا كانت القيمة "false"، لن يعرض الرسم البياني الأحداث "select" أو غيرها من الأحداث المستندة إلى التفاعل (ولكنه سيعرض أحداثًا جاهزة أو يعرض أخطاء)، ولن يعرض النصّ التمريري أو يتغيّر استنادًا إلى البيانات التي أدخلها المستخدِم. النوع: قيمة منطقية
القيمة التلقائية:صحيح
|
focusTarget |
نوع العنصر الذي يتم التركيز عليه عند تمرير الماوس. ويؤثر أيضًا في العنصر الذي يتم اختياره من خلال النقر بالماوس، بالإضافة إلى عنصر جدول البيانات المرتبط بالأحداث. يمكن أن يكون أيًا مما يلي:
في viewTarget "category" (الفئة)، يعرِض التلميح جميع قيم الفئة. قد يكون هذا مفيدًا في مقارنة قيم سلاسل مختلفة. النوع: سلسلة
تلقائي: "المرجع"
|
fontSize |
حجم الخط الافتراضي بالبكسل لجميع النص في الرسم البياني. ويمكنك إلغاء هذا الإجراء باستخدام سمات لعناصر محدَّدة في الرسم البياني. النوع: رقم
تلقائي: تلقائي
|
fontName |
واجهة الخط التلقائية لكل النص في الرسم البياني ويمكنك إلغاء هذا الإجراء باستخدام سمات لعناصر محدَّدة في الرسم البياني. النوع: سلسلة
القيمة التلقائية: "Arial"
|
forceIFrame |
لرسم الرسم البياني داخل إطار مضمّن. (يُرجى ملاحظة أنّه في IE8، يتم تجاهل هذا الخيار، ويتم رسم كل مخططات IE8 بالإطارات i-frames). النوع: قيمة منطقية
الإعداد التلقائي: خطأ
|
hAxis |
كائن يحتوي على أعضاء لضبط عناصر متعددة للمحور الأفقي. لتحديد خصائص هذا الكائن، يمكنك استخدام التدوين الحرفي للكائن، كما هو موضّح هنا: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Type: كائن
الإعداد التلقائي: قيمة خالية
|
hAxis.baseline |
الخط القاعدي للمحور الأفقي. هذا الخيار متاح فقط لمحور النوع: رقم
تلقائي: تلقائي
|
hAxis.baselineColor |
لون الخط القاعدي للمحور الأفقي. يمكن أن تكون أي سلسلة لون HTML، على سبيل المثال: هذا الخيار متاح فقط لمحور النوع: رقم
الوضع التلقائي: "أسود"
|
hAxis.direction |
الاتجاه الذي تنمو به القيم على طول المحور الأفقي. حدِّد النوع: 1 أو -1
تلقائي: 1
|
hAxis.format |
سلسلة تنسيق لتصنيفات المحور الرقمي أو محور التاريخ.
بالنسبة إلى تصنيفات محور الأرقام، هذه مجموعة فرعية من التنسيق العشري
مجموعة أنماط ICU
. على سبيل المثال، سيعرض
بالنسبة إلى تصنيفات محور التاريخ، هذه مجموعة فرعية من تنسيق التاريخ
تم ضبط أنماط ICU
. على سبيل المثال، سيعرض يتم اشتقاق التنسيق الفعلي المطبَّق على التصنيف من اللغة التي تم تحميل واجهة برمجة التطبيقات بها. لمزيد من التفاصيل، راجِع تحميل الرسوم البيانية بلغة معيّنة .
عند احتساب قيم التجزئة وخطوط الشبكة، سيتم النظر في عدة مجموعات بديلة من جميع خيارات خطوط الشبكة ذات الصلة وسيتم رفض البدائل إذا كانت تصنيفات علامات التجزئة المنسَّقة مكرّرة أو متداخلة.
يمكنك تحديد
هذا الخيار متاح فقط للمحور
النوع: سلسلة
الإعداد التلقائي: تلقائي
|
hAxis.gridlines |
كائن له خصائص لإعداد خطوط الشبكة على المحور الأفقي. لاحظ أن خطوط الشبكة ذات المحور الأفقي يتم رسمها عموديًا. لتحديد سمات هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن على النحو الموضّح هنا: {color: '#333', minSpacing: 20}
هذا الخيار متاح فقط للمحور
Type: كائن
الإعداد التلقائي: قيمة خالية
|
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: كائن
الإعداد التلقائي: قيمة خالية
|
hAxis.minorGridlines |
كائن يحتوي على أعضاء لضبط خطوط الشبكة الصغيرة على المحور الأفقي، على غرار الخيار hAxis.gridlines.
هذا الخيار متاح فقط للمحور
Type: كائن
الإعداد التلقائي: قيمة خالية
|
hAxis.minorGridlines.color |
لون خطوط الشبكة الصغيرة الأفقية داخل منطقة الرسم البياني. حدِّد سلسلة لون HTML صالحة. النوع: سلسلة
الوضع التلقائي: مزيج من خطوط الشبكة وألوان الخلفية
|
hAxis.minorGridlines.interval |
يشبه الخيار miniGrids.interval خيار الفاصل الزمني لخطوط الشبكة الرئيسية، ولكن الفاصل الزمني الذي يتم اختياره سيكون دائمًا قاسمًا متساويًا للفاصل الزمني لخط الشبكة الرئيسي.
الفاصل التلقائي للمقاييس الخطية هو النوع: رقم
تلقائي:1
|
hAxis.minorGridlines.minSpacing |
تمثّل هذه السمة الحد الأدنى للمساحة المطلوبة بالبكسل، وبين خطوط الشبكة الصغيرة المجاورة، وبين خطوط الشبكة الثانوية والكبيرة. القيمة التلقائية هي 1/2 من الحد الأدنى لتباعد خطوط الشبكة الرئيسية للمقاييس الخطية، و1/5 من المسافة الدقيقة للمقاييس اللوغاريتمية. النوع: رقم
تلقائي: محسوبة
|
hAxis.minorGridlines.multiple |
كما هو الحال مع النوع: رقم
تلقائي: 1
|
hAxis.minorGridlines.count |
يتم إيقاف الخيار النوع: رقم
تلقائي: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: كائن
الإعداد التلقائي: قيمة خالية
|
hAxis.logScale |
سمة هذا الخيار متاح فقط لمحور النوع: قيمة منطقية
الإعداد التلقائي: خطأ
|
hAxis.scaleType |
السمة
هذا الخيار متاح فقط لمحور النوع: سلسلة
القيمة التلقائية: خالية
|
hAxis.textPosition |
موضع نص المحور الأفقي، بالنسبة إلى منطقة الرسم البياني القيم المسموح بها: 'out' و'in' و'none'. النوع: سلسلة
القيمة التلقائية: "out"
|
hAxis.textStyle |
كائن يحدد نمط نص المحور الأفقي. يحتوي الكائن على التنسيق التالي: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن تكون السمة Type: كائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.ticks |
يستبدل علامات المحور "س" التي يتم إنشاؤها تلقائيًا بالصفيف المحدد. ويجب أن يكون كل عنصر في المصفوفة عبارة عن قيمة تجزئة صالحة (مثل رقم أو تاريخ أو تاريخ ووقت أو وقت يوميًا) أو كائنًا. إذا كان كائنًا، يجب أن يتضمّن السمة
وسيتم توسيع viewWindow تلقائيًا
ليشمل الحدَّين الأدنى والأقصى لعلامتَي التجزئة ما لم تحدّد
أمثلة:
هذا الخيار متاح فقط للمحور
النوع: مصفوفة من العناصر
الإعداد التلقائي: تلقائي
|
hAxis.title |
السمة النوع: سلسلة
الإعداد التلقائي: قيمة خالية
|
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 |
إذا كانت القيمة "خطأ"، سيتم إخفاء التصنيفات الخارجية بدلاً من السماح باقتصاصها باستخدام حاوية الرسم البياني. إذا كانت القيمة هي "صحيح"، سيتم السماح باقتصاص التصنيفات. هذا الخيار متاح فقط لمحور النوع: قيمة منطقية
الإعداد التلقائي: خطأ
|
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.maxValue |
نقل الحد الأقصى لقيمة المحور الأفقي إلى القيمة المحددة، سيكون متجهًا لليمين في معظم الرسومات البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أصغر من الحد الأقصى لقيمة "س" للبيانات.
تلغي
هذا الخيار متاح فقط للمحور
النوع: رقم
تلقائي: تلقائي
|
hAxis.minValue |
نقل الحد الأدنى لقيمة المحور الأفقي إلى القيمة المحددة، ويكون متجهًا لليسار في معظم الرسومات البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أكبر من الحد الأدنى لقيمة "س" للبيانات.
تلغي
هذا الخيار متاح فقط للمحور
النوع: رقم
تلقائي: تلقائي
|
hAxis.viewWindowMode |
لتحديد كيفية ضبط قياس المحور الأفقي لعرض القيم داخل منطقة الرسم البياني. ويمكن استخدام قيم السلسلة التالية:
هذا الخيار متاح فقط للمحور
النوع: سلسلة
الخيار التلقائي:
تعادل هذه القيمة "pretty"، ولكن
تكون الأولوية للسمتَين
haxis.viewWindow.min
وhaxis.viewWindow.max في حال استخدامهما.
|
hAxis.viewWindow |
لتحديد نطاق الاقتصاص للمحور الأفقي. Type: كائن
الإعداد التلقائي: قيمة خالية
|
hAxis.viewWindow.max |
يتم تجاهل السياسة عندما تكون قيمة النوع: رقم
الإعداد التلقائي: تلقائي
|
hAxis.viewWindow.min |
يتم تجاهل السياسة عندما تكون قيمة النوع: رقم
الإعداد التلقائي: تلقائي
|
الطول |
تمثّل هذه السمة ارتفاع الرسم البياني بالبكسل. النوع: رقم
التلقائي: ارتفاع العنصر الذي يحتوي على الصورة
|
أسطورة |
كائن يحتوي على أعضاء لضبط جوانب مختلفة من وسيلة الإيضاح. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن على النحو الموضّح هنا: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type: كائن
الإعداد التلقائي: قيمة خالية
|
legend.alignment |
محاذاة وسيلة الإيضاح. يمكن أن تكون الحالة واحدة مما يلي:
ترتبط البداية والوسط والنهاية بالنمط - رأسي أو أفقي - للوسيلة الإيضاح. على سبيل المثال، في وسيلة الإيضاح "الأيمن"، تظهر "البدء" و"النهاية" في الأعلى والأسفل على التوالي، وبالنسبة إلى وسيلة الإيضاح "الأعلى"، تظهر "البداية" و"النهاية" على يسار المساحة ويمينها، على التوالي. وتعتمد القيمة الافتراضية على موضع وسيلة الإيضاح. وبالنسبة إلى وسائل الإيضاح "الأسفل"، يكون الإعداد التلقائي هو "المركز"، فيما تكون وسائل الإيضاح الأخرى هي "البدء". النوع: سلسلة
تلقائي: تلقائي
|
legend.maxLines |
الحد الأقصى لعدد الأسطر في وسيلة الإيضاح. اضبط هذا على رقم أكبر من واحد لإضافة أسطر إلى وسيلة الإيضاح. ملاحظة: لا يزال المنطق الدقيق المستخدَم لتحديد العدد الفعلي للسطر المعروض قيد التغير. لا يعمل هذا الخيار حاليًا إلا عندما تكون ميزة "أفضل موضع" متاحة في "الأعلى". النوع: رقم
تلقائي: 1
|
legend.pageIndex |
تم اختيار أول فهرس صفحة يستند إلى صفر في وسيلة الإيضاح. النوع: رقم
القيمة التلقائية: 0
|
legend.position |
موضع وسيلة الإيضاح. يمكن أن تكون الحالة واحدة مما يلي:
النوع: سلسلة
الوضع التلقائي: "اليمين"
|
legend.textStyle |
كائن يحدد نمط نص وسيلة الإيضاح. يحتوي الكائن على التنسيق التالي: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن تكون السمة Type: كائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
الاتجاه |
اتجاه الرسم البياني. عند ضبط هذه القيمة على النوع: سلسلة
تلقائي: "أفقي"
|
reverseCategories |
في حال ضبطها على "صحيح"، سيتم رسم سلسلة من اليمين إلى اليسار. الإعداد الافتراضي هو الرسم من اليسار إلى اليمين.
هذا الخيار متاح فقط لمحور
النوع: قيمة منطقية
الإعداد التلقائي: خطأ
|
selectionMode |
عند ضبط قيمة النوع: سلسلة
تلقائي: "أغانٍ"
|
السلسلة |
يشير ذلك المصطلح إلى مصفوفة من العناصر يصف كل منها تنسيق السلسلة المقابلة في الرسم البياني. لاستخدام القيم التلقائية لسلسلة ما، يجب تحديد عنصر فارغ {}. إذا لم يتم تحديد سلسلة أو قيمة، سيتم استخدام القيمة العامة. ويوفّر كل كائن السمات التالية:
يمكنك تحديد إما مصفوفة من العناصر، وينطبق كل منها على السلسلة بالترتيب المقدم، أو يمكنك تحديد كائن حيث يكون لكل فرع مفتاح رقمي يشير إلى السلسلة التي تنطبق عليها. على سبيل المثال، التعريفان التاليان متطابقان، ويشيران إلى أنّ السلسلة الأولى باللون الأسود ولا تظهر في وسيلة الإيضاح، والسلسلة الرابعة باللون الأحمر وبدونها من وسيلة الإيضاح: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } النوع: مصفوفة من العناصر أو الكائن الذي يضم كائنات متداخلة
تلقائي: {}
|
مظهر |
المظهر هو مجموعة من قيم الخيارات المحدّدة مسبقًا التي تعمل معًا لتحقيق سلوك محدّد في الرسم البياني أو تأثير مرئي. يتوفّر مظهر واحد فقط في الوقت الحالي:
النوع: سلسلة
الإعداد التلقائي: قيمة خالية
|
title |
النص المطلوب عرضه أعلى الرسم البياني النوع: سلسلة
تلقائي: بلا عنوان
|
titlePosition |
مكان وضع عنوان الرسم البياني، مقارنةً بمساحة الرسم البياني. القيم المسموح بها:
النوع: سلسلة
القيمة التلقائية: "out"
|
titleTextStyle |
كائن يحدد نمط نص العنوان. يحتوي الكائن على التنسيق التالي: { 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: كائن
الإعداد التلقائي: قيمة خالية
|
tooltip.ignoreBounds |
في حال ضبط هذه السياسة على ملاحظة: ينطبق هذا فقط على تلميحات HTML. في حال تفعيل هذه السياسة باستخدام تلميحات رسومات موجّهة يمكن تغيير حجمها (SVG)، سيتم اقتصاص أي تجاوز خارج حدود الرسم البياني. راجِع تخصيص محتوى التلميح لمعرفة مزيد من التفاصيل. النوع: قيمة منطقية
الإعداد التلقائي: خطأ
|
tooltip.isHtml |
في حال ضبط السياسة على "صحيح"، يمكنك استخدام تلميحات الأدوات المعروضة بتنسيق HTML (بدلاً من عرضها بتنسيق SVG). راجِع تخصيص محتوى التلميح لمعرفة مزيد من التفاصيل. ملاحظة: لا يتيح العرض المرئي للرسم البياني الفقاعي تخصيص محتوى تلميح HTML من خلال دور بيانات عمود التلميح. النوع: قيمة منطقية
الإعداد التلقائي: خطأ
|
tooltip.showColorCode |
في حال اختيار القيمة، اعرض مربّعات ملوّنة بجانب معلومات السلسلة في التلميح. وتكون القيمة التلقائية "صحيح" عند ضبط السمة النوع: قيمة منطقية
تلقائي: تلقائي
|
tooltip.textStyle |
كائن يحدد نمط نص التلميح. يحتوي الكائن على التنسيق التالي: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن تكون السمة Type: كائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.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 } ] النوع: مصفوفة من الكائن أو الكائن يضم عناصر ثانوية
الإعداد التلقائي: قيمة خالية
|
vAxis |
كائن يحتوي على أعضاء لضبط عناصر متعددة من المحور الرأسي. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن على النحو الموضّح هنا: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Type: كائن
الإعداد التلقائي: قيمة خالية
|
vAxis.baseline |
سمة النوع: رقم
تلقائي: تلقائي
|
vAxis.baselineColor |
لتحديد لون الخط القاعدي للمحور الرأسي. يمكن أن تكون أي سلسلة لون HTML،
على سبيل المثال: النوع: رقم
الوضع التلقائي: "أسود"
|
vAxis.direction |
الاتجاه الذي تنمو به القيم على طول المحور الرأسي. تظهر القيم المنخفضة تلقائيًا في أسفل الرسم البياني. حدِّد النوع: 1 أو -1
تلقائي: 1
|
vAxis.format |
سلسلة تنسيق لتصنيفات المحور الرقمي. هذه مجموعة فرعية من
مجموعة أنماط ICU
.
على سبيل المثال، سيعرض
يتم اشتقاق التنسيق الفعلي المطبَّق على التصنيف من اللغة التي تم تحميل واجهة برمجة التطبيقات بها. لمزيد من التفاصيل، راجِع تحميل الرسوم البيانية بلغة معيّنة .
عند احتساب قيم التجزئة وخطوط الشبكة، سيتم النظر في عدة مجموعات بديلة من جميع خيارات خطوط الشبكة ذات الصلة وسيتم رفض البدائل إذا كانت تصنيفات علامات التجزئة المنسَّقة مكرّرة أو متداخلة.
يمكنك تحديد النوع: سلسلة
الإعداد التلقائي: تلقائي
|
vAxis.gridlines |
كائن يحتوي على أعضاء لضبط خطوط الشبكة على المحور الرأسي لاحظ أن خطوط الشبكة ذات المحور الرأسي يتم رسمها أفقيًا. لتحديد خصائص هذا الكائن، يمكنك استخدام التدوين الحرفي للكائن، كما هو موضّح هنا: {color: '#333', minSpacing: 20} Type: كائن
الإعداد التلقائي: قيمة خالية
|
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: كائن
الإعداد التلقائي: قيمة خالية
|
vAxis.minorGridlines |
كائن يحتوي على أعضاء لضبط خطوط الشبكة الصغيرة على المحور الرأسي، على غرار الخيار vAxis.gridlines. Type: كائن
الإعداد التلقائي: قيمة خالية
|
vAxis.minorGridlines.color |
لون خطوط الشبكة الرأسية الصغيرة داخل منطقة الرسم البياني. حدِّد سلسلة لون HTML صالحة. النوع: سلسلة
الوضع التلقائي: مزيج من خطوط الشبكة وألوان الخلفية
|
vAxis.minorGridlines.count |
يتم إيقاف خيار miniGridlines.count نهائيًا، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الصغيرة على الفاصل بين خطوط الشبكة الرئيسية (راجِع vAxis.gridlines.interval) والحد الأدنى للمساحة المطلوبة (يمكنك الاطّلاع على vAxis.minorGridlines.minSpacing). النوع: رقم
تلقائي: 1
|
vAxis.minorGridlines.interval |
يشبه الخيار miniGrids.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: كائن
الإعداد التلقائي: قيمة خالية
|
vAxis.logScale |
إذا كانت القيمة هي true، يصبح المحور الرأسي مقياسًا لوغاريتميًا. ملاحظة: يجب أن تكون جميع القيم موجبة. النوع: قيمة منطقية
الإعداد التلقائي: خطأ
|
vAxis.scaleType |
السمة
هذا الخيار متاح فقط لمحور النوع: سلسلة
الإعداد التلقائي: قيمة خالية
|
vAxis.textPosition |
موضع نص المحور الرأسي، بالنسبة إلى مساحة الرسم البياني القيم المسموح بها: 'out' و'in' و'none'. النوع: سلسلة
القيمة التلقائية: "out"
|
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 |
لاستبدال علامات المحور ص التي يتم إنشاؤها تلقائيًا بالمصفوفة المحددة. ويجب أن يكون كل عنصر في المصفوفة عبارة عن قيمة تجزئة صالحة (مثل رقم أو تاريخ أو تاريخ ووقت أو وقت يوميًا) أو كائنًا. إذا كان كائنًا، يجب أن يتضمّن السمة
وسيتم توسيع 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 |
نقل الحد الأقصى لقيمة المحور الرأسي إلى القيمة المحددة، ويكون هذا العمود للأعلى في معظم الرسومات البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أصغر من قيمة الحد الأقصى لقيمة "ص" للبيانات.
تلغي النوع: رقم
تلقائي: تلقائي
|
vAxis.minValue |
نقل الحد الأدنى للقيمة للمحور العمودي إلى القيمة المحددة، وسيتحرك هذا القيمة إلى أسفل في معظم الرسوم البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أكبر من قيمة الحد الأدنى لقيمة ص للبيانات.
تلغي النوع: رقم
الإعداد التلقائي: قيمة خالية
|
vAxis.viewWindowMode |
لتحديد كيفية ضبط حجم المحور العمودي لعرض القيم داخل منطقة الرسم البياني. ويمكن استخدام قيم السلسلة التالية:
النوع: سلسلة
الخيار التلقائي:
تعادل هذه القيمة "pretty"، ولكن
تكون الأولوية للسمتَين
vaxis.viewWindow.min
وvaxis.viewWindow.max في حال استخدامهما.
|
vAxis.viewWindow |
لتحديد نطاق الاقتصاص للمحور العمودي. Type: كائن
الإعداد التلقائي: قيمة خالية
|
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) |
عرض الإحداثي السيني للبكسل مثال: وعليك باستدعاء هذا بعد رسم الرسم البياني. نوع الإرجاع: رقم
|
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 |
يتم الإطلاق عندما ينقر المستخدم على عنصر مرئي. لمعرفة ما تم اختياره، يمكنك الاتصال بالرقم
الخصائص: غير محدّدة
|
سياسة البيانات
تتم معالجة جميع الرموز والبيانات وعرضها في المتصفّح. ولا يتم إرسال أي بيانات إلى أي خادم.