تصف هذه الصفحة جميع الميزات والمعلمات المتوافقة مع Chart API. وتختلف آلية عمل بعض هذه المَعلمات حسب نوع الرسم البياني، وفي هذه الحالة، يتم الربط بين المستندات والمستندات المناسبة.
المَعلمات
هذه هي المعلمات المعتمدة من قبل Google Chart API.
المَعلمة | الوصف والبنية | أنواع الرسوم البيانية |
---|---|---|
Cbh | عرض
الشريط والتباعد
|
بار |
شيكو | ألوان
السلسلة
chco= |
Bar وGoogle-o-meter وLine وMap وPie وRadar وScatter وVenn |
chd | سلسلة
بيانات الرسم البياني
chd= t:s,e,r,i,e,s,1|s,e,r,i,e,s,2|... أو s:series1,series2,... أو e:series1,series2,... |
كل الرسوم البيانية |
chdl، chdlp، chdls | نص وسيلة الإيضاح والنمط في الرسم البياني
|
Bar وCandlestick وGoogle-o-meter وLine وPie وRadar وScatter وVenn |
أمر chds | تغيير حجم
تنسيق النص باستخدام نطاق مخصّص
chds= |
جميع الرسوم البيانية التي يمكن قبول chd |
كيم | علامات الرموز الديناميكية
chem= |
شريط وشمعدان وخط ورادار ومبعثر |
فرنك سويسري | تعبئة متدرجة
chf= |
Bar وCandlestick وGoogle-ometer (في الخلفية فقط) وخط وPie (في الخلفية) ورادار وبعثر وVenn |
فرنك سويسري | التعبئة المخططة
chf= |
Bar وCandlestick وGoogle-ometer (في الخلفية فقط) وخط وPie (في الخلفية) ورادار وبعثر وVenn |
فرنك سويسري | تعبئة مصمتة
chf= |
|
فرنك سويسري | دوال البيانات
chfd= |
جميع الرسوم البيانية
التي يمكن أن تقبل chd |
تغيير | خطوط
الشبكة
chg= |
شريط وشمعدان وخط ورادار ومبعثر |
تشيلي | تصنيفات
الرسم البياني الدائري، تصنيف
مقياس Google الخاص بمقياس الأداء
chl=<label>|... |
مقياس الضغط على Google، Pie |
chld | بيانات تصنيفات الرسم البياني (أنواع مختلفة)
chld=<chart-specific_data>|<chart-specific_data>|... |
الرموز الديناميكية المستقلة |
تشيلي | أنماط
الخطوط
chls= |
الخط، الرادار |
chm=D | علامات
الخطوط
chm= |
شريط وشمعدان وخط ورادار ومبعثر |
chm=r|R | علامات
النطاقات
chm= |
شريط وشمعدان وخط ورادار ومبعثر |
chm= a|c|C d|E|o| h|H| s|S| v|V|x |
علامات
الأشكال
chm= |
شريط وشمعدان وخط ورادار ومبعثر |
chm= f|t|A|N |
علامات القيم النصية
والبيانات
chm= |
شريط وشمعدان وخط ورادار ومبعثر |
chm=F | محدّدات الشمعدان
chm= |
بار، شمعدان، خط |
chm=b/B | ملء
الأسطر
chm= |
شريط (مع علامات الخطوط فقط)، خط، رادار |
chma | هوامش
الرسم البياني
chma= |
Bar وCandlestick وGoogle-o-meter وLine وخريطة وPie ورادار وScatter وVenn |
تشوف | تنسيق
الإخراج
chof=<format> |
كل الرسوم البيانية |
بروتوكول chp | خط صفري
رسم بياني شريطي، اتجاه الرسم البياني
الدائري
chp=<zero_val>,... |
Bar وPie |
نظام التشغيل chs | حجم
الرسم البياني
chs=<width>x<height> |
كل الرسوم البيانية |
نظام التشغيل Chrome | نوع الرمز
الديناميكي
chst=<icon_string_constant> |
الرموز الديناميكية المستقلة |
cht | نوع
الرسم البياني
cht=<chart_type> |
كل الرسوم البيانية |
Chtm | المنطقة
الجغرافية
chtm=<zoom_area> |
خريطة |
chtt، chts | عنوان
الرسم البياني ونمطه
|
Bar وCandlestick وGoogle-o-meter وLine وPie وRadar وScatter وVenn |
أمر chxt | المحاور المرئية
chxt=<axis_1>,... |
Bar وCandlestick وGoogle-o-meter وخط والرادار ومبعثر |
جهاز Chxr | نطاقات
المحور
chxr= |
Bar وCandlestick وGoogle-o-meter وخط والرادار ومبعثر |
CHXL | تصنيفات
المحور
chxl= |
Bar وCandlestick وGoogle-o-meter وخط والرادار ومبعثر |
نظام chxp | مواضع تصنيف المحور
chxp= |
Bar وCandlestick وGoogle-o-meter وخط والرادار ومبعثر |
نظام chxs | أنماط
تصنيفات المحور
chxs= |
Bar، Candlestick، Google-o-meter (محدود)، خط، الرادار، مبعثر |
أمر chxtc | أنماط علامة المحور
chxtc= |
شريط وشمعدان وخط ورادار ومبعثر |
يمكنك تحديد الألوان باستخدام سلسلة مكوّنة من 6 أحرف من القيم السداسية العشرية، بالإضافة إلى قيمتَي شفافية اختياريتين، بالتنسيق RRGGBB[AA]
.
مثلاً:
FF0000
= أحمر00FF00
= أخضر0000FF
= أزرق000000
= أسودFFFFFF
= أبيض
AA
هي قيمة شفافية اختيارية، حيث يكون 00
شفافًا تمامًا وFF
معتمًا تمامًا. مثلاً:
0000FFFF
= أزرق خالص0000FF66
= أزرق شفاف
حجم الرسم البياني chs
[كل الرسوم البيانية]
تتطلب جميع الرسوم البيانية تحديد الحجم. تحدِّد هذه المَعلمة إجمالي عرض وارتفاع صورة الرسم البياني، بما في ذلك التسمية التوضيحية والهوامش والعناوين. يتم اقتصاص وسائل الإيضاح والهوامش والعناوين لتلائم الحجم الإجمالي للرسم البياني.
الحد الأقصى لحجم الرسم البياني لجميع الرسوم البيانية باستثناء الخرائط هو 300,000 بكسل إجمالاً، والحد الأقصى للعرض أو الطول هو 1,000 بكسل. الحد الأقصى لحجم الخرائط هو 440 × 220.
القيم هي أعداد صحيحة.
البنية
chs=<width>x<height>
- <width>
- العرض بالبكسل. الحد الأقصى للقيمة هو 1,000. يجب ألا يتجاوز العرض × الارتفاع 300,000.
- <height>
- الارتفاع بالبكسل الحد الأقصى للقيمة هو 1,000. لا يمكن أن يتجاوز العرض × الارتفاع 300,000.
مثال
الوصف | مثال |
---|---|
رسم بياني بدقة 250 × 100 بكسل |
chs=250x100 |
نوع الرسم البياني cht
[الكل باستثناء الرموز الديناميكية]
حدِّد نوع الرسم البياني باستخدام المَعلمة cht
. يمكنك الاطّلاع على صفحات المستندات الفردية الخاصة بالرسومات البيانية للاطّلاع على قائمة بأنواع الرسوم البيانية المتاحة.
البنية
cht=<type>[:nda]
- <type>
- هي إحدى قيم نوع الرسم البياني.
- :nda
- [اختياري، الرسومات البيانية الخطية فقط] يمكنك إضافة
:nda
بعد نوع الرسم البياني في الرسوم البيانية الخطية لإخفاء المحاور التلقائية.
أمثلة
الوصف | مثال |
---|---|
مخطط دائري |
cht=p |
مخطط Venn | cht=v |
رسم بياني خطي بمحاور تلقائية وبدونها. | |
ألوان السلسلة chco
[كل الرسوم البيانية]
يمكنك تحديد ألوان سلسلة معيّنة أو جميع عناصر سلسلة معيّنة
باستخدام المَعلمة chco
. ويمكن أن تختلف البنية والمعنى الدقيق حسب نوع الرسم البياني. لمعرفة التفاصيل، يمكنك الاطّلاع على نوع الرسم البياني المحدّد.
البنية
chco= <series_1_element_1>|...|<series_1_element_n>,<series_2>,...,<series_m>
كل إدخال في هذه السلسلة هو رقم سداسي عشري لتنسيق RRGGBB. يتم الفصل بين الألوان التي تنطبق على سلسلة كاملة بفاصلة، ويتم الفصل بين الألوان التي تنطبق على العناصر الفردية داخل السلسلة بشريط. بالنسبة إلى معظم أنواع الرسوم البيانية، يمكنك مزج أوصاف الألوان لسلسلة كاملة وعناصر السلسلة الفردية. إذا كان عدد السلاسل أو العناصر في الرسم البياني أكبر من الألوان المحدّدة في السلسلة، تتنقل واجهة برمجة التطبيقات عادةً بين ألوان العناصر من بداية هذه السلسلة (للعناصر) أو لألوان السلسلة من بداية قائمة السلاسل. مرة أخرى، يمكنك مراجعة مستندات الرسم البياني الفردية للاطّلاع على التفاصيل.
أمثلة
الوصف | مثال |
---|---|
عند تحديد لون واحد لكل سلسلة في رسم بياني خطي، يتم تخصيص اللون المقابل لكل سطر. يحتوي هذا المثال على ثلاث سلاسل بيانات وثلاثة ألوان محددة. |
|
يحتوي هذا الرسم البياني الخطي أيضًا على ثلاث سلاسل بيانات، ولكن تم تحديد لونَين فقط. وبما أنّ لون السلسلة الثالثة غير محدَّد، يتم رسم الخط الثالث باستخدام اللون الأول (الأحمر). |
|
يوضح هذا المثال كيفية تحديد لون للأعضاء الفرديين في سلسلة ما (الأشرطة في هذا المثال). |
|
هذه العملية توضّح تحديد كل من ألوان السلسلة وألوان العناصر الفردية. السلسلة الأولى كلها باللون الأسود (000000). السلسلة الثانية، والتي يتم وضع علامة فاصلة عليها، تحتوي على ألوان فردية يتم تخصيصها، ويتم الفصل بينها باستخدام أحرف |. |
|
تنسيق الإخراج chof
[كل
الرسوم البيانية]
يمكنك اختيار تنسيق الناتج للمخطط باستخدام معلمة chof. يمكن أيضًا استخدام هذه المَعلمة لعرض معلومات تصحيح الأخطاء عند تصميم الرسم البياني. يُرجى العلم بأنّ بعض تنسيقات الإخراج هي رسومات بيانية (مثل PNG وGIF)، لكنّها ليست كذلك. سيؤدي استخدام تنسيق غير مصوَّر كمَعلمة src لعلامة <img> إلى ظهور صورة معطّلة في صفحتك.
البنية
chof=png|gif|json|validate.
حدِّد إحدى السلاسل التالية:
- "png" - لعرض المخطط كصورة PNG.
- "gif" - لعرض المخطط كصورة GIF.
- "json": لعرض بيانات خريطة الصور للرسم البياني، كسلسلة JSON. يمكن استخدام هذه البيانات لإنشاء خريطة صور للرسم البياني لإتاحة إمكانية النقر على مناطق مختلفة. ويمكنك الاطّلاع على خريطة صورة رسم بياني لتنسيق هذه السلسلة والاطّلاع على مزيد من المعلومات حول كيفية استخدامها.
- 'verify' - لعرض صفحة HTML تسرد أي أخطاء في عنوان URL للرسم البياني. راجِع تصحيح الأخطاء للاطّلاع على مزيد من النصائح حول تصحيح الأخطاء.
أمثلة
الوصف | مثال | |
---|---|---|
إليك أمثلة بتنسيق PNG وGIF على الرسم البياني نفسه: |
chof=png |
chof=gif |
رسم بياني يحتوي على عنوان URL غير صالح: يؤدي تحديد |
مثال على عنوان URL سيئ مع chof=validate |
|
في ما يلي رمز HTML الذي تم عرضه لعنوان URL صالح عند |
عنوان URL صالح للرسم البياني في إطار <iframe> |
عنوان الرسم البياني chtt
، chts
[كل
الرسوم البيانية]
يمكنك تحديد نص العنوان واللون وحجم الخط للمخطط.
البنية
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
: لتحديد عنوان الرسم البياني.
- <chart_title>
- عنوان للعرض في الرسم البياني لا يمكنك تحديد مكان ظهور هذا النص، ولكن يمكنك تحديد حجم الخط ولونه اختياريًا. استخدِم علامة + للإشارة إلى المسافات، وحرف الشرطة المستقيمة (
|
) للإشارة إلى فواصل الأسطر.
chts
[اختيارية] - الألوان
وحجم الخط للمَعلمة chtt
- <color>
- لون العنوان، بتنسيق RRGGBB السداسي العشري. اللون التلقائي هو الأسود.
- <font_size>
- حجم خط العنوان بالنقاط
- <opt_alignment>
- [اختياري] محاذاة العنوان: اختَر إحدى قيم السلسلة التالية الحساسة لحالة الأحرف: "l" (يسار) أو "c" (في المنتصف) "r" (يمينًا). القيمة التلقائية هي "c".
أمثلة
الوصف | مثال |
---|---|
مخطط بعنوان، يستخدم اللون وحجم الخط الافتراضيين. يُرجى تحديد مساحة بعلامة زائد ( استخدِم حرف الشرطة ( لم يتم تحديد |
chtt=Site+visitors+by+month| |
رسم بياني بعنوان أزرق مكوّن من 20 نقطة بمحاذاة إلى اليمين. |
chtt=Site+visitors |
نص وسيلة إيضاح الرسم البياني ونمطه chdl
، chdlp
، chdls
[كل
الرسوم البيانية]
وسيلة الإيضاح هي قسم جانبي من الرسم البياني يقدّم وصفًا نصيًا صغيرًا لكل سلسلة. يمكنك تحديد النص المرتبط بكل سلسلة في وسيلة الإيضاح هذه وتحديد مكان ظهور النص على الرسم البياني.
راجِع أيضًا chma
لمعرفة كيفية ضبط الهوامش حول وسيلة الإيضاح.
ملاحظة بشأن قيم السلسلة: يُسمح فقط باستخدام الأحرف الآمنة لعنوان URL في سلاسل التصنيفات. لتحقيق الأمان، عليك ترميز عنوان URL لأي سلاسل تحتوي على أحرف ليست ضمن مجموعة الأحرف 0-9a-zA-Z
.
يمكنك العثور على برنامج ترميز عناوين URL في مستندات Google المرئية.
البنية
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
: نص كل سلسلة ليتم عرضه في
وسيلة الإيضاح.
- <data_series_label>
- نص إدخالات وسيلة الإيضاح ينطبق كل تصنيف على السلسلة المقابلة في مصفوفة
chd
. استخدِم علامة + للمساحة. إذا لم تحدّد هذه المَعلمة، لن يتم تضمين وسيلة إيضاح للرسم البياني. ولا تتوفّر طريقة لتحديد فاصل أسطر في التسمية. ويتم عادةً توسيع وسيلة الإيضاح لتتضمن نص التسمية التوضيحية، وسيتم تقليص مساحة الرسم البياني لتلائم وسيلة الإيضاح.
chdlp
- [اختيارية] موضع
وسيلة الإيضاح وترتيب إدخالات وسيلة الإيضاح. يمكنك تحديد <position>
و/أو <label_order>. وفي حال تحديدهما، يُرجى الفصل بينهما باستخدام حرف شريطي. يمكنك إضافة 's' إلى أي قيمة إذا أردت تخطي إدخالات وسيلة الإيضاح الفارغة في chdl
في وسيلة الإيضاح. أمثلة: chdlp=bv
وchdlp=r
وchdlp=bv|r
وchdlp=bvs|r
- <opt_position>
- [اختيارية] تحدّد هذه السمة موضع وسيلة الإيضاح على الرسم البياني. لتحديد مساحة متروكة إضافية بين وسيلة الإيضاح ومنطقة الرسم البياني أو حدود الصورة، استخدِم المَعلمة
chma
. اختَر إحدى القيم التالية:b
- وسيلة الإيضاح أسفل الرسم البياني، وإدخالات وسيلة الإيضاح في صف أفقي.bv
- وسيلة الإيضاح أسفل الرسم البياني، وإدخالات وسيلة الإيضاح في عمود عمودي.t
- تسمية توضيحية أعلى الرسم البياني، وإدخالات وسيلة الإيضاح في صف أفقي.tv
- وسيلة الإيضاح أعلى الرسم البياني، وإدخالات وسيلة الإيضاح في عمود عمودي.r
- [تلقائية] وسيلة الإيضاح على يسار الرسم البياني، وإدخالات وسيلة الإيضاح في عمود عمودي.l
- وسيلة الإيضاح على يسار الرسم البياني، وإدخالات وسيلة الإيضاح في عمود عمودي.
- <opt_label_order>
- [اختيارية]
الترتيب الذي تظهر به التصنيفات في وسيلة الإيضاح.
اختَر إحدى القيم التالية:
l
- [الخيار التلقائي وسائل الإيضاح العمودية] تعرض التصنيفات بالترتيب المقدّمchdl
.r
- عرض التصنيفات بالترتيب العكسي كما هو موضَّح فيchdl
. ويكون هذا مفيدًا في الرسوم البيانية الشريطية المكدَّسة لعرض وسيلة الإيضاح
بالترتيب نفسه الذي تظهر فيه الأشرطة.a
- [الخيار التلقائي وسائل الإيضاح الأفقية] الترتيب التلقائي: يعني تقريبًا الترتيب حسب الطول، والأقصر أولاً، وحسب قياسه في وحدات بحجم 10 بكسل. عندما يكون هناك عنصران بنفس الطول (مقسم إلى كتل بحجم 10 بكسل)، سيظهر العنصر المدرج أولاً أولاً.0,1,2...
- ترتيب التصنيف المخصّص. هذه قائمة تضم فهارس تصنيفات مستندة إلى صفر منchdl
، مفصولة بفواصل.
chdls
- [اختيارية] تحدِّد هذه السمة لون نص التسمية التوضيحية وحجمه.
- <color>
- لون نص وسيلة الإيضاح بتنسيق RRGGBB السداسي العشري.
- <size>
- حجم النقطة لنص وسيلة الإيضاح.
أمثلة
الوصف | مثال |
---|---|
مثالان على وسائل الإيضاح. حدِّد نص وسيلة الإيضاح بالترتيب نفسه كسلسلة البيانات. |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
يوضح الرسم البياني الأول إدخالات وسيلة الإيضاح الأفقية ( |
|
يوضح هذا المثال تغيير حجم الخط. |
|
هوامش الرسم البياني chma
[كل
الرسوم البيانية]
يمكنك تحديد حجم هوامش الرسم البياني بالبكسل. يتم احتساب الهوامش
للداخل من حجم الرسم البياني المحدّد (chs
)، ولا تؤدي زيادة حجم
الهامش إلى زيادة الحجم الإجمالي للرسم البياني، بل تؤدي إلى تقليص مساحة الرسم البياني
إذا لزم الأمر.
الهوامش هي بشكل افتراضي كل ما يتم تركه بعد حساب حجم المخطط. تختلف هذه القيمة التلقائية حسب نوع الرسم البياني. الهوامش التي تحدّدها هي الحد الأدنى للقيمة. إذا كانت منطقة الرسم البياني تترك مساحة للهوامش، سيكون حجم الهوامش أي جزء متبقّي، ولا يمكنك الضغط على الهوامش لتكون أصغر من المطلوب لأي وسائل إيضاح وتصنيفات. في ما يلي رسم بياني يعرض الأجزاء الأساسية من الرسم البياني:
وتشمل هوامش الرسم البياني تصنيفات المحاور ومنطقة التسمية التوضيحية. يتم تغيير حجم منطقة التسمية التوضيحية تلقائيًا لتلائم النص تمامًا، ما لم تحدّد عرضًا أكبر باستخدام ملاحظة: في الرسم البياني الشريطي، إذا كان حجم الأشرطة ثابتًا (الإعداد التلقائي)، لا يمكن تصغير عرض مساحة الرسم البياني. يجب تحديد حجم شريط أصغر أو قابل لتغيير الحجم
باستخدام السمة |
البنية
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>، <left_margin>، <top_ مدّة >، <left_margin>
- الحد الأدنى لحجم الهامش حول مساحة الرسم البياني بالبكسل يمكنك زيادة هذه القيمة لتضمين بعض المساحة المتروكة لمنع اهتزاز تصنيفات المحاور لحدود الرسم البياني.
- <opt_legend_width>، <opt_legend_height>
- [اختيارية] عرض الهامش حول وسيلة الإيضاح بالبكسل. استخدِم هذا الخيار لتجنُّب ارتجاع وسيلة الإيضاح في منطقة الرسم البياني أو حواف الصورة.
أمثلة
الوصف | مثال |
---|---|
في هذا المثال، يتضمّن الرسم البياني هامشًا لا يقل عن 30 بكسل على كل جانب. نظرًا لأن عرض وسيلة إيضاح الرسم البياني يزيد عن 30 بكسل، يتم ضبط الهامش في الجانب الأيمن على عرض وسيلة إيضاح الرسم البياني ويختلف عن الهوامش الأخرى. تقع تسميات المحور خارج مساحة الرسم، وبالتالي يتم رسمها داخل مساحة الهامش. |
|
لإضافة هامش حول وسيلة الإيضاح، اضبط قيمة للمَعلمتَين في هذا المثال، يبلغ عرض وسيلة الإيضاح 60 بكسل تقريبًا. وفي حال ضبط |
|
أنماط وتصنيفات المحور [خط، شريطي، مقياس Google، الرادار، النقاط المبعثرة]
يمكنك تحديد المحاور التي سيتم عرضها على الرسم البياني ومنحها تصنيفات ومواضع ونطاقات وأنماط مخصّصة.
لا تعرض بعض الرسوم البيانية خطوط المحور تلقائيًا. يمكنك تحديد المحاور التي يجب أن يعرضها الرسم البياني بالضبط باستخدام المَعلمة chxt
. لا تعرض خطوط المحاور التلقائية أي أرقام، وعليك تحديد محور في المعلَمة chxt
لعرض الأرقام.
يمكنك اختيار أن تعرض
المحاور أرقامًا تعكس قيم البيانات، أو يمكنك تحديد محاور مخصّصة.
الإعداد التلقائي هو عرض القيم الرقمية،
مع تقليل القيم لتتراوح بين 0 و100.
ومع ذلك، يمكنك تغيير هذا النطاق باستخدام chxr
لعرض أي نطاق، ويمكنك اختيار نمط للقيم (على سبيل المثال، لعرض رموز العملات أو المنازل العشرية) باستخدام chxs
.
إذا اخترت استخدام قيم مخصّصة، مثل "الإثنين، الثلاثاء، الأربعاء"، يمكنك استخدام المَعلمة chxl
.
لوضع هذه التصنيفات في مواقع معيّنة على طول المحور، استخدِم المَعلمة chxp
.
أخيرًا، يمكنك استخدام المعلمتَين chxs
وchxtc
لتحديد اللون والحجم والمحاذاة وغيرها من الخصائص لكل من تصنيفات المحاور المخصّصة والرقمية.
ملاحظة بشأن قيم السلسلة: يُسمح فقط باستخدام الأحرف الآمنة لعنوان URL في سلاسل التصنيفات. لتحقيق الأمان، عليك ترميز عنوان URL لأي سلاسل تحتوي على أحرف ليست ضمن مجموعة الأحرف 0-9a-zA-Z
.
يمكنك العثور على برنامج ترميز عناوين URL في مستندات Google المرئية.
يتناول هذا القسم المواضيع التالية:
- المحاور المرئية (
chxt
): المحاور المطلوب عرضها. - نطاق المحور (
chxr
): نطاق قيم لكل محور - تصنيفات المحور المخصّصة (
chxl
): قيم مخصّصة للعرض على المحور. - مواضع تصنيف المحور (
chxp
) - وضع التصنيفات المخصّصة على طول كل محور - أنماط تصنيفات المحور (
chxs
): اللون والحجم والمحاذاة وتنسيق تصنيفات المحاور. - أنماط علامات التجزئة المحورية (
chxtc
): طول علامات التجزئة لمحور محدّد
المحاور المرئية chxt
تعرِض الرسوم البيانية الشريطية والخطية والرادارية والنقاط المبعثرة
خطًا أو خطَين من المحور تلقائيًا، ولكن هذه الخطوط لا تشتمل على قيم.
لعرض القيم على خطوط المحور أو لتغيير المحاور المعروضة، يجب
استخدام المَعلمة chxt
.
وتتراوح قيم المحور تلقائيًا بين 0 و100، ما لم يتم تغيير حجمها بشكل صريح
باستخدام سمة chxr
. لإخفاء جميع خطوط المحور في رسم بياني خطي، حدِّد السمة :nda
بعد قيمة نوع الرسم البياني في المعلَمة cht
(مثال: cht=lc:nda
).
لا يعرض المحاور العلوي والسفلي علامات التجزئة حسب القيم تلقائيًا، بينما يعرضها المحوران الأيسر والأيمن. يمكنك تغيير هذا السلوك باستخدام المَعلمة chxs
.
البنية
chxt= <axis_1> ,..., <axis_n>
- <axis>
- محور لعرضه على الرسم البياني والمحاور المتاحة هي:
x
- المحور س السفليt
- المحور س العلوي [غير متوافق مع مقياس Google-o-Meter]y
- المحور "ص" الأيسرr
- المحور ص الأيمن [غير متوافق مع مقياس Google-o-Meter]
يمكنك تحديد عدة محاور من النوع نفسه،
على سبيل المثال: cht=x,x,y
. سيؤدي ذلك إلى تكديس مجموعتين من المحاور س على طول
الجزء السفلي من الرسم البياني. ويُعدّ هذا الإجراء مفيدًا عند إضافة تصنيفات مخصّصة على طول
محور يعرض قيمًا رقمية (راجع المثال أدناه). يتم رسم المحاور من الداخل إلى الخارج، لذا إذا كان لديك x,x
، يشير الرمز x الأول إلى النسخة الأصلية، بينما يشير الرمز x التالي إلى النسخة الخارجية التالية، وهكذا.
أمثلة
الوصف | مثال |
---|---|
يعرض هذا المثال رسمًا بيانيًا خطيًا بمحور س ومحور ص ومحور علوي (t) ومحور أيمن (r). وبما أنه لم يتم تحديد أي تصنيفات، سيكون النطاق التلقائي للرسم البياني هو النطاق من 0 إلى 100 لجميع المحاور. ملاحظة: لا تظهر علامات التجزئة حسب التصنيفات تلقائيًا في المحاور العلوية والسفلية. |
|
ويمكنك تضمين مجموعات متعددة من التصنيفات لكل محور عن طريق تضمين القيمة نفسها أكثر من مرة. يوضح هذا المثال مجموعتين من المحور س ومجموعتين من المحاور ص. وهذا ليس مفيدًا على وجه التحديد عند استخدام تصنيفات المحاور التلقائية فقط، كما هو موضّح هنا. ولكن يمكنك تحديد تصنيفات مخصّصة لكل نسخة
من كل محور، باستخدام المعلَمة chxl . |
<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHHKUju9uuXUc&chco=76A4FB&chls=2.0,xty25x" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHHKUju9uuXUc&chco=76A4FB&chls=76A4FB&chls=76A4FB&chls=76A4FB&chls=2.0&chlging=2.0&chs=50% |
يعرض هذا المثال رسمًا بيانيًا شريطيًا أفقيًا يحتوي على محور س ومحور ص ومحور t أعلى ومحور r أيمن. يتم حذف تصنيفات المحور، وبالتالي تعرض Chart API نطاقًا من 0 إلى 100 للمحور x والمحور t. يتم تحديد نطاق المحور ص والمحور r من خلال عدد الأشرطة. في هذه الحالة، هناك خمسة أشرطة، وبالتالي تعرض Chart API نطاقًا من 0 إلى 4. يتم توسيط التصنيف الأول في قاعدة الشريط الأول، ويتم توسيط التصنيف الثاني في قاعدة الشريط الثاني، وهكذا. |
|
يمكنك إيقاف عرض المحاور التلقائية في رسم بياني خطي من خلال تحديد :nda بعد نوع الرسم البياني. |
cht=lc:nda |
نطاق المحور chxr
يمكنك تحديد نطاق القيم التي تظهر في كل محور بشكل مستقل، باستخدام المَعلمة chxr. يُرجى العِلم أنّ هذا الإجراء لن يؤدي إلى تغيير مقياس عناصر الرسم البياني، بل تغيير مقياس تسميات المحور فقط. إذا كنت تريد أن تجعل أرقام المحاور تصف قيم البيانات الفعلية، اضبط <start_val> و <end_val> على القيم الدنيا والعليا لنطاق تنسيق البيانات، على التوالي. اطّلِع على مقياس المحور لمزيد من المعلومات.
وعليك إظهار المحور باستخدام المَعلمة chxt
إذا كنت تريد تحديد نطاقه.
لتحديد قيم المحور المخصّص، استخدِم المَعلمة chxl
.
البنية
افصل بين نطاقات تصنيفات المحاور باستخدام
حرف الشُرط ( |
).
chxr= <axis_index>,<start_val>,<end_val>,<opt_step> |...| <axis_index>,<start_val>,<end_val>,<opt_step>
- <axis_index>
- المحور الذي تريد تطبيق التصنيفات عليه هذا فهرس يستند إلى صفر في صفيف المحور المحدّد في
chxt
. على سبيل المثال، سيكون المحور r هو 1 فيchxt=x,r,y
. - <start_val>
- رقم يحدد القيمة المنخفضة لهذا المحور.
- <end_val>
- رقم يحدد القيمة العالية لهذا المحور.
- <opt_step>
- [اختيارية] تحدّد هذه السمة خطوة العدد بين علامات التجزئة على المحور. ولا توجد قيمة تلقائية للخطوة، يتم احتساب الخطوة لمحاولة عرض مجموعة من التصنيفات المتباعدة بشكل جيد.
أمثلة
الوصف | مثال |
---|---|
يعرض هذا المثال المحاور الصادي اليسرى واليمنى ( لكل محور نطاق محدد. وبما أنّه لم يتم تحديد أي تصنيفات أو مواضع، يتم استخراج القيم من النطاق المحدّد وتكون متباعدة بشكل متساوٍ داخل هذا النطاق. في المخطط الخطي، تنتشر القيم بالتساوي على المحور س. يتم عكس اتجاه المحور للمحور r (الفهرس |
|
في هذا المثال، يتم تحديد قيم للمحور x. تكون تسميات المحور متباعدة بشكل متساوٍ على طول المحور. تم تحديد قيمة خمسة ( |
|
تصنيفات المحور المخصّصة chxl
يمكنك تحديد تصنيفات مخصّصة لمحور السلسلة على أي محور، باستخدام المعلَمة chxl
. يمكنك تحديد أي عدد تريده من التصنيفات. وإذا عرضت محورًا (باستخدام المعلَمة chxt
)
ولم تحدّد تصنيفات مخصّصة، سيتم تطبيق التصنيفات العادية الرقمية.
لتحديد نطاق رقمي مخصّص، استخدِم المَعلمة chxr
بدلاً من ذلك.
ولتحديد مواقع جغرافية محدّدة على طول المحور في التصنيفات، استخدِم المَعلمة chxp
.
البنية
حدِّد مجموعة معلَمة واحدة لكل محور تريد إضافة تصنيف له. افصل بين مجموعات التصنيفات المتعددة باستخدام رمز الشرطة الرأسية ( |
).
chxl= <axis_index>:|<label_1>|...|<label_n> |...| <axis_index>:|<label_1>|...|<label_n>
- <axis_index>
- المحور الذي تريد تطبيق التصنيفات عليه وهذا
فهرس في مصفوفة المعلَمة
chxt
. على سبيل المثال، إذا كانت لديكchxt=x,x,y,y
، سيكون الفهرس 0 هو أول محور x، وسيكون 1 المحور س الثاني. - <label_1>| ... |<label_n>
- ضَع تصنيف واحد أو أكثر على طول هذا
المحور. ويمكن أن تكون هذه القيم سلسلة أو أرقام، وليس بالضرورة أن تكون السلاسل بين علامتَي اقتباس. ويتم عرض label_1 في أدنى موضع على المحور، بينما يتم عرض label_n في أعلى موضع. يتم تباعد التصنيفات الإضافية بالتساوي بينها.
الإشارة إلى المسافات باستخدام علامة +. ولا تتوفّر طريقة لتحديد فاصل أسطر في التسمية. افصل التسميات باستخدام حرف الشرطة المستقيمة. ملاحظة: لا تضع شرطة بعد التصنيف النهائي في المَعلمة
chxl
.
أمثلة
الوصف | مثال |
---|---|
يوضّح هذا الرسم البياني كيفية إضافة تصنيفات مخصّصة إلى محورَين. يُرجى
ملاحظة كيفية تباعد القيم بشكل متساوٍ، وكيفية عدم انتهاء قيمة |
chxt=x,y |
يشمل هذا المثال تصنيفات المحاور على المحاور ص على اليسار واليمين ( |
|
يشمل هذا المثال تصنيفات المحاور على المحاور ص اليسرى واليمنى
( يستخدم هذا المثال القيم الافتراضية لتسميات المحاور على المحور ص الأيسر. |
|
إذا كنت تريد إضافة تصنيف عام لوصف محور
بأكمله (على سبيل المثال، لتسمية محور
واحد باسم "التكلفة" وتصنيف "طالب" آخر)، استخدِم السمة |
chxt=x,x,y,y |
مواضع تصنيف المحور chxp
ويمكنك تحديد تصنيفات المحاور التي تريد عرضها، سواء باستخدام التصنيفات التلقائية أو
التصنيفات المخصّصة المحدّدة باستخدام chxl
. إذا لم تحدّد مواضع دقيقة باستخدام هذه المَعلمة، سيتم وضع مسافات بين التصنيفات بالتساوي
وبقيمة خطوة تلقائية على المحاور. وإذا لم تحدّد chxl
، ستكون تصنيفات علامة الاختيار هي القيم التلقائية (عادةً قيم البيانات أو أرقام الشريط في الرسوم البيانية الشريطية).
البنية
افصل مجموعات تحديد الموضع المتعددة باستخدام رمز الشرطة الرأسية (|
).
chxp= <axis_1_index>,<label_1_position>,...,<label_n_position> |...| <axis_m_index>,<label_1_position>,...,<label_n_position>
- <axis_index>
- المحور الذي
تحدِّد المواضع له. وهذا فهرس في مصفوفة المعلَمة
chxt
. على سبيل المثال، إذا كان لديكchxt=x,x,y,y
، سيكون الفهرس 0 هو أول محور x، وسيكون الرقم 1 هو المحور س الثاني، وهكذا. - <label_1_position>,...,<label_n_position>
- موضع التصنيف على طول المحور. هذه قائمة من القيم الرقمية مفصولة بفواصل، حيث تحدّد كل قيمة موضع التصنيف المقابل في مصفوفة
chxl
: ينطبق الإدخال الأول على التصنيف الأول، وهكذا. الموضع هو قيمة في نطاق ذلك المحور. تجدر الإشارة إلى أنّ هذه القيمة ستكون دائمًا 0—100 ما لم تحدّد نطاقًا مخصّصًا باستخدامchxr
. يجب أن يكون لديك العديد من المواضع كما هو الحال في التصنيفات لذلك المحور.
أمثلة
الوصف | مثال |
---|---|
يتضمن هذا المثال تسميات المحور r في مواضع
محددة على الرسم البياني. يتم تحديد نص التصنيف باستخدام المَعلمة يتم وضع التصنيفات التي لها موضع محدد وهو يتم وضع التصنيفات التي يكون موضعها |
|
يوضِّح هذا المثال عرض القيم التلقائية للتصنيفات، ولكن في مواقع جغرافية محدّدة فقط.
|
chxt=x,y
chxt=x,y لم يتم تحديد chxp |
أنماط تصنيفات المحور chxs
يمكنك تحديد حجم الخط ولونه ومحاذاة لتصنيفات المحاور، سواء التصنيفات المخصّصة أو قيم التصنيفات التلقائية. وجميع التصنيفات على المحور نفسه لها التنسيق نفسه. إذا كانت لديك نُسخ متعددة من أحد المحور، يمكنك تنسيق كل منها بشكل مختلف. يمكنك أيضًا تحديد تنسيق سلسلة التصنيف، لعرض رموز العملات أو الأصفار اللاحقة على سبيل المثال.
بشكل افتراضي، لا يُظهر المحاور العلوي والسفلي علامات التجزئة حسب القيم، بينما يعرضها المحاور الأيسر والأيمن.
البنية
يجب فصل قيم المحاور المتعددة باستخدام رمز الشرطة المستقيمة (|
).
chxs= <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color> |...| <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
- <axis_index>
- المحور الذي ينطبق عليه هذا التغيير وهذا الفهرس يستند إلى صفر في المعلَمة
chxt
. - <opt_format_string>
- [اختيارية] هذه سلسلة تنسيق اختيارية، في حال استخدامها، تتّبِعها مباشرةً بعد رقم فهرس المحور بدون فاصلة متداخلة. تبدأ
بحرف حرف N متبوعًا بالقيم التالية، وكلها اختيارية:
N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
في ما يلي معنى كل عنصر:<preceding_text>
- النص الحرفي الذي يسبق كل قيمة*...*
: عبارة عن وحدة اختيارية ملفوفة بعلامات نجمية حرفية، حيث يمكنك تحديد تفاصيل تنسيق الأرقام. يمكن استخدام القيم التالية، وجميعها اختيارية:<number_type>
: تنسيق الأرقام للقيم الرقمية حدِّد أحد الخيارات التالية:f
- [التلقائي] تنسيق النقاط العائمة ننصحك بتحديد الدقة أيضًا باستخدام قيمة <decimal_places>.p
- تنسيق النسبة المئوية يتم إلحاق علامة % تلقائيًا. ملاحظة: عند استخدام هذا التنسيق، يتم ربط قيم البيانات من 0.0 — 1.0 إلى 0 — 100% (على سبيل المثال، سيظهر 0.43 على هذا النحو 43%).e
- تنسيق الترميز العلميc<CUR>
- تنسيق الرقم بالعملة المحدّدة باستخدام علامة العملة المناسبة استبدِل<CUR>
برمز عملة مكوّن من ثلاثة أحرف. مثال:cEUR
لليورو. يمكنك العثور على قائمة بالرموز على موقع ISO الإلكتروني، ولكن ليس جميع الرموز متوافقة.
<decimal_places>
- عدد صحيح يحدّد عدد المنازل العشرية المطلوب عرضها. يتم تقريب القيمة إلى هذا الطول (بدون اقتطاع). القيمة التلقائية هي 2.z
- عرض الأصفار اللاحقة القيمة التلقائية هي "لا".s
- فواصل مجموعات الشبكة الإعلانية القيمة التلقائية هي "لا".x
أوy
- يتم عرض البيانات من الإحداثي س أو ص على النحو المحدّد. يختلف معنى بيانات "س" حسب نوع الرسم البياني: عليك تجربة الرسم البياني لتحديد معناه. القيمة التلقائية هي "y".
<following_text>
- النص الحرفي المطلوب اتباع كل قيمة.
- <opt_label_color>
- اللون الذي سيتم تطبيقه على نص المحور (وليس خط المحور)، بتنسيق RRGGBB السداسي العشري. يتم تحديد لون خط المحور بشكل منفصل باستخدام opt_axis_color. الإعداد التلقائي هو الرمادي.
- <opt_font_size>
- [اختيارية] تحدّد حجم الخط بالبكسل. هذه المعلمة اختيارية.
- <opt_alignment>
- [اختياري] محاذاة التصنيفات بالنسبة إلى المحاور العلوية أو السفلية، يوضّح هذا طريقة محاذاة التصنيف مع علامة دقات أعلى أو أسفلها. أما بالنسبة إلى المحاور اليسرى أو اليمنى، فيصف هذا كيفية محاذاة المحاور داخل مربع الإحاطة الذي يلمس المحور. حدِّد أحد الأرقام التالية:
-1
- لأعلى أو أسفل: تظهر التصنيفات على يسار علامات التجزئة، وعلى اليسار أو اليمين: تكون التصنيفات بمحاذاة الجانبَين. القيمة التلقائية لتصنيفات المحور r0
- لأعلى أو أسفل: تظهر التصنيفات في وسط علامات التجزئة، ولليسار أو لليمين: تكون التصنيفات في وسط المنطقة. القيمة التلقائية للتصنيفات على المحورين "س" و"t".1
- لأعلى أو أسفل: تظهر التصنيفات على يسار علامات التجزئة، ولليسار أو لليمين: تكون التصنيفات بمحاذاة مواضعها باتجاه اليمين. القيمة التلقائية لتصنيفات المحور ص
- <opt_axis_or_tick>
- [اختيارية، غير متاحة في مقياس Google-ometer] لتحديد ما إذا كان سيتم عرض علامات التجزئة و/أو خطوط المحور لهذا المحور. لا تتوفّر علامات التجزئة وخطوط المحاور إلا للمحاور الداخلية (على سبيل المثال، لا يمكن الاستناد إليها في الجزء الخارجي من محورَي س). استخدِم إحدى القيم التالية:
l
(حرف صغير "L") - رسم خط المحور فقطt
- رسم علامات التجزئة فقط علامات التجزئة هي الخطوط الصغيرة التي تظهر بجانب تسميات المحاور.lt
- [تلقائي] ارسم خط المحور وعلامات التجزئة لجميع التصنيفات._
- (شرطة سفلية) لا يتم رسم خط المحور ولا علامات التجزئة. إذا كنت تريد إخفاء خط محور، استخدم هذه القيمة.
- <tick_color>
- [اختيارية، غير متاحة في Google-o-meter] لون علامة الاختيار، بتنسيق RRGGBB السداسي العشري. الإعداد التلقائي هو الرمادي.
- <opt_axis_color>
- [اختياري] لون خط المحور هذا، بتنسيق RRGGBB سداسي عشري. الإعداد التلقائي هو الرمادي.
أمثلة
الوصف | مثال |
---|---|
ويتم تحديد حجم الخط ولونه للمحور س الثاني (يناير، فبراير، مارس). |
|
يتم تحديد حجم الخط ولونه ومحاذاة للمحور y الأيمن. يتم رسم علامات التجزئة، ولكن لا يتم رسم خط المحور. |
|
يتضمّن هذا الرسم البياني ثلاث مجموعات بيانات، ويعرض ثلاث مجموعات من تصنيفات المحاور، مجموعة واحدة لكل سلسلة. يتم تنسيق كل مجموعة من التصنيفات باستخدام سلسلة تنسيق مخصّص، كما هو موضّح في ما يلي:
يتم ضبط نطاقات تصنيف المحور باستخدام المَعلمة |
chd=s: |
أنماط علامات المحور chxtc
يمكنك تحديد علامات فاصلة طويلة ل محاور معيّنة. تُستخدَم هذه الخوارزمية عادةً لتوسيع
علامة التجزئة على طول الرسم البياني. استخدِم المَعلمة chxs
لتغيير لون علامة الاختيار.
يجب فصل قيم المحاور المتعددة باستخدام رمز الشرطة الرأسية (|
). ويجب فصل القيم في السلسلة باستخدام فاصلة.
البنية
chxtc= <axis_index_1>,<tick_length_1>,...,<tick_length_n> |...| <axis_index_m>,<tick_length_1>,...,<tick_length_n>
- <axis_index>
- المحور الذي ينطبق عليه هذا التغيير هذا فهرس مستند إلى صفر داخل المعلمة
chxt
. افصل بين القيم للمحاور المختلفة باستخدام محدد شريط. - <tick_length_1>,...,<tick_length_n>
- طول علامات التجزئة على هذا المحور بالبكسل. في حال تحديد قيمة واحدة، سيتم تطبيقها على جميع القيم، وفي حال تقديم أكثر من قيمة واحدة، ستنتقل علامات تحديد المحور إلى قائمة القيم الخاصة بهذا المحور. يتم رسم القيم الموجبة خارج مساحة الرسم البياني ويتم اقتصاصها من خلال حدود الرسم البياني. والحد الأقصى للقيمة الموجبة هو 25. يتم رسم القيم السالبة داخل مساحة الرسم البياني واقتصاصها من خلال حدود منطقة الرسم البياني.
أمثلة
الوصف | مثال |
---|---|
مثال على استخدام
|
|
يوضّح هذا الرسم البياني أطوال علامات التجزئة البديلة. وتحدِّد السمة chxtc قيمتَي طول إشارة للمحور y (5 و15)، والمؤشرات المرسومة على الرسم البياني متبادلة بين القيمتَين. |
chxt=x,y |
تتم تعبئة الخلفية chf
[كل
الرسوم البيانية]
يمكنك تحديد ألوان التعبئة وأنماطها لمنطقة بيانات الرسم البياني و/أو
خلفية الرسم البياني بالكامل. تتضمن أنواع التعبئة التعبئة الخالصة والتعبئة المخططة والتدرجات.
يمكنك تحديد عمليات ملء مختلفة لمناطق مختلفة (على سبيل المثال، منطقة الرسم البياني بالكامل أو منطقة البيانات فقط). وتحلّ تعبئة منطقة الرسم البياني محلّ تعبئة الخلفية. يتم تحديد جميع عمليات التعبئة باستخدام المعلَمة chf
، ويمكنك المزج بين أنواع التعبئة المختلفة (المواد الخطرة والخطوط والتدرجات) في الرسم البياني نفسه من خلال فصل القيم باستخدام حرف الشرطة الرأسية ( | ). تؤدي ملء منطقة الرسم البياني إلى استبدال تعبئة الخلفية في الرسم البياني.
ملء صلب chf
[كل
الرسوم البيانية]
يمكنك تحديد تعبئة خالصة للخلفية و/أو منطقة الرسم البياني أو تخصيص
قيمة شفافية للرسم البياني بالكامل. يمكنك تحديد عمليات تعبئة متعددة باستخدام
حرف التوجيه (|
). (خرائط: الخلفية فقط).
البنية
chf=<fill_type>,s,<color>|...
- <fill_type>
- الجزء الذي تتم تعبئته من الرسم البياني. اختَر إحدى القيم التالية:
bg
- تعبئة الخلفيةc
- ملء منطقة الرسم البياني هذه الميزة غير متاحة مع الرسومات البيانية للخرائط.a
- جعل الرسم البياني بالكامل (بما في ذلك الخلفيات) شفاف يتم تجاهل الأرقام الستة الأولى من السمة<color>
، ويتم تطبيق آخر رقمين فقط (قيمة الشفافية) على الرسم البياني بالكامل وجميع عمليات التعبئة.b<index>
- تعبئة الشريط الخصري (الرسوم البيانية الشريطية فقط) استبدِل <index> بفهرس سلسلة الأشرطة لتعبئة لون ثابت. ويكون التأثير مشابهًا لتحديدchco
في رسم بياني شريطي. للاطّلاع على مثال، راجِع ألوان سلاسل الرسم البياني الشريطي.
- s
- تشير إلى تعبئة خالصة أو شفافة.
- <color>
- لون التعبئة بتنسيق RRGGBB السداسي العشري. بالنسبة إلى الطابعات الشفافة، يتم تجاهل الأرقام الستة الأولى، ولكن يجب تضمينها على أي حال.
أمثلة
الوصف | مثال |
---|---|
يعمل هذا المثال على تعبئة خلفية الرسم البياني باللون الرمادي الباهت
( |
|
يعمل هذا المثال على تعبئة خلفية الرسم البياني باللون الرمادي الفاتح
( |
|
يطبّق هذا المثال شفافية بنسبة 50% على الرسم البياني بالكامل (80 في النظام السداسي العشري تساوي 128، أو شفافية تبلغ حوالي 50%). لاحِظ خلفية خلية الجدول تظهر من خلال الرسم البياني. |
|
ملء التدرج chf
[خط،
شريطي، مقياس Google-o ، الرادار، مبعثر، Venn]
يمكنك تطبيق تعبئة متدرجة واحدة أو أكثر على مناطق الرسم البياني أو الخلفيات. تتلاشى التعبئة المتدرجة من لون إلى لون آخر. (مخططات دائرية، مخططات Google الخاصة بمقياس Google: الخلفية فقط.)
تحدّد كل تعبئة متدرجة زاوية، ويتم بعد ذلك تثبيت لونين أو أكثر في موقع محدّد. ويختلف اللون عند انتقاله من علامة ارتساء إلى أخرى. يجب أن يكون لديك لونان على الأقل بقيم <color_centerpoint> مختلفة، بحيث يمكن أن يتلاشى أحدهما للضوء الآخر. ويتم تحديد كل تدرج إضافي بواسطة زوج <color>,<color_centerpoint>.
البنية
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_type>
- منطقة الرسم البياني المطلوب ملؤها واحد ممّا يلي:
bg
- تعبئة الخلفيةc
- ملء منطقة الرسم البيانيb<index>
- التعبئة المتدرجة الشريطية (الرسوم البيانية الشريطية فقط) استبدِل <index> بفهرس سلسلة الأشرطة لتعبئة التدرج. للاطّلاع على مثال، راجِع ألوان سلاسل الرسم البياني الشريطي.
- lg
- لتحديد تعبئة التدرج.
- <angle>
- رقم يحدِّد زاوية التدرج من 0 (أفقي) إلى 90 (عمودي)
- <color>
- لون التعبئة بتنسيق RRGGBB السداسي العشري.
- <color_centerpoint>
- يحدد نقطة الارتساء للون. سيبدأ اللون في التلاشي بدءًا من هذه النقطة عندما يقترب من علامة ارتساء أخرى. ويتراوح نطاق القيمة من 0.0 (الحافة السفلية أو اليسرى) إلى 1.0 (الحافة العلوية أو اليمنى)، ويكون مائلاً بزاوية تحدّدها <angle>.
أمثلة
الوصف | مثال |
---|---|
تحتوي مساحة الرسم البياني على تدرج خطي أفقي، وقد تم تحديده بزاوية صفرية ( الألوان فاتحة ( يتم رسم خلفية الرسم البياني باللون الرمادي ( |
|
تتضمّن مساحة الرسم البياني تدرجًا خطيًا قُطريًا (من أسفل اليسار إلى أعلى اليمين) وزاوية تبلغ خمسة وأربعين درجة ( الخوخ ( الأزرق ( يتم رسم خلفية الرسم البياني باللون الرمادي ( |
|
تتضمّن مساحة الرسم البياني تدرجًا خطيًا رأسيًا (من أعلى إلى أسفل) بزاوية تسعين درجة ( الأزرق ( الخوخ ( يتم رسم خلفية الرسم البياني باللون الرمادي ( |
|
التعبئة مخطَّطة chf
[خط،
شريطي، مقياس Google، مقياس رادار، مبعثر، Venn]
يمكنك تحديد تعبئة خلفية مخطّطة لمنطقة الرسم البياني أو الرسم البياني بالكامل. (مخططات دائرية، مخططات Google الخاصة بمقياس Google: الخلفية فقط.)
البنية
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_type>
- منطقة الرسم البياني المطلوب ملؤها واحد ممّا يلي:
bg
- تعبئة الخلفيةc
- ملء منطقة الرسم البيانيb<index>
- تعبئة المخطط الشريطي (الرسوم البيانية الشريطية فقط) استبدِل <index> بفهرس سلسلة الأشرطة لملئه بالخطوط. للاطّلاع على مثال، راجِع القسم ألوان السلاسل الشريطية.
- ls
- يحدد هذا الخيار تعبئة الشريط الخطي.
- <angle>
- زاوية كل الخطوط بالنسبة إلى المحور y. استخدِم
0
للخطوط العمودية أو90
للخطوط الأفقية. - <color>
- لون هذا الشريط بتنسيق RRGGBB السداسي العشري. كرِّر <color> و <width> لكل شريط إضافي. يجب أن يكون لديك شريطان على الأقل. تتناوب الخطوط إلى أن يمتلئ الرسم البياني.
- <width>
- عرض هذا المخطط، من
0
إلى1
، حيث يمثل1
عرض الرسم البياني بالكامل. يتم تكرار الخطوط حتى يمتلئ الرسم البياني. كرِّر <color> و <width> لكل شريط إضافي. يجب أن يكون لديك شريطان على الأقل. تتناوب الخطوط إلى أن يمتلئ الرسم البياني.
أمثلة
الوصف | مثال |
---|---|
|
chf= |
|
chf= |
خطوط الشبكة chg
[خط،
شريطي، رادار، نقاط مبعثرة]
يمكنك تحديد خطوط شبكة متصلة أو منقّطة
في الرسم البياني باستخدام المَعلمة chg
.
لا تتيح لك هذه المعلمة تحديد سُمك الخطوط أو لونها. لمزيد من الطرق لإنشاء الخطوط في الرسم البياني، يمكنك الاطّلاع على علامات الأشكال (chm
اكتب h أو H أو v أو V) وعلامات النطاقات (chm
) وعلامات تحديد المحور (chxtc
).
البنية
chg= <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
- <x_axis_step_size>, <y_axis_step_size>
- تُستخدَم هذه الوظيفة لحساب عدد خطوط الشبكة التي تتضمّن س أو ص المطلوب عرضها على الرسم البياني. 100 / step_size = عدد خطوط الشبكة في الرسم البياني. وبالتالي، يشير الرقم 20,25 إلى 5 خطوط شبكة عمودية و4 خطوط شبكة أفقية.
- <opt_dash_length> ، <opt_space_length>
- [اختيارية] تُستخدَم لتحديد خطوط الشبكة المتقطّعة. المعلمة الأولى هي طول كل شرطة سطر، بالبكسل. المعلمة الثانية هي التباعد بين الشرطات، بالبكسل. حدِّد 0 في <opt_space_length> للسطر المتصل. القيم التلقائية هي 4 و1.
- <opt_x_offset>,<opt_y_offset>
- [اختيارية] عدد الوحدات، وفقًا لمقياس الرسم البياني، لمعادلة خطَي الشبكة "س" و"ص" على التوالي. يمكن أن تكون قيمًا موجبة أو سلبية. إذا حددت هذه القيمة، يجب أيضًا تحديد جميع القيم السابقة. القيم التلقائية هي 0,0.
أمثلة
الوصف | مثال |
---|---|
تستخدم هذه الأمثلة المَعلمتَين |
chg=20,50 chg=20,50 |
يستخدم هذا المثال مسافات أكبر لعرض خطوط شبكة أفتح ( |
|
لعرض خطوط الشبكة المتصلة، حدِّد صفر ( يحدد هذا المخطط أيضًا إزاحة المحور س بقيمة 10. |
chg=20,50,1,0,10 |
يوضح هذا الرسم البياني إزاحة المحور س بقيمة 10، وإزاحة المحور y بقيمة 20. |
chg=20,50,3,3,10,20 |
أنماط الخطوط chls
[خط،
رادار]
يمكنك تحديد سُمك الخط والنمط الثابت/المتقطع باستخدام المَعلمة chls
. ولا يمكن استخدام هذه المعلَمة إلّا لتصميم الخطوط في الرسوم البيانية الخطيّة أو النسيجية، ولا يمكنك استخدامها لتصميم الخطّ في
خطوط رسم بياني مركّبة، إلّا إذا كان النوع الأساسي للرسم البياني المركّب هو رسم بياني خطي.
البنية
افصل بين أنماط الأسطر المتعددة باستخدام حرف الشرطة الرأسية ( |
)، وينطبق النمط الأول على السطر الأول والثاني إلى السطر التالي، وهكذا. وإذا كانت لديك أنماط أقل من الأسطر، يتم تطبيق النمط التلقائي على جميع الأسطر غير المحددة.
chls= <line_1_thickness>,<opt_dash_length>,<opt_space_length> |...| <line_n_thickness>,<opt_dash_length>,<opt_space_length>
- <line_1_thickness>
- سمك الخط، بالبكسل.
- <opt_dash_length> ، <opt_space_length>
- [اختيارية] تُستخدَم لتحديد خطوط الشبكة المتقطّعة. المعلمة الأولى هي طول كل شرطة سطر، بالبكسل. المعلمة الثانية هي التباعد بين الشرطات، بالبكسل. أما بالنسبة إلى السطر الثابت، فلا تحدّد أيًّا من القيم. وإذا حدّدت <opt_dash_length> فقط، سيتمّ ضبط <opt_space_length> على <opt_dash_length>. القيمة التلقائية هي 1,0 (خط ثابت).
أمثلة
الوصف | مثال |
---|---|
يتم هنا تحديد الخط المتقطّع باستخدام |
chls=3,6,3|5 |
علامات الرموز الديناميكيةchem
[شريط، خطي،
رادار، نقاط مبعثرة]
أنشئ المخطط، وحدد رمزًا ديناميكيًا واحدًا أو أكثر كقيم chem. وتكون بنية chem
على النحو التالي. تُعد جميع العناصر المفصولة بفواصل منقوطة باللون البنفسجي اختيارية،
ويمكن حذف أي عنصر تمامًا في عنوان URL. ويمكنك تضمين عدة علامات من خلال تضمين عدة سلاسل بنية مفصولة بحرف |. يمكنك
قراءة المزيد من المعلومات عن الرموز الديناميكية في صفحة
الرموز الديناميكية.
يمكنك أيضًا تضمين مخطط داخل مخطط آخر كرمز ديناميكي. يمكنك الاطّلاع على القسم الفرعي الرسوم البيانية المضمّنة أدناه.
chem= y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
|...| y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
- s=<icon_string_constant>
- ثابت علامة السلسلة لرمز ديناميكي، من صفحة الرموز الديناميكية. إنّ هذه القيمة الثابتة تقريبًا مع المَعلمة
chst
للرموز القائمة بذاتها. ولكن عندما تبدأ سلسلة الرموز المستقلة بـ "d_"، يجب إزالة تلك البادئة للحصول على محدِّد الرمز الديناميكي المكافئ. مثال: رمز مستقل:d_bubble_icon_text_small
، أو علامة رمز ديناميكي مكافئة:bubble_icon_text_small
. - d=<marker_data_string>
- البيانات المطلوبة لنوع العلامة هذا تحديدًا. وتحتوي هذه العلامة على
السلسلة نفسها التي سيتم استخدامها في المَعلَمة
chld
لرمز مكافئ مستقل، باستثناء ضرورة استبدال جميع محدِّدات | بفاصلات (تذكّر استخدام الفواصل بدلاً من علامات الشُرط للنص المتعدّد الأسطر). يُرجى العِلم أنّه ضمن سلسلة البيانات، يجب أيضًا إلغاء الأحرف التالية بعلامة @: ممر ( | ) أو @ ( @ ) أو يساوي ( = ) أو فاصلة ( , ) فاصلة منقوطة ( ). أمثلة:hello@,+world
أو5@@10+cents+each
- ds=<which_series>
- [اختيارية] الفهرس المستند إلى صفر لسلسلة البيانات التي تنتمي إليها هذه العلامة. القيمة التلقائية هي 0.
- dp=<which_points>
- [اختيارية] تحدّد هذه السمة نقاط البيانات التي يتم استخدامها لرسم العلامات. القيمة التلقائية هي 0 (النقطة الأولى في السلسلة). استخدِم أحد التنسيقات التالية:
n.d
: أي نقطة بيانات يجب رسم العلامة عليها، حيث يشير n.d إلى فهرس يستند إلى صفر في السلسلة. وإذا حدّدت قيمة لا تمثّل عددًا صحيحًا، يشير الكسر إلى نقطة متوسطة محسوبة. على سبيل المثال، 3.5 تعني في المنتصف بين النقطة 3 والنقطة 4.range,<start>,<end>,<step>
- يمكنك رسم علامة على كل نقطة بيانات خطوة ضمن نطاق من البدء إلى النهاية، بشكل شامل. تكون البداية والنهاية قيمتَين فهرس، ويمكن أن تكونا أرقام نقاط عائمة للإشارة إلى قيم متوسطة. جميع القيم اختيارية، والقيم التلقائية هي: start=0 و end=last item وstep=1. إذا تخطّيت إحدى القيم، عليك تضمين أي فواصل وسيطة، ولكن لن تحتاج إلى تضمين فواصل لاحقة فارغة. أمثلة: يرسمdp=range,0,4
علامة على العناصر من 0 إلى 4، ويرسمdp=range,5,10,2
علامة على العناصر 5 و7 و9، ويرسمdp=range,2
النقاط على النقطة الثالثة والنقاط التالية، بينما يرسمdp=range,3,,1.5
علامات على كل 1.5 نقطة بيانات بدءًا من العنصر الرابع وحتى العنصر الأخير.all
: يمكنك رسم علامة على كل عنصر. يعادل ذلكrange,0,end_index
. مثال:dp=all
every,n
- رسم علامة على كل علامة ن مثال: ترسم دالةdp=every,2
علامة على العناصر 0 و2 و4.
- py=<z_order>
- [اختيارية] تمثّل هذه السمة الطبقة التي يتم رسم العلامة عليها، مقارنةً بالعلامات الأخرى وجميع عناصر الرسم البياني الأخرى. وهذا هو رقم النقطة العائمة من -1.0 إلى 1.0، شاملاً، حيث -1.0 هو الجزء السفلي و1.0 في الأعلى. عناصر الرسم البياني (الخطوط والأشرطة) أسفل الصفر مباشرةً. في حال وجود علامتَين بالقيمة نفسها، سيتم رسمهما بالترتيب الذي يحدّده عنوان URL. القيمة التلقائية هي 0.0 (أعلى عناصر الرسم البياني مباشرةً).
- po=<x,y>
- [اختياري] موضع مطلق على الرسم البياني لرسم العلامة، ويشير الرمز x وy إلى عدد النقاط العائمة، حيث يمثّل 0.0,0.0 الزاوية السفلية اليسرى و1.0,1.0 في أعلى يسار الشاشة.
- of=<x_offset,y_offset>
- [اختيارية] عدد من وحدات البكسل لإزاحة الرمز من موضعه العادي. x_offset وy_offset أعداد صحيحة موجبة أو سالبة. من المهم تحديد هذه القيمة في رمز ديناميكي مضمّن، لأن العلامة سيتم توسيطها عموديًا وأفقيًا فوق النقطة، ما يعني أن النقطة لن تتم محاذاتها على الأرجح مع علامة البيانات. إنّ الإزاحة الجيدة للدبوس العمودي هي
of=0,22
، والإزاحة الجيدة للمسمار المائل هيof=-12,20
أوof=12,20
اعتمادًا على اتجاه الخط المائل، ولكن قد يكون عليك إجراء تجارب. القيمة التلقائية هي 0,0.
أمثلة
الوصف | مثال |
---|---|
في ما يلي أمثلة على الرمز الديناميكي نفسه الذي تم إنشاؤه كصورة قائمة بذاتها واستخدامها كعلامة ضمن رسم بياني خطي.
الرسم البياني 1: الرسم البياني 2: |
|
يُرجى العلم أنه سيتم توسيط علامة الرمز الديناميكي على النقطة أفقيًا وعموديًا. وبالتالي، في حال استخدام رمز ديناميكي مع ذيل، لن يكون الذيل على نقطة الرسم البياني، وسيكون مركز العلامة هو الحال. يوسيط الرسم البياني الأول العلامة على نقطة البيانات 3، والتي تضع الذيل قليلاً إلى يمين العلامة على الخط. يستخدم الرسم البياني الثاني القيمة |
chem=y;
chem=y; |
لتضمين رموز ديناميكية متعدّدة، كرِّر سلسلة البنية، المفصولة بحرف |. يوضح هذا المثال نطاقًا، بالإضافة إلى علامتين فرديتين. لاحِظ كيف تتم معادلة الدبابيس العمودية بـ 0,22، وقيمة الدبوس المائل تبلغ 12,20، ما يجعل نقاط الدبوس تتماشى مع السلسلة التي تصفها. |
chem= |
يوضح هذا علامة نص متعدد الأسطر. يجب إزاحة العلامة بعد إضافة النص، لأنه يتم تغيير حجم الفقاعة التفسيرية لتلائم النص، ما يؤدي إلى إعادة توسيطه على الرسم البياني. لاحِظ كيف تتم الإشارة إلى الأسطر الجديدة في النص
باستخدام فواصل في سلسلة بيانات d . |
chem=y; |
الرسوم البيانية المضمَّنة
يمكنك تضمين مخطط واحد داخل آخر باستخدام بنية الرمز الديناميكية.
هناك نمطان لعلامات الرسم البياني المضمَّنة: الرسوم البيانية المضمَّنة في فقاعة تفسيرية، والرسوم البيانية المضمَّنة بدون فقاعة تفسيرية. إليك أمثلة على كليهما:
رسم بياني مع فقاعة تفسيرية |
رسم بياني بدون فقاعة تفسيرية |
في ما يلي تفاصيل معلَمات s=<icon_string_constant>;d=<marker_data_string>
، لكل من الرسوم البيانية غير الفقاعية والمضمّنة في فقاعات (لم يتم وصف المعلمات المشار إليها أعلاه مرة أخرى هنا):
البنية
Non-bubble: chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset> Bubble: chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
- alignment_string
- [إعلان غير فقاعي فقط] أي جزء من الرسم البياني المضمّن بدون فقاعات يتم تثبيته على نقطة البيانات. اختَر أحد ثوابت السلسلة المكوَّنة من حرفين في الرسم البياني التالي:
- chart_data
- بيانات الرسم البياني المضمّن هذه هي كل القيم التي تظهر بعد
https://chart.googleapis.com/chart?
في عنوان URL الخاص بالرسم البياني الذي سيتم تضمينه. يمكنك استخدام الأداة أدناه أو اتّباع القواعد المدرَجة أسفلها. - frame_type
- [فقاعة تفسيرية فقط] أحد الرموز الديناميكية ثابتة نمط الإطار.
- المساحة المتروكة
- [فقاعة تفسيرية فقط] المساحة المتروكة داخل الفقاعة التفسيرية بالبكسل.
- frame_color
- [فقاعة تفسيرية فقط] لون الإطار، كسلسلة لون HTML مكوّنة من ستة أرقام بدون العلامة #. مثال:
FF00FF
. - fill_color
- [فقاعة تفسيرية فقط] لون تعبئة الفقاعات هو سلسلة لون HTML مكوّنة من ستة أرقام بدون العلامة #. مثال:
FF00FF
.
بيانات الرسم البياني المضمّنة
استخدِم أداة الإحالات الناجحة التالية للمساعدة في إنشاء سلسلة الرسم البياني، أو يمكنك إنشاء سلسلة الرسم البياني يدويًا باتّباع القواعد المحدَّدة بعد الأداة.
قواعد الإحالة الناجحة اليدوية
1- أولاً، استبدِل جميع الأحرف التالية في أزواج المعلمات والقيم بالقيم التالية، بالترتيب المعروض:
استبدال | مع هذا |
---|---|
%7C أو %7c |
| |
@ |
@@ |
% |
25% |
, |
@, |
| |
@| |
; |
@; |
و |
%26 |
= |
%3D |
2. بعد ذلك، استبدِل جميع قيم &
و=
في أزواج parameter1=value1¶meter2=value2...
بفواصل.
ملء الخطوط chm
[خط،
رادار]
يمكنك ملء المنطقة أسفل خط البيانات بلون ثابت.
يمكنك دمج عمليات تعبئة الأسطر مع أي معلَمات chm
أخرى باستخدام
حرف الشُرط ( |
) لفصل معلَمات chm
.
البنية
chm= <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0> |...| <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
- <b_or_B>
- ما إذا كنت تريد التعبئة حتى أسفل الرسم البياني، أم إلى السطر السفلي التالي فقط.
- B - التعبئة من
<start_line_index>
إلى أسفل الرسم البياني تتوافق السمة<end_line_index>
مع بنية خاصة تتيح لك ملء شريحة من الرسم البياني. وتكون هذه الطريقة أسهل إذا كان لديك رسم بياني بخط واحد تريد ملؤه. - b - املأ بين سطرين في مخطط متعدد الأسطر. يتم الإشارة إلى
سطري البداية والنهاية من خلال
<start_line_index>
و<end_line_index>
.
- B - التعبئة من
- <color>
- رقم سداسي عشري بتنسيق RRGGBB للون التعبئة.
- <start_line_index>
- فهرس الخط الذي تبدأ فيه التعبئة. وتحتوي سلسلة البيانات الأولى المحددة في
chd
على فهرس صفر (0
)، وفهرس سلسلة البيانات الثانية هو1
، وهكذا. - <end_line_index>
-
- نوع التعبئة "b" - الخط الذي يتم عنده إيقاف التعبئة. ويجب أن يكون هذا السطر أسفل الخط الحالي.
- نوع التعبئة
"B" - أحد الخيارات التالية:
- أي قيمة - يتم تجاهل أي رقم فردي في هذه المعلمة، وستنتقل التعبئة من السطر المحدد إلى أساس الرسم البياني
- start:end - لملء شريحة رأسية أسفل الرسم البياني، حدِّد start:end، حيث تمثل فهارس نقاط البيانات التي تصف مكان بدء التعبئة وإيقافها. كلتا القيمتَين اختياريتان، ويتم ضبطهما تلقائيًا على first_point:last_point. (اطّلِع على المثال أدناه).
- <0>
- قيمة محجوزة — يجب أن تكون صفر.
أمثلة
الوصف | مثال |
---|---|
إنّ استخدام " هذا هو نوع منطقة التعبئة الوحيد المتاح للمخططات النسيجية. لا تعمل السمة |
|
إليك مخطط يتضمن سطرين وعمليتين. يتطلب ملء المساحة أسفل الخط السفلي وفوق السطر العلوي أسلوبًا خاصًا سنتناوله تاليًا. |
|
في رسم بياني متعدد الأسطر، للتعبئة من أعلى الرسم البياني إلى السطر الأول، أدرِج سلسلة تحتوي على نسختين من أعلى قيمة بيانات لتنسيق البيانات. على سبيل المثال، " لتعبئة من السطر الأخير إلى أسفل الرسم البياني، أدرِج سلسلة تحتوي على نسختَين من أدنى قيمة للبيانات لتنسيق البيانات. على سبيل المثال، AAAA للترميز الممتد، 0,0 للتنسيق الأساسي للنص، وما إلى ذلك. يتم رسم الخطوط نفسها باللون الأسود باستخدام |
chd=e: (أعلى قيمة) (قيمة صفرية)chm= (أزرق فاتح) b,224499,1,2,0| (أزرق) b,FF0000,2,3,0| (أحمر) b,80C65A,3,4,0 (أخضر)chco=000000 |
في ما يلي رسم بياني خطي بشرائح تعبئة عمودية. ويتم تحقيق ذلك من خلال تحديد زوج start:end لـ <end_line_index> مع نوع تعبئة السطر 'B'.
|
chm= |
يوضح هذا المثال استخدام تعبئة خطية على مخطط نسيجي. |
chm= |
علامات الأشكال chm
[شريطي، خطي،
رادار، نقاط مبعثرة]
يمكنك تحديد علامات رسومية لجميع نقاط البيانات أو نقاط بيانات فردية على الرسم البياني. إذا كانت هناك علامتان أو أكثر تشغلان النقطة نفسها،
يتم رسم العلامات بالترتيب الذي تظهر به في المعلَمة chm
.
يمكنك أيضًا إنشاء علامات نصية على نقاط البيانات التي تتناولها علامات نقاط البيانات.
يمكنك دمج علامات الأشكال مع أي معلَمات chm
أخرى باستخدام حرف الشرطة الرأسية ( |
) لفصل معلَمات chm
.
البنية
حدِّد مجموعة واحدة من المَعلمات التالية لكل سلسلة يجب وضع علامة عليها. لوضع علامة على عدّة سلاسل، عليك إنشاء مجموعات معلَمات إضافية، يتم الفصل بينها بفاصلة. وليس عليك ترميز كل السلاسل. إذا لم يتم وضع علامات لسلسلة بيانات، لن تظهر فيها أي علامات.
تعمل علامات الأشكال بشكلٍ مختلف قليلاً في الرسوم البيانية المبعثرة. يمكنك الاطّلاع على هذا المستند للحصول على مزيد من المعلومات.
chm= [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset> |...| [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
- @
- [اختيارية] إذا قبلت نوع العلامة بحرف @ اختياري، يجب أن تستخدم العلامة <opt_ which_points> التنسيق x:y.
- <marker_type>
- نوع العلامة المطلوب استخدامها. حدِّد أحد الأنواع التالية:
a
- سهمc
- متقاطعC
- مستطيل في حال استخدام علامة مستطيل، يجب أن تكون لديك سلسلتان من البيانات على الأقل، حيث تحدد السلسلة 0 الحافة السفلية والسلسلة 1 تحدد الحافة العلوية. <size> يحدد عرض المستطيل بالبكسل.d
- ماسيE
- علامة شريط الخطأ ( ) يتطلّب إنشاء هذه العلامة سلسلتَي بيانات، قيمة واحدة في الأسفل والنقطة المقابلة في السلسلة الثانية في الأعلى. ويعرض أيضًا بنية <size> موسّعة: line_thickness[:top_and_bottom_width] حيث يكون top_and_bottom_width اختياريًا. شاهد الأمثلة أدناه.h
- خط أفقي عبر الرسم البياني عند ارتفاع محدد (التنسيق الوحيد الصالح للمَعلمة <opt_which_points> هو opt_which_points.)H
- خط أفقي خلال علامة البيانات المحددة ويتيح لك ذلك استخدام بنية <size> موسّعة تتيح لك تحديد طول السطر بدقة: line_thickness[:length] حيث يكون :length اختياريًا، ويتم ضبطه تلقائيًا على العرض الكامل لمساحة الرسم البياني.o
- دائرةs
- مربّعةv
- خط عمودي من المحور x إلى نقطة البياناتV
- خط عمودي للطول القابل للتعديل. ويتيح لك ذلك استخدام بنية قيمة <size> موسّعة تتيح لك تحديد طول السطر بدقة: line_thickness[:length] حيث يكون :length اختياريًا، ويتم ضبطه تلقائيًا على ارتفاع مساحة الرسم البياني الكامل. يتم توسيط العلامة على نقطة البيانات.x
- حرف X
- <color>
- لون علامات هذه السلسلة، بتنسيق RRGGBB السداسي العشري
- <series_index>
- هو الفهرس المستند إلى صفر لسلسلة البيانات التي يتم رسم العلامات عليها. تم التجاهل
لعلامات
h
وعلامات تحديد الموقع الجغرافي حسب الموضع x/y (تبدأ بالحرف @). يمكنك استخدام سلسلة البيانات المخفية كمصدر للعلامات. راجع المخططات المركّبة للحصول على مزيد من المعلومات. تتوافق الرسوم البيانية الشريطية العمودية المجمّعة مع بنية خاصة موسّعة لمحاذاة العلامات مع أشرطة معيّنة. - <opt_which_points>
- [اختيارية] تحديد النقاط المطلوب رسم العلامات عليها الإعداد التلقائي هو
جميع العلامات. استخدِم إحدى القيم التالية:
n.d
- مكان رسم محدِّد الموقع يعتمد المعنى على نوع العلامة:- جميع الأنواع باستثناء h: تشير هذه النقطة إلى نقطة البيانات التي يجب رسم العلامة عليها، حيث يشير n.d إلى فهرس يستند إلى الصفر في السلسلة. وإذا حدّدت قيمة لا تمثّل عددًا صحيحًا، يشير الكسر إلى نقطة متوسطة محسوبة. على سبيل المثال، 3.5 تعني في المنتصف بين النقطة 3 والنقطة 4.
h
- رقم من 0.0 إلى 1.0، حيث يمثّل 0.0 أسفل الرسم البياني و1.0 أعلى الرسم البياني.
-1
- رسم علامة على جميع نقاط البيانات ويمكنك أيضًا ترك هذه المَعلمة فارغة للاعتماد على جميع نقاط البيانات.-n
- رسم علامة على كل نقطة بيانات n. قيمة النقاط العائمة: إذا كان n أقل من 1، سيحسب الرسم البياني نقاطًا وسيطة إضافية لك. على سبيل المثال، سيؤدي إدخال -0.5 إلى وضع ضعف عدد العلامات التي وضعتها نقاط البيانات.start:end:n
- رسم علامة على كل نقطة بيانات n رقم في نطاق، من قيم فهرس n إلى n، بما في ذلك قيم الفهرس إنّ جميع المَعلمات اختيارية (قد لا تكون متوفرة)، لذا فإنّ نسبة 3::1 ستكون من العنصر الرابع حتى العنصر الأخير، في حال إغفال هذه المَعلمة بالكامل، سيؤدي حذف هذه المَعلمة بالكامل إلى ضبط القيمة first:last:1. يمكن أن تكون جميع القيم أرقامًا بنقاط عائمة. ويمكن أن تكون قيمة start وend سالبة، ليتم العد التنازلي من القيمة الأخيرة. إذا كانت كل من start وend سالبة، احرص على إدراجهما بقيمة متزايدة (على سبيل المثال، -6:-1:1). إذا كانت قيمة الخطوة n أقل من 1، ستحتسب نقاط البيانات الإضافية من خلال إدخال قيم البيانات المقدَّمة. القيم التلقائية هي first:last:1x:y
- رسم علامة عند نقطة x/y معينة على الرسم البياني. ولا يلزم أن تكون هذه النقطة على خط. لاستخدام هذا الخيار، أضِف الرمز @ قبل نوع العلامة. حدِّد الإحداثيات على أنّها قيم النقطة العائمة، حيث يمثل0:0
أسفل يسار الرسم البياني و1:1
في أعلى يسار الرسم البياني. على سبيل المثال، لإضافة ماسة حمراء مقاس 15 بكسل إلى وسط رسم بياني، استخدِم@d,FF0000,0,0.5:0.5,15
.
- <size>
- حجم العلامة بالبكسل. يستخدم معظمهم قيمة رقمية واحدة لهذه المَعلمة، وتتيح العلامات V وH وS استخدام البنية <size>[:width] حيث يحدّد الجزء الثاني الاختياري طول السطر أو العلامة.
- <opt_z_order>
- [اختيارية] تمثّل هذه السمة الطبقة التي يتم رسم العلامة عليها، مقارنةً بالعلامات الأخرى وجميع عناصر الرسم البياني الأخرى. وهذا هو رقم النقطة العائمة من -1.0 إلى 1.0، شاملاً، حيث -1.0 هو الجزء السفلي و1.0 في الأعلى. عناصر الرسم البياني (الخطوط والأشرطة) أقل من صفر. في حال وجود علامتَين بالقيمة نفسها، سيتم رسمهما بالترتيب الذي يحدّده عنوان URL. القيمة التلقائية هي 0.0 (أعلى عناصر الرسم البياني مباشرةً).
- <opt_offset>
- [اختيارية] تتيح لك تحديد الإزاحة الأفقية والعمودية من
الموقع المحدَّد. إليك الصيغة التي تستخدم : المحدد:
reserved:<horizontal_offset>:<vertical_offset>
. يمكنك تضمين قيمة , فارغة في سلسلة المَعلمةchm
للسمة <opt_z_order> في حال تحديدها. أمثلة:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- محجوز - اترك الحقل فارغًا.
<horizontal_offset>
- رقم موجب أو سالب يحدّد الإزاحة الأفقية بالبكسل. اختياري، ويمكنك ترك هذا الحقل فارغًا إذا لم يتم استخدامه.<vertical_offset>
- رقم موجب أو سالب يحدّد الإزاحة العمودية بالبكسل. اختياري، ويمكنك ترك هذا الحقل فارغًا إذا لم يتم استخدامه.
أمثلة
الوصف | مثال |
---|---|
في ما يلي مثال على العديد من علامات الأشكال والخطوط.
|
chm= |
في ما يلي مثال على استخدام المعينات لسلسلة بيانات واحدة، والدوائر لسلسلة البيانات الأخرى. إذا كانت هناك علامتان أو أكثر تشغلان النقطة نفسها، يتم رسم العلامات بالترتيب الذي تظهر به في المعلَمة |
chm= |
في ما يلي رسم بياني خطي يتضمّن محدِّدًا على كل نقطة بيانات ثانية (ويشير -2 إلى كل نقطة أخرى). |
chd=t: |
في ما يلي رسم بياني خطي يحتوي على ضعف عدد العلامات المماثل لنقاط البيانات (يشير -0.5 إلى كل نصف نقطة). | chd=t: |
يوضّح هذا المثال كيفية استخدام علامات h وv لإنشاء خطوط شبكة بألوان وسمك مخصّصَين. يتم ضبط قيمة الترتيب z (القيمة الأخيرة) على -1 بحيث يتم رسم خطوط الشبكة أسفل خط البيانات. |
chm= |
يضيف هذا المخطط خطوط تعبئة عمودية إلى مخطط خطي:
|
chm= |
يضيف هذا المثال سهمًا وعلامة نص إلى الرسم البياني باستخدام الإحداثيات الدقيقة. علامة D الأولى هي خط التتبع أسفل الأشرطة. العلامة الثانية هي السهم، والعلامة الثالثة هي نص السهم. | chm= |
يمكن أن يكون الخط الأفقي المثبَّت على نقطة بيانات معيّنة (H ) مفيدًا لعرض القيم النسبية أو التأكيد على ارتفاع قيمة بيانات في رسم بياني. |
chm=H,FF0000,0,18,1 |
يعرض هذا الرسم البياني العلامات التي يمكنها تحديد سُمك الخط وطوله في المعلمة <size>.
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50,1,2,5:50chm=
|
علامات قيم البيانات والنص chm
[شريط، خطي،
رادار، مبعثر]
ويمكنك تصنيف نقاط محددة على الرسم البياني باستخدام نص مخصّص أو نُسخ منسّقة من البيانات في هذه المرحلة.
يمكنك دمج أي علامات chm
باستخدام حرف شَرطة ( |
) لفصل مجموعات المعلَمات chm
.
ملاحظة بشأن قيم السلسلة: يُسمح فقط باستخدام الأحرف الآمنة لعنوان URL في سلاسل التصنيفات. لتحقيق الأمان، عليك ترميز عنوان URL لأي سلاسل تحتوي على أحرف ليست ضمن مجموعة الأحرف 0-9a-zA-Z
.
يمكنك العثور على برنامج ترميز عناوين URL في مستندات Google المرئية.
البنية
حدِّد مجموعة واحدة من المَعلمات التالية لكل سلسلة يجب وضع علامة عليها. لوضع علامة على عدّة سلاسل، عليك إنشاء مجموعات معلَمات إضافية، يتم الفصل بينها بفاصلة. ولن تحتاج إلى ترميز كل السلاسل. إذا لم يتم وضع علامات لسلسلة بيانات، لن تظهر فيها أي علامات.
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <marker_type>
- نوع العلامة المطلوب استخدامها. يمكنك الاختيار من بين الأنواع التالية:
f<text>
- علم يحتوي على نص. حدِّد الحرف "f" متبوعًا بنص مخصّص بترميز عنوان URL. لتخطي الفواصل في علامات النص، أضِف علامة \ قبل الفاصلة. مثال:fHello\,+World!
t<text>
- محدد نص بسيط. حدِّد الحرف 't' متبوعًا بنص مخصّص بترميز عنوان URL. لتخطي الفواصل في علامات النص، أضِف علامة \ قبل الفاصلة. مثال:tHello\,+World!
A<text>
- علامة تعليق توضيحي. يشبه ذلك علامة العلامة، ولكن العلامات ستنسّق موضعها بحيث لا تتداخل. التنسيق الوحيد الصالح لـ <opt_which_points> هو opt_which_points، وذلك للدلالة على فهرس إحدى النقاط في السلسلة.N<formatting_string>
: قيمة البيانات في هذه المرحلة، مع تنسيق اختياري. إذا لم تستخدم المعلَمةchds
(تحجيم مخصّص)، سيتم عرض القيمة المرمّزة بالضبط. وفي حال استخدام هذه المعلَمة مع أي نوع تنسيق، سيتم ضبط القيمة على النطاق الذي تحدّده. يمكنك الاطّلاع على مثال عنchds
باستخدام علامات رقمية أدناه. باستخدام نوع العلامة هذا في مخطط شريطي مكدس، إذا حددت -1 لـ <series_index>، ستحصل على علامة تعرض مجموع كل القيم في هذا الشريط المكدس. تكون بنية سلسلة التنسيق على النحو التالي:
<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
.
كل هذه العناصر اختيارية. في ما يلي معنى كل عنصر:<preceding_text>
- النص الذي يسبق كل قيمة*...*
: عبارة عن وحدة اختيارية ملفوفة بعلامات نجمية حرفية، حيث يمكنك تحديد تفاصيل تنسيق الأرقام. يمكن استخدام القيم التالية، وجميعها اختيارية:<number_type>
: تنسيق الأرقام للقيم الرقمية حدِّد أحد الخيارات التالية:f
- [التلقائي] تنسيق النقاط العائمة ننصحك بتحديد الدقة أيضًا باستخدام قيمة <decimal_places>.p
- تنسيق النسبة المئوية يتم إلحاق علامة % تلقائيًا. ملاحظة: عند استخدام هذا التنسيق، يتم ربط قيم البيانات من 0.0 - 1.0 إلى 0 — 100% (على سبيل المثال، سيظهر 0.43 على هذا النحو 43%).e
- تنسيق الترميز العلميc<CUR>
- تنسيق الرقم بالعملة المحدّدة باستخدام علامة العملة المناسبة استبدِل<CUR>
برمز عملة مكوّن من ثلاثة أحرف. مثال:cEUR
لليورو. يمكنك العثور على قائمة بالرموز على موقع ISO الإلكتروني، ولكن لا يُسمح باستخدام جميع الرموز.
<decimal_places>
- عدد صحيح يحدّد عدد المنازل العشرية المطلوب عرضها. يتم تقريب القيمة إلى هذا الطول (بدون اقتطاع). القيمة التلقائية هي 2.z
- عرض الأصفار اللاحقة القيمة التلقائية هي "لا".s
- فواصل مجموعات الشبكة الإعلانية القيمة التلقائية هي "لا".x
أوy
- يتم عرض البيانات من الإحداثي س أو ص على النحو المحدّد. يختلف معنى بيانات "س" حسب نوع الرسم البياني: عليك تجربة الرسم البياني لتحديد معناه. القيمة التلقائية هي "y".
<following_text>
- نص لاتّباع كل قيمة
- <color>
- لون علامات هذه المجموعة، بتنسيق RRGGBB السداسي العشري
- <series_index>
- هو الفهرس المستند إلى صفر لسلسلة البيانات التي يتم رسم العلامات عليها. إذا كان هذا رسمًا بيانيًا شريطيًا مكدسًا وكان نوع العلامة هو N (قيم نقاط البيانات)، يمكنك تحديد -1 لإنشاء علامة قيمة مجمّعة لكل حزمة من الأشرطة. انظر أدناه للاطّلاع على مثال.
- <opt_which_points>
- [اختيارية] تحديد النقاط المطلوب رسم العلامات عليها الإعداد التلقائي هو جميع العلامات. استخدِم
إحدى القيم التالية:
n.d
: نقطة البيانات التي يجب رسم العلامة عليها، حيث يشير n.d إلى فهرس يستند إلى الصفر في السلسلة. وإذا حدّدت قيمة لا تمثّل عددًا صحيحًا، يشير الكسر إلى نقطة متوسطة محسوبة. على سبيل المثال، 3.5 تعني المنتصف بين النقطة 3 والنقطة 4.-1
- رسم علامة على جميع نقاط البيانات ويمكنك أيضًا ترك هذه المَعلمة فارغة للاعتماد على جميع نقاط البيانات.-n
- رسم علامة على كل نقطة بيانات n.start:end:n
- رسم علامة على كل نقطة بيانات n في نطاق، من قيم فهرس n إلى n، شاملة إنّ جميع المَعلمات اختيارية (قد لا تكون متوفرة)، لذا فإنّ نسبة 3::1 سيتم نقلها من العنصر الرابع إلى العنصر الأخير، والخطوة رقم 1، في حال إزالة هذه المَعلمة بالكامل، سيتم ضبط القيمة التلقائية first:last:1. يمكن أن تكون جميع القيم أرقامًا بنقاط عائمة. ويمكن أن تكون قيمة start وend سالبة، ليتم العد التنازلي من القيمة الأخيرة. إذا كانت كل من start وend سالبة، تأكّد من إدراجهما بقيمة متزايدة (على سبيل المثال، -6:-1:1). إذا كانت قيمة الخطوة n أقل من 1، ستحتسب نقاط البيانات الإضافية من خلال إدخال قيم البيانات المقدَّمة. القيم التلقائية هي first:last:1x:y
- [غير متوافقة مع علامات من نوع N] ارسم علامة عند نقطة x/y معيّنة على الرسم البياني. ولا يجب أن تكون هذه النقطة على سطر. أضِف الحرف at (@
) قبل نوع العلامة لاستخدام هذا الخيار. حدِّد الإحداثيات على أنّها قيم نقاط عائمة، حيث يمثّل الرمز0:0
أسفل يسار الرسم البياني و0.5:0.5
في وسط الرسم البياني و1:1
في أعلى يسار الرسم البياني. على سبيل المثال، لإضافة ماسة حمراء بحجم 15 بكسل إلى منتصف رسم بياني، استخدِم@d,FF0000,0,0.5:0.5,15
.
- <size>
- حجم العلامة بالبكسل. إذا كان هذا الرسم البياني مبعثرًا يتضمّن سلسلة بيانات ثالثة (تُستخدم لتحديد أحجام النقاط)، سيتم ضبط هذه القيمة حسب نطاق البيانات. وبالتالي، إذا كان نطاق البيانات من 0 إلى 100 و <size> هو 30، ستكون قيمة البيانات 100 بعرض 30 بكسل، وقيمة البيانات 50 ستكون عرض 15 بكسل، وهكذا.
- <opt_z_order>
- [اختيارية] تمثّل هذه السمة الطبقة التي يتم رسم العلامة عليها، مقارنةً بالعلامات الأخرى وجميع عناصر الرسم البياني الأخرى. وهذا هو رقم النقطة العائمة من -1.0 إلى 1.0، شاملاً، حيث -1.0 هو الجزء السفلي و1.0 في الأعلى. عناصر الرسم البياني (الخطوط والأشرطة) أقل من صفر. في حال وجود علامتَين بالقيمة نفسها، سيتم رسمهما بالترتيب الذي يحدّده عنوان URL. القيمة التلقائية هي 0.0 (أعلى عناصر الرسم البياني مباشرةً).
- <opt_placement>
- [اختيارية] تفاصيل إضافية عن موضع الإعلان توضّح مكان وضع هذه
العلامة في ما يتعلق بنقطة البيانات. يمكنك تحديد الوضع النسبي الأفقي و/أو الرأسي، بالإضافة إلى القيم الإزاحة. بنية موضع الإعلان هي سلسلة تتضمّن :
محدِّدات كما هو موضّح هنا. جميع العناصر اختيارية:
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
. يمكنك تضمين قيمة , فارغة في سلسلة المعلَمةchm
للسمة <opt_z_order>، على سبيل المثال:N,000000,0,1,10,,b
وN,000000,0,1,10,,lv
وN,000000,0,1,10,,r::10
.- horizontal_and_vertical_justification
- نقطة ارتساء العلامة ويعمل ذلك بشكل عكسي للتبرير، لذا يؤدي الارتساء الأيسر إلى وضع العلامة على يمين نقطة البيانات. يمكنك اختيار مبرّر أفقي
و/أو رأسي من القائمة التالية:
- الموضع الأفقي: "l" أو "h" أو "r" - لليسار أو في المنتصف أو مثبّت على اليمين، أفقيًا. القيمة التلقائية هي "l".
- موضع الإعلان: "b" أو "v" أو "t" - أسفل أو في المنتصف أو في موضع علوي، أو عموديًا. القيمة التلقائية هي "b".
- موضع إعلان عمودي [الرسوم البيانية الشريطية فقط]: 's' أو 'c' أو 'e' - قاعدة أو وسط أو أعلى شريط. بالنسبة إلى الرسوم البيانية المكدَّسة، يرتبط ذلك بقسم الشريط لكل سلسلة، وليس للشريط بأكمله. إذا كان فهرس السلسلة المقدم -1 (إجمالي تسلسل استدعاء الدوال البرمجية)، يكون بالنسبة إلى الشريط بأكمله. يمكن الجمع بين ذلك وقِيم مواضع الإعلان الرأسية، مثل "be" أو "vs". القيمة التلقائية هي "e".
- horizontal_offset
- إزاحة أفقية لهذه العلامة بالبكسل. القيمة التلقائية هي 0.
- vertical_offset
- إزاحة عمودية لهذه العلامة بالبكسل. الإعداد التلقائي للرسم البياني غير الشريطي: 15، الإعداد التلقائي للرسم البياني غير الشريطي: 2.
الوصف | مثال | |
---|---|---|
فيما يلي مثال على تصنيفات القيم في مخطط شريطي. يحدد الرسم البياني الأول ( يعرض الرسم البياني الثاني ( |
|
|
يمكنك استخدام المَعلمة يعرض هذا المثال رسمًا بيانيًا بقيم مرمّزة بسيطة
وهي 46 و39 و29 و30 و43 و41. يتراوح نطاق الترميز البسيط بين 0 و61
. تحدّد المَعلمة |
chd=s:underp |
|
في ما يلي مثال على رسم بياني يتضمن تصنيفًا نصيًا في أدنى نقطة وعلامة عند أقصى نقطة. |
|
|
يعرض هذا المثال رسمًا بيانيًا مكدّسًا يحتوي على قيم لسلسلة فردية، بالإضافة إلى إجمالي قيمة السلسلة. لعرض قيم السلسلة المكدسة، يجب استخدام خيار تحديد الموضع "c". وإذا لم يتم ذلك، ستتداخل قيمة الشريط العلوي مع قيمة الإجمالي في أعلى كل شريط. | chm= |
|
بعض العروض التوضيحية الإضافية حول آلية عمل المواضع العمودية والأفقية يعرض هذا المثال مجموعات مختلفة من قيم الارتساء للمخططات الشريطية (التي تستخدم s وc وe للموضع الرأسي). لاحظ كيف يؤدي ارتساء الجزء الأيمن إلى تحريك العلامة إلى اليسار، بينما يؤدي ارتساء الجزء العلوي إلى تحريك العلامة لأسفل، والعكس صحيح. تُظهر النقاط الحمراء القاعدة والوسط وأعلى كل شريط. ويمثل الرقم قيمة البيانات، ويتم تثبيتها باستخدام قيم ارتساء مختلفة لكل شريط. | chm= |
|
تضبط علامات التعليقات التوضيحية موضع التصنيف تلقائيًا
بحيث لا تتداخل. قيمة chm الأولى مخصصة لملء الخط، والقيم التالية كلها علامات للتعليقات التوضيحية. |
chm=B,C5D4B5BB,0,0,0 |
|
مثال آخر لعلامة تعليق توضيحي يوضّح ارتفاعات المدن في سويسرا. |
علامات النطاق chm
[بار،
شمعدان، خطي،
رادار، مبعثر]
يمكنك تلوين نطاقات أفقية أو رأسية من تعبئة الخلفية لتمييز مناطق معيّنة من الرسم البياني.
يمكنك دمج أي علامات chm
باستخدام حرف الشرطة ( |
) لفصل مجموعات معلَمات chm
.
البنية
حدِّد مجموعة واحدة من المعلَمات التالية لكل نطاق للرسم. لرسم نطاقات متعددة، أنشِئ مجموعات معلَمات إضافية، يتم الفصل بينها بفاصلة. يتم رسم النطاقات بالترتيب المحدد، وبالتالي سيتم رسم آخر نطاق مرسوم أعلى النطاقات السابقة.
chm= <direction>,<color>,0,<start_point>,<end_point> |...| <direction>,<color>,0,<start_point>,<end_point>
- <direction>
- يحدد التظليل الأفقي أو العمودي. استخدِم
r
لنطاق أفقي وR
لنطاق عمودي. - <color>
- لون النطاق كرقم سداسي عشري بتنسيق RRGGBB.
- 0
- قيمة محجوزة — يجب أن تكون صفر.
- <start_point>
- موضع بداية النطاق
- بالنسبة إلى علامات النطاق الأفقية، يمثّل هذا الموضع على المحور الصادي،
حيث يمثّل
0.00
أسفل الرسم البياني و1.00
في الجزء العلوي من الرسم البياني. - بالنسبة إلى علامات النطاق الرأسية، تمثّل هذه السمة موضعًا على المحور س،
حيث يكون
0.00
على يسار الرسم البياني و1.00
على يمين الرسم البياني.
- <end_point>
- موضع نهاية النطاق
- بالنسبة إلى علامات النطاق الأفقية، يمثّل هذا الموضع على المحور الصادي،
حيث يمثّل
0.00
أسفل الرسم البياني و1.00
في الجزء العلوي من الرسم البياني. - بالنسبة إلى علامات النطاق الرأسية، تمثّل هذه السمة موضعًا على المحور س،
حيث يكون
0.00
على يسار الرسم البياني و1.00
على يمين الرسم البياني.
أمثلة
الوصف | مثال |
---|---|
يمكن أن تكون علامات النطاق خطًا رفيعًا أو شريطًا من الألوان.
|
|
يوضح هذا المثال علامات النطاقات الرأسية. العلامة الأولى عبارة عن خط أحمر ( |
|
يتم رسم العلامات بالترتيب المحدد. في هذا المثال، يمكنك معرفة أنّ محدّد الموقع الأحمر العمودي قد تم رسمه قبل العلامة الأفقية الزرقاء الباهتة. |
chm= |
في ما يلي مثال على رسم بياني خطي يستخدم علامات النطاقات لرسم خطوط أفقية باهتة في الخط صفر وخط المنتصف وفي الأعلى. |
|
محدّدات الشمعدان chm=F
[شريط،
خط]
تشير علامات الشمعدان إلى التباين والاتجاه في سلسلة بيانات. وتُستخدم غالبًا لعرض قيم الأسهم على مدار اليوم. تشتمل العلامة على شرائح تعرض القيمة العالية والمنخفضة، بالإضافة إلى القيمة الافتتاحية والختامية لفترة زمنية محددة (يوم واحد عادةً). لمزيد من المعلومات حول علامات الشمعدان، انقر هنا.
يتم رسم علامة الشمعدان على شكل مستطيل مقسَّم بخط عمودي. وتتطلّب هذه السلسلة أربع سلاسل بيانات لرسم محدِّد شمعدان، وإليك ما تحدِّده كل سلسلة:
- تحدّد السلسلتان 1 و4 أسفل الخط العمودي وعليه، على التوالي. تمثّل هذه البيانات عادةً القيم المنخفضة والمرتفعة لليوم.
- تحدد السلسلتان 2 و3 الحدود الرأسية للمستطيل. السلسلة 2 هي القيمة الافتتاحية، وسلسلة 3 هي القيمة الختامية. يعتمد لون المستطيل على أيهما أعلى: عندما تكون القيمة الافتتاحية (السلسلة 2) أقل من القيمة الختامية (السلسلة 3)، يرتفع السعر ويتم ملء المستطيل باللون الأخضر الثابت تلقائيًا. وعندما تكون القيمة الافتتاحية (السلسلة 2) أعلى من القيمة الختامية (السلسلة 3)، انخفض السعر، ويتم تلقائيًا تعبئة المستطيل باللون الأحمر الخالص. يمكنك تحديد لون تعبئة فقط للمستطيل ذي القيمة الأقل. عند تحديد ذلك، يكون المستطيل ذو القيمة المتزايدة غير معبأ (فارغ). يُرجى العِلم أنّ السلسلة 2 يمكن أن تظهر في أعلى المستطيل أو أسفله، استنادًا إلى ما إذا كان السعر قد ارتفع أو انخفض.
يمكنك دمج علامات الشمعدان مع أي معلَمات chm
أخرى باستخدام حرف الشرطة ( |
) لفصل معلَمات chm
.
ملاحظة: إذا كنت لا تريد إظهار خطوط البيانات المستخدَمة لرسم العلامات في الرسم البياني، يجب تضمين 0 بعد نوع التنسيق. على سبيل المثال: chd=t0:10,20,30,40
في سلسلة بيانات بتنسيق نصي. راجع المخططات المركّبة للحصول على مزيد من المعلومات.
في ما يلي مثال يوضّح الخطوط لكل سلسلة:
البنية
chm= F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
- F
- يشير إلى أنّ هذا محدّد شمعدان.
- <opt_declining_color>
- [اختيارية] لون تعبئة المستطيلات عندما تنخفض القيمة (عندما تكون القيمة في السلسلة 2 > قيمة السلسلة المقابلة 3) ويكون هذا رقمًا سداسيًا عشريًا لتنسيق RGGBB. عندما تزداد القيم، سيكون المستطيل فارغًا. القيمة التلقائية هي اللون الأخضر الثابت لزيادة القيم، والأحمر الثابت للتقليل (لا يمكنك تحديد لون تعبئة مخصّص لزيادة القيم).
- <data_series_index>
- فهرس سلسلة البيانات الذي سيتم استخدامه كسلسلة البيانات الأولى لعلامات الشموع ويكون هذا فهرسًا مستندًا إلى صفر. لذلك، إذا حددت 1 هنا وكانت لديك ستة سلاسل، سيتم استخدام السلسلة الثانية والثالثة والرابعة والخامسة لرسم علامات الشمعدان.
- <opt_that_points>
- [اختيارية] تحدّد هذه السمة نقاط البيانات التي يتم استخدامها لرسم العلامات. الخيار التلقائي
هو جميع العلامات. استخدِم أحد
التنسيقات التالية:
n.d
- رسم علامة على نقطة واحدة في السلسلة، حيث يشير n.d إلى فهرس النقطة في السلسلة وإذا حدّدت قيمة لا تمثّل عددًا صحيحًا، يشير الكسر إلى نقطة متوسطة محسوبة. على سبيل المثال، 3.5 تعني في المنتصف بين النقطة 3 والنقطة 4.-1
- رسم علامة على جميع نقاط البيانات ويمكنك أيضًا ترك هذه المَعلمة فارغة للرسم على جميع العلامات.-n
- رسم علامة على كل نقطة بيانات n.start:end:n
- رسم علامة على كل نقطة بيانات n رقم في نطاق، من قيم فهرس n إلى n، بما في ذلك قيم الفهرس إنّ جميع المَعلمات اختيارية (قد لا تكون متوفرة)، لذا فإنّ نسبة 3::1 ستكون من العنصر الرابع حتى العنصر الأخير، في حال إغفال هذه المَعلمة بالكامل، سيؤدي حذف هذه المَعلمة بالكامل إلى ضبط القيمة first:last:1. يمكن أن تكون جميع القيم أرقامًا بنقاط عائمة. ويمكن أن تكون قيمة start وend سالبة، ليتم العد التنازلي من القيمة الأخيرة. إذا كانت كل من start وend سالبة، تأكّد من إدراجهما بقيمة متزايدة (على سبيل المثال، -6:-1:1). إذا كانت قيمة الخطوة n أقل من 1، ستحتسب نقاط البيانات الإضافية من خلال إدخال قيم البيانات المقدَّمة. القيم التلقائية هي first:last:1
- <width>
- عرض جميع المستطيلات بالبكسل
- <opt_z_order>
- [اختيارية] تمثّل هذه السمة الطبقة التي يتم رسم العلامة عليها، مقارنةً بالعلامات الأخرى وجميع عناصر الرسم البياني الأخرى. وهذا هو رقم النقطة العائمة من -1.0 إلى 1.0، شاملاً، حيث -1.0 هو الجزء السفلي و1.0 في الأعلى. عناصر الرسم البياني (الخطوط والأشرطة) أقل من صفر. في حال وجود علامتَين بالقيمة نفسها، سيتم رسمهما بالترتيب الذي يحدّده عنوان URL. القيمة التلقائية هي 0.0 (أعلى عناصر الرسم البياني).
أمثلة
الوصف | مثال |
---|---|
في ما يلي مثال على علامات الشمعدان على رسم بياني خطي
مكوّن من أربع سلاسل. تم تحديد لون التعبئة المخصّص يتم اقتطاع المستطيل الأول والأخير بواسطة المخطط. وللتخلص من هذه القيم، يمكنك تحديد 1:4 للمعلمة الرابعة من chm. لاحظ الصفر في سلسلة البيانات، لإخفاء أسطر السلسلة: إنّ المعلَمة <which_point> فارغة، ما يؤدي إلى رسم شمعدان على جميع نقاط البيانات. |
chd=t0: |
في ما يلي مثال على الرسم البياني نفسه باستخدام الألوان التلقائية وإزالة العنصرَين الأول والأخير. هذا رسم بياني مركب: هو مزيج من رسم بياني خطي (نوع الرسم البياني الأساسي) وعلامات الشموع. تعني القيمة 1 في |
|
علامات الخطوط chm=D
[شريط،
شمعدان، خطي، رادار،
نقاط مبعثرة]
يمكنك إضافة سطر يتتبع البيانات في الرسم البياني. وفي أغلب الأحيان، يتم استخدام هذه البيانات في الرسوم البيانية المركّبة.
لإضافة أسطر متعدّدة (أو دمج هذه العلامة مع أيّ علامات chm
أخرى)،
افصل بين مجموعات المَعلمات chm باستخدام محدِّد الشرطة الرأسية ( |
). لا يمكنك وضع علامة خط متقطع باستخدام هذه المعلمة.
البنية
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- D
- يشير إلى أن هذه علامة خط.
- <color>
- لون الخط بالتنسيق RRGGBB السداسي العشري.
- <series_index>
- فهرس سلسلة البيانات المستخدَم لرسم الخط وفهرس سلسلة البيانات هو
0
لسلسلة البيانات الأولى و1
لسلسلة البيانات الثانية، وهكذا. - <which_points>
- النقاط في السلسلة المطلوب استخدامها لرسم الخط استخدِم إحدى القيم التالية:
0
- استخدِم جميع النقاط في السلسلة.start:end
- استخدِم نطاقًا محددًا من النقاط في السلسلة، بدءًا من البداية إلى النهاية شاملة (فهرس على أساس صفري). يمكنك أيضًا استخدام قيم النقطة العائمة لتحديد النقاط الوسيطة، أو يمكنك ترك حقل start أو end فارغًا للإشارة إلى نقطة البيانات الأولى أو الأخيرة على التوالي. ويمكن أن تكون قيمة start وend سالبة، كفهرس عكسي من القيمة الأخيرة. إذا كانت كل من start وend سالبة، احرص على كتابتها بقيمة متزايدة (على سبيل المثال، -6:-1).
- <size>
- عرض الخط بالبكسل.
- <opt_z_order>
- [اختيارية] تمثّل هذه السمة الطبقة التي يتم رسم العلامة عليها، مقارنةً بالعلامات الأخرى وجميع عناصر الرسم البياني الأخرى. وهذا هو رقم النقطة العائمة من -1.0 إلى 1.0، شاملاً، حيث -1.0 هو الجزء السفلي و1.0 في الأعلى. عناصر الرسم البياني (الخطوط والأشرطة) أقل من صفر. في حال وجود علامتَين بالقيمة نفسها، سيتم رسمهما بالترتيب الذي يحدّده عنوان URL. القيمة التلقائية هي 0.0 (أعلى عناصر الرسم البياني).
أمثلة
الوصف | مثال |
---|---|
هذا مثال على رسم خط علامة على مخطط شريطي.
تم ضبط الترتيب z على |
chm=D,0033FF,0,0,5,1 |
هذا هو الرسم البياني الشريطي نفسه، ولكن مع سلسلة بيانات
إضافية للخط فقط. هذا مثال على مخطط مركب.
يتم رسم الرسوم البيانية المركّبة من خلال إضافة سلسلة بيانات إضافية إلى المعلَمة راجع الرسوم البيانية المركّبة للحصول على مزيد من المعلومات. |
chm=D,0033FF,1,0,5,1 |
دوال البيانات chfd
[كل
chd
الرسوم البيانية]
يمكنك تحديد دالة مخصّصة لتشغيلها على بيانات الرسم البياني باستخدام بنية دالة muParser. يمكن أن تأتي البيانات المستخدمة في الدالة من أحد المصدرين:
- سلسلة بيانات من
chd
: يتم سحب البيانات من السلسلة المحدّدة فيchd
. - نطاق من القيم المعلَن عنها في المَعلمة
chfd
نفسها: عليك تحديد قيمة بداية وتوقّف وخطوة لنطاق بيانات عشوائي.
ملاحظة: يجب في جميع الحالات تخصيص المخرجات لسلسلة حالية في chd
، وسيتم استبدال هذه السلسلة بمخرجات الدالة. لا يتم عرض الرسم البياني إلا بعد الانتهاء من معالجة جميع الدوال، لذلك في حال تعيين دوال متعددة لإخراج سلسلة البيانات نفسها، سيتم تنفيذ الدوال بالترتيب المحدّد، ولكن سيتم رسم مخرجات الدالة النهائية فقط على الرسم البياني. نشير إلى أنّه يمكنك إنشاء سلسلة من الدوال،
بحيث يمكن لدالة واحدة استخدامها كإدخال سلسلة تم إخراجها من دالة
سابقة.
لتخصيص ألوان أو علامات chm
لسطر الدالة، عليك تحديد الألوان أو العلامات لفهرس سلسلة الدالة. يُرجى العِلم أنّه يتم وضع العلامات وفقًا للبيانات بعد معالجتها من خلال الدالة.
البنية
chfd= <output_series_index>,<function_data>,<function_string> |...| <output_series_index>,<function_data>,<function_string>
- <output_series_index>
- فهرس مستند إلى صفر لسلسلة بيانات في
chd
تتم كتابة ناتج الدالة عليها. سيتم استبدال أي بيانات حالية بالكامل بمخرجات الدالة. إذا لم يتم استخدام سلسلة كإدخال لدالة، فإن أفضل الممارسات هي تخصيص قيمة وهمية واحدة لتلك السلسلة. - <function_data>
- المتغيّرات والبيانات المُراد رسمها يمكن أن تكون البيانات من نطاق تحدده أو
من إحدى سلاسل بيانات
chd
. يمكنك تحديد متغيّرات متعددة لكل دالة، باستخدام محدِّد ; (فاصلة منقوطة) لمتغيرات متعددة. يُرجى العلم أنّه إذا حدّدت متغيّرات متعددة لدالة واحدة وكانت هذه المتغيرات تتضمّن عددًا مختلفًا من النقاط، ستتوقف الدالة عند وصولها إلى نقطة النهاية الأولى. على سبيل المثال، إذا كانت الدالة تحدّد كلاً من x=1 —5 الخطوة 1 وy=1—10 الخطوة 1، ستنتهي الدالة عندما تصل إلى النقطة الخامسة.
<variable_name>,<input_series_index>
أو
<variable_name>,<start>,<end>,<step>
- variable_name - اسم سلسلة عشوائية للمتغير. ويمكنك استخدام هذا في الدالة التي تحدّدها function_string.
- input_series_index: فهرس سلسلة بيانات
chd
لاستخدامه كبيانات إدخال. - start - قيمة البداية الرقمية لنطاق.
- end - قيمة النهاية الرقمية لنطاق.
- step - القيمة الرقمية للخطوة من start إلى end. يمكن أن تكون القيمة موجبة أو سالبة، ولكن لا يمكن أن تكون صفرًا.
x,0,100,1
" عن متغيّر باسمx
يتضمّن القيم 0 و1 و2 و... 100. يعلنx,0,100,1;r,0,3.1,.1
عن متغيّرx
نفسه بالإضافة إلى متغيّر باسمr
بالقيم 0 و0.1 و0.2 و... و3.0 و3.1. تُعلنx,0
عن متغيّر باسم x يستخدم البيانات من سلسلةchd
الأولى. سيتم استخدام هذه المتغيرات من خلال function_string. ولن يتم رسمها على الرسم البياني ما لم تحدّدها في function_string. كلما كانت الخطوة أصغر، كان الرسم البياني أكثر سلاسة. - <function_string>
- دالةك، مكتوبة بالبنية muParser. يتم تطبيق الدالة على المتغيرات والبيانات المحدّدة في variable_data.
يمكنك فقط الإشارة إلى المتغيّرات المُعلنة في مجموعة الدوال المحلية هذه، وليس في مجموعة أخرى من معلَمات
chfd
. دوال الملخص اللغوي غير متوافقة (الحد الأدنى، الحد الأقصى للمجموع، المتوسط). ملاحظة مهمة: لا تنسَ استخدام%2B
بدلاً من+
في الدوال.
أمثلة
الوصف | مثال |
---|---|
موجة جيبية بسيطة. بعض الأشياء التي يجب ملاحظتها:
|
cht=lc |
يستخدم هذا السطر بيانات من مَعلمة chd . |
chd=t:5,10 |
مزيج من أسطر الدوال وغير الدالة. لاحِظ كيف يتم تحديد الألوان من خلال معلَمة لون السلسلة لاحظ موضع العلامات في إخراج الدالة. يتم احتساب نقاط البيانات من start وend وstep، وبالتالي إذا كان النطاق 0—11 الخطوة 0.1، والنقطة 0 هي 0، والنقطة 1 هي 0.1، وهكذا، حتى النقطة 110 التي تبلغ قيمتها 11. |
chd=t: |
لتحديد دالة في السمتَين، استخدِم الرسم البياني
|
cht=lxy |
تتيح لك المَعلمة جرِّب النقر على هذه الصور لفتحها وتشغيلها في مساحة الرسوم البيانية، ستنال إعجابك. |