خيارات ضبط الرسم البياني

أنواع الرسوم البيانية

خيارات إعداد الرسم البياني للتعليقات التوضيحية

الاسم
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
displayRangeSelector

تحديد ما إذا كان سيتم عرض منطقة اختيار نطاق التكبير (المنطقة في أسفل الرسم البياني)، حيث يعني false عدم العرض

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

النوع: boolean
القيمة التلقائية: true
displayZoomButtons

تحديد ما إذا كنت تريد عرض أزرار التكبير أو التصغير ("يوم واحد و5 أيام وشهر واحد" وما إلى ذلك)، حيث يعني false عدم العرض

النوع: boolean
القيمة التلقائية: true
الحد الأقصى

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

هذا مشابه للسمة maxValue في المخططات الأساسية.

النوع: number
تلقائي: تلقائي
دقيقة

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

هذا مشابه للسمة minValue في المخططات الأساسية.

النوع: number
تلقائي: تلقائي

خيارات إعداد الرسم البياني المساحي

الاسم
areaOpacity

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

النوع: number، 0.0- 1.0
القيمة التلقائية: 0.3
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
interpolateNulls

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

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

النوع: boolean
القيمة التلقائية: false
isStacked

إذا تم ضبطها على true، يتم ترتيب العناصر لجميع السلاسل في كل قيمة نطاق. ملاحظة: في الرسومات البيانية من النوع Column و Area و SteppedArea، تعكس &quot;رسومات Google البيانية&quot; ترتيب عناصر وسيلة الإيضاح لتتطابق بشكل أفضل مع ترتيب عناصر السلسلة (على سبيل المثال، ستكون السلسلة 0 هي عنصر وسيلة الإيضاح السفلي). لا ينطبق ذلك على الرسومات البيانية الشريطية.

يتيح الخيار 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، ويجب أن تكون قيمة الأساس صفرًا.

النوع: boolean/string
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

النوع: number
القيمة التلقائية: 2
pointShape

شكل عناصر البيانات الفردية: 'circle' أو 'triangle' أو 'square' أو 'diamond' أو 'star' أو 'polygon' يمكنك الاطّلاع على مستندات النقاط للحصول على أمثلة.

النوع: string
القيمة التلقائية: 'circle'
pointSize

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

النوع: number
القيمة التلقائية: 0
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

  • 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 - قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّه يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

إذا تم ضبطها على true، سيتعامل المخطط مع العمود كعمود نصي.

النوع: boolean
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات إعدادات الرسم البياني الشريطي

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع:string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: رقم أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
hAxes

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

لتحديد رسم بياني يتضمّن عدة محاور أفقية، عليك أولاً تحديد محور جديد باستخدام series.targetAxisIndex، ثم ضبط المحور باستخدام hAxes. يعيّن المثال التالي السلسلة 1 إلى المحور السفلي ويحدّد عنوانًا مخصّصًا ونمط نص له:

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

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

 hAxes: {   {}, // Nothing specified for axis 0   {     title:'Losses',     textStyle: {       color: 'red'     }   } // Axis 1     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
isStacked

إذا تم ضبطها على true، يتم ترتيب العناصر لجميع السلاسل في كل قيمة نطاق. ملاحظة: في الرسومات البيانية من النوع Column و Area و SteppedArea، تعكس &quot;رسومات Google البيانية&quot; ترتيب عناصر وسيلة الإيضاح لتتطابق بشكل أفضل مع ترتيب عناصر السلسلة (على سبيل المثال، ستكون السلسلة 0 هي عنصر وسيلة الإيضاح السفلي). لا ينطبق ذلك على الرسومات البيانية الشريطية.

يتيح الخيار 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، ويجب أن تكون قيمة الأساس صفرًا.

النوع: boolean/string
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

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

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

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

  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • targetAxisIndex: المحور الذي سيتم تعيين هذه السلسلة إليه، حيث يمثّل 0 المحور التلقائي، ويمثّل 1 المحور المعاكس. القيمة التلقائية هي 0، ويمكن ضبطها على 1 لتحديد رسم بياني يتم فيه عرض السلاسل المختلفة على محاور مختلفة. يجب تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
خطوط المؤشرات

تعرض خطوط المؤشرات في الرسوم البيانية التي تتوافق معها. يتم تلقائيًا استخدام خطوط الاتجاه linear، ولكن يمكن تخصيص ذلك باستخدام الخيار trendlines.n.type.

يتم تحديد خطوط الاتجاه على أساس كل سلسلة، لذا ستظهر خياراتك في معظم الأحيان على النحو التالي:

 var options = {   trendlines: {     0: {       type: 'linear',       color: 'green',       lineWidth: 3,       opacity: 0.3,       visibleInLegend: true     }   } }     
النوع: object
القيمة التلقائية: null
trendlines.n.color

لون خط الاتجاه ، معبَّرًا عنه إما باسم لون باللغة الإنجليزية أو كسلسلة سداسية عشرية.

النوع: string
تلقائي: لون السلسلة التلقائي
trendlines.n.degree

بالنسبة إلى خطوط الاتجاه لـ type: 'polynomial'، تمثّل درجة الحدود المتعددة (2 للتربيعية، و3 للتكعيبية، وما إلى ذلك).

النوع: number
القيمة التلقائية: 3
trendlines.n.labelInLegend

في حال ضبطها، سيظهر خط الاتجاه في وسيلة الإيضاح كسلسلة.

النوع: string
القيمة التلقائية: null
trendlines.n.lineWidth

تمثّل هذه السمة عرض خط الميل، بوحدة البكسل.

النوع: number
القيمة التلقائية: 2
trendlines.n.type

تحدّد هذه السمة ما إذا كانت خطوط المؤشرات هي 'linear' (القيمة التلقائية) أو 'exponential' أو 'polynomial'.

النوع: string
القيمة التلقائية: linear
trendlines.n.visibleInLegend

تُستخدَم لتحديد ما إذا كانت معادلة خط الاتجاه تظهر في وسيلة الإيضاح. سيظهر في تلميح خط الاتجاه.

النوع: boolean
القيمة التلقائية: false
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات إعداد الرسم البياني الفقاعي

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
فقاعة تفسيرية

عنصر يتضمّن أعضاء لإعداد الخصائص المرئية للفقاعات.

النوع: object
القيمة التلقائية: null
bubble.opacity

مستوى شفافية الفقاعات، حيث تكون 0 شفافة تمامًا و1 معتمة تمامًا

النوع: رقم بين 0.0 و1.0
القيمة التلقائية: 0.8
bubble.stroke

لون حدود الفقاعات

النوع: string
القيمة التلقائية: '#ccc'
bubble.textStyle

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

{color: <string>, fontName: <string>, fontSize: <number>}

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
السلسلة

كائن من الكائنات، حيث تكون المفاتيح هي أسماء السلسلة (القيم في عمود "اللون") ويصف كل كائن تنسيق السلسلة المقابلة في الرسم البياني. إذا لم يتم تحديد سلسلة أو قيمة، سيتم استخدام القيمة العامة. يتيح كل عنصر استخدام الخصائص التالية:

  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.
مثال:
series: {'Europe': {color: 'green'}}
النوع: عنصر يتضمّن عناصر أخرى
القيمة التلقائية: {}
sizeAxis

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

 {minValue: 0,  maxSize: 20}
النوع: object
القيمة التلقائية: null
sizeAxis.maxSize

الحد الأقصى لنصف قطر أكبر فقاعة ممكنة، بالبكسل

النوع: number
القيمة التلقائية: 30
sizeAxis.minSize

الحد الأدنى لنصف قطر أصغر فقاعة ممكنة، بالبكسل

النوع: number
القيمة التلقائية: 5
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

إذا تم ضبطها على true، سيتعامل المخطط مع العمود كعمود نصي.

النوع: boolean
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات إعداد التقويم

الاسم
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
العرض

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

النوع: number
القيمة التلقائية: عرض العنصر الحاوي

خيارات ضبط إعدادات الرسم البياني بالشموع

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • fallingColor.fill: تلغي هذه السمة قيمة candlestick.fallingColor.fill العامة لهذه السلسلة.
  • fallingColor.stroke: تلغي هذه السمة قيمة candlestick.fallingColor.stroke العامة لهذه السلسلة.
  • fallingColor.strokeWidth: تلغي هذه السمة قيمة candlestick.fallingColor.strokeWidth العامة لهذه السلسلة.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • risingColor.fill: تلغي هذه السمة قيمة candlestick.risingColor.fill العامة لهذه السلسلة.
  • risingColor.stroke: تلغي هذه السمة قيمة candlestick.risingColor.stroke العامة لهذه السلسلة.
  • risingColor.strokeWidth: تلغي هذه السمة قيمة candlestick.risingColor.strokeWidth العامة لهذه السلسلة.
  • targetAxisIndex: المحور الذي سيتم تعيين هذه السلسلة إليه، حيث يمثّل 0 المحور التلقائي، ويمثّل 1 المحور المعاكس. القيمة التلقائية هي 0، ويمكن ضبطها على 1 لتحديد رسم بياني يتم فيه عرض السلاسل المختلفة على محاور مختلفة. يجب تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} } 
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات إعداد المخطط العمودي

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
isStacked

إذا تم ضبطها على true، يتم ترتيب العناصر لجميع السلاسل في كل قيمة نطاق. ملاحظة: في الرسومات البيانية من النوع Column و Area و SteppedArea، تعكس &quot;رسومات Google البيانية&quot; ترتيب عناصر وسيلة الإيضاح لتتطابق بشكل أفضل مع ترتيب عناصر السلسلة (على سبيل المثال، ستكون السلسلة 0 هي عنصر وسيلة الإيضاح السفلي). لا ينطبق ذلك على الرسومات البيانية الشريطية.

يتيح الخيار 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، ويجب أن تكون قيمة الأساس صفرًا.

النوع: boolean/string
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

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

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

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

  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • targetAxisIndex: المحور الذي سيتم تعيين هذه السلسلة إليه، حيث يمثّل 0 المحور التلقائي، ويمثّل 1 المحور المعاكس. القيمة التلقائية هي 0، ويمكن ضبطها على 1 لتحديد رسم بياني يتم فيه عرض السلاسل المختلفة على محاور مختلفة. يجب تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
خطوط المؤشرات

تعرض خطوط المؤشرات في الرسوم البيانية التي تتوافق معها. يتم تلقائيًا استخدام خطوط الاتجاه linear، ولكن يمكن تخصيص ذلك باستخدام الخيار trendlines.n.type.

يتم تحديد خطوط الاتجاه على أساس كل سلسلة، لذا ستظهر خياراتك في معظم الأحيان على النحو التالي:

 var options = {   trendlines: {     0: {       type: 'linear',       color: 'green',       lineWidth: 3,       opacity: 0.3,       visibleInLegend: true     }   } }     
النوع: object
القيمة التلقائية: null
trendlines.n.color

لون خط الاتجاه ، معبَّرًا عنه إما باسم لون باللغة الإنجليزية أو كسلسلة سداسية عشرية.

النوع: string
تلقائي: لون السلسلة التلقائي
trendlines.n.degree

بالنسبة إلى خطوط الاتجاه لـ type: 'polynomial'، تمثّل درجة الحدود المتعددة (2 للتربيعية، و3 للتكعيبية، وما إلى ذلك).

النوع: number
القيمة التلقائية: 3
trendlines.n.labelInLegend

في حال ضبطها، سيظهر خط الاتجاه في وسيلة الإيضاح كسلسلة.

النوع: string
القيمة التلقائية: null
trendlines.n.lineWidth

تمثّل هذه السمة عرض خط الميل، بوحدة البكسل.

النوع: number
القيمة التلقائية: 2
trendlines.n.type

تحدّد هذه السمة ما إذا كانت خطوط المؤشرات هي 'linear' (القيمة التلقائية) أو 'exponential' أو 'polynomial'.

النوع: string
القيمة التلقائية: linear
trendlines.n.visibleInLegend

تُستخدَم لتحديد ما إذا كانت معادلة خط الاتجاه تظهر في وسيلة الإيضاح. سيظهر في تلميح خط الاتجاه.

النوع: boolean
القيمة التلقائية: false
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات إعداد الرسم البياني المجمّع

الاسم
areaOpacity

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

النوع: number، 0.0- 1.0
القيمة التلقائية: 0.3
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
curveType

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

  • 'none': خطوط مستقيمة بدون انحناء
  • 'function': سيتم تنعيم زوايا الخط.
النوع:string
القيمة التلقائية: none
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
interpolateNulls

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

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

النوع: boolean
القيمة التلقائية: false
isStacked

إذا تم ضبطها على true، يتم ترتيب العناصر لجميع السلاسل في كل قيمة نطاق. ملاحظة: في الرسومات البيانية من النوع Column و Area و SteppedArea، تعكس &quot;رسومات Google البيانية&quot; ترتيب عناصر وسيلة الإيضاح لتتطابق بشكل أفضل مع ترتيب عناصر السلسلة (على سبيل المثال، ستكون السلسلة 0 هي عنصر وسيلة الإيضاح السفلي). لا ينطبق ذلك على الرسومات البيانية الشريطية.

يتيح الخيار 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، ويجب أن تكون قيمة الأساس صفرًا.

النوع: boolean/string
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

النوع: number
القيمة التلقائية: 2
pointShape

شكل عناصر البيانات الفردية: 'circle' أو 'triangle' أو 'square' أو 'diamond' أو 'star' أو 'polygon' يمكنك الاطّلاع على مستندات النقاط للحصول على أمثلة.

النوع: string
القيمة التلقائية: 'circle'
pointSize

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

النوع: number
القيمة التلقائية: 0
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

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

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

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

  • areaOpacity: تلغي هذه السمة قيمة areaOpacity العامة لهذه السلسلة.
  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • curveType: تلغي هذه السمة قيمة curveType العامة لهذه السلسلة.
  • fallingColor.fill: تلغي هذه السمة قيمة candlestick.fallingColor.fill العامة لهذه السلسلة.
  • fallingColor.stroke: تلغي هذه السمة قيمة candlestick.fallingColor.stroke العامة لهذه السلسلة.
  • fallingColor.strokeWidth: تلغي هذه السمة قيمة candlestick.fallingColor.strokeWidth العامة لهذه السلسلة.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • lineDashStyle: تلغي هذه السمة قيمة lineDashStyle العامة لهذه السلسلة.
  • lineWidth: تلغي هذه السمة قيمة lineWidth العامة لهذه السلسلة.
  • pointShape: تلغي هذه السمة قيمة pointShape العامة لهذه السلسلة.
  • pointSize: تلغي هذه السمة قيمة pointSize العامة لهذه السلسلة.
  • pointsVisible: تلغي هذه السمة قيمة pointsVisible العامة لهذه السلسلة.
  • risingColor.fill: تلغي هذه السمة قيمة candlestick.risingColor.fill العامة لهذه السلسلة.
  • risingColor.stroke: تلغي هذه السمة قيمة candlestick.risingColor.stroke العامة لهذه السلسلة.
  • risingColor.strokeWidth: تلغي هذه السمة قيمة candlestick.risingColor.strokeWidth العامة لهذه السلسلة.
  • targetAxisIndex: المحور الذي سيتم تعيين هذه السلسلة إليه، حيث يمثّل 0 المحور التلقائي، ويمثّل 1 المحور المعاكس. القيمة التلقائية هي 0، ويمكن ضبطها على 1 لتحديد رسم بياني يتم فيه عرض السلاسل المختلفة على محاور مختلفة. يجب تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.
  • type: نوع العلامة لهذه السلسلة القيم الصالحة هي "line" و"area" و"bars" و"steppedArea". يُرجى العِلم أنّ الأشرطة هي في الواقع أشرطة عمودية (أعمدة). يتم تحديد القيمة التلقائية من خلال الخيار seriesType في الرسم البياني.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات ضبط المقياس

الاسم
greenColor

اللون الذي سيتم استخدامه للقسم الأخضر في ترميز ألوان HTML

النوع: string
القيمة التلقائية: '#109618'
greenFrom

أدنى قيمة لنطاق مميّز باللون الأخضر

النوع: number
القيمة التلقائية: لا شيء
greenTo

أعلى قيمة لنطاق مميّز باللون الأخضر

النوع: number
القيمة التلقائية: لا شيء
الطول

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

النوع: number
القيمة التلقائية: عرض الحاوية
الحد الأقصى

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

هذا مشابه للسمة maxValue في المخططات الأساسية.

النوع: number
تلقائي: تلقائي
دقيقة

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

هذا مشابه للسمة minValue في المخططات الأساسية.

النوع: number
تلقائي: تلقائي
redColor

اللون الذي سيتم استخدامه للقسم الأحمر في ترميز ألوان HTML.

النوع: string
القيمة التلقائية: '#DC3912'
redFrom

أدنى قيمة لنطاق مميّز باللون الأحمر

النوع: number
القيمة التلقائية: لا شيء
redTo

أعلى قيمة لنطاق مميّز باللون الأحمر

النوع: number
القيمة التلقائية: لا شيء
العرض

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

النوع: number
القيمة التلقائية: عرض الحاوية
yellowColor

اللون الذي سيتم استخدامه للقسم الأصفر في ترميز ألوان HTML.

النوع: string
القيمة التلقائية: '#FF9900'
yellowFrom

أدنى قيمة لنطاق مميّز باللون الأصفر

النوع: number
القيمة التلقائية: لا شيء
yellowTo

أعلى قيمة لنطاق مميّز باللون الأصفر

النوع: number
القيمة التلقائية: لا شيء

خيارات ضبط الرسم البياني الجغرافي

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
datalessRegionColor

اللون الذي سيتم تعيينه للمناطق التي لا تتضمّن بيانات مرتبطة

النوع: string
القيمة التلقائية: '#F5F5F5'
defaultColor

اللون الذي سيتم استخدامه لنقاط البيانات في رسم بياني جغرافي عندما يكون الموقع الجغرافي (مثل تكون السمة 'US' ) متوفّرة ولكن تكون القيمة إما null أو غير محدّدة. يختلف ذلك عن datalessRegionColor، وهو اللون المستخدَم عند عدم توفّر بيانات.

النوع: string
القيمة التلقائية: '#267114'
displayMode

تحدّد هذه السمة نوع الخريطة الجغرافية. يجب أن يتطابق تنسيق DataTable مع القيمة المحدّدة. يمكن استخدام القيم التالية:

  • 'auto': اختَر استنادًا إلى تنسيق DataTable.
  • 'regions' - تلوين المناطق في الرسم البياني الجغرافي
  • 'markers' - ضَع علامات على المناطق.
  • 'text' - تصنيف المناطق باستخدام نص من DataTable
النوع: string
القيمة التلقائية: auto
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legendTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
المنطقة

المنطقة المطلوب عرضها على الرسم البياني الجغرافي يتم عرض المناطق المحيطة أيضًا. يمكن أن تكون إحدى القيم التالية:

  • 'world': رسم بياني جغرافي للعالم بأسره
  • قارة أو شبه قارة، يتم تحديدها من خلال رمز مكوّن من 3 أرقام، مثل '011' لغرب أفريقيا.
  • تمثّل هذه السمة بلدًا محدّدًا برمز ISO 3166-1 alpha-2، مثل ‫'AU' لأستراليا
  • تمثّل هذه السمة ولاية في الولايات المتحدة، ويتم تحديدها من خلال رمز ISO 3166-2:US، مثلاً: ‫'US-AL' في ألاباما يُرجى العِلم أنّه يجب ضبط الخيار resolution على 'provinces' أو 'metros'.
النوع: string
القيمة التلقائية: world
العرض

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

النوع: number
القيمة التلقائية: عرض العنصر الحاوي

خيارات إعداد المدرّج التكراري

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object/div>
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
histogram.bucketSize

تحديد حجم كل شريط مدرج تكراري بشكل ثابت بدلاً من السماح بتحديده بشكل خوارزمي

النوع: number
القيمة التلقائية: تلقائي
histogram.hideBucketItems

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

النوع: boolean
القيمة التلقائية: false
histogram.lastBucketPercentile

عند احتساب حجم مجموعة الرسم البياني المدرّج التكراري، تجاهِل النسبة المئوية lastBucketPercentile في الأعلى والأسفل. لا تزال القيم مضمّنة في المدرّج التكراري، ولكنّها لا تؤثّر في التقسيم إلى مجموعات.

النوع: number
القيمة التلقائية: 0
interpolateNulls

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

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

النوع: boolean
القيمة التلقائية: false
isStacked

إذا تم ضبطها على true، يتم ترتيب العناصر لجميع السلاسل في كل قيمة نطاق. ملاحظة: في الرسومات البيانية من النوع Column و Area و SteppedArea، تعكس &quot;رسومات Google البيانية&quot; ترتيب عناصر وسيلة الإيضاح لتتطابق بشكل أفضل مع ترتيب عناصر السلسلة (على سبيل المثال، ستكون السلسلة 0 هي عنصر وسيلة الإيضاح السفلي). لا ينطبق ذلك على الرسومات البيانية الشريطية.

يتيح الخيار 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، ويجب أن تكون قيمة الأساس صفرًا.

النوع: boolean/string
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • targetAxisIndex: المحور الذي سيتم تعيين هذه السلسلة إليه، حيث يمثّل 0 المحور التلقائي، ويمثّل 1 المحور المعاكس. القيمة التلقائية هي 0، ويمكن ضبطها على 1 لتحديد رسم بياني يتم فيه عرض السلاسل المختلفة على محاور مختلفة. يجب تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
العرض

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

النوع: number
القيمة التلقائية: عرض العنصر الحاوي

خيارات إعداد المخطط الخطي

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
curveType

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

  • 'none': خطوط مستقيمة بدون انحناء
  • 'function': سيتم تنعيم زوايا الخط.
النوع: string
القيمة التلقائية: none
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع:string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
interpolateNulls

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

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

النوع: boolean
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

النوع: number
القيمة التلقائية: 2
pointShape

شكل عناصر البيانات الفردية: 'circle' أو 'triangle' أو 'square' أو 'diamond' أو 'star' أو 'polygon' يمكنك الاطّلاع على مستندات النقاط للحصول على أمثلة.

النوع: string
القيمة التلقائية: 'circle'
pointSize

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

النوع: number
القيمة التلقائية: 0
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

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

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

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

  • type: نوع العلامة لهذه السلسلة القيم الصالحة هي "line" و"area" و"bars" و"steppedArea". يُرجى العِلم أنّ الأشرطة هي في الواقع أشرطة عمودية (أعمدة). يتم تحديد القيمة التلقائية من خلال الخيار seriesType في الرسم البياني.
  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • curveType: تلغي هذه السمة قيمة curveType العامة لهذه السلسلة.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • lineDashStyle: تلغي هذه السمة قيمة lineDashStyle العامة لهذه السلسلة.
  • lineWidth: تلغي هذه السمة قيمة lineWidth العامة لهذه السلسلة.
  • pointShape: تلغي هذه السمة قيمة pointShape العامة لهذه السلسلة.
  • pointSize: تلغي هذه السمة قيمة pointSize العامة لهذه السلسلة.
  • pointsVisible: تلغي هذه السمة قيمة pointsVisible العامة لهذه السلسلة.
  • targetAxisIndex: المحور الذي سيتم تعيين هذه السلسلة إليه، حيث يمثّل 0 المحور التلقائي، ويمثّل 1 المحور المعاكس. القيمة التلقائية هي 0، ويمكن ضبطها على 1 لتحديد رسم بياني يتم فيه عرض السلاسل المختلفة على محاور مختلفة. يجب تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

إذا تم ضبطها على true، سيتعامل المخطط مع العمود كعمود نصي.

النوع: boolean
خطوط المؤشرات

تعرض خطوط المؤشرات في الرسوم البيانية التي تتوافق معها. يتم تلقائيًا استخدام خطوط الاتجاه linear، ولكن يمكن تخصيص ذلك باستخدام الخيار trendlines.n.type.

يتم تحديد خطوط الاتجاه على أساس كل سلسلة، لذا ستظهر خياراتك في معظم الأحيان على النحو التالي:

 var options = {   trendlines: {     0: {       type: 'linear',       color: 'green',       lineWidth: 3,       opacity: 0.3,       visibleInLegend: true     }   } }     
النوع: object
القيمة التلقائية: null
trendlines.n.color

لون خط الاتجاه ، معبَّرًا عنه إما باسم لون باللغة الإنجليزية أو كسلسلة سداسية عشرية.

النوع: string
تلقائي: لون السلسلة التلقائي
trendlines.n.degree

بالنسبة إلى خطوط الاتجاه لـ type: 'polynomial'، تمثّل درجة الحدود المتعددة (2 للتربيعية، و3 للتكعيبية، وما إلى ذلك).

النوع: number
القيمة التلقائية: 3
trendlines.n.labelInLegend

في حال ضبطها، سيظهر خط الاتجاه في وسيلة الإيضاح كسلسلة.

النوع: string
القيمة التلقائية: null
trendlines.n.lineWidth

تمثّل هذه السمة عرض خط المؤشر بالبكسل.

النوع: number
القيمة التلقائية: 2
trendlines.n.type

تحدّد هذه السمة ما إذا كانت خطوط المؤشرات هي 'linear' (القيمة التلقائية) أو 'exponential' أو 'polynomial'.

النوع: string
القيمة التلقائية: linear
trendlines.n.visibleInLegend

تُستخدَم لتحديد ما إذا كانت معادلة خط الاتجاه تظهر في وسيلة الإيضاح. سيظهر في تلميح خط الاتجاه.

النوع: boolean
القيمة التلقائية: false
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات ضبط الرسم البياني الهيكلي

الاسم
اللون

لون خلفية عناصر المخطط التنظيمي

النوع: string
القيمة التلقائية: '#edf7ff'
selectionColor

لون الخلفية لعناصر المخطط التنظيمي المحدّدة

النوع: string
القيمة التلقائية: '#d6e9f8'
الحجم

الحجم الكلي للرسم البياني تشمل الخيارات 'small' أو 'medium' أو 'large'.

النوع: string
القيمة التلقائية: 'medium'

خيارات إعداد المخطط الدائري

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
is3D

إذا كانت true، تعرض مخططًا ثلاثي الأبعاد.

النوع: boolean
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
pieHole

إذا كانت القيمة بين 0 و1، يتم عرض رسم بياني دائري مجوّف. يبلغ نصف قطر الثقب number ضعف نصف قطر الرسم البياني.

النوع: number
القيمة التلقائية: 0
pieSliceBorderColor

لون حدود الشريحة لا ينطبق ذلك إلا عندما يكون الرسم البياني ثنائي الأبعاد.

النوع: string
القيمة التلقائية: 'white'
pieSliceText

محتوى النص المعروض على الشريحة يمكن أن تكون إحدى القيم التالية:

  • 'percentage': النسبة المئوية لحجم الشريحة من الإجمالي.
  • 'value': القيمة الكمية للشريحة.
  • 'label': اسم الشريحة.
  • 'none': لا يتم عرض أي نص.
النوع: string
القيمة التلقائية: 'percentage'
pieSliceTextStyle

عنصر يحدّد نمط نص الشريحة. يكون الكائن بالتنسيق التالي:

{color: <string>, fontName: <string>, fontSize: <number>}

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
slices.color

اللون المستخدَم في هذا الجزء

النوع: string
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}

خيارات إعداد المخطط البياني المبعثر

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع:string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
curveType

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

  • 'none': خطوط مستقيمة بدون انحناء
  • 'function': سيتم تنعيم زوايا الخط.
النوع:string
القيمة التلقائية: none
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.gridlines.color

لون خطوط الشبكة الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
القيمة التلقائية: '#CCC'
hAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
hAxis.logScale

السمة hAxis التي تجعل المحور الأفقي مقياسًا لوغاريتميًا (تتطلّب أن تكون جميع القيم موجبة). اضبط القيمة على true للإشارة إلى "نعم".

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: boolean
القيمة التلقائية: false
hAxis.maxValue

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

النوع: number
تلقائي: تلقائي
hAxis.minorGridlines

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
hAxis.minorGridlines.color

لون خطوط الشبكة الثانوية الأفقية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
hAxis.minorGridlines.count

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

النوع: number
القيمة التلقائية: 1
hAxis.minValue

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

النوع: number
تلقائي: تلقائي
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

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

النوع: number
القيمة التلقائية: 2
pointShape

شكل عناصر البيانات الفردية: 'circle' أو 'triangle' أو 'square' أو 'diamond' أو 'star' أو 'polygon' يمكنك الاطّلاع على مستندات النقاط للحصول على أمثلة.

النوع: string
القيمة التلقائية: 'circle'
pointSize

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

النوع: number
القيمة التلقائية: 0
السلسلة

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

  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • lineWidth: تلغي هذه السمة قيمة lineWidth العامة لهذه السلسلة.
  • pointShape: تلغي هذه السمة قيمة pointShape العامة لهذه السلسلة.
  • pointSize: تلغي هذه السمة قيمة pointSize العامة لهذه السلسلة.
  • pointsVisible: تلغي هذه السمة قيمة pointsVisible العامة لهذه السلسلة.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

إذا تم ضبطها على true، سيتعامل المخطط مع العمود كعمود نصي.

النوع: boolean
خطوط المؤشرات

تعرض خطوط المؤشرات في الرسوم البيانية التي تتوافق معها. يتم تلقائيًا استخدام خطوط الاتجاه linear، ولكن يمكن تخصيص ذلك باستخدام الخيار trendlines.n.type.

يتم تحديد خطوط الاتجاه على أساس كل سلسلة، لذا ستظهر خياراتك في معظم الأحيان على النحو التالي:

 var options = {   trendlines: {     0: {       type: 'linear',       color: 'green',       lineWidth: 3,       opacity: 0.3,       visibleInLegend: true     }   } }     
النوع: object
القيمة التلقائية: null
trendlines.n.color

لون خط الاتجاه ، معبَّرًا عنه إما باسم لون باللغة الإنجليزية أو كسلسلة سداسية عشرية.

النوع: string
تلقائي: لون السلسلة التلقائي
trendlines.n.degree

بالنسبة إلى خطوط الاتجاه لـ type: 'polynomial'، تمثّل درجة الحدود المتعددة (2 للتربيعية، و3 للتكعيبية، وما إلى ذلك).

النوع: number
القيمة التلقائية: 3
trendlines.n.labelInLegend

في حال ضبطها، سيظهر خط الاتجاه في وسيلة الإيضاح كسلسلة.

النوع: string
القيمة التلقائية: null
trendlines.n.lineWidth

تمثّل هذه السمة عرض خط المؤشر بالبكسل.

النوع: number
القيمة التلقائية: 2
trendlines.n.type

تحدّد هذه السمة ما إذا كانت خطوط المؤشرات هي 'linear' (القيمة التلقائية) أو 'exponential' أو 'polynomial'.

النوع: string
القيمة التلقائية: linear
trendlines.n.visibleInLegend

تُستخدَم لتحديد ما إذا كانت معادلة خط الاتجاه تظهر في وسيلة الإيضاح. سيظهر في تلميح خط الاتجاه.

النوع: boolean
القيمة التلقائية: false
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي

خيارات إعداد الرسم البياني المساحي المدرّج

الاسم
areaOpacity

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

النوع: number، 0.0- 1.0
القيمة التلقائية: 0.3
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
backgroundColor.fill

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

النوع: string
القيمة التلقائية: 'white'
chartArea

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

النوع: object
القيمة التلقائية: null
chartArea.backgroundColor
لون خلفية مساحة الرسم البياني عند استخدام سلسلة، يمكن أن تكون سلسلة سداسية عشرية (مثل '#fdc') أو اسم لون باللغة الإنجليزية. عند استخدام عنصر، يمكن تقديم الخصائص التالية:
  • stroke: اللون، ويتم تقديمه كسلسلة سداسية عشرية أو اسم لون باللغة الإنجليزية.
  • strokeWidth: في حال توفّره، يرسم هذا الخيار حدًا حول مساحة الرسم البياني بالعرض المحدّد (وبلون stroke).
النوع: string أو object
القيمة التلقائية: 'white'
chartArea.height

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

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.left

تحديد المسافة التي يجب رسم المخطط البياني بها من الحد الأيمن

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.top

تحدّد هذه السمة المسافة التي يجب رسم الرسم البياني بها من الحدّ العلوي.

النوع: number أو string
القيمة التلقائية: تلقائي
chartArea.width

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

النوع: number أو string
القيمة التلقائية: تلقائي
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
hAxis

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

 {   title: 'Hello',   titleTextStyle: {     color: '#FF0000'   } }     
النوع: object
القيمة التلقائية: null
hAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
hAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
hAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

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

النوع: string
القيمة التلقائية: null
hAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور الأفقي.

النوع: object
القيمة التلقائية: null
hAxis.viewWindow.max

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
hAxis.viewWindow.min

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

يتم تجاهله عندما تكون قيمة hAxis.viewWindowMode هي 'pretty' أو 'maximized'.

النوع: number
القيمة التلقائية: تلقائي
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
isStacked

إذا تم ضبطها على true، يتم ترتيب العناصر لجميع السلاسل في كل قيمة نطاق. ملاحظة: في الرسومات البيانية من النوع Column و Area و SteppedArea، تعكس &quot;رسومات Google البيانية&quot; ترتيب عناصر وسيلة الإيضاح لتتطابق بشكل أفضل مع ترتيب عناصر السلسلة (على سبيل المثال، ستكون السلسلة 0 هي عنصر وسيلة الإيضاح السفلي). لا ينطبق ذلك على الرسومات البيانية الشريطية.

يتيح الخيار 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، ويجب أن تكون قيمة الأساس صفرًا.

النوع: boolean/ string
القيمة التلقائية: false
أسطورة

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
النوع: object
القيمة التلقائية: null
legend.position

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

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

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

إذا تم ضبطها على true، يتم رسم السلسلة من اليمين إلى اليسار. الإعداد التلقائي هو الرسم من اليسار إلى اليمين.

لا يتوفّر هذا الخيار إلا لمحور discrete major.

النوع: boolean
القيمة التلقائية: false
السلسلة

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

  • areaOpacity: تلغي قيمة areaOpacity العامة لهذه السلسلة.
  • color: اللون الذي سيتم استخدامه لهذه السلسلة. حدِّد سلسلة ألوان HTML صالحة.
  • type: نوع العلامة لهذه السلسلة القيم الصالحة هي "line" و"area" و"bars" و"steppedArea". يُرجى العِلم أنّ الأشرطة هي في الواقع أشرطة عمودية (أعمدة). يتم تحديد القيمة التلقائية من خلال الخيار seriesType في الرسم البياني.
  • labelInLegend: وصف السلسلة الذي سيظهر في وسيلة الإيضاح الخاصة بالرسم البياني
  • lineDashStyle: تلغي هذه السمة قيمة lineDashStyle العامة لهذه السلسلة.
  • targetAxisIndex: المحور الذي سيتم تعيين هذه السلسلة إليه، حيث يمثّل 0 المحور التلقائي، ويمثّل 1 المحور المعاكس. القيمة التلقائية هي 0، ويمكن ضبطها على 1 لتحديد رسم بياني يتم فيه عرض السلاسل المختلفة على محاور مختلفة. يجب تخصيص سلسلة واحدة على الأقل للمحور التلقائي. يمكنك تحديد مقياس مختلف لمحاور مختلفة.
  • visibleInLegend: قيمة boolean، حيث يشير true إلى أنّ السلسلة يجب أن تتضمّن إدخالاً في وسيلة الإيضاح، ويشير false إلى أنّها يجب ألا تتضمّن إدخالاً. القيمة التلقائية هي true.

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

 series: [   {color: 'black', visibleInLegend: false}, {}, {},   {color: 'red', visibleInLegend: false} ] series: {   0:{color: 'black', visibleInLegend: false},   3:{color: 'red', visibleInLegend: false} }     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر مدمجة
القيمة التلقائية: {}
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
مظهر

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

  • 'maximized': تعمل هذه السمة على زيادة مساحة الرسم البياني إلى أقصى حد، كما ترسم وسيلة الإيضاح وجميع التصنيفات داخل مساحة الرسم البياني.
النوع: string
القيمة التلقائية: null
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

إذا تم ضبطها على true، سيتعامل المخطط مع العمود كعمود نصي.

النوع: boolean
useFirstColumnAsDomain

إذا تم ضبطها على true، سيتعامل الرسم البياني مع العمود كنطاق.

النوع: boolean
vAxes

تحدّد هذه السمة خصائص المحاور العمودية الفردية، إذا كان الرسم البياني يتضمّن محاور عمودية متعدّدة. كل عنصر ثانوي هو عنصر 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   } ]     
النوع: مصفوفة من العناصر أو عنصر يتضمّن عناصر فرعية
القيمة التلقائية: null
vAxis

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
النوع: object
القيمة التلقائية: null
vAxis.direction

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

النوع: 1 أو -1
القيمة التلقائية: 1
vAxis.gridlines

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

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

لا يتوفّر هذا الخيار إلا لمحور continuous.

النوع: object
القيمة التلقائية: null
vAxis.gridlines.color

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

النوع: string
القيمة التلقائية: '#CCC'
vAxis.gridlines.count

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

النوع: number
القيمة التلقائية: -1
vAxis.logScale

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

النوع: boolean
القيمة التلقائية: false
vAxis.maxValue

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

النوع: number
تلقائي: تلقائي
vAxis.minorGridlines

كائن يتضمّن عناصر لإعداد خطوط الشبكة الثانوية على المحور العمودي، على غرار الخيار vAxis.gridlines.

النوع: object
القيمة التلقائية: null
vAxis.minorGridlines.color

لون خطوط الشبكة الثانوية العمودية داخل مساحة الرسم البياني يُرجى تحديد سلسلة ألوان HTML صالحة.

النوع: string
تلقائي: مزيج من ألوان خطوط الشبكة والخلفية
vAxis.minorGridlines.count

تم إيقاف الخيار minorGridlines.count نهائيًا في معظم الحالات، باستثناء إيقاف خطوط الشبكة الثانوية من خلال ضبط العدد على 0. يعتمد عدد خطوط الشبكة الثانوية على الفاصل بين خطوط الشبكة الرئيسية والحد الأدنى للمساحة المطلوبة.

النوع: number
القيمة التلقائية: 1
vAxis.minValue

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

النوع: number
القيمة التلقائية: null
vAxis.textPosition

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

النوع: string
القيمة التلقائية: 'out'
vAxis.textStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

تحدّد هذه السمة عنوانًا للمحور العمودي.

النوع: string
القيمة التلقائية: ما مِن عنوان
vAxis.titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

تحدّد هذه السمة نطاق الاقتصاص للمحور العمودي.

النوع: object
القيمة التلقائية: null
vAxis.viewWindow.max

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
vAxis.viewWindow.min

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

يتم تجاهلها عندما تكون قيمة vAxis.viewWindowMode هي "pretty" أو "maximized".

النوع: number
القيمة التلقائية: تلقائي
العرض

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

النوع: number
القيمة التلقائية: عرض العنصر الحاوي

خيارات إعداد الرسم البياني الجدولي

الاسم
alternatingRowStyle

تحدّد هذه السمة ما إذا كان سيتم تعيين نمط ألوان متناوب للصفوف الفردية والزوجية.

النوع: boolean
القيمة التلقائية: true
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
صفحة

ما إذا كان من الممكن تفعيل تقسيم البيانات إلى صفحات وكيفية ذلك اختَر إحدى قيم string التالية:

  • 'enable' - سيتضمّن الجدول زرَّي الانتقال إلى الصفحة التالية والصفحة السابقة. سيؤدي النقر على هذه الأزرار إلى تنفيذ عملية التقسيم إلى صفحات وتغيير الصفحة المعروضة. ننصحك أيضًا بتحديد الخيار pageSize.
  • 'event' - سيتضمّن الجدول زرَّي الانتقال إلى الصفحة التالية والصفحة السابقة، ولكن النقر عليهما سيؤدي إلى تشغيل حدث 'page' ولن يؤدي إلى تغيير الصفحة المعروضة. يجب استخدام هذا الخيار عندما تنفّذ الرمز البرمجي منطقًا خاصًا به لتقليب الصفحات. راجِع مثال TableQueryWrapper للاطّلاع على مثال حول كيفية التعامل مع أحداث تقسيم الصفحات يدويًا.
  • 'disable' - [Default] لا تتوفّر ميزة تقسيم الصفحات.
  • النوع: string
    القيمة التلقائية: 'disable'
pageSize

عدد الصفوف في كل صفحة، عندما تكون ميزة تقسيم المحتوى إلى صفحات مفعّلة مع خيار الصفحة

النوع: number
القيمة التلقائية: 10
showRowNumber

إذا تم ضبطها على true، سيتم عرض رقم الصف كعمود أول في الجدول.

النوع: boolean
القيمة التلقائية: false
ترتيب

تحديد ما إذا كان سيتم ترتيب الأعمدة وكيفية ترتيبها عندما ينقر المستخدم على عنوان عمود في حال تفعيل الترتيب، ننصحك بضبط السمتَين sortAscending وsortColumn أيضًا. اختَر إحدى قيم string التالية:

  • 'enable' - [تلقائي] يمكن للمستخدمين النقر على عناوين الأعمدة للترتيب حسب العمود الذي تم النقر عليه. عندما ينقر المستخدمون على عنوان العمود، يتم ترتيب الصفوف تلقائيًا، ويتم بدء 'sort'حدث.
  • 'event' - عند نقر المستخدمين على عنوان العمود، يتم تنشيط الحدث 'sort'، ولكن لا يتم ترتيب الصفوف تلقائيًا. يجب استخدام هذا الخيار عندما تنفّذ الصفحة عملية ترتيب خاصة بها. اطّلِع على مثال TableQueryWrapper للحصول على مثال حول كيفية التعامل مع ترتيب الأحداث يدويًا.
  • 'disable'- لا يؤدي النقر على عنوان عمود إلى أي نتيجة.
النوع: string
القيمة التلقائية: 'enable'
sortAscending

ترتيب فرز العمود الأوّلي. True للترتيب التصاعدي، وfalse للترتيب التنازلي. يتم تجاهل هذه السمة إذا لم يتم تحديد sortColumn.

النوع: boolean
القيمة التلقائية: true
sortColumn

فهرس لعمود في جدول البيانات، يتم من خلاله فرز الجدول في البداية يتم تمييز العمود بسهم صغير يشير إلى ترتيب الفرز.

النوع: number
القيمة التلقائية: -1
العرض

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

النوع: number
القيمة التلقائية: عرض العنصر الحاوي

خيارات إعداد المخطط الزمني

الاسم
backgroundColor

لون الخلفية للمنطقة الرئيسية من الرسم البياني يمكن أن تكون هذه السمة سلسلة ألوان HTML بسيطة، مثل 'red' أو '#00cc00'، أو كائنًا يتضمّن السمات التالية.

النوع: string أو object
القيمة التلقائية: 'white'
الألوان

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

النوع: مصفوفة من السلاسل
تلقائي: الألوان التلقائية
الطول

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

النوع: number
القيمة التلقائية: ارتفاع العنصر الحاوي
العرض

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

النوع: number
القيمة التلقائية: عرض العنصر الحاوي

خيارات ضبط الخريطة المتفرّعة

الاسم
headerColor

لون قسم العنوان لكل عقدة حدِّد قيمة لون HTML.

النوع: string
القيمة التلقائية: #988f86
maxColor

لون المستطيل الذي يحتوي على القيمة maxColorValue في العمود 3 حدِّد قيمة لون HTML.

النوع: string
القيمة التلقائية: #00dd00
maxDepth

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

النوع: number
القيمة التلقائية: 1
maxPostDepth

عدد مستويات العُقد التي تزيد عن maxDepth المطلوب عرضها بشكل "ملمّح" تظهر العُقد التي تم اقتراحها كمستطيلات مظلّلة داخل عقدة تقع ضمن الحدّ maxDepth.

النوع: number
القيمة التلقائية: 0
midColor

لون مستطيل ذي قيمة في العمود 3 تقع في منتصف المسافة بين maxColorValue وminColorValue حدِّد قيمة لون HTML.

النوع: string
القيمة التلقائية: #000000
minColor

لون المستطيل الذي يتضمّن القيمة minColorValue في العمود 3 حدِّد قيمة لون HTML.

النوع: string
القيمة التلقائية: #dd0000
noColor

لون المستطيل الذي سيتم استخدامه عندما لا تتضمّن العقدة قيمة للعمود 3، وتكون العقدة ورقة (أو تحتوي على أوراق فقط). حدِّد قيمة لون HTML.

النوع: string
القيمة التلقائية: #000000
العنوان الفرعي

النص الذي سيتم عرضه أسفل عنوان الرسم البياني

النوع: string
القيمة التلقائية: ما مِن عنوان
subtitleTextStyle

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
textStyle

عنصر يحدّد نمط نص العنوان. يمكن أن يكون اللون أي سلسلة ألوان HTML، مثلاً: 'red' أو '#00cc00'. راجِع أيضًا fontName وfontSize.

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
title

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

النوع: string
القيمة التلقائية: ما مِن عنوان
titleTextStyle

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

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

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

النوع: object
القيمة التلقائية: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}