پرش به محتوا

الگو:میله‌های داده

از ویکی‌پدیا، دانشنامهٔ آزاد
توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

استفاده[ویرایش]

این الگو برای ساخت و نمایش نمودار میله‌ای کاربرد دارد.

نمونه‌ای ساده به سبک پیش‌فرض:
{{میله‌های داده
| ستون‌ها = ۶ | ژانویه | فوریه | مارس | آوریل | مه | ژوئن
| blue|بلوبری|      ۶۵|     ۳۸|    ۷۲|     ۴۷|  ۲۰|   ۳۰
}}
همان کاربرد، اما به‌صورت افقی (سبک = ۲):
{{میله‌های داده
| سبک = ۲
| ستون‌ها = ۶ | ژانویه | فوریه | مارس | آوریل | مه | ژوئن
| blue|بلوبری|      65|     ۳۸|    ۷۲|     ۴۷|  ۲۰|   ۳۰
}}


با چندین ردیف داده که به‌شکل زیر است:
حداکثر ستون‌های داده: ۱۶
{{میله‌های داده
| ستون‌ها =   ۱۲|ژانویه|فوریه|مارس|آوریل|مه|ژوئن|ژوئیه|اوت|سپتامبر|اکتبر|نوامبر|دسامبر
| green|    سیب|    ۶۰|   ۷۰|  ۹۰|   ۳۰|۵۰|  ۳۰|  ۱۰۰|۱۳۰|    ۱۲۰|   ۹۰|    ۵۰|   ۱۱۰
|yellow|    موز|    ۹۰|   ۸۰| ۱۱۰|   ۶۰|۷۰|  ۸۰|   ۷۰| ۷۰|     ۴۰|   ۵۰|    ۵۰|    ۶۰
|orange| پرتقال|    ۵۰|   ۴۰|  ۶۰|  ۱۱۰|۹۰|  ۶۰|   ۳۰| ۶۰|     ۷۰|   ۶۰|    ۸۰|    ۴۰
}}
حداکثر ردیف‌های داده: ۸
...الگو نموداری مجتمع و دارای شرح رنگ را نمایش می‌دهد که به‌شکل زیر است:

عنوان، مقیاس، منبع و هم‌ترازی[ویرایش]

پارامترهای نام‌گذاری‌شدهٔ اختیاری این الگو شامل عنوان، مقیاس و منبع هستند.

عنوان به‌صورت پررنگ و وسط‌چین در بالای نمودار نمایش داده می‌شود.
مقیاس برای بررسی اعداد بسیار کوچک یا اعداد بسیار بزرگ لازم است.
منبع اطلاعات منبعی که اطلاعات از آنجا آمده را در اختیار مخاطب قرار می‌دهد.


عنوان = اعداد کوچک، مقیاس بزرگ
مقیاس = ۱۰
منبع = داده‌های غیرواقعی برای این نمونه.
{{میله‌های داده
| عنوان  = اعداد کوچک، مقیاس بزرگ
| مقیاس  = ۱۰
| منبع   =  داده‌های غیرواقعی برای این نمونه.
| ستون‌ها =    ۶|ژانویه|فوریه|مارس|آوریل|مه|ژوئن
|   red|   گیلاس|     ۶|    ۷|   ۹|    ۳| ۵|   ۳
|  blue| بلوبری|     ۹|    ۸|  ۱۱|    ۶| ۷|   ۸
|purple|  انگور|     ۵|    ۴|   ۶|   ۱۱| ۹|   ۶
}}
عنوان = اعداد بزرگ، مقیاس کوچک
مقیاس = ۰٫۱        سبک = ۲
منبع = داده‌های غیرواقعی برای این نمونه.
{{میله‌های داده
| عنوان  = اعداد بزرگ، مقیاس کوچک
| مقیاس  = ۰٫۱ | سبک = ۲
| منبع   = داده‌های غیرواقعی برای این نمونه.
| ستون‌ها =   ۶ | ژوئیه| اوت| سپتامبر| اکتبر| نوامبر| دسامبر
| green|    سیب|   ۶۰۰| ۷۰۰|     ۹۰۰|   ۳۰۰|    ۵۰۰|    ۳۰۰
|yellow|    موز|   ۹۰۰| ۸۰۰|    ۱۱۰۰|   ۶۰۰|    ۷۰۰|    ۸۰۰
|orange| پرتقال|   ۵۰۰| ۴۰۰|     ۶۰۰|  ۱۱۰۰|    ۹۰۰|    ۶۰۰
}}

علاوه بر این، برای شناورسازی نمودار در سمت راست یا چپ، یکی از مقدارهای فارسی وسط، چپ یا راست (یا مقدارهای انگلیسی center، right یا left) را در پارامتر تراز (که با نام شناور نیز شناخته می‌شود) وارد کنید. For example:

{{میله‌های داده
| تراز   = چپ
| ستون‌ها =  ۶| ژانویه| فوریه| مارس| آوریل| مه| ژوئن
| blue|بلوبری|     ۶۵|    ۳۸|   ۷۲|    ۴۷|  ۲۰|  ۳۰
}}

جهت‌دهی، حاشیه‌ها، جزئیات و میانگین‌ها[ویرایش]

شانزده سبک برای انتخاب وجود دارد.

اعداد فرد برای سبک نمودار را عمودی می‌کنند.
اعداد زوج برای سبک نمودار را افقی می‌کنند.
سبک‌های ۳ و ۴ دارای حاشیه و سایه هستند.
سبک‌های ۵ تا ۸ درست همانند سبک‌های ۱ تا ۴ هستند، اما جزئیات بیشتری را نمایش می‌دهند.
سبک‌های ۹ تا ۱۶ درست همانند سبک‌های ۱ تا ۸ هستند، با این تفاوت که میانگین‌ها به‌جای این که به‌همراه مجموع نمایش داده شوند، به‌همراه شرح رنگ‌ها نمایش می‌یابند.

برای مثال، در نمونهٔ زیر از سبک = ۸ استفاده شده‌است:

افقی، به‌همراه حاشیه، سایه و جزئیات نمایان.
{{میله‌های داده
| سبک    = ۸
| مقیاس  = ۰٫۱
| عنوان  = مقدار میوه‌ها (کیلوگرم)
| منبع   = داده‌های غیرواقعی برای استفاده در نمونه.
| ستون‌ها =   ۶|۱۳۸۸|۱۳۹۰|۱۳۹۲|۱۳۹۴|۱۳۹۶|۱۳۹۸
| green|   سیب|    | ۷۰۰| ۹۰۰| ۳۰۰| ۵۰۰| ۳۰۰
|yellow|   موز| ۹۰۰|    |۱۱۰۰| ۶۰۰| ۷۰۰| ۸۰۰
|orange|پرتقال| ۵۰۰| ۴۰۰|    |۱۱۰۰| ۹۰۰| ۶۰۰
|   red|  گیلاس| ۷۰۰| ۳۰۰| ۶۰۰|    | ۹۰۰| ۶۰۰
|purple| انگور| ۳۰۰| ۵۰۰| ۶۰۰| ۹۰۰| ۷۰۰|    
}}
و در نمونهٔ زیر دقیقاً همان داده‌ها به‌همراه سبک = ۱۳ وارد شده است که به‌جای مجموع، میانگین‌ها را در سمت چپ نمایش می‌دهد:

شیوه[ویرایش]

این الگو به پنج «زیرالگو» وابسته است. با استفاده از ستون‌ها و ردیف‌های داده، یک جدول توسط این الگو تولید می‌شود.

{{میله‌های داده/میله}} کار رسم هریک از مستطیل‌های عمودی یا افقی که به‌صورت اختیاری رنگ‌آمیزی شده و با نام و/یا مقدار برچسب خورده‌اند را انجام می‌دهد.
{{میله‌های داده/ستون}} کار ساخت یک ستون داده را انجام می‌هد.

اگر سبک > ۸، داده‌ها برای نمایش میانگین‌ها به‌جای مجموع به‌همراه شرح رنگ به زیرالگوهای دیگر فرستاده می‌شوند.

{{میله‌های داده/میانگین‌ها}} میانگین‌های تمام ردیف‌های داده‌ها را محاسبه می‌کند.
{{میله‌های داده/میانگین‌ها/نمایش}} میانگین‌ها را برای نمایش در قالب یک میلهٔ مجتمع به پارامترهای نام‌گذاری‌شده اختصاص می‌دهد.
{{میله‌های داده/میانگین‌ها/ستون}} یک میلهٔ برچسب‌دار عمودی حاوی میانگین‌هایی که کار شرح رنگ را می‌کنند را رسم می‌کند.