التصور: مخطط مساحي

• 'category': تجميع البيانات المحدّدة حسب القيمة س
• 'series': تجميع البيانات المحدّدة حسب السلسلة
• 'auto': تجميع البيانات المحددة حسب القيمة "س" إذا كانت جميع الاختيارات تحتوي على قيمة x نفسها، وحسب السلسلة في الحالات الأخرى.
• 'none': عرض تلميح واحد فقط لكل اختيار.

var options = {
  // Allow multiple
  // simultaneous selections.
  selectionMode: 'multiple',
  // Trigger tooltips
  // on selections.
  tooltip: {trigger: 'selection'},
  // Group selections
  // by x-value.
  aggregationTarget: 'category',
};
    

مدة الحركة بالمللي ثانية. لمعرفة التفاصيل، يمكنك الاطّلاع على مستندات الصور المتحركة.

دالة التخفيف المطبقة على الصورة المتحركة. تتوفّر الخيارات التالية:

• "خطي" - سرعة ثابتة
• "داخل" - إرخاء في البدء - البدء ببطء والسرعة.
• "إنهاء" - إرخاء - البدء بسرعة وتبطئ.
• "inAndOut" - يبدأ العمل ببطء ويبدأ بالسرعة ثم بطئ.

تحدِّد هذه السياسة ما إذا كان الرسم البياني سيتم تحريكه عند الرسم الأولي. إذا كانت القيمة true، سيبدأ الرسم البياني عند خط الأساس، وسيتحرك إلى حالته النهائية.

بالنسبة إلى الرسوم البيانية التي تتيح استخدام التعليقات التوضيحية، يتحكّم الكائن annotations.boxStyle في مظهر المربعات المحيطة بالتعليقات التوضيحية:

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
      }
    }
  }
};
    

هذا الخيار متاح حاليًا للمخططات المساحية والشريطية والعمودية والمختلطة والخطية والمخطَّطات المبعثرة. ولا يتوافق مع الرسم البياني للتعليقات التوضيحية.

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
    }
  }
};
    

هذا الخيار متاح حاليًا للمخططات المساحية والشريطية والعمودية والمختلطة والخطية والمخطَّطات المبعثرة. ولا يتوافق مع الرسم البياني للتعليقات التوضيحية .

التعتيم التلقائي للمساحة الملونة ضمن سلسلة الرسم البياني المساحي، حيث تكون القيمة 0.0 شفافًا تمامًا و1.0 معتمة بالكامل لتحديد التعتيم لسلسلة فردية، اضبط قيمة تعتيم المنطقة في السمة series.

مكان وضع عناوين المحاور، مقارنة بمساحة الرسم البياني. القيم المسموح بها:

• in - ارسم عناوين المحاور داخل منطقة المخطط.
• out - رسم عناوين المحاور خارج مساحة المخطط.
• بلا - حذف عناوين المحاور.

لون الخلفية للمنطقة الرئيسية من الرسم البياني. يمكن أن تكون إما سلسلة لون HTML بسيطة، على سبيل المثال: 'red' أو '#00cc00'، أو كائنًا بالسمات التالية.

لون حد الرسم البياني، كسلسلة لون HTML.

عرض الحدود بالبكسل.

لون تعبئة الرسم البياني، كسلسلة لون HTML.

كائن يحتوي على أعضاء لضبط موضع مساحة الرسم البياني وحجمها (حيث يتم رسم الرسم البياني نفسه، باستثناء المحور ووسائل الإيضاح). يمكنك استخدام تنسيقَين: رقم أو رقم متبوعًا بنسبة مئوية. والرقم البسيط هو قيمة بالبكسل، بينما يمثّل الرقم متبوعًا بنسبة مئوية نسبة مئوية. مثلاً: chartArea:{left:20,top:0,width:'50%',height:'75%'}

• stroke: اللون، يتم تقديمه كسلسلة سداسية عشرية أو اسم اللون الإنجليزي.
• strokeWidth: في حال توفّره، يتم رسم حدود حول مساحة الرسم البياني للعرض المحدَّد (وبلون stroke).

مقدار المسافة لرسم الرسم البياني من الحد الأيسر.

مقدار المسافة لرسم الرسم البياني من الحد العلوي.

عرض مساحة الرسم البياني

ارتفاع مساحة الرسم البياني

الألوان المراد استخدامها لعناصر الرسم البياني تمثّل هذه السمة مصفوفة من السلاسل يكون فيها كل عنصر سلسلة لون HTML، على سبيل المثال: colors:['red','#004411'].

تمثّل هذه السمة كائنًا يحتوي على سمات الشعر المتقاطع للرسم البياني.

لون الشعر المتقاطع، معبرًا عنه إما باسم لون (على سبيل المثال، "أزرق") أو قيمة نموذج أحمر أخضر أزرق (مثل، "#adf").

كائن يحتوي على خصائص المؤشر المتقاطع عند التركيز عليه
مثال: crosshair: { focused: { color: '#3bc', opacity: 0.8 } }

تعتيم الشعر المتقاطع، وتكون 0.0 شفافة تمامًا و1.0 معتمة تمامًا.

اتجاه المؤشر المتقاطع الذي يمكن أن يكون "عموديًا" للشعر الرأسي فقط أو "أفقي" للشعر الأفقي فقط أو "كلاهما" للشعر المتقاطع التقليدي.

كائن يحتوي على خصائص المؤشر المتقاطع عند التحديد.
مثال: crosshair: { selected: { color: '#3bc', opacity: 0.8 } }

وقت عرض المؤشر المتقاطع: في 'focus' أو 'selection' أو 'both'.

شفافية نقاط البيانات، حيث تكون القيمة 1.0 معتمة تمامًا و0.0 شفافة تمامًا. في المخططات المبعثرة والمدرج التكراري والشريطي والعمودي، يشير ذلك إلى البيانات المرئية: النقاط في الرسم البياني بالنقاط المبعثرة والمستطيلات في الأخرى. في الرسوم البيانية التي يؤدي فيها اختيار البيانات إلى إنشاء نقطة، مثل الرسوم البيانية الخطية والمساحية، يشير هذا الحقل إلى الدوائر التي تظهر عند التمرير أو الاختيار. يُظهر الرسم البياني المختلط السلوكَين، وليس لهذا الخيار أي تأثير في الرسوم البيانية الأخرى. (لتغيير مستوى تعتيم خط الاتجاه، اطّلِع على تعتيم خط الاتجاه ).

ما إذا كان الرسم البياني يعرض أحداثًا مستندة إلى المستخدمين أو يتفاعل مع تفاعل المستخدم إذا كانت القيمة "false"، لن يعرض الرسم البياني الأحداث "select" أو غيرها من الأحداث المستندة إلى التفاعل (ولكنه سيعرض أحداثًا جاهزة أو يعرض أخطاء)، ولن يعرض النصّ التمريري أو يتغيّر استنادًا إلى البيانات التي أدخلها المستخدِم.

يتيح الخيار explorer للمستخدمين تحريك الرسوم البيانية في Google وتكبيرها أو تصغيرها. يوفّر explorer: {} سلوك المستكشف التلقائي، ما يتيح للمستخدمين تحريك أفقيًا وعموديًا عن طريق السحب، والتكبير والتصغير من خلال التمرير.

هذه الميزة تجريبية وقد تتغير في إصدارات مستقبلية.

ملاحظة: لا يعمل المستكشف إلا مع المحاور المتصلة (مثل الأرقام أو التواريخ).

يدعم مستكشف مخططات Google ثلاثة إجراءات:

• dragToPan: اسحب للتحريك حول الرسم البياني أفقيًا وعموديًا. للتحريك على طول المحور الأفقي فقط، استخدِم explorer: { axis: 'horizontal' }. وبالمثل بالنسبة للمحور الرأسي.
• dragToZoom: السلوك التلقائي للمستكشف هو التكبير والتصغير عند انتقال المستخدم في الصفحة. في حال استخدام explorer: { actions: ['dragToZoom', 'rightClickToReset'] }، يؤدي السحب على مساحة مستطيلة إلى تكبير تلك المنطقة. وننصح باستخدام السمة rightClickToReset عند استخدام السمة dragToZoom. يمكنك الاطّلاع على explorer.maxZoomIn وexplorer.maxZoomOut وexplorer.zoomDelta للحصول على تخصيصات للتكبير أو التصغير.
• rightClickToReset: يؤدي النقر بزر الماوس الأيمن على الرسم البياني إلى إعادته إلى مستوى التحريك والتكبير/التصغير الأصليَين.

وفقًا للإعدادات التلقائية، يمكن للمستخدمين التحريك أفقيًا وعموديًا عند استخدام الخيار explorer. إذا كنت تريد أن يجري المستخدمون العرض الشامل أفقيًا فقط، استخدِم explorer: { axis: 'horizontal' }. وبالمثل، تعمل ميزة explorer: { axis: 'vertical' } على تفعيل العرض الشامل العمودي فقط.

تلقائيًا، يمكن للمستخدمين التحريك في كل مكان، بغض النظر عن مكان البيانات. لضمان عدم استخدام المستخدمين أي عرض شامل خارج الرسم البياني الأصلي، استخدِم explorer: { keepInBounds: true }.

الحد الأقصى الذي يمكن للمستكشف تكبيره. سيتمكّن المستخدمون تلقائيًا من التكبير بما يكفي لمشاهدة% 25 فقط من العرض الأصلي. يؤدي ضبط explorer: { maxZoomIn: .5 } إلى السماح للمستخدمين بالتكبير بعيدًا بما يكفي لمشاهدة نصف العرض الأصلي.

الحد الأقصى الذي يمكن للمستكشف تصغيره. تلقائيًا، سيتمكّن المستخدمون من التصغير إلى حد كبير بما يكفي لأن يشغل الرسم البياني 1/4 المساحة المتاحة فقط. في حال ضبط السمة explorer: { maxZoomOut: 8 }، يتم السماح للمستخدمين بالتصغير بشكل كافٍ كي يشغل الرسم البياني 1/8 المساحة المتاحة فقط.

عندما يقوم المستخدمون بالتكبير أو التصغير، تحدِّد explorer.zoomDelta مقدار التكبير أو التصغير. كلما كان الرقم أصغر، كان التكبير والتصغير أكثر سلاسة وبطئًا.

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

• "المرجع": التركيز على نقطة بيانات واحدة يرتبط بخلية في جدول البيانات.
• "الفئة" - التركيز على مجموعة من جميع نقاط البيانات على طول المحور الرئيسي. يرتبط بصف في جدول البيانات.

في viewTarget "category" (الفئة)، يعرِض التلميح جميع قيم الفئة. قد يكون هذا مفيدًا في مقارنة قيم سلاسل مختلفة.

حجم الخط الافتراضي بالبكسل لجميع النص في الرسم البياني. ويمكنك إلغاء هذا الإجراء باستخدام سمات لعناصر محدَّدة في الرسم البياني.

واجهة الخط التلقائية لكل النص في الرسم البياني ويمكنك إلغاء هذا الإجراء باستخدام سمات لعناصر محدَّدة في الرسم البياني.

لرسم الرسم البياني داخل إطار مضمّن. (يُرجى ملاحظة أنّه في IE8، يتم تجاهل هذا الخيار، ويتم رسم كل مخططات IE8 بالإطارات i-frames).

كائن يحتوي على أعضاء لضبط عناصر متعددة للمحور الأفقي. لتحديد خصائص هذا الكائن، يمكنك استخدام التدوين الحرفي للكائن، كما هو موضّح هنا:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    

الخط القاعدي للمحور الأفقي.

هذا الخيار متاح فقط لمحور continuous.

لون الخط القاعدي للمحور الأفقي. يمكن أن تكون أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'.

هذا الخيار متاح فقط لمحور continuous.

الاتجاه الذي تنمو به القيم على طول المحور الأفقي. حدِّد -1 لعكس ترتيب القيم.

سلسلة تنسيق لتصنيفات المحور الرقمي أو محور التاريخ.

بالنسبة إلى تصنيفات محور الأرقام، هذه مجموعة فرعية من التنسيق العشري مجموعة أنماط ICU . على سبيل المثال، سيعرض {format:'#,###%'} القيم "1,000%" و"750%" و "50%" للقيم 10 و7.5 و0.5. ويمكنك أيضًا توفير أيٍّ مما يلي:

• {format: 'none'}: يعرض أرقامًا بدون تنسيق (مثل 8000000)
• {format: 'decimal'}: تعرض الأرقام مع فواصل الآلاف (مثل 8,000,000)
• {format: 'scientific'}: يعرض الأرقام بالترميز العلمي (مثل 8e6)
• {format: 'currency'}: يعرض الأرقام بالعملة المحلية (مثل 8,000,000.00 دولار)
• {format: 'percent'}: يعرض الأرقام كنسب مئوية (مثل 800,000,000%)
• {format: 'short'}: يعرض الأرقام المختصرة (مثل 8 مليون)
• {format: 'long'}: يعرض الأرقام ككلمات كاملة (مثل 8 مليون)

بالنسبة إلى تصنيفات محور التاريخ، هذه مجموعة فرعية من تنسيق التاريخ تم ضبط أنماط ICU . على سبيل المثال، سيعرض {format:'MMM d, y'} القيمة "1 تموز (يوليو) 2011" للتاريخ الذي سيكون أول تموز (يوليو) 2011 هو الأول.

يتم اشتقاق التنسيق الفعلي المطبَّق على التصنيف من اللغة التي تم تحميل واجهة برمجة التطبيقات بها. لمزيد من التفاصيل، راجِع تحميل الرسوم البيانية بلغة معيّنة .

عند احتساب قيم التجزئة وخطوط الشبكة، سيتم النظر في عدة مجموعات بديلة من جميع خيارات خطوط الشبكة ذات الصلة وسيتم رفض البدائل إذا كانت تصنيفات علامات التجزئة المنسَّقة مكرّرة أو متداخلة. يمكنك تحديد format:"#" إذا كنت تريد عرض قيم علامات الأعداد الصحيحة فقط، ولكن انتبه إلى أنّه في حال عدم استيفاء أي بديل لهذا الشرط، لن يتم عرض أي خطوط للشبكة أو علامات.

هذا الخيار متاح فقط للمحور continuous.

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

{color: '#333', minSpacing: 20}

هذا الخيار متاح فقط للمحور continuous.

لون خطوط الشبكة الأفقية داخل منطقة الرسم البياني. حدِّد سلسلة لون HTML صالحة.

العدد التقريبي لخطوط الشبكة الأفقية داخل منطقة الرسم البياني. إذا حدّدت رقمًا موجبًا في السمة gridlines.count، سيتم استخدامه لاحتساب قيمة السمة minSpacing بين خطوط الشبكة. يمكنك تحديد القيمة 1 لرسم خط شبكة واحد فقط، أو 0 لرسم أي خطوط شبكة. حدِّد -1، وهو الإعداد التلقائي، لاحتساب عدد خطوط الشبكة تلقائيًا استنادًا إلى خيارات أخرى.

تمثّل هذه السمة مصفوفة من الأحجام (كقيم بيانات، وليس وحدات بكسل) بين خطوط الشبكة المجاورة. هذا الخيار مخصّص فقط للمحاور الرقمية في الوقت الحالي، ولكنّه مماثل لخيارات gridlines.units.<unit>.interval التي تُستخدم فقط للتواريخ والأوقات. بالنسبة إلى المقاييس الخطية، تكون القيمة التلقائية [1, 2, 2.5, 5]، ما يعني أنّ قيم خط الشبكة يمكن أن تقع على كل وحدة (1) أو في الوحدات الزوجية (2) أو مضاعفات 2.5 أو 5. ويتم أيضًا احتساب أيّ أس 10 أضعاف هذه القيم (مثل [10، 20، 25، 50] و[ .1، .2، .25، 5.]). وبالنسبة إلى المقاييس السجّلية، تكون القيمة التلقائية هي [1, 2, 5].

الحد الأدنى لمساحة الشاشة بالبكسل بين خطوط الشبكة الرئيسية ذات المحور السداسي الإعداد التلقائي لخطوط الشبكة الرئيسية هو 40 للمقاييس الخطّية، و20 للمقاييس اللوغاريتمية. إذا حددت count وليس minSpacing، يتم احتساب minSpacing من العدد. وفي المقابل، إذا حددت minSpacing وليس count، يتم احتساب العدد من minSpacing. وإذا حددت كليهما، سيتم إلغاء سياسة minSpacing.

يجب أن تكون جميع قيم خطوط الشبكة ومؤشرات التجزئة مضاعفًا لقيمة هذا الخيار. يُرجى العلم أنّه على عكس الفواصل، لا يتم اعتبار القوى التي تبلغ 10 أضعاف المضاعفات. وبالتالي، يمكنك أن تفرض أن تكون قيم المؤشرات أعدادًا صحيحة من خلال تحديد gridlines.multiple = 1، أو أن تفرض أن تكون علامات التجزئة مضاعفات العدد 1000 من خلال تحديد gridlines.multiple = 1000.

لإلغاء التنسيق التلقائي لجوانب مختلفة من أنواع بيانات التاريخ/التاريخ/الوقت في اليوم عند استخدامها مع خطوط الشبكة المحسوبة في الرسم البياني. تتيح التنسيق بالسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية.

التنسيق العام هو:

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*/]},
  }
}
    

يمكنك الاطّلاع على معلومات إضافية في التواريخ والأوقات.

كائن يحتوي على أعضاء لضبط خطوط الشبكة الصغيرة على المحور الأفقي، على غرار الخيار hAxis.gridlines.

هذا الخيار متاح فقط للمحور continuous.

لون خطوط الشبكة الصغيرة الأفقية داخل منطقة الرسم البياني. حدِّد سلسلة لون HTML صالحة.

يتم إيقاف الخيار minorGridlines.count نهائيًا في أغلب الأحيان، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الصغيرة الآن كليًا على الفاصل بين خطوط الشبكة الرئيسية (راجِع hAxis.gridlines.interval) والحد الأدنى للمساحة المطلوبة (راجِع hAxis.minorGridlines.minSpacing).

يشبه الخيار miniGrids.interval خيار الفاصل الزمني لخطوط الشبكة الرئيسية، ولكن الفاصل الزمني الذي يتم اختياره سيكون دائمًا قاسمًا متساويًا للفاصل الزمني لخط الشبكة الرئيسي. الفاصل التلقائي للمقاييس الخطية هو [1, 1.5, 2, 2.5, 5]، والفاصل الزمني التلقائي هو [1, 2, 5].

تمثّل هذه السمة الحد الأدنى للمساحة المطلوبة بالبكسل، وبين خطوط الشبكة الصغيرة المجاورة، وبين خطوط الشبكة الثانوية والكبيرة. القيمة التلقائية هي 1/2 من الحد الأدنى لتباعد خطوط الشبكة الرئيسية للمقاييس الخطية، و1/5 من المسافة الدقيقة للمقاييس اللوغاريتمية.

كما هو الحال مع gridlines.multiple الرئيسي.

تلغي هذه العلامة التنسيق التلقائي لجوانب مختلفة من أنواع بيانات التاريخ/التاريخ/الوقت في اليوم عند استخدامها مع الخطوط الصغيرة المحسوبة في الرسم البياني. تتيح التنسيق بالسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية.

التنسيق العام هو:

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*/]},
  }
}
    

يمكنك الاطّلاع على معلومات إضافية في التواريخ والأوقات.

سمة hAxis تجعل المحور الأفقي عبارة عن مقياس لوغاريتمي (يجب أن تكون جميع القيم موجبة). قم بتعيينها على true لنعم.

هذا الخيار متاح فقط لمحور continuous.

السمة hAxis التي تجعل المحور الأفقي عبارة عن مقياس لوغاريتمي. يمكن أن تكون الحالة واحدة مما يلي:

• فارغ - لم يتم تنفيذ تحجيم لوغاريتمي.
• "السجل" - التحجيم اللوغاريتمي. لا يتم رسم القيم السالبة والصفرية. هذا الخيار مماثل للإعداد hAxis: { logscale: true }.
• "mirrorLog" - تحجيم لوغاريتمي يتم فيه رسم القيم السالبة والصفرية. القيمة المرسومة لعدد سالب هي سالب سجل القيمة المطلقة. يتم تمثيل القيم القريبة من 0 على مقياس خطي.

هذا الخيار متاح فقط لمحور continuous.

موضع نص المحور الأفقي، بالنسبة إلى منطقة الرسم البياني القيم المسموح بها: 'out' و'in' و'none'.

كائن يحدد نمط نص المحور الأفقي. يحتوي الكائن على التنسيق التالي:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

يمكن أن تكون السمة color أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'. اطّلِع أيضًا على fontName وfontSize.

يستبدل علامات المحور "س" التي يتم إنشاؤها تلقائيًا بالصفيف المحدد. ويجب أن يكون كل عنصر في المصفوفة عبارة عن قيمة تجزئة صالحة (مثل رقم أو تاريخ أو تاريخ ووقت أو وقت يوميًا) أو كائنًا. إذا كان كائنًا، يجب أن يتضمّن السمة v لقيمة علامة التجزئة، وسمة f الاختيارية التي تحتوي على السلسلة الحرفية ليتم عرضها كتصنيف.

وسيتم توسيع viewWindow تلقائيًا ليشمل الحدَّين الأدنى والأقصى لعلامتَي التجزئة ما لم تحدّد viewWindow.min أو viewWindow.max لإلغاء العملية.

أمثلة:

• hAxis: { ticks: [5,10,15,20] }
• hAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• hAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• hAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

هذا الخيار متاح فقط للمحور continuous.

السمة hAxis التي تحدد عنوان المحور الأفقي.

كائن يحدد نمط نص عنوان المحور الأفقي. يحتوي الكائن على التنسيق التالي:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

يمكن أن تكون السمة color أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'. اطّلِع أيضًا على fontName وfontSize.

إذا كانت القيمة "خطأ"، سيتم إخفاء التصنيفات الخارجية بدلاً من السماح باقتصاصها باستخدام حاوية الرسم البياني. إذا كانت القيمة هي "صحيح"، سيتم السماح باقتصاص التصنيفات.

هذا الخيار متاح فقط لمحور discrete.

إذا كانت القيمة هي true، ارسم نص المحور الأفقي بزاوية للمساعدة في احتواء المزيد من النص على طول المحور. أمّا إذا كانت القيمة "false"، ارسم نص المحور الأفقي في الوضع العمودي. يكون السلوك التلقائي هو إمالة النص إذا لم تتمكّن من عرضه بالكامل عند الرسم في وضع عمودي. يُرجى العلم بأنّ هذا الخيار لا يتوفّر إلا عند ضبط hAxis.textPosition على "out" (وهو الإعداد التلقائي). القيمة التلقائية هي false للتواريخ والأوقات.

زاوية نص المحور الأفقي، إذا كانت مائلة، إذا كانت مرسومة. تم تجاهل السياسة إذا كانت قيمة السمة hAxis.slantedText هي false أو في الوضع التلقائي، وقرّر الرسم البياني رسم النص أفقيًا. إذا كانت الزاوية موجبة، يكون التدوير عكس اتجاه عقارب الساعة، وإذا كان سالبًا، سيكون عكس اتجاه عقارب الساعة.

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

الحد الأقصى لعدد الأسطر المسموح بها للتصنيفات النصية. يمكن أن تمتد التصنيفات على عدة أسطر إذا كانت طويلة جدًا، وكان عدد الأسطر تلقائيًا محدودًا بارتفاع المساحة المتاحة.

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

عدد تصنيفات المحاور الأفقية المراد عرضها، ويعني 1 عرض كل تصنيف، ويعني الرقم 2 عرض كل تصنيف آخر، وهكذا. الإعداد التلقائي هو محاولة عرض أكبر عدد ممكن من التصنيفات بدون تداخل.

نقل الحد الأقصى لقيمة المحور الأفقي إلى القيمة المحددة، سيكون متجهًا لليمين في معظم الرسومات البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أصغر من الحد الأقصى لقيمة "س" للبيانات. تلغي hAxis.viewWindow.max هذه السمة.

هذا الخيار متاح فقط للمحور continuous.

نقل الحد الأدنى لقيمة المحور الأفقي إلى القيمة المحددة، ويكون متجهًا لليسار في معظم الرسومات البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أكبر من الحد الأدنى لقيمة "س" للبيانات. تلغي hAxis.viewWindow.min هذه السمة.

هذا الخيار متاح فقط للمحور continuous.

لتحديد كيفية ضبط قياس المحور الأفقي لعرض القيم داخل منطقة الرسم البياني. ويمكن استخدام قيم السلسلة التالية:

• "pretty": تغيير حجم القيم الأفقية بحيث يتم عرض الحدَّين الأقصى والأدنى لقيم البيانات قليلاً في يمين ويمين مساحة الرسم البياني. يتم توسيع viewWindow إلى أقرب خط شبكة رئيسي للأرقام، أو أقرب خط شبكة ثانوي للتواريخ والأوقات.
• "maximized": تغيير حجم القيم الأفقية بحيث تتلاءم القيم القصوى والحد الأدنى من البيانات مع يمين ويمين مساحة الرسم البياني. سيؤدي ذلك إلى تجاهل السمتَين haxis.viewWindow.min وhaxis.viewWindow.max.
• "explicit": خيار تم إيقافه نهائيًا لتحديد قيم المقياس الأيسر والأيمن في منطقة الرسم البياني. (تم إيقاف هذه الميزة لأنّها متكررة في haxis.viewWindow.min وhaxis.viewWindow.max). سيتم اقتصاص قيم البيانات خارج هذه القيم. وعليك تحديد عنصر hAxis.viewWindow يصف القيم القصوى والدنيا لعرضه.

هذا الخيار متاح فقط للمحور continuous.

لتحديد نطاق الاقتصاص للمحور الأفقي.

• بالنسبة إلى محور continuous :

  الحد الأقصى لقيمة البيانات الأفقية المطلوب عرضها.

• بالنسبة إلى المحور discrete:

  فهرس الصفوف القائم على الصفر حيث تنتهي نافذة الاقتصاص. وسيتم اقتصاص نقاط البيانات في هذا الفهرس والأعلى. وبالارتباط مع vAxis.viewWindowMode.min، يتم تحديد نطاق نصف مفتوح [min, max) الذي يشير إلى فهارس العناصر المطلوب عرضها. بتعبير آخر، سيتم عرض كل فهرس ليتم عرض min <= index < max.

يتم تجاهل السياسة عندما تكون قيمة hAxis.viewWindowMode "جميلة" أو "مكثّفة".

• بالنسبة إلى المحور continuous:

  الحد الأدنى لقيمة البيانات الأفقية المطلوب عرضها.

• بالنسبة إلى المحور discrete:

  فهرس الصفوف القائم على الصفر حيث تبدأ نافذة الاقتصاص. وسيتم اقتصاص نقاط البيانات عند المؤشرات الأقل من هذه. وبالارتباط مع vAxis.viewWindowMode.max، يتم تحديد نطاق نصف مفتوح [min, max) الذي يشير إلى فهارس العناصر المطلوب عرضها. وبعبارة أخرى، سيتم عرض كل فهرس حتى يتم عرض min <= index < max.

يتم تجاهل السياسة عندما تكون قيمة hAxis.viewWindowMode "جميلة" أو "مكثّفة".

تمثّل هذه السمة ارتفاع الرسم البياني بالبكسل.

تحديد ما إذا كان يمكن تخمين قيمة النقاط المفقودة. إذا كانت القيمة هي true، سيتم تخمين قيمة أي بيانات ناقصة بناءً على النقاط المجاورة. إذا كانت القيمة "false"، سيؤدي ذلك إلى ترك فاصل زمني في السطر عند النقطة غير المعروفة.

هذا لا يتوافق مع الرسوم البيانية المساحية التي تستخدم الخيار isStacked: true/'percent'/'relative'/'absolute'.

في حال الضبط على "صحيح"، يعمل على تكديس العناصر لكل السلاسل في قيمة كل نطاق. ملاحظة: في الرسوم البيانية العمودية والمنطقة وSteppedArea، تعكس "الرسوم البيانية" ترتيب العناصر التفسيرية لكي تتوافق بشكل أفضل مع تكديس عناصر السلسلة (على سبيل المثال، ستكون السلسلة 0 هي العنصر الأدنى في وسيلة الإيضاح). لا ينطبق هذا على "الرسوم البيانية" Bar.

ويتيح الخيار isStacked أيضًا استخدام التكديس بنسبة 100%، حيث تتم إعادة ضبط حزم العناصر في كل قيمة في النطاق لإضافة ما يصل إلى %100.

خيارات "isStacked" هي:

• false: لن يتم تكديس العناصر. وتجدر الإشارة إلى أنّ هذا هو الخيار التلقائي.
• true — يكدّس العناصر لكل السلاسل في كل قيمة نطاق.
• 'percent' — يكدّس العناصر لكل السلسلة في كل قيمة في النطاق ويغيّر حجمها بحيث يصل مجموعها إلى 100%، مع احتساب قيمة كل عنصر كنسبة مئوية من 100%.
• 'relative' — يكدّس العناصر لكل السلسلة في كل قيمة في النطاق ويعيد قياسها بحيث يزيد مجموعها عن 1، مع احتساب قيمة كل عنصر على أنها كسر من 1.
• 'absolute': لا يؤدي هذا الإجراء إلى تغيير isStacked: true.

بالنسبة إلى التجميع بنسبة 100%، ستظهر القيمة المحسوبة لكل عنصر في التلميح بعد قيمته الفعلية.

سيتم تلقائيًا ضبط المحور المستهدف على قيم التجزئة بناءً على المقياس النسبي 0-1 ككسور بنسبة 1 لـ 'relative'، ومن 0 إلى 100% لـ 'percent' (ملاحظة: عند استخدام الخيار 'percent'، يتم عرض قيم المحور/المؤشرات كنسب مئوية، ولكن القيم الفعلية هي قيم المقياس النسبية من 0 إلى 1. ويرجع ذلك إلى أنّ مؤشرات محور النسبة المئوية هي نتيجة تطبيق تنسيق "#.##%" على قيم المقياس النسبية 0-1. عند استخدام isStacked: 'percent'، احرص على تحديد أي مؤشرات أو خطوط شبكة باستخدام قيم المقياس النسبية من 0 إلى 1). يمكنك تخصيص قيم خطوط الشبكة/المؤشرات والتنسيق باستخدام خيارات hAxis/vAxis المناسبة.

لا يتوافق التكديس بنسبة 100% إلا مع قيم البيانات من النوع number، ويجب أن يكون المتوقع صفر.

كائن يحتوي على أعضاء لضبط جوانب مختلفة من وسيلة الإيضاح. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن على النحو الموضّح هنا:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}

محاذاة وسيلة الإيضاح. يمكن أن تكون الحالة واحدة مما يلي:

• 'start' - تتم محاذاتها مع بداية المنطقة المخصصة للوسيلة الإيضاح.
• 'center' - تكون متمركزة في المنطقة المخصصة للوسيلة الإيضاح.
• 'end' - تمت محاذاته مع نهاية المنطقة المخصصة للوسيلة الإيضاح.

ترتبط البداية والوسط والنهاية بالنمط - رأسي أو أفقي - للوسيلة الإيضاح. على سبيل المثال، في وسيلة الإيضاح "الأيمن"، تظهر "البدء" و"النهاية" في الأعلى والأسفل على التوالي، وبالنسبة إلى وسيلة الإيضاح "الأعلى"، تظهر "البداية" و"النهاية" على يسار المساحة ويمينها، على التوالي.

وتعتمد القيمة الافتراضية على موضع وسيلة الإيضاح. وبالنسبة إلى وسائل الإيضاح "الأسفل"، يكون الإعداد التلقائي هو "المركز"، فيما تكون وسائل الإيضاح الأخرى هي "البدء".

الحد الأقصى لعدد الأسطر في وسيلة الإيضاح. اضبط هذا على رقم أكبر من واحد لإضافة أسطر إلى وسيلة الإيضاح. ملاحظة: لا يزال المنطق الدقيق المستخدَم لتحديد العدد الفعلي للسطر المعروض قيد التغير.

لا يعمل هذا الخيار حاليًا إلا عندما تكون ميزة "أفضل موضع" متاحة في "الأعلى".

تم اختيار أول فهرس صفحة يستند إلى صفر في وسيلة الإيضاح.

موضع وسيلة الإيضاح. يمكن أن تكون الحالة واحدة مما يلي:

• "أسفل" - أسفل الرسم البياني.
• "left" - يقع على يسار الرسم البياني، بشرط ألا يتضمن المحور الأيسر أي سلسلة مرتبطة به. ولذلك، إذا كنت تريد وسيلة الإيضاح التي تظهر على اليمين، فاستخدم الخيار targetAxisIndex: 1.
• "in" - داخل المخطط، بجانب أعلى اليمين.
• 'none' - لا يتم عرض أي وسيلة إيضاح.
• "right" - إلى يمين المخطط. غير متوافق مع الخيار vAxes.
• "أعلى" - أعلى الرسم البياني

كائن يحدد نمط نص وسيلة الإيضاح. يحتوي الكائن على التنسيق التالي:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

يمكن أن تكون السمة color أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'. اطّلِع أيضًا على fontName وfontSize.

نمط التشغيل والإيقاف للخطوط المتقطعة. على سبيل المثال، سيكرّر [4, 4] شرطات بطول 4 أطوال متبوعة بـ 4 فجوات، وسيكرّر [5, 1, 3] شرطة بطول 5 ومسافة 1 طول وشرطة 3 أطوال ومسافة 5 أطوال وشرطة بطول 1 ومسافة 3 أطوال. يمكنك الاطّلاع على Dashed Lines للحصول على مزيد من المعلومات.

عرض خط البيانات بالبكسل. استخدِم الصفر لإخفاء جميع الأسطر وعرض النقاط فقط. يمكنك إلغاء القيم لسلسلة فردية باستخدام السمة series.

اتجاه الرسم البياني. عند ضبط هذه القيمة على 'vertical'، يتم تدوير محاور الرسم البياني بحيث يتحوّل (على سبيل المثال) الرسم البياني العمودي إلى رسم بياني شريطي، وينمو الرسم البياني المساحي باتجاه اليسار بدلاً من الجزء العلوي:

شكل عناصر البيانات الفردية: "دائرة" أو "مثلّث" أو "مربع" أو "ماسي" أو "نجمة" أو "مضلّع". راجِع المستندات المتعلقة بالنقاط للحصول على أمثلة.

قطر النقاط المعروضة بالبكسل استخدِم صفرًا لإخفاء جميع النقاط. يمكنك إلغاء القيم لسلسلة فردية باستخدام السمة series. إذا كنت تستخدم خطًا مؤشرات، سيؤثّر الخيار pointSize في عرض خط الاتجاه ما لم يتم تجاوزه باستخدام الخيار trendlines.n.pointsize.

تحدِّد هذه السياسة ما إذا كان سيتم عرض النقاط. يمكنك ضبط القيمة على false لإخفاء جميع النقاط. يمكنك إلغاء القيم لسلسلة فردية باستخدام السمة series. إذا كنت تستخدم خطًا رائجًا، سيؤثر الخيار pointsVisible في مستوى ظهور النقاط على جميع خطوط الاتجاه ما لم تلغِه باستخدام الخيار trendlines.n.pointsVisible.

ويمكن أيضًا إلغاء هذه السمة باستخدام دور النمط في شكل "point {visible: true}".

في حال ضبطها على "صحيح"، سيتم رسم سلسلة من اليمين إلى اليسار. الإعداد الافتراضي هو الرسم من اليسار إلى اليمين.

هذا الخيار متاح فقط لمحور discrete major.

عند ضبط قيمة selectionMode على 'multiple'، يمكن للمستخدمين اختيار عدة نقاط بيانات.

يشير ذلك المصطلح إلى مصفوفة من العناصر يصف كل منها تنسيق السلسلة المقابلة في الرسم البياني. لاستخدام القيم التلقائية لسلسلة ما، يجب تحديد عنصر فارغ {}. إذا لم يتم تحديد سلسلة أو قيمة، سيتم استخدام القيمة العامة. ويوفّر كل كائن السمات التالية:

• annotations - كائن سيتم تطبيقه على التعليقات التوضيحية لهذه السلسلة. يمكن استخدام ذلك للتحكّم في textStyle للسلسلة مثلاً:

  series: {
    0: {
      annotations: {
        textStyle: {fontSize: 12, color: 'red' }
      }
    }
  }
            

  اطّلِع على خيارات annotations المختلفة للحصول على قائمة أكثر اكتمالاً بما يمكن تخصيصه.

• areaOpacity - لإلغاء areaOpacity العام لهذه السلسلة.
• color - اللون المطلوب استخدامه لهذه السلسلة. حدِّد سلسلة لون HTML صالحة.
• labelInLegend - وصف السلسلة التي ستظهر في وسيلة إيضاح الرسم البياني.
• lineDashStyle - لإلغاء قيمة lineDashStyle العامة لهذه السلسلة
• lineWidth - لإلغاء قيمة lineWidth العامة لهذه السلسلة
• pointShape - لإلغاء قيمة pointShape العامة لهذه السلسلة
• pointSize - لإلغاء قيمة pointSize العامة لهذه السلسلة
• pointsVisible - لإلغاء قيمة pointsVisible العامة لهذه السلسلة
• targetAxisIndex - المحور الذي يجب تخصيص هذه السلسلة له، حيث يمثّل الرقم 0 المحور التلقائي والرقم 1 هو المحور المعاكس. القيمة التلقائية هي 0، ويتم ضبطها على 1 لتحديد رسم بياني يتم فيه عرض سلاسل مختلفة على محاور مختلفة. سيتم تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.
• visibleInLegend - قيمة منطقية، حيث تعني القيمة "صحيح" أنّ السلسلة يجب أن تشتمل على إدخال وسيلة إيضاح، في حين تعني القيمة "خطأ" أنّه يجب ألا تتضمّن السلسلة. الإعداد التلقائي صحيح.

يمكنك تحديد إما مصفوفة من العناصر، وينطبق كل منها على السلسلة بالترتيب المقدم، أو يمكنك تحديد كائن حيث يكون لكل فرع مفتاح رقمي يشير إلى السلسلة التي تنطبق عليها. على سبيل المثال، التعريفان التاليان متطابقان، ويشيران إلى أنّ السلسلة الأولى باللون الأسود ولا تظهر في وسيلة الإيضاح، والسلسلة الرابعة باللون الأحمر وبدونها من وسيلة الإيضاح:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    

المظهر هو مجموعة من قيم الخيارات المحدّدة مسبقًا التي تعمل معًا لتحقيق سلوك محدّد في الرسم البياني أو تأثير مرئي. يتوفّر مظهر واحد فقط في الوقت الحالي:

• "maximized": لتكبير مساحة الرسم البياني ورسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني لضبط الخيارات التالية:

  chartArea: {width: '100%', height: '100%'},
  legend: {position: 'in'},
  titlePosition: 'in', axisTitlesPosition: 'in',
  hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
          

النص المطلوب عرضه أعلى الرسم البياني

مكان وضع عنوان الرسم البياني، مقارنةً بمساحة الرسم البياني. القيم المسموح بها:

• in - ارسم العنوان داخل منطقة المخطط.
• out - ارسم العنوان خارج مساحة المخطط.
• لا شيء - حذف العنوان.

كائن يحدد نمط نص العنوان. يحتوي الكائن على التنسيق التالي:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

يمكن أن تكون السمة color أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'. اطّلِع أيضًا على fontName وfontSize.

كائن يحتوي على أعضاء لضبط عناصر تلميح مختلفة. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن، كما هو موضّح هنا:

{textStyle: {color: '#FF0000'}, showColorCode: true}

في حال ضبط هذه السياسة على true، سيتم السماح لرسم تلميحات الأدوات بالتدفق خارج حدود الرسم البياني على جميع الجوانب.

ملاحظة: ينطبق هذا فقط على تلميحات HTML. في حال تفعيل هذه السياسة باستخدام تلميحات رسومات موجّهة يمكن تغيير حجمها (SVG)، سيتم اقتصاص أي تجاوز خارج حدود الرسم البياني. راجِع تخصيص محتوى التلميح لمعرفة مزيد من التفاصيل.

في حال ضبط السياسة على "صحيح"، يمكنك استخدام تلميحات الأدوات المعروضة بتنسيق HTML (بدلاً من عرضها بتنسيق SVG). راجِع تخصيص محتوى التلميح لمعرفة مزيد من التفاصيل.

ملاحظة: لا يتيح العرض المرئي للرسم البياني الفقاعي تخصيص محتوى تلميح HTML من خلال دور بيانات عمود التلميح.

في حال اختيار القيمة، اعرض مربّعات ملوّنة بجانب معلومات السلسلة في التلميح. وتكون القيمة التلقائية "صحيح" عند ضبط السمة focusTarget على "الفئة"، وبخلاف ذلك، تكون القيمة التلقائية "خطأ".

كائن يحدد نمط نص التلميح. يحتوي الكائن على التنسيق التالي:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

يمكن أن تكون السمة color أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'. اطّلِع أيضًا على fontName وfontSize.

تفاعل المستخدِم الذي يتسبب في عرض التلميح:

• "Focus" (التركيز): سيتم عرض التلميح عندما يمرِّر المستخدم مؤشر الماوس فوق العنصر.
• 'none' - لن يتم عرض التلميح.
• "الاختيار": سيتم عرض التلميح عندما يختار المستخدم العنصر.

تحدّد هذه السمة خصائص المحاور الرأسية الفردية إذا كان الرسم البياني يحتوي على عدة محاور رأسية. كل عنصر فرعي هو كائن vAxis، ويمكن أن يحتوي على جميع السمات المتوافقة مع vAxis. تلغي قيم السمات هذه أي إعدادات عامة للموقع نفسه.

لتحديد رسم بياني يحتوي على عدة محاور عمودية، حدِّد أولاً محورًا جديدًا باستخدام series.targetAxisIndex، ثم اضبط المحور باستخدام vAxes. يعيّن المثال التالي السلسلة 2 إلى المحور الأيمن ويحدّد عنوانًا مخصّصًا ونمط نص لها:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

يمكن أن تكون هذه السمة كائنًا أو مصفوفة: الكائن عبارة عن مجموعة من الكائنات، ولكل منها تصنيف رقمي يحدد المحور الذي يعرِّفه، وهذا هو التنسيق الموضح أعلاه، والمصفوفة هي مصفوفة من الكائنات، عنصر لكل محور. على سبيل المثال، يتطابق ترميز نمط المصفوفة التالي مع الكائن vAxis الموضّح أعلاه:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    

كائن يحتوي على أعضاء لضبط عناصر متعددة من المحور الرأسي. لتحديد خصائص هذا الكائن، يمكنك استخدام الترميز الحرفي للكائن على النحو الموضّح هنا:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}

سمة vAxis التي تحدد خط الأساس للمحور الرأسي. إذا كان الخط القاعدي أكبر من أعلى خط شبكي أو أصغر من أدنى خط شبكي، سيتم تقريبه إلى أقرب خط شبكة.

لتحديد لون الخط القاعدي للمحور الرأسي. يمكن أن تكون أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'.

الاتجاه الذي تنمو به القيم على طول المحور الرأسي. تظهر القيم المنخفضة تلقائيًا في أسفل الرسم البياني. حدِّد -1 لعكس ترتيب القيم.

سلسلة تنسيق لتصنيفات المحور الرقمي. هذه مجموعة فرعية من مجموعة أنماط ICU . على سبيل المثال، سيعرض {format:'#,###%'} القيم "1,000%" و"750%" و "50%" للقيم 10 و7.5 و0.5. ويمكنك أيضًا توفير أيٍّ مما يلي:

• {format: 'none'}: يعرض أرقامًا بدون تنسيق (مثل 8000000)
• {format: 'decimal'}: تعرض الأرقام مع فواصل الآلاف (مثل 8,000,000)
• {format: 'scientific'}: يعرض الأرقام بالترميز العلمي (مثل 8e6)
• {format: 'currency'}: يعرض الأرقام بالعملة المحلية (مثل 8,000,000.00 دولار)
• {format: 'percent'}: يعرض الأرقام كنسب مئوية (مثل 800,000,000%)
• {format: 'short'}: يعرض الأرقام المختصرة (مثل 8 مليون)
• {format: 'long'}: يعرض الأرقام ككلمات كاملة (مثل 8 مليون)

يتم اشتقاق التنسيق الفعلي المطبَّق على التصنيف من اللغة التي تم تحميل واجهة برمجة التطبيقات بها. لمزيد من التفاصيل، راجِع تحميل الرسوم البيانية بلغة معيّنة .

عند احتساب قيم التجزئة وخطوط الشبكة، سيتم النظر في عدة مجموعات بديلة من جميع خيارات خطوط الشبكة ذات الصلة وسيتم رفض البدائل إذا كانت تصنيفات علامات التجزئة المنسَّقة مكرّرة أو متداخلة. يمكنك تحديد format:"#" إذا كنت تريد عرض قيم علامات الأعداد الصحيحة فقط، ولكن انتبه إلى أنّه في حال عدم استيفاء أي بديل لهذا الشرط، لن يتم عرض أي خطوط للشبكة أو علامات.

كائن يحتوي على أعضاء لضبط خطوط الشبكة على المحور الرأسي لاحظ أن خطوط الشبكة ذات المحور الرأسي يتم رسمها أفقيًا. لتحديد خصائص هذا الكائن، يمكنك استخدام التدوين الحرفي للكائن، كما هو موضّح هنا:

{color: '#333', minSpacing: 20}

لون خطوط الشبكة الرأسية داخل منطقة الرسم البياني. حدِّد سلسلة لون HTML صالحة.

العدد التقريبي لخطوط الشبكة الأفقية داخل منطقة الرسم البياني. إذا حدّدت رقمًا موجبًا في السمة gridlines.count، سيتم استخدامه لاحتساب قيمة السمة minSpacing بين خطوط الشبكة. يمكنك تحديد القيمة 1 لرسم خط شبكة واحد فقط، أو 0 لرسم أي خطوط شبكة. حدِّد -1، وهو الإعداد التلقائي، لاحتساب عدد خطوط الشبكة تلقائيًا استنادًا إلى خيارات أخرى.

تمثّل هذه السمة مصفوفة من الأحجام (كقيم بيانات، وليس وحدات بكسل) بين خطوط الشبكة المجاورة. هذا الخيار مخصّص فقط للمحاور الرقمية في الوقت الحالي، ولكنّه مماثل لخيارات gridlines.units.<unit>.interval التي تُستخدم فقط للتواريخ والأوقات. بالنسبة إلى المقاييس الخطية، تكون القيمة التلقائية [1, 2, 2.5, 5]، ما يعني أنّ قيم خط الشبكة يمكن أن تقع على كل وحدة (1) أو في الوحدات الزوجية (2) أو مضاعفات 2.5 أو 5. ويتم أيضًا احتساب أيّ أس 10 أضعاف هذه القيم (مثل [10، 20، 25، 50] و[ .1، .2، .25، 5.]). وبالنسبة إلى المقاييس السجّلية، تكون القيمة التلقائية هي [1, 2, 5].

الحد الأدنى لمساحة الشاشة بالبكسل بين خطوط الشبكة الرئيسية ذات المحور السداسي الإعداد التلقائي لخطوط الشبكة الرئيسية هو 40 للمقاييس الخطّية، و20 للمقاييس اللوغاريتمية. إذا حددت count وليس minSpacing، يتم احتساب minSpacing من العدد. وفي المقابل، إذا حددت minSpacing وليس count، يتم احتساب العدد من minSpacing. وإذا حددت كليهما، سيتم إلغاء سياسة minSpacing.

يجب أن تكون جميع قيم خطوط الشبكة ومؤشرات التجزئة مضاعفًا لقيمة هذا الخيار. يُرجى العلم أنّه على عكس الفواصل، لا يتم اعتبار القوى التي تبلغ 10 أضعاف المضاعفات. وبالتالي، يمكنك أن تفرض أن تكون قيم المؤشرات أعدادًا صحيحة من خلال تحديد gridlines.multiple = 1، أو أن تفرض أن تكون علامات التجزئة مضاعفات العدد 1000 من خلال تحديد gridlines.multiple = 1000.

لإلغاء التنسيق التلقائي لجوانب مختلفة من أنواع بيانات التاريخ/التاريخ/الوقت في اليوم عند استخدامها مع خطوط الشبكة المحسوبة في الرسم البياني. تتيح التنسيق بالسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية.

التنسيق العام هو:

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*/]}
  }
}
    

يمكنك الاطّلاع على معلومات إضافية في التواريخ والأوقات.

كائن يحتوي على أعضاء لضبط خطوط الشبكة الصغيرة على المحور الرأسي، على غرار الخيار vAxis.gridlines.

لون خطوط الشبكة الرأسية الصغيرة داخل منطقة الرسم البياني. حدِّد سلسلة لون HTML صالحة.

يشبه الخيار miniGrids.interval خيار الفاصل الزمني لخطوط الشبكة الرئيسية، ولكن الفاصل الزمني الذي يتم اختياره سيكون دائمًا قاسمًا متساويًا للفاصل الزمني لخط الشبكة الرئيسي. الفاصل التلقائي للمقاييس الخطية هو [1, 1.5, 2, 2.5, 5]، والفاصل الزمني التلقائي هو [1, 2, 5].

تمثّل هذه السمة الحد الأدنى للمساحة المطلوبة بالبكسل، وبين خطوط الشبكة الصغيرة المجاورة، وبين خطوط الشبكة الثانوية والكبيرة. القيمة التلقائية هي 1/2 من الحد الأدنى لتباعد خطوط الشبكة الرئيسية للمقاييس الخطية، و1/5 من المسافة الدقيقة للمقاييس اللوغاريتمية.

كما هو الحال مع gridlines.multiple الرئيسي.

يتم إيقاف خيار miniGridlines.count نهائيًا، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الصغيرة على الفاصل بين خطوط الشبكة الرئيسية (راجِع vAxis.gridlines.interval) والحد الأدنى للمساحة المطلوبة (يمكنك الاطّلاع على vAxis.minorGridlines.minSpacing).

تلغي هذه العلامة التنسيق التلقائي لجوانب مختلفة من أنواع بيانات التاريخ/التاريخ/الوقت في اليوم عند استخدامها مع الخطوط الصغيرة المحسوبة في الرسم البياني. تتيح التنسيق بالسنوات والأشهر والأيام والساعات والدقائق والثواني والمللي ثانية.

التنسيق العام هو:

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*/]},
  }
}
    

يمكنك الاطّلاع على معلومات إضافية في التواريخ والأوقات.

إذا كانت القيمة هي true، يصبح المحور الرأسي مقياسًا لوغاريتميًا. ملاحظة: يجب أن تكون جميع القيم موجبة.

السمة vAxis التي تجعل المحور الرأسي مقياسًا لوغاريتميًا. يمكن أن تكون الحالة واحدة مما يلي:

• فارغ - لم يتم تنفيذ تحجيم لوغاريتمي.
• "السجل" - التحجيم اللوغاريتمي. لا يتم رسم القيم السالبة والصفرية. هذا الخيار مماثل للإعداد vAxis: { logscale: true }.
• "mirrorLog" - تحجيم لوغاريتمي يتم فيه رسم القيم السالبة والصفرية. القيمة المرسومة لعدد سالب هي سالب سجل القيمة المطلقة. يتم تمثيل القيم القريبة من 0 على مقياس خطي.

هذا الخيار متاح فقط لمحور continuous.

موضع نص المحور الرأسي، بالنسبة إلى مساحة الرسم البياني القيم المسموح بها: 'out' و'in' و'none'.

كائن يحدد نمط نص المحور الرأسي. يحتوي الكائن على التنسيق التالي:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

يمكن أن تكون السمة color أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'. اطّلِع أيضًا على fontName وfontSize.

لاستبدال علامات المحور ص التي يتم إنشاؤها تلقائيًا بالمصفوفة المحددة. ويجب أن يكون كل عنصر في المصفوفة عبارة عن قيمة تجزئة صالحة (مثل رقم أو تاريخ أو تاريخ ووقت أو وقت يوميًا) أو كائنًا. إذا كان كائنًا، يجب أن يتضمّن السمة v لقيمة علامة التجزئة، وسمة f الاختيارية التي تحتوي على السلسلة الحرفية ليتم عرضها كتصنيف.

وسيتم توسيع viewWindow تلقائيًا ليشمل الحدَّين الأدنى والأقصى لعلامتَي التجزئة ما لم تحدّد viewWindow.min أو viewWindow.max لإلغاء العملية.

أمثلة:

• vAxis: { ticks: [5,10,15,20] }
• vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

السمة vAxis التي تحدد عنوانًا للمحور العمودي.

كائن يحدد نمط نص عنوان المحور الرأسي. يحتوي الكائن على التنسيق التالي:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

يمكن أن تكون السمة color أي سلسلة لون HTML، على سبيل المثال: 'red' أو '#00cc00'. اطّلِع أيضًا على fontName وfontSize.

نقل الحد الأقصى لقيمة المحور الرأسي إلى القيمة المحددة، ويكون هذا العمود للأعلى في معظم الرسومات البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أصغر من قيمة الحد الأقصى لقيمة "ص" للبيانات. تلغي vAxis.viewWindow.max هذه السمة.

نقل الحد الأدنى للقيمة للمحور العمودي إلى القيمة المحددة، وسيتحرك هذا القيمة إلى أسفل في معظم الرسوم البيانية. يتم تجاهل السياسة إذا تم ضبط هذه السمة على قيمة أكبر من قيمة الحد الأدنى لقيمة ص للبيانات. تلغي vAxis.viewWindow.min هذه السمة.

لتحديد كيفية ضبط حجم المحور العمودي لعرض القيم داخل منطقة الرسم البياني. ويمكن استخدام قيم السلسلة التالية:

• "pretty": تغيير حجم القيم العمودية ليتم عرض الحدَّين الأقصى والأدنى لقيم البيانات قليلاً في الجزء السفلي والأعلى من مساحة الرسم البياني. يتم توسيع viewWindow إلى أقرب خط شبكة رئيسي للأرقام، أو أقرب خط شبكة ثانوي للتواريخ والأوقات.
• "maximized": تغيير حجم القيم الرأسية بحيث تتلاءم قيم البيانات القصوى والدنيا أعلى وأسفل مساحة الرسم البياني. سيؤدي ذلك إلى تجاهل السمتَين vaxis.viewWindow.min وvaxis.viewWindow.max.
• "explicit": خيار تم إيقافه نهائيًا لتحديد قيم المقياس العلوي والسفلي لمنطقة الرسم البياني. (تم إيقافها نهائيًا لأنّها متكررة في vaxis.viewWindow.min وvaxis.viewWindow.max. وسيتم اقتصاص قيم البيانات خارج هذه القيم. وعليك تحديد عنصر vAxis.viewWindow يصف القيم القصوى والدنيا المراد عرضها.

لتحديد نطاق الاقتصاص للمحور العمودي.

الحد الأقصى لقيمة بيانات موضع الإعلان المطلوب عرضها.

يتم تجاهل السياسة عندما تكون قيمة vAxis.viewWindowMode "جميلة" أو "مكثّفة".

الحد الأدنى لقيمة بيانات موضع الإعلان المطلوب عرضها.

يتم تجاهل السياسة عندما تكون قيمة vAxis.viewWindowMode "جميلة" أو "مكثّفة".

عرض الرسم البياني بالبكسل

لرسم الرسم البياني. لا يقبل الرسم البياني طلبات الطُرق الإضافية إلا بعد تنشيط حدث ready. Extended description.

عرض كائن إجراء التلميح مع actionID المطلوب.

تعرض كائنًا يحتوي على يسار عنصر الرسم البياني id وأعلاه وعرضه وارتفاعه. لم يتم توثيق تنسيق id بعد (هذه هي القيم التي تعرضها معالِجات الأحداث)، ولكن إليك بعض الأمثلة:

var cli = chart.getChartLayoutInterface();

ارتفاع مساحة الرسم البياني

cli.getBoundingBox('chartarea').height

عرض الشريط الثالث في السلسلة الأولى من رسم بياني شريطي أو عمودي

cli.getBoundingBox('bar#0#2').width

مربع ربط الإسفين الخامس لمخطط دائري

cli.getBoundingBox('slice#4')

مربع ربط بيانات المخطط العمودي (على سبيل المثال، عمودي):

cli.getBoundingBox('vAxis#0#gridline')

مربع ربط بيانات المخطط لمخطط أفقي (على سبيل المثال، شريطي):

cli.getBoundingBox('hAxis#0#gridline')

ترتبط القيم بحاوية الرسم البياني. وعليك باستدعاء هذا بعد رسم الرسم البياني.

تعرض كائنًا يحتوي على يسار محتوى الرسم البياني وأعلاه وعرضه وارتفاعه (أي باستثناء التصنيفات والتسمية التوضيحية):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left

cli.getChartAreaBoundingBox().top

cli.getChartAreaBoundingBox().height

cli.getChartAreaBoundingBox().width

ترتبط القيم بحاوية الرسم البياني. وعليك باستدعاء هذا بعد رسم الرسم البياني.

تعرض كائنًا يحتوي على معلومات حول موضع الرسم البياني وعناصره على الشاشة.

يمكن استدعاء الطرق التالية للكائن الذي تم إرجاعه:

• getBoundingBox
• getChartAreaBoundingBox
• getHAxisValue
• getVAxisValue
• getXLocation
• getYLocation

وعليك باستدعاء هذا بعد رسم الرسم البياني.

تعرض قيمة البيانات الأفقية على xPosition، وهي إزاحة بكسل من الحافة اليسرى لحاوية الرسم البياني. يمكن أن تكون سلبية.

مثال: chart.getChartLayoutInterface().getHAxisValue(400)

وعليك باستدعاء هذا بعد رسم الرسم البياني.

تعرض الرسم البياني المتسلسل كمعرّف الموارد المنتظم (URI) للصورة.

وعليك باستدعاء هذا بعد رسم الرسم البياني.

راجِع طباعة مخططات PNG.

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

تعرض قيمة البيانات العمودية على yPosition، وهي قيمة إزاحة بكسل من الحافة العلوية لحاوية الرسم البياني. يمكن أن تكون سلبية.

مثال: chart.getChartLayoutInterface().getVAxisValue(300)

وعليك باستدعاء هذا بعد رسم الرسم البياني.

عرض الإحداثي السيني للبكسل dataValue بالنسبة إلى الحافة اليسرى لحاوية الرسم البياني.

مثال: chart.getChartLayoutInterface().getXLocation(400)

وعليك باستدعاء هذا بعد رسم الرسم البياني.

يتم عرض إحداثي y بكسل لـ dataValue بالنسبة إلى الحافة العلوية لحاوية الرسم البياني.

مثال: chart.getChartLayoutInterface().getYLocation(300)

وعليك باستدعاء هذا بعد رسم الرسم البياني.

إزالة إجراء التلميح باستخدام actionID المطلوب من الرسم البياني.

ضبط إجراء تلميح ليتم تنفيذه عندما ينقر المستخدم على نص الإجراء.

تستخدم طريقة setAction كائنًا كمعلمة الإجراء الخاصة به. ويجب أن يحدّد هذا الكائن 3 سمات، وهي: id، رقم تعريف الإجراء الذي يتم ضبطه، وtext، النص الذي يجب أن يظهر في التلميح الخاص بالإجراء، وaction الوظيفة التي يجب تشغيلها عندما ينقر المستخدم على نص الإجراء.

يجب ضبط كل إجراءات التلميحات قبل استدعاء طريقة draw() للرسم البياني. الوصف الموسّع:

لاختيار العناصر المحددة في الرسم البياني يؤدي هذا الإجراء إلى إلغاء أي اختيار سابق. الكيانات القابلة للاختيار هي النقاط والتعليقات التوضيحية وإدخالات وسائل الإيضاح والفئات. تتوافق نقطة أو تعليق توضيحي مع خلية في جدول البيانات وإدخال وسيلة إيضاح لعمود (فهرس الصف فارغ) وفئة في صف (فهرس العمود فارغ). بالنسبة إلى هذا الرسم البياني، يمكن اختيار كيان واحد فقط في كل مرة. Extended description .

يؤدي هذا الإجراء إلى محو الرسم البياني وتحرير جميع الموارد المخصّصة له.

يتم إطلاقه عند اكتمال الحركة الانتقالية.

يتم الإطلاق عندما ينقر المستخدم داخل الرسم البياني. ويمكن استخدامها لتحديد وقت النقر على العنوان أو عناصر البيانات أو إدخالات وسيلة الإيضاح أو المحاور أو خطوط الشبكة أو التصنيفات.

يتم إطلاقه عند حدوث خطأ عند محاولة عرض الرسم البياني.

يتم الإطلاق عندما ينقر المستخدم على أسهم التقسيم على صفحات في وسيلة الإيضاح. تمرير فهرس الصفحة الحالي القائم على وسيلة إيضاح صفرية وإجمالي عدد الصفحات.

يتم الإطلاق عندما يمرر المستخدم الماوس فوق كيان مرئي. ينقل فهارس الصفوف والأعمدة لعنصر جدول البيانات المقابل.

يتم إطلاقها عندما يوجِّه المستخدم الماوس بعيدًا عن كيان مرئي. ينقل فهارس الصفوف والأعمدة لعنصر جدول البيانات المقابل.

الرسم البياني جاهز لاستدعاءات الطرق الخارجية. إذا كنت تريد التفاعل مع الرسم البياني وطرق الاتصال بعد رسمه، عليك إعداد أداة معالجة لهذا الحدث قبل استدعاء طريقة draw، وعدم الاتصال بها إلا بعد تنشيط الحدث.

يتم الإطلاق عندما ينقر المستخدم على عنصر مرئي. لمعرفة ما تم اختياره، يمكنك الاتصال بالرقم getSelection().