وحدة:Graph2/شرح
 | هذه صفحة توثيق وحدة:Graph2 الفرعية، لشرح القالب وتصنيفه، وهي لا تدخل في استخدامه. |
 | صُنفت هذه الوحدة على أنها في مرحلة ألفا. تكون الوحدة في هذه المرحلة جاهزة نوعا ما لأن تستخدم من طرف ثالث، أي بمعنى أخر على النطاقات في صفحات التجارب. لكن يجب أن تستخدم في صفحات محددة للغاية وأن لا يوسع إستخدامها ابدا، حتى تنتقل للمرحلة التي بعدها. يجب أن يضاف لهذه الوحدة صفحة توثيق تشرح مدخلاتها وطريقة استخدامها. يجب أن تراقب هذه الوحدة جيدا وملاحظة أي أخطاء قد تحدث والعمل على عزلها وإصلاحها. |
وحدة مع الوظائف المساعدة لاستخدام Graph .
وظائف القوالب
map
ينشىء عنصر JSON لاستخدام <graph> لعرض خريطة سياسية مع الضوء الملونة. في نطاق المقالات يستخدم قالب:Graph:Chart بدلاً من ذلك. انظر صفحة توثيق القالب لحالات الاستخدام.
يمكن إيجاد الخرائط في خاص:Prefixindex/Module:Graph/ (مثال WorldMap-iso2.json لحدود البلدان) وينبغي أيضا حفظ الخرائط الجديدة تحت وحدة:Graph/.
الوسائط:
- basemap: Sets the base map. The map definitions must follow the TopoJSON format and if saved in Wikipedia are available for this module. Maps in the default directory خاص:Prefixindex/Module:Graph/ such as WorldMap-iso2.json should only be referenced by their name while omitting the Module:Graph/ prefix to allow better portability. The parameter also accepts URLs, e.g. maps from other Wikipedia versions (the link should follow the scheme of //en.wikipedia.org/w/index.php?title=mapname&action=raw, i.e. protocol-relative without leading http/s and a trailing action=raw to fetch the raw content only). URLs to maps on external sites should be avoided for the sake of link stability, performance, security, and she be assumed to be blocked by the software or browser anyway.
- scale: حجم الخريطة (افتراضي: 100)
- projection: the إسقاط الخرائط to use. Supported values are listed at https://github.com/mbostock/d3/wiki/Geo-Projections. The default value is equirectangular for an إسقاط متساوي المستطيلات.
- ids of geographic entities: The actual parameter names depend on the base map. For example, for the above mentioned world map the ids are قائمة الدول حسب المعيار الدولي أيزو 3166-1. The values can be either colors or numbers in case the geographic entities should be associated with numeric data: DE=lightblue marks Germany in light blue color, and DE=80.6 assigns Germany the value 80.6 (population in millions). In the latter case, the actual color depends on the following parameters.
- colorScale: the color palette to use for the color scale. The palette must be provided as a comma-separated list of color values. The color values must be given either as #rgb/#rrggbb or by a ألوان الويب. Instead of a list, the built-in color palettes category10 and category20 can also be used.
- scaleType: القيم المدعومة هي:
- linear for a linear mapping between the data values and the color scale
- log for a log mapping
- pow for a power mapping (the exponent can be provided as pow 0.5)
- sqrt for a square-root mapping
- quantize for a quantized scale, i.e. the data is grouped in as many classes as the color palette has colors.
- domainMin: الحد الأدنى لقيم البيانات، أي أن قيم البيانات الأصغر حجما يتم تعيينها إلى الحد الأدنى
- domainMax: الحد الأعلى لقيم البيانات، أي أن قيم البيانات الأكبر يتم تعيينها إلى الحد الأعلى
- legend: show color legend (does not work with quantize)
- defaultValue: default value for unused geographic entities. In case the id values are colors the default value is silver, in case of numbers it is 0.
- formatjson: تنسيق كائن JSON للحصول على أفضل وضوح
Template wrappers
الوظيفة mapWrapper وchartWrapper لتمرير كافة معلمات القالب إلى كل من وظيفتي map و chart .
ملاحظة: في معاينة المحرر تنشىء إضافة Graph canvas element مع الرسومات المتجهة. ومع ذلك، عند حفظ الصفحة يتم إنشاء الرسومات النقطية بصيغة PNG بدلا من ذلك. {{#invoke:Graph2