نظرة عامة
تشير المخططات المبعثرة إلى نقاط على الرسم البياني. عندما يمرر المستخدم مؤشر الماوس فوق النقاط، يتم عرض تلميحات الأدوات تتضمّن المزيد من المعلومات.
يتم عرض الرسوم البيانية للنقاط المبعثرة من Google في المتصفّح باستخدام SVG أو VML وفقًا لإمكانيات المتصفّح.
مثال
<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([ ['Age', 'Weight'], [ 8, 12], [ 4, 5.5], [ 11, 14], [ 4, 5], [ 3, 3.5], [ 6.5, 7] ]); var options = { title: 'Age vs. Weight comparison', hAxis: {title: 'Age', minValue: 0, maxValue: 15}, vAxis: {title: 'Weight', minValue: 0, maxValue: 15}, legend: 'none' }; var chart = new google.visualization.ScatterChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
تغيير الأشكال وتحريكها
تمثل المخططات المبعثرة بشكل افتراضي عناصر مجموعة البيانات مع الدوائر. يمكنك تحديد أشكال أخرى باستخدام الخيار pointShape
الوارد بالتفصيل في مستندات تخصيص النقاط.
كما هو الحال مع معظم مخططات Google الأخرى، يمكنك تحريكها باستخدام الأحداث. يمكنك إضافة
أداة معالجة الحدث للحدث ready
الأول وإعادة رسم الرسم البياني
بعد إجراء التعديلات المطلوبة. بعد انتهاء حدث ready
الأول، يمكنك الاستماع إلى
فعالية animationfinish
لتكرار العملية، ما يؤدي إلى إنشاء
حركة مستمرّة. يتحكّم الخيار animation
في طريقة إعادة الرسم: على الفور
(بدون رسوم متحركة) أو بسلاسة، وفي سلاسة وسرعة أي سلوك.
var options = { legend: 'none', colors: ['#087037'], pointShape: 'star', pointSize: 18, animation: { duration: 200, easing: 'inAndOut', } }; // Start the animation by listening to the first 'ready' event. google.visualization.events.addOneTimeListener(chart, 'ready', randomWalk); // Control all other animations by listening to the 'animationfinish' event. google.visualization.events.addListener(chart, 'animationfinish', randomWalk); ... function randomWalk() { ... }
<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 = new google.visualization.DataTable(); data.addColumn('number'); data.addColumn('number'); var radius = 100; for (var i = 0; i < 6.28; i += 0.1) { data.addRow([radius * Math.cos(i), radius * Math.sin(i)]); } // Our central point, which will jiggle. data.addRow([0, 0]); var options = { legend: 'none', colors: ['#087037'], pointShape: 'star', pointSize: 18, animation: { duration: 200, easing: 'inAndOut', } }; var chart = new google.visualization.ScatterChart(document.getElementById('animatedshapes_div')); // Start the animation by listening to the first 'ready' event. google.visualization.events.addOneTimeListener(chart, 'ready', randomWalk); // Control all other animations by listening to the 'animationfinish' event. google.visualization.events.addListener(chart, 'animationfinish', randomWalk); chart.draw(data, options); function randomWalk() { var x = data.getValue(data.getNumberOfRows() - 1, 0); var y = data.getValue(data.getNumberOfRows() - 1, 1); x += 5 * (Math.random() - 0.5); y += 5 * (Math.random() - 0.5); if (x * x + y * y > radius * radius) { // Out of bounds. Bump toward center. x += Math.random() * ((x < 0) ? 5 : -5); y += Math.random() * ((y < 0) ? 5 : -5); } data.setValue(data.getNumberOfRows() - 1, 0, x); data.setValue(data.getNumberOfRows() - 1, 1, y); chart.draw(data, options); } } </script> </head> <body> <div id="animatedshapes_div" style="width: 500px; height: 500px;"></div> </body> </html>
إنشاء رسوم بيانية للنقاط المبعثرة
في عام 2014، أعلنت Google عن إرشادات تهدف إلى دعم الشكل والأسلوب الشائعين عبر مواقعها وتطبيقاتها (مثل تطبيقات Android) التي تعمل على أنظمة Google الأساسية. ونُطلق على هذا الإجراء اسم التصميم المتعدد الأبعاد. سنقدّم نُسخًا "مادّة" لجميع الرسوم البيانية الأساسية، ويمكنك استخدامها إن أردت.
إنّ عملية إنشاء رسم بياني للنقاط المبعثرة مماثلة لإنشاء ما نطلق عليه الآن اسم رسم بياني للنقاط المبعثرة "الكلاسيكي". وتحمّل واجهة برمجة تطبيقات الرسوم المرئية في Google (على الرغم من استخدام حزمة 'scatter'
بدلاً من حزمة 'corechart'
)، ويمكنك تحديد جدول البيانات، ثم إنشاء عنصر
(بدلاً من الفئة google.charts.Scatter
بدلاً من
google.visualization.ScatterChart
).
ملاحظة: لن تعمل مخططات المواد في الإصدارات القديمة من Internet Explorer. (لا يتوافق الإصدار IE8 والإصدارات الأقدم معه مع تنسيق SVG، وهو الأمر الذي تتطلبه ميزة الرسوم البيانية للمواد).
تشتمل مخططات النقاط المبعثرة على العديد من التحسينات الصغيرة على مخططات النقاط المبعثرة الكلاسيكية، بما في ذلك تعتيم المتغيرات لسهولة قراءة النقاط المتداخلة ولوحة ألوان محسّنة وتنسيق أكثر وضوحًا للمسافة وتباعد تلقائي أكثر دقة وخطوط شبكة أكثر انسيابية وعناوين (وإضافة ترجمات مصاحبة).
google.charts.load('current', {'packages':['scatter']}); google.charts.setOnLoadCallback(drawChart); function drawChart () { var data = new google.visualization.DataTable(); data.addColumn('number', 'Hours Studied'); data.addColumn('number', 'Final'); data.addRows([ [0, 67], [1, 88], [2, 77], [3, 93], [4, 85], [5, 91], [6, 71], [7, 78], [8, 93], [9, 80], [10, 82],[0, 75], [5, 80], [3, 90], [1, 72], [5, 75], [6, 68], [7, 98], [3, 82], [9, 94], [2, 79], [2, 95], [2, 86], [3, 67], [4, 60], [2, 80], [6, 92], [2, 81], [8, 79], [9, 83], [3, 75], [1, 80], [3, 71], [3, 89], [4, 92], [5, 85], [6, 92], [7, 78], [6, 95], [3, 81], [0, 64], [4, 85], [2, 83], [3, 96], [4, 77], [5, 89], [4, 89], [7, 84], [4, 92], [9, 98] ]); var options = { width: 800, height: 500, chart: { title: 'Students\' Final Grades', subtitle: 'based on hours studied' }, hAxis: {title: 'Hours Studied'}, vAxis: {title: 'Grade'} }; var chart = new google.charts.Scatter(document.getElementById('scatterchart_material')); chart.draw(data, google.charts.Scatter.convertOptions(options)); }
الرسوم البيانية للمواد تجريبية. يُعدّ الشكل
والتفاعل النهائيان نهائيين إلى حدّ كبير، ولكنّ العديد من الخيارات المتوفّرة في الرسوم البيانية الكلاسيكية
غير متوفرة بعد. يمكنك الاطّلاع على قائمة بالخيارات غير المتاحة بعد في
هذه المشكلة.
بالإضافة إلى ذلك، لم يتم إنهاء الطريقة التي يتم بها الإعلان عن الخيارات، لذا إذا كنت تستخدم أيًا من الخيارات الكلاسيكية، يجب تحويلها إلى خيارات المواد من خلال استبدال هذا السطر:
chart.draw(data, options);
...باستخدام هذا:
chart.draw(data, google.charts.Scatter.convertOptions(options));
الرسوم البيانية الثنائية ص
في بعض الأحيان، ستحتاج إلى عرض سلسلتَين في رسم بياني للنقاط المبعثرة، مع محورَين صاديَين مستقلَين: المحور الأيسر لسلسلة واحدة، والمحور الأيمن لسلسلة أخرى:
لاحظ أنه لا يتم تصنيف محوري ص فقط بشكلٍ مختلف ("درجة الاختبار النهائي" في مقابل
"ساعات الدراسة") ولكن لكل منهما مقاييس وخطوط شبكة مستقلة. وإذا أردت تخصيص هذا السلوك، يمكنك استخدام خيارات vAxis.gridlines
.
في الرمز الوارد أدناه، يحدّد الخياران axes
وseries
معًا شكل الرسم البياني الثنائي. يحدّد الخيار series
المحور المطلوب استخدامه لكل منهما ('final grade'
و'hours studied'
، ولا يلزم أن تكون هناك أي علاقة
بأسماء الأعمدة في جدول البيانات). يؤدي الخيار axes
بعد ذلك إلى تحويل هذا الرسم البياني إلى رسم بياني ثنائي ص، ووضع المحور 'Final Exam Grade'
على اليسار والمحور 'Hours Studied'
على اليمين.
google.charts.load('current', {'packages':['corechart', 'scatter']}); google.charts.setOnLoadCallback(drawStuff); function drawStuff() { var button = document.getElementById('change-chart'); var chartDiv = document.getElementById('chart_div'); var data = new google.visualization.DataTable(); data.addColumn('number', 'Student ID'); data.addColumn('number', 'Hours Studied'); data.addColumn('number', 'Final'); data.addRows([ [0, 0, 67], [1, 1, 88], [2, 2, 77], [3, 3, 93], [4, 4, 85], [5, 5, 91], [6, 6, 71], [7, 7, 78], [8, 8, 93], [9, 9, 80], [10, 10, 82], [11, 0, 75], [12, 5, 80], [13, 3, 90], [14, 1, 72], [15, 5, 75], [16, 6, 68], [17, 7, 98], [18, 3, 82], [19, 9, 94], [20, 2, 79], [21, 2, 95], [22, 2, 86], [23, 3, 67], [24, 4, 60], [25, 2, 80], [26, 6, 92], [27, 2, 81], [28, 8, 79], [29, 9, 83] ]); var materialOptions = { chart: { title: 'Students\' Final Grades', subtitle: 'based on hours studied' }, width: 800, height: 500, series: { 0: {axis: 'hours studied'}, 1: {axis: 'final grade'} }, axes: { y: { 'hours studied': {label: 'Hours Studied'}, 'final grade': {label: 'Final Exam Grade'} } } }; var classicOptions = { width: 800, series: { 0: {targetAxisIndex: 0}, 1: {targetAxisIndex: 1} }, title: 'Students\' Final Grades - based on hours studied', vAxes: { // Adds titles to each axis. 0: {title: 'Hours Studied'}, 1: {title: 'Final Exam Grade'} } }; function drawMaterialChart() { var materialChart = new google.charts.Scatter(chartDiv); materialChart.draw(data, google.charts.Scatter.convertOptions(materialOptions)); button.innerText = 'Change to Classic'; button.onclick = drawClassicChart; } function drawClassicChart() { var classicChart = new google.visualization.ScatterChart(chartDiv); classicChart.draw(data, classicOptions); button.innerText = 'Change to Material'; button.onclick = drawMaterialChart; } drawMaterialChart(); };
أهمّ المخططات X
ملاحظة: لا تتوفّر محاور الجزء العلوي من X إلا للرسوم البيانية الأساسية (أي تلك التي تحتوي على حزمة scatter
).
إذا كنت تريد وضع تصنيفات المحور "س" والعنوان في أعلى الرسم البياني بدلاً من أسفله، يمكنك إجراء ذلك في الرسومات البيانية المتعددة الأبعاد باستخدام الخيار axes.x
:
google.charts.load('current', {'packages':['scatter']}); google.charts.setOnLoadCallback(drawChart); function drawChart () { var data = new google.visualization.DataTable(); data.addColumn('number', 'Hours Studied'); data.addColumn('number', 'Final'); data.addRows([ [0, 67], [1, 88], [2, 77], [3, 93], [4, 85], [5, 91], [6, 71], [7, 78], [8, 93], [9, 80], [10, 82], [0, 75], [5, 80], [3, 90], [1, 72], [5, 75], [6, 68], [7, 98], [3, 82], [9, 94], [2, 79], [2, 95], [2, 86], [3, 67], [4, 60], [2, 80], [6, 92], [2, 81], [8, 79], [9, 83], [3, 75], [1, 80], [3, 71], [3, 89], [4, 92], [5, 85], [6, 92], [7, 78], [6, 95], [3, 81], [0, 64], [4, 85], [2, 83], [3, 96], [4, 77], [5, 89], [4, 89], [7, 84], [4, 92], [9, 98] ]); var options = { width: 800, height: 500, chart: { title: 'Students\' Final Grades', subtitle: 'based on hours studied' }, axes: { x: { 0: {side: 'top'} } } }; var chart = new google.charts.Scatter(document.getElementById('scatter_top_x')); chart.draw(data, google.charts.Scatter.convertOptions(options)); }
جارٍ التحميل
اسم الحزمة google.charts.load
هو "corechart"
، واسم فئة التمثيل البصري هو google.visualization.ScatterChart
.
google.charts.load("current", {packages: ["corechart"]});
var visualization = new google.visualization.ScatterChart(container);
بالنسبة إلى مخططات النقاط المبعثرة، يكون اسم حزمة google.charts.load
هو
"scatter"
، واسم فئة التمثيل البصري هو google.charts.Scatter
.
google.charts.load("current", {packages: ["scatter"]});
var visualization = new google.charts.Scatter(container);
تنسيق البيانات
الصفوف: يمثل كل صف في الجدول مجموعة من نقاط البيانات بقيمة المحور السيني نفسها.
الأعمدة:
العمود 0 | العمود 1 | ... | العمود N | |
---|---|---|---|---|
الغرض: | قيم نقطة البيانات "س" | قيم السلسلة Y من الفئة 1 | ... | قيم السلسلة N Y |
نوع البيانات: | سلسلة أو رقم أو تاريخ/تاريخ/وقت/يوم | سلسلة أو رقم أو تاريخ/تاريخ/وقت/يوم | ... | سلسلة أو رقم أو تاريخ/تاريخ/وقت/يوم |
الدور: | البيانات | البيانات | ... | البيانات |
أدوار الأعمدة الاختيارية: | بدون قفل |
... |
لتحديد سلسلة متعددة، حدِّد عمودين أو أكثر من أعمدة المحور "ص"، وحدّد قيم "ص" في عمود واحد فقط على شكل "ص":
قيم X | قيم السلسلة 1 Y | قيم السلسلة 2 Y |
---|---|---|
10 | قيمة فارغة | 75 |
20 | قيمة فارغة | 18 |
33 | قيمة فارغة | 22 |
55 | 16 | قيمة فارغة |
14 | 61 | قيمة فارغة |
48 | 3 | قيمة فارغة |
خيارات الضبط
الاسم | |
---|---|
هدف التجميع |
كيفية تجميع اختيارات البيانات المتعددة في تلميحات الأدوات:
غالبًا ما يتم استخدام
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', }; النوع: سلسلة
تلقائي: 'auto'
|
.GIF |
مدة الصورة المتحركة بالمللي ثانية. لمعرفة التفاصيل، يُرجى الاطّلاع على مستندات الصور المتحركة. النوع: الرقم
القيمة التلقائية: 0
|
رسم متحرك. |
دالة الإرخاء المطبَّقة على الحركة. تتوفّر الخيارات التالية:
النوع: سلسلة
افتراضي: "خطي"
|
تشغيل الصور المتحركة. |
لتحديد ما إذا كان الرسم المتحرك سيتحرك في الرسم الأولي. إذا كانت القيمة النوع: منطقي
افتراضي
|
تعليقات توضيحية.مربع النمط |
بالنسبة إلى الرسوم البيانية التي تتيح استخدام التعليقات التوضيحية، يتحكّم الكائن var options = { annotations: { boxStyle: { // Color of the box outline. stroke: '#888', // Thickness of the box outline. strokeWidth: 1, // x-radius of the corner curvature. rx: 10, // y-radius of the corner curvature. ry: 10, // Attributes for linear gradient fill. gradient: { // Start color for gradient. color1: '#fbf6a7', // Finish color for gradient. color2: '#33b679', // Where on the boundary to start and // end the color1/color2 gradient, // relative to the upper left corner // of the boundary. x1: '0%', y1: '0%', x2: '100%', y2: '100%', // If true, the boundary for x1, // y1, x2, and y2 is the box. If // false, it's the entire chart. useObjectBoundingBoxUnits: true } } } }; يتوفر هذا الخيار حاليًا للمخططات المساحية والشريطية والعمودية والسردية والخطية والنقاط المبعثرة. وهذا الإجراء غير متاح في الرسم البياني للتعليقات التوضيحية. النوع: الكائن
تلقائي: null
|
تعليقات توضيحية.مرجع |
بالنسبة إلى الرسوم البيانية التي تتيح استخدام
التعليقات التوضيحية،
يتيح لك الكائن
annotations.datum إلغاء اختيار
"المخطّطات من Google" للتعليقات التوضيحية المقدَّمة
لعناصر البيانات الفردية (مثل القيم التي تظهر مع كل شريط على الرسم البياني الشريطي). يمكنك التحكم في اللون باستخدام annotations.datum.stem.color ، وطول الجذعية باستخدام annotations.datum.stem.length ، والنمط باستخدام annotations.datum.style .
النوع: الكائن
تلقائي: اللون "أسود"، والطول 12، النمط هو "نقطة".
|
تعليقات توضيحية.نطاق |
بالنسبة إلى الرسوم البيانية التي تتيح استخدام
التعليقات التوضيحية،
يتيح لك الكائن
annotations.domain إلغاء
خيار "خرائط Google" للتعليقات التوضيحية المقدّمة لنطاق (المحور الرئيسي في الرسم البياني، مثل المحور "س" على رسم بياني خطي
عادي). يمكنك التحكم في اللون باستخدام annotations.domain.stem.color ، وطول الجذعية باستخدام annotations.domain.stem.length ، والنمط باستخدام annotations.domain.style .
النوع: الكائن
افتراضي: اللون "أسود"، والطول 5، النمط هو "نقطة".
|
تعليق توضيحي.highContrast |
بالنسبة إلى الرسوم البيانية التي تتيح
التعليقات التوضيحية،
تتيح لك العلامة المنطقية
annotations.highContrast إلغاء اختيار "رسومات Google البيانية"
للون التعليق التوضيحي. ويتم ضبط annotations.highContrast على "صحيح" تلقائيًا، ما يجعل
الرسوم البيانية تختار لون التعليق التوضيحي بدرجة تباين جيدة: الألوان الفاتحة على الخلفيات الداكنة
والألوان الداكنة على الإضاءة. إذا ضبطت السمة annotations.highContrast على "خطأ" ولم تحدّد
لون التعليق التوضيحي الخاص بك، ستستخدم مخططات Google لون السلسلة التلقائي الخاص بالتعليقات التوضيحية:
النوع: منطقي
افتراضي: صحيح
|
تعليقات توضيحية. |
بالنسبة إلى الرسوم البيانية التي تتيح
التعليقات التوضيحية،
يتيح لك الكائن
annotations.stem إلغاء
اختيار الرسوم البيانية في "مخططات Google" للنمط الجذري. يمكنك التحكم في اللون باستخدام annotations.stem.color وطول الجذعية باستخدام annotations.stem.length . يُرجى العِلم بأنّ خيار طول الجذع ليس له أي تأثير على التعليقات التوضيحية ذات النمط 'line' : بالنسبة إلى التعليقات التوضيحية للمرجع 'line' ، يكون طول الجذعية دائمًا مماثلاً للنص، وبالنسبة إلى التعليقات التوضيحية لنطاق 'line' ، يمتد الساق عبر المخطط بأكمله.
النوع: الكائن
افتراضي: اللون "أسود"، والطول 5 للتعليقات التوضيحية للنطاق و12 اللون للتعليقات التوضيحية المرجعة.
|
تعليقات توضيحية. |
بالنسبة إلى الرسوم البيانية التي تتيح
التعليقات التوضيحية،
يتيح لك الخيار
annotations.style إلغاء
اختيار نوع الرسوم التوضيحية في "مخطّطات Google". ويمكن أن تكون القيمة 'line' أو 'point' .
النوع: سلسلة
تلقائي: "نقطة"
|
تعليقات توضيحية.نمط النص |
بالنسبة إلى الرسوم البيانية التي تتيح استخدام التعليقات التوضيحية، يتحكّم العنصر
annotations.textStyle في مظهر نص التعليق التوضيحي:
var options = { annotations: { textStyle: { fontName: 'Times-Roman', fontSize: 18, bold: true, italic: true, // The color of the text. color: '#871b47', // The color of the text outline. auraColor: '#d799ae', // The transparency of the text. opacity: 0.8 } } }; يتوفر هذا الخيار حاليًا للمخططات المساحية والشريطية والعمودية والسردية والخطية والنقاط المبعثرة. لا يتوافق هذا الرسم البياني مع الرسم البياني للتعليقات التوضيحية. النوع: الكائن
تلقائي: null
|
موضع العناوين |
مكان وضع عناوين المحور، مقارنة بمنطقة المخطط. القيم المسموح بها:
النوع: سلسلة
تلقائي: "out"
|
لون الخلفية |
لون الخلفية للمنطقة الرئيسية من المخطط. يمكن أن تكون إما سلسلة لون HTML بسيطة، على سبيل المثال: النوع: سلسلة أو كائن
تلقائي: "أبيض"
|
backgroundColor.com |
لون حد المخطط، كسلسلة لون HTML. النوع: سلسلة
الافتراضي: '#666'
|
عرض لون الخلفية.الشطب |
عرض الحدود، بالبكسل. النوع: الرقم
القيمة التلقائية: 0
|
backgroundColor.fill |
لون تعبئة المخطط، كسلسلة لون HTML. النوع: سلسلة
تلقائي: "أبيض"
|
schema.title |
بالنسبة إلى مخططات المواد، يحدد هذا الخيار العنوان. النوع: سلسلة
تلقائي: null
|
مخطط فرعي |
بالنسبة إلى مخططات المواد، يحدد هذا الخيار العنوان الفرعي. لا تتيح سوى الرسوم البيانية المادية استخدام الترجمات المصاحبة. النوع: سلسلة
تلقائي: null
|
منطقة الرسم البياني |
كائن به أعضاء لضبط موضع وحجم منطقة الرسم البياني (حيث يتم رسم الرسم البياني نفسه، باستثناء المحور والتسمية التوضيحية). هناك تنسيقان متوافقان: رقم أو رقم متبوع بعلامة %. الرقم البسيط هو قيمة بوحدات البكسل، ويكون الرقم متبوعًا بعلامة النسبة المئوية نسبة مئوية. مثال: النوع: الكائن
تلقائي: null
|
لون الرسم البياني لمنطقة الخلفية |
لون خلفية منطقة الرسم البياني. عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل "#fdc") أو اسم اللون الإنجليزي. عند استخدام كائن، يمكن توفير الخصائص التالية:
النوع: سلسلة أو كائن
تلقائي: "أبيض"
|
منطقة الرسم البياني اليسرى |
مقدار رسم الرسم البياني من الحد الأيسر. النوع: رقم أو سلسلة
تلقائي: تلقائي
|
منطقة الرسم البياني العليا |
مقدار رسم المخطط من الحد العلوي. النوع: رقم أو سلسلة
تلقائي: تلقائي
|
مخطط منطقة العرض |
عرض منطقة الرسم البياني. النوع: رقم أو سلسلة
تلقائي: تلقائي
|
ارتفاع الرسم البياني |
رسم بياني لمنطقة ارتفاع. النوع: رقم أو سلسلة
تلقائي: تلقائي
|
ألوان |
الألوان التي يمكن استخدامها لعناصر الرسم البياني. مصفوفة من السلاسل، حيث يكون كل عنصر عبارة عن سلسلة لون HTML، على سبيل المثال: النوع: مصفوفة من السلاسل
الافتراضي: الألوان التلقائية
|
تقاطع |
تمثل هذه الخاصية كائنًا يحتوي على خصائص التقاطع للرسم البياني. النوع: الكائن
تلقائي: null
|
لون متقاطع |
اللون المتقاطع، ويُعبر عنه باسم لون (على سبيل المثال، "الأزرق") أو بقيمة نموذج أحمر أخضر أزرق (مثل "#adf"). النوع: سلسلة
النوع: التلقائي
|
التركيز على الشعر المتقاطع |
عنصر يحتوي على خصائص التقاطع عند التركيز. النوع: الكائن
افتراضي: تلقائي
|
تقاطع الشعر |
تعتيم التقاطع، مع إظهار النوع: الرقم
الإعداد التلقائي: 1.0
|
خطوط متقاطعة. |
الاتجاه المتقاطع، الذي يمكن أن يكون "رأسيًا" للشعر الرأسي فقط، أو "أفقيًا" للشعر الأفقي فقط، أو "كلاهما" للتقاطعات التقليدية. النوع: سلسلة
تلقائي: 'both'
|
تم التحديد |
كائن يحتوي على خصائص التقاطع عند التحديد. النوع: الكائن
افتراضي: تلقائي
|
تقاطع. |
وقت عرض المؤشر المتقاطع: على النوع: سلسلة
تلقائي: 'both'
|
نوع المنحنى |
يتحكم في منحنى الخطوط عندما لا يكون عرض الخط صفرًا. يمكن أن يكون واحدًا مما يلي:
النوع:سلسلة نصية
تلقائي: 'none'
|
تعتيم البيانات |
شفافية نقاط البيانات، حيث تكون القيمة 1.0 معتمة تمامًا و0.0 شفافة بالكامل. في الرسوم البيانية للنقاط المبعثرة والمدرّجة التكرارية والشريطية والعمودية، يشير ذلك إلى البيانات المرئية: النقاط في الرسم البياني للنقاط المبعثرة والمستطيلات في المناطق الأخرى. في الرسوم البيانية حيث يؤدي تحديد البيانات إلى إنشاء نقطة، مثل المخططات الخطية والمساحية، يشير هذا إلى الدوائر التي تظهر عند التمرير فوق النص أو عند تحديده. يعرض الرسم البياني للسلوك كلا السلوكين، ولن يكون لهذا الخيار أي تأثير في الرسوم البيانية الأخرى. (لتغيير مستوى تعتيم خط الاتجاه، يُرجى الاطّلاع على تعتيم خط الاتجاه .) النوع: الرقم
الإعداد التلقائي: 1.0
|
تفعيل التفاعل |
ما إذا كان الرسم البياني يعرض أحداثًا مستندة إلى المستخدمين أو يتفاعل مع تفاعل المستخدم. وفي حال اختيار القيمة "false"، لن يعرض الرسم البياني أحداث "اختيار" أو أحداث أخرى قائمة على التفاعل (ولكنه سيعرض أحداث جاهزة أو خطأ)، ولن يعرض نص تمرير النص أو سيتغيّر بناءً على إدخال المستخدم. النوع: منطقي
افتراضي: صحيح
|
مستكشِف |
يسمح الخيار هذه الميزة تجريبية وقد تتغير في الإصدارات المستقبلية. ملاحظة: لا يعمل المستكشف إلا مع المحاور المستمرة (مثل الأرقام أو التواريخ). النوع: الكائن
تلقائي: null
|
explorer.actions |
يتيح مستكشف مخططات Google ثلاثة إجراءات:
النوع: مصفوفة من السلاسل
الافتراضي: ['dragToPan', 'rightClickToReset']
|
محور المستكشف |
بشكل تلقائي، يمكن للمستخدمين التحريك أفقيًا ورأسيًا عند استخدام الخيار النوع: سلسلة
الوضع التلقائي:التحريك الأفقي والرأسي
|
explorer.keepInBounds |
بشكل تلقائي، يمكن للمستخدمين التحريك في جميع أنحاء المكان، بغض النظر عن مكان البيانات. وللتأكد من عدم تجاوز المستخدمين للرسم البياني خارج الرسم البياني الأصلي، استخدِم النوع: منطقي
تلقائي: خطأ
|
explorer.maxZoomIn |
الحد الأقصى الذي يمكن للمستكشف تكبيره. بشكل تلقائي، سيتمكّن المستخدمون من التكبير بشكلٍ كافٍ
لدرجة أنهم لن يشاهدوا سوى 25% من العرض الأصلي. يؤدي ضبط السياسة النوع: الرقم
القيمة التلقائية: 0.25
|
explorer.maxZoomOut |
الحد الأقصى الذي يمكن للمستكشف تصغيره. سيتمكّن المستخدمون تلقائيًا من التصغير
بما يكفي لأن يحتل الرسم البياني ثلث المساحة المتاحة فقط. من خلال ضبط السياسة النوع: الرقم
تلقائي: 4
|
explorer.zoomDelta |
عند إجراء المستخدمين للتكبير أو التصغير، تحدد النوع: الرقم
الإعداد التلقائي: 1.5
|
حجم الخط |
حجم الخط الافتراضي، بالبكسل، لكل النص في المخطط. يمكنك إلغاء هذا باستخدام الخصائص لعناصر معينة في الرسم البياني. النوع: الرقم
افتراضي: تلقائي
|
اسم الخط |
واجهة الخط الافتراضية لكل النص في المخطط. يمكنك إلغاء هذا باستخدام الخصائص لعناصر معينة في الرسم البياني. النوع: سلسلة
افتراضي: 'Arial'
|
فرض إطار |
لرسم المخطط داخل إطار مضمن. (تجدر الإشارة إلى أنه يتم تجاهل هذا الخيار في IE8، ويتم رسم جميع الرسوم البيانية لـ IE8 في إطارات i.) النوع: منطقي
تلقائي: خطأ
|
محور محوري |
كائن به أعضاء لتهيئة عناصر محور أفقية مختلفة. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن، كما هو موضّح هنا: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } النوع: الكائن
تلقائي: null
|
خط الأساس hAxis.base |
خط الأساس للمحور الأفقي. النوع: الرقم
افتراضي: تلقائي
|
لون hAxis.baseline |
لون خط الأساس للمحور الأفقي. يمكن أن تكون أي سلسلة لون HTML، مثل:
النوع: الرقم
افتراضي: "أسود"
|
hAxis.direction |
الاتجاه الذي تنمو فيه القيم على طول المحور الأفقي. حدِّد النوع: 1 أو -1
تلقائي: 1
|
تنسيق hAxis.format |
سلسلة تنسيق لتصنيفات المحاور الرقمية. هذه مجموعة فرعية من
مجموعة أنماط وحدة العناية المركزة
. على سبيل المثال، سيعرض
التنسيق الفعلي المطبّق على التصنيف مشتق من اللغة التي تم تحميل واجهة برمجة التطبيقات بها. لمزيد من التفاصيل، يمكنك الاطّلاع على تحميل الرسوم البيانية بلغة معيّنة .
عند احتساب قيم المؤشرات وخطوط الشبكة في الحوسبة، ستتم مراعاة عدة نُسخ بديلة من جميع خيارات خطوط الشبكة ذات الصلة، وسيتم رفض البدائل في حال تكرار تصنيفات المؤشرات التي تم تنسيقها أو التداخل معها.
لذلك، يمكنك تحديد النوع: سلسلة
تلقائي: تلقائي
|
خطوط hAxis.gridlines |
كائن له خصائص لضبط خطوط الشبكة على المحور الأفقي. لاحظ أنه يتم رسم خطوط الشبكة للمحور الأفقي رأسيًا. لتحديد خصائص هذا الكائن، يمكنك استخدام التدوين الحرفي للكائن، كما هو موضّح أدناه: {color: '#333', minSpacing: 20} النوع: الكائن
تلقائي: null
|
hAxis.gridlines.color |
لون خطوط الشبكة الأفقية داخل منطقة المخطط. حدد سلسلة لون HTML صالحة. النوع: سلسلة
الافتراضي: '#CCC'
|
hAxis.gridlines.count |
العدد التقريبي لخطوط الشبكة الأفقية داخل منطقة المخطط.
إذا حددت رقمًا موجبًا لـ النوع: الرقم
تلقائي: -1
|
وحدات hAxis.gridlines.units |
تلغي هذه السياسة التنسيق التلقائي لجوانب مختلفة من أنواع البيانات المتعلقة بالتاريخ/التاريخ والوقت/timedayday عند استخدامها مع خطوط الشبكة المحسوبة في رسم بياني. تسمح هذه السياسة بالتنسيق للسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية. التنسيق العام هو: 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*/]}, } } ويمكن العثور على معلومات إضافية في التواريخ والأوقات. النوع: الكائن
تلقائي: null
|
hAxis.minorGridlines |
كائن به أعضاء لضبط خطوط الشبكة الثانوية على المحور الأفقي، مثل خيار hAxis.gridlines. النوع: الكائن
تلقائي: null
|
hAxis.minorGridlines.color |
لون خطوط الشبكة الثانوية الأفقية داخل منطقة الرسم البياني. حدد سلسلة لون HTML صالحة. النوع: سلسلة
افتراضي: مزيج من خطوط الشبكة وألوان الخلفية
|
hAxis.minorGridlines.count |
يكون الخيار النوع: الرقم
تلقائي:1
|
وحدات hAxis.minorGridlines.units |
لإلغاء التنسيق التلقائي لمختلف جوانب أنواع البيانات التاريخ/التاريخ والوقت/timedayday عند استخدامها مع خطوط الشبكة التي تم حسابها من خلال الرسم البياني. تسمح هذه السياسة بالتنسيق للسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية. التنسيق العام هو: 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*/]}, } } ويمكن العثور على معلومات إضافية في التواريخ والأوقات. النوع: الكائن
تلقائي: null
|
hAxis.logScale |
الخاصية النوع: منطقي
تلقائي: خطأ
|
hAxis.scaleType |
خاصية
النوع: سلسلة
القيمة التلقائية: فارغة
|
hAxis.textPosition |
موضع نص المحور الأفقي، بالنسبة إلى منطقة المخطط. القيم المسموح بها: "out" و"in" و"none". النوع: سلسلة
تلقائي: "out"
|
hAxis.textStyle |
كائن يحدد نمط نص المحور الأفقي. ويكون الكائن بهذا التنسيق: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن يكون النوع: الكائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.ticks |
لاستبدال مؤشرات المحور السيني التي يتم إنشاؤها تلقائيًا بالمصفوفة المحددة. ويجب أن يكون كل عنصر من عناصر الصفيف إما قيمة صالحة صالحة للإشارة (مثل رقم أو تاريخ أو تاريخ ووقت أو يوم من اليوم) أو كائن. وإذا كان العنصر عبارة عن كائن، يجب أن يحتوي على السمة
وسيتم توسيع viewViewdow تلقائيًا لتضمين علامات الحد الأقصى والحد الأقصى إلا في حال تحديد أمثلة:
النوع: مصفوفة من العناصر
تلقائي: تلقائي
|
hAxis.title |
الخاصية النوع: سلسلة
تلقائي: null
|
hAxis.titleTextStyle |
كائن يحدد نمط نص عنوان المحور الأفقي. ويكون الكائن بهذا التنسيق: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن يكون النوع: الكائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.maxValue |
لنقل الحد الأقصى للمحور الأفقي إلى القيمة المحددة، سيكون هذا يمينًا في معظم الرسومات البيانية. يتم التجاهل إذا تم ضبط القيمة على قيمة أصغر من الحد الأقصى لقيمة x للبيانات.
يلغي النوع: الرقم
افتراضي: تلقائي
|
hAxis.minValue |
لنقل القيمة الدنيا للمحور الأفقي إلى القيمة المحددة، سيكون هذا لليسار في معظم الرسوم البيانية. يتم التجاهل إذا تم ضبط القيمة على قيمة أكبر من الحد الأدنى لقيمة x للبيانات.
يلغي النوع: الرقم
افتراضي: تلقائي
|
hAxis.viewWindowMode |
لتحديد كيفية تغيير حجم المحور الأفقي لعرض القيم داخل منطقة المخطط. تتوفّر قيم السلسلة التالية:
النوع: سلسلة
تلقائي:
مكافئة لـ "pretty"، ولكن يكون لـ
haxis.viewWindow.min وhaxis.viewWindow.max الأولوية في حال استخدامها.
|
hAxis.viewWindow |
لتحديد نطاق الاقتصاص للمحور الأفقي. النوع: الكائن
تلقائي: null
|
HAxis.viewWindow.max |
الحد الأقصى لقيمة البيانات الأفقية المطلوب عرضها. يتم التجاهل عندما تكون قيمة النوع: الرقم
تلقائي: تلقائي
|
hAxis.viewWindow.min |
الحد الأدنى لقيمة البيانات الأفقية المطلوب عرضها. يتم التجاهل عندما تكون قيمة النوع: الرقم
تلقائي: تلقائي
|
الارتفاع |
ارتفاع المخطط بالبكسل. النوع: الرقم
افتراضي: ارتفاع العنصر المضمن
|
أسطورة |
كائن به أعضاء لتهيئة جوانب مختلفة من التسمية التوضيحية. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن، كما هو موضّح هنا: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} النوع: الكائن
تلقائي: null
|
محاذاة |
محاذاة التسمية التوضيحية. يمكن أن يكون واحدًا مما يلي:
يرتبط كل من البداية والوسط والنهاية بنمط - رأسي أو أفقي - للتسمية التوضيحية. على سبيل المثال، في وسيلة إيضاح "اليمين" تكون "البدء" و"الانتهاء" في الجزء العلوي والسفلي على التوالي، وبالنسبة إلى وسيلة الإيضاح "أعلى" تكون "البدء" و"الانتهاء" في يسار ويمين المنطقة، على التوالي. وتعتمد القيمة الافتراضية على موضع التسمية التوضيحية. وبالنسبة إلى التعليقات التفسيرية "bottom"، تكون القيمة التلقائية هي "center"، بينما تكون القيمة التلقائية الأخرى هي "start". النوع: سلسلة
افتراضي: تلقائي
|
وسيلة الإيضاح.maxLines |
الحد الأقصى لعدد الأسطر في وسيلة الإيضاح. اضبط هذا الرقم على رقم أكبر من رقم واحد لإضافة أسطر إلى وسيلة الإيضاح. ملاحظة: المنطق الدقيق المُستخدَم لتحديد العدد الفعلي للخطوط المعروضة لا يزال في حالة تدفق. لا يعمل هذا الخيار حاليًا إلا عندما تكون وسيلة الإيضاح "top". النوع: الرقم
تلقائي: 1
|
مؤشر التسمية التوضيحية |
تم اختيار مبدئي فهرس الصفحات الصفري المستند إلى الصفر. النوع: الرقم
القيمة التلقائية: 0
|
وضع التسمية التوضيحية |
موضع التسمية التوضيحية. يمكن أن يكون واحدًا مما يلي:
النوع: سلسلة
تلقائي: 'يمين'
|
وسيلة الإيضاح |
كائن يحدد نمط نص التسمية التوضيحية. ويكون الكائن بهذا التنسيق: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن يكون النوع: الكائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
عرض الخط |
عرض الخط بالبكسل. استخدم الصفر لإخفاء كل الخطوط وعرض النقاط فقط. النوع: الرقم
القيمة التلقائية: 0
|
الاتجاه |
اتجاه المخطط. عند الضبط على النوع: سلسلة
تلقائي: "أفقية"
|
شكل نقطة |
شكل عناصر البيانات الفردية: "circle" أو "مثلث" أو "مربّع" أو "ألماس" أو "نجمة" أو "مضلع". يمكنك الاطّلاع على مستندات النقاط للحصول على أمثلة. النوع: سلسلة
افتراضي: 'circle'
|
حجم النقطة |
قطر نقاط البيانات، بالبكسل. استخدم الصفر لإخفاء كل النقاط. يمكنك إلغاء القيم لسلسلة بيانات فردية باستخدام السمة النوع: الرقم
الافتراضي: 7
|
النقاط المرئية |
لتحديد ما إذا كان سيتم عرض النقاط أم لا. اضبط القيمة على
ويمكن أيضًا تجاوز ذلك باستخدام
دور النمط على شكل
النوع: منطقي
افتراضي: صحيح
|
وضع التحديد |
عندما يكون النوع: سلسلة
تلقائي: "أغنية منفردة"
|
سلسلة |
مصفوفة من العناصر تصف كل منها تنسيق السلسلة المقابلة في الرسم البياني. لاستخدام قيم تلقائية لسلسلة، حدِّد كائنًا فارغًا {}. وإذا لم يتم تحديد سلسلة أو قيمة، سيتم استخدام القيمة العامة. يدعم كل كائن الخصائص التالية:
يمكنك تحديد مصفوفة من العناصر، ينطبق كل منها على السلسلة بالترتيب المحدد، أو يمكنك تحديد كائن يحتوي فيه كل طفل على مفتاح رقمي يشير إلى السلسلة التي ينطبق عليها. على سبيل المثال، البيانان التاليان متطابقان ويعلنان أن السلسلة الأولى سوداء ولا تتوفّر في وسيلة الإيضاح، والبيان الرابع على أنّه أحمر وغائب عن التسمية التوضيحية: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } النوع: مصفوفة من الكائنات أو كائن به كائنات مدمجة
تلقائي: {}
|
مظهر |
التصميم هو مجموعة من قيم الخيارات المحدّدة مسبقًا التي تعمل معًا لتحقيق سلوك محدّد للرسم البياني أو تأثير مرئي. لا يتوفر حاليًا سوى مظهر واحد:
النوع: سلسلة
تلقائي: null
|
العنوان |
النص المطلوب عرضه أعلى المخطط. النوع: سلسلة
تلقائي: بدون عنوان
|
titleالموضع |
مكان وضع عنوان المخطط، مقارنةً بمنطقة المخطط. القيم المسموح بها:
النوع: سلسلة
تلقائي: "out"
|
العنوانTextStyle |
كائن يحدد نمط نص العنوان. ويكون الكائن بهذا التنسيق: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن يكون النوع: الكائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
تلميح |
كائن به أعضاء لتهيئة عناصر تلميحات متنوعة. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن، كما هو موضح هنا: {textStyle: {color: '#FF0000'}, showColorCode: true} النوع: الكائن
تلقائي: null
|
tooltip.ignoreBounds |
في حال الضبط على ملاحظة: ينطبق هذا فقط على تلميحات HTML. في حال تفعيل هذا الخيار باستخدام تلميحات الأدوات بتنسيق SVG، سيتم اقتصاص أي تدفق خارج حدود الرسم البياني. ولمزيد من التفاصيل، يمكنك الاطّلاع على تخصيص محتوى التلميح. النوع: منطقي
تلقائي: خطأ
|
tooltip.isHtml |
في حال ضبطها على "صحيح"، استخدِم تلميحات الأدوات المعروضة بتنسيق HTML (بدلاً من ملفات SVG التي يتم عرضها). ولمزيد من التفاصيل، يمكنك الاطّلاع على تخصيص محتوى التلميح. ملاحظة: لا يمكن تخصيص محتوى تلميح HTML عبر دور بيانات عمود تلميحات الأدوات من خلال التمثيل البصري لمخطط الفقاعات التفسيرية. النوع: منطقي
تلقائي: خطأ
|
tooltip.showColorCode |
إذا كان ذلك صحيحًا، فاعرض المربعات الملونة بجوار معلومات السلسلة في تلميح الأداة. النوع: منطقي
تلقائي: خطأ
|
tooltip.textStyle |
كائن يحدد نمط نص التلميح. ويكون الكائن بهذا التنسيق: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن يكون النوع: الكائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.trigger |
تفاعل المستخدم الذي يتسبب في عرض التلميح:
النوع: سلسلة
تلقائي: "التركيز"
|
خطوط الاتجاه |
تعرض
خطوط الاتجاه
على الرسوم البيانية التي تدعمها. ويتم تلقائيًا استخدام خطوط الاتجاه الخطية، ولكن يمكن تخصيصه باستخدام الخيار
ويتم تحديد خطوط الاتجاه على أساس كل سلسلة، ولذلك ستبدو خياراتك في معظم الأوقات على النحو التالي: var options = { trendlines: { 0: { type: 'linear', color: 'green', lineWidth: 3, opacity: 0.3, showR2: true, visibleInLegend: true } } } النوع: الكائن
تلقائي: null
|
colorlines.n.color. |
لون خط الاتجاه ، ويُعبر عنه باسم لون إنجليزي أو سلسلة سداسية عشرية. النوع: سلسلة
تلقائي: لون السلسلة التلقائي
|
خطوط الاتجاه.n.degree |
بالنسبة إلى
خطوط الاتجاه
لـ النوع: الرقم
تلقائي: 3
|
Trendslines.n.labelInLegend |
في حال الضبط، سيظهر خط الاتجاه في وسيلة الإيضاح كسلسلة بيانات. النوع: سلسلة
تلقائي: null
|
عرض خطوط الاتجاه.n.line |
عرض خط خط الاتجاه بالبكسل. النوع: الرقم
تلقائي: 2
|
خطوط الاتجاه.n.opacity |
شفافية خط الاتجاه ، من 0.0 (شفاف) إلى 1.0 (غير شفاف). النوع: الرقم
الإعداد التلقائي: 1.0
|
خطوط الاتجاه.n.pointSize |
خطوط الاتجاه
يتم حصرها بختم مجموعة من النقاط على الرسم البياني، ويتيح لك هذا الخيار الذي نادرًا ما تحتاج إليه
تخصيص حجم النقاط. عادةً ما يكون خيار النوع: الرقم
تلقائي: 1
|
خطوط المؤشرات.n.النقاط المرئية |
خطوط الاتجاه
يتم ربطها بختم مجموعة من النقاط على الرسم البياني. يحدّد الخيار النوع: منطقي
افتراضي: صحيح
|
خطوط الاتجاه.n.showR2 |
يمكنك اختيار ما إذا كنت تريد عرض معامل التحديد في تلميح وسيلة الإيضاح أو خط الاتجاه. النوع: منطقي
تلقائي: خطأ
|
typelines.n.type |
ما إذا كانت
خطوط الاتجاه
هي النوع: سلسلة
افتراضي: خطي
|
لاين لاين |
يمكنك اختيار ما إذا كانت معادلة خط الاتجاه تظهر في وسيلة الإيضاح. (وسيظهر في تلميح خط الاتجاه.) النوع: منطقي
تلقائي: خطأ
|
محور محوري |
كائن به أعضاء لتهيئة عناصر محور رأسي متنوعة. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن، كما هو موضّح هنا: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} النوع: الكائن
تلقائي: null
|
إصدار vAxis.baseline |
الخاصية النوع: الرقم
افتراضي: تلقائي
|
لون vAxis.baseline |
تحدد لون خط الأساس للمحور العمودي. يمكن أن تكون أي سلسلة لون HTML، على سبيل المثال: النوع: الرقم
افتراضي: "أسود"
|
إصدار vAxis.direction |
الاتجاه الذي تنمو فيه القيم على طول المحور الرأسي. تظهر القيم المنخفضة في أسفل الرسم البياني تلقائيًا. حدِّد النوع: 1 أو -1
تلقائي: 1
|
تنسيق vAxis. |
سلسلة تنسيق لتصنيفات المحاور الرقمية. هذه مجموعة فرعية من
مجموعة أنماط وحدة العناية المركزة
.
على سبيل المثال، سيعرض
التنسيق الفعلي المطبّق على التصنيف مشتق من اللغة التي تم تحميل واجهة برمجة التطبيقات بها. لمزيد من التفاصيل، يمكنك الاطّلاع على تحميل الرسوم البيانية بلغة معيّنة .
عند احتساب قيم المؤشرات وخطوط الشبكة في الحوسبة، ستتم مراعاة عدة نُسخ بديلة من جميع خيارات خطوط الشبكة ذات الصلة، وسيتم رفض البدائل في حال تكرار تصنيفات المؤشرات التي تم تنسيقها أو التداخل معها.
لذلك، يمكنك تحديد النوع: سلسلة
تلقائي: تلقائي
|
خطوط vAxis.gridlines |
كائن به أعضاء لضبط خطوط الشبكة على المحور الرأسي. لاحظ أنه يتم رسم خطوط الشبكة للمحور العمودي أفقيًا. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن، كما هو موضّح هنا: {color: '#333', minSpacing: 20} النوع: الكائن
تلقائي: null
|
vAxis.gridlines.color |
لون خطوط الشبكة الرأسية داخل منطقة المخطط. حدد سلسلة لون HTML صالحة. النوع: سلسلة
الافتراضي: '#CCC'
|
vAxis.gridlines.count |
العدد التقريبي لخطوط الشبكة الأفقية داخل منطقة المخطط.
إذا حددت رقمًا موجبًا لـ النوع: الرقم
تلقائي: -1
|
وحدات vAxis.gridlines.units |
تلغي هذه السياسة التنسيق التلقائي لجوانب مختلفة من أنواع البيانات المتعلقة بالتاريخ/التاريخ والوقت/timedayday عند استخدامها مع خطوط الشبكة المحسوبة في رسم بياني. تسمح هذه السياسة بالتنسيق للسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية. التنسيق العام هو: 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*/]} } } ويمكن العثور على معلومات إضافية في التواريخ والأوقات. النوع: الكائن
تلقائي: null
|
vAxis.minorGridlines |
كائن به أعضاء لضبط خطوط الشبكة الثانوية على المحور الرأسي، على غرار خيار vAxis.gridlines. النوع: الكائن
تلقائي: null
|
vAxis.minorGridlines.color |
لون خطوط الشبكة الرأسية داخل منطقة المخطط. حدد سلسلة لون HTML صالحة. النوع: سلسلة
افتراضي: مزيج من خطوط الشبكة وألوان الخلفية
|
vAxis.minorGridlines.count |
غالبًا ما يتم إيقاف الخيار GridGridlines.count، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل الزمني بين خطوط الشبكة الرئيسية (يُرجى الاطِّلاع على vAxis.gridlines.interval) والحد الأدنى من المساحة المطلوبة (يمكنك الاطّلاع على vAxis.minorGridlines.minSpacing). النوع: الرقم
تلقائي: 1
|
وحدات vAxis.minorGridlines.units |
لإلغاء التنسيق التلقائي لمختلف جوانب أنواع البيانات التاريخ/التاريخ والوقت/timedayday عند استخدامها مع خطوط الشبكة التي تم حسابها من خلال الرسم البياني. تسمح هذه السياسة بالتنسيق للسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية. التنسيق العام هو: 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*/]}, } } ويمكن العثور على معلومات إضافية في التواريخ والأوقات. النوع: الكائن
تلقائي: null
|
vAxis.logScale |
إذا كانت القيمة true، سيتم تحويل المحور الرأسي إلى مقياس لوغاريتمي. ملاحظة: يجب أن تكون جميع القيم موجبة. النوع: منطقي
تلقائي: خطأ
|
vAxis.scaleType |
الخاصية
النوع: سلسلة
تلقائي: null
|
vAxis.textPosition |
موضع نص المحور الرأسي بالنسبة إلى منطقة المخطط. القيم المسموح بها: "out" و"in" و"none". النوع: سلسلة
تلقائي: "out"
|
vAxis.textStyle |
كائن يحدد نمط نص المحور العمودي. ويكون الكائن بهذا التنسيق: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن يكون النوع: الكائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
الإصدار vAxis.ticks |
لاستبدال علامات المحور الصادي التي يتم إنشاؤها تلقائيًا بالمصفوفة المحددة. ويجب أن يكون كل عنصر من عناصر الصفيف إما قيمة صالحة صالحة للإشارة (مثل رقم أو تاريخ أو تاريخ ووقت أو يوم من اليوم) أو كائن. وإذا كان العنصر عبارة عن كائن، يجب أن يحتوي على الخاصية
وسيتم توسيع viewViewdow تلقائيًا لتضمين علامات الحد الأقصى والحد الأقصى إلا في حال تحديد أمثلة:
النوع: مصفوفة من العناصر
تلقائي: تلقائي
|
عنوان vAxis.title |
الخاصية النوع: سلسلة
تلقائي: بدون عنوان
|
vAxis.titleTextStyle |
كائن يحدد نمط نص عنوان المحور الرأسي. ويكون الكائن بهذا التنسيق: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
يمكن أن يكون النوع: الكائن
تلقائي:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.maxValue |
لنقل الحد الأقصى لقيمة المحور الرأسي إلى القيمة المحددة، سيكون هذا أعلى في معظم الرسوم البيانية. يتم التجاهل إذا تم ضبط القيمة على قيمة أصغر من الحد الأقصى لقيمة "ص" للبيانات.
يلغي النوع: الرقم
افتراضي: تلقائي
|
vAxis.minValue |
لنقل القيمة الدنيا للمحور العمودي إلى القيمة المحددة، سيكون هذا أقل في معظم الرسومات البيانية. يتم التجاهل إذا تم ضبط القيمة على قيمة أكبر من الحد الأدنى لقيمة "ص" للبيانات.
يلغي النوع: الرقم
تلقائي: null
|
vAxis.viewWindowMode |
لتحديد كيفية تغيير حجم المحور الرأسي لعرض القيم ضمن منطقة المخطط. تتوفّر قيم السلسلة التالية:
النوع: سلسلة
تلقائي:
مكافئة لـ "pretty"، ولكن يكون لـ
vaxis.viewWindow.min وvaxis.viewWindow.max الأولوية في حال استخدامها.
|
vAxis.viewWindow |
لتحديد نطاق الاقتصاص للمحور العمودي. النوع: الكائن
تلقائي: null
|
vAxis.viewWindow.max |
الحد الأقصى لقيمة بيانات القطاعات المطلوب عرضها. يتم التجاهل عندما تكون قيمة النوع: الرقم
تلقائي: تلقائي
|
vAxis.viewWindow.min |
الحد الأدنى لقيمة بيانات القطاعية المطلوب عرضها. يتم التجاهل عندما تكون قيمة النوع: الرقم
تلقائي: تلقائي
|
width |
عرض المخطط بالبكسل. النوع: الرقم
افتراضي: عرض العنصر المضمن
|
الطرق
الطريقة | |
---|---|
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) |
لعرض الإحداثي الصادي لبكسل وحدة البكسل مثال: وعليك باستدعاء هذا بعد رسم المخطط. نوع الإرجاع: رقم
|
removeAction(actionID) |
إزالة إجراء تلميح الأداة نوع الإرجاع:
none |
setAction(action) |
تُحدِّد إجراء تلميح لتنفيذه عندما ينقر المستخدم على نص الإجراء.
تستخدم الطريقة
يجب ضبط جميع إجراءات التلميحات قبل استدعاء طريقة الرسم البياني نوع الإرجاع:
none |
setSelection() |
لاختيار كيانات الرسم البياني المحددة. لإلغاء أي اختيار سابق.
الكيانات القابلة للتحديد هي نقاط وإدخالات تسمية توضيحية.
تتطابق نقطة مع خلية في جدول البيانات، وإدخال تسمية توضيحية إلى عمود (فهرس الصف فارغ).
بالنسبة إلى هذا الرسم البياني، لا يمكن اختيار سوى كيان واحد في كل مرة.
نوع الإرجاع: لا شيء
|
clearChart() |
محو الرسم البياني وإصدار جميع الموارد المخصّصة له نوع الإرجاع: لا شيء
|
الأحداث
للحصول على مزيد من المعلومات عن كيفية استخدام هذه الأحداث، يمكنك الاطّلاع على التفاعل الأساسي والتعامل مع الأحداث وتنشيط الأحداث.
الاسم | |
---|---|
animationfinish |
يتم الإطلاق عند اكتمال الرسوم المتحركة للنقل. الخصائص: بلا
|
click |
يتم الإطلاق عندما ينقر المستخدم داخل الرسم البياني. ويمكن استخدامها لتحديد وقت النقر على العنوان أو عناصر البيانات أو إدخالات وسيلة الإيضاح أو المحاور أو خطوط الشبكة أو التصنيفات. الخصائص: targetID
|
error |
يتم الإطلاق عند حدوث خطأ عند محاولة عرض الرسم البياني. الخصائص: رقم التعريف، الرسالة
|
legendpagination |
يتم الإطلاق عندما ينقر المستخدم على أسهم ترقيم الصفحات. لإرجاع فهرس الصفحة الحالي المستند إلى الصفر وإجمالي عدد الصفحات. الخصائص: currentPageIndex, totalPages
|
onmouseover |
يتم الإطلاق عندما يمرر المستخدم الماوس فوق وحدة مرئية. لإرجاع فهارس الصفوف والأعمدة الخاصة بعنصر جدول البيانات المقابل. الخصائص: صف، عمود
|
onmouseout |
يتم الإطلاق عندما يمرر المستخدم بعيدًا عن وحدة مرئية. لإرجاع فهارس الصفوف والأعمدة الخاصة بعنصر جدول البيانات المقابل. الخصائص: صف، عمود
|
ready |
المخطط جاهز لاستدعاءات الطرق الخارجية. إذا كنت تريد التفاعل مع الرسم البياني وطرق الاتصال بعد رسمه، عليك إعداد مستمع لهذا الحدث قبل طلب طريقة الخصائص: بلا
|
select |
يتم الإطلاق عندما ينقر المستخدم على كيان مرئي. للاطّلاع على ما تم اختياره، يمكنك الاتصال
الخصائص: بلا
|
سياسة البيانات
تتم معالجة جميع الرموز والبيانات وعرضها في المتصفح. ولا يتم إرسال أي بيانات إلى أي خادم.