توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]
این الگو برای رسم یک «میله» به‌همراه یک حاشیهٔ خاکستری ۱ پیکسلی به‌منظور استفاده در نمودار میله‌ای کاربرد دارد.

رنگ میله به‌طور پیش‌فرض خاسکتری روشن است و عرض و ارتفاع داخلی آن برابر با ۲۰ پیکسل است.

{{میله‌های داده/میله}}

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

{{میله‌های داده/میله|رنگ=powderblue}}
{{میله‌های داده/میله|رنگ=#B0E0E6}}

با ترکیب رنگ‌ها و برچسب‌ها (پایین را ببینید)، به‌سادگی می‌توانید یک فهرست شرح رنگ یا راهنمای رنگ تولید کنید. برای مثال،

{{میله‌های داده/میله|رنگ=red    |نام=کالیفرنیا }}
{{میله‌های داده/میله|رنگ=blue   |نام=فلوریدا   }}
{{میله‌های داده/میله|رنگ=yellow |نام=اورگن     }}
{{میله‌های داده/میله|رنگ=green  |نام=میزوری    }}
کالیفرنیا
فلوریدا
اورگن
میزوری

ارتفاع یا عرض

ویرایش

پارامتر نام‌گذاری‌شدهٔ ارتفاع برای تنظیم ارتفاع داخلی میله درون یک نمودار میله‌ای عمودی کاربرد دارد.

{{میله‌های داده/میله
| رنگ    = green
| ارتفاع = ۶۰
}}

پارامتر نام‌گذاری‌شدهٔ عرض برای تنظیم عرض میله درون یک نمودار میله‌ای افقی کاربرد دارد.

{{میله‌های داده/میله
| رنگ = yellow
| عرض = ۶۰
}}

ارتفاع و عرض را نمی‌توان همزمان با یکدیگر به‌کار برد. با این حال، اگر درون یک نمودار میله‌ای عمودی نیاز به میله‌هایی با عرض‌های متفاوت بود، یا این که درون یک نمودار میله‌ای افقی نیاز به میله‌هایی با ارتفاع‌های متفاوت بود، می‌توان از پارامتر نام‌گذاری‌شدهٔ اندازه استفاده کرد.

{{میله‌های داده/میله
| رنگ    = orange
| ارتفاع = ۸۰
| اندازه = ۴
}}
{{میله‌های داده/میله
| رنگ    = red
| عرض    = ۸۰
| اندازه = ۴
}}

یک‌کاسه کردن

ویرایش

با فهرست کردن میله‌ها به‌صورت متوالی می‌توان آن‌ها را در نمودارهای افقی یا عمودی «یک‌کاسه» کرد.

{{میله‌های داده/میله|ارتفاع=۵۰|رنگ=red}}
{{میله‌های داده/میله|ارتفاع=۳۰|رنگ=green}}
{{میله‌های داده/میله|ارتفاع=۴۰|رنگ=blue}}
{{میله‌های داده/میله|عرض=۵۰|رنگ=red}}
{{میله‌های داده/میله|عرض=۳۰|رنگ=green}}
{{میله‌های داده/میله|عرض=۴۰|رنگ=blue}}

برچسب‌ها

ویرایش

با استفاده از پارامترهای برچسب و/یا مقدار و/یا نام می‌توان به میله‌ها برچسب افزود.

برچسب

ویرایش

پارامتر برچسب در پایین میله نمایش داده می‌شود.

{{میله‌های داده/میله
| برچسب  = پرتقال‌ها
| ارتفاع = ۸۰
}}
پرتقال‌ها
{{میله‌های داده/میله
| برچسب = سیب‌ها
| عرض   = ۸۰
}}
سیب‌ها

مقدار

ویرایش

پارامتر مقدار برچسبی با اندازهٔ قلم کوچک‌تر است و می‌توان از آن برای نمایش عدد ارائه‌شده توسط میله استفاده کرد.

این پارامتر که در واقع همان مقدار میله در نمودارهای عمودی در بالای میله، و در نمودارهای افقی در سمت چپ میله نمایش می‌یابد.

{{میله‌های داده/میله
| ارتفاع = ۸۰
| برچسب  = پرتقال‌ها
| مقدار  = ۸۰٬۰۰۰
}}
۸۰٬۰۰۰
پرتقال‌ها
{{میله‌های داده/میله
| عرض    = ۸۰
| برچسب  = سیب‌ها
| مقدار  = ۸۰٬۰۰۰
}}
۸۰٬۰۰۰
سیب‌ها

پارامتر مقدار لزوماً نباید حاوی عدد باشد.

با این حال، به‌منظور حفظ سادگی (فقط) در نمودارهای میله‌ای عمودی، در صورت استفاده از عدد در پارامتر مقدار می‌توان دیگر از ارتفاع استفاده نکرد.

{|
|- style="vertical-align:bottom;"
| {{میله‌های داده/میله | مقدار = ۸۰}}
| {{میله‌های داده/میله | مقدار = ۲۳}}
| {{میله‌های داده/میله | مقدار = ۴۲}}
| {{میله‌های داده/میله | مقدار = ۱۳}}
| {{میله‌های داده/میله | مقدار = ۶۶}}
|}
۸۰
۲۳
۴۲
۱۳
۶۶


نام اخرین نوع برچسبی است که در دسترس است. درست همانند مقدار، این پارامتر نیز دارای اندازهٔ قلم کوچک‌تر است و می‌توان از آن برای نمایش عدد ارائه‌شده توسط میله استفاده کرد.

تنها تفاوت آن با مقدار در محل قرارگیری آن است. نام اگر وارد شده باشد، در نمودارهای عمودی در سمت چپ میله، و در نمودارهای افقی در بالای میله نمایش داده می‌شود.

{{میله‌های داده/میله
| ارتفاع = ۸۰
| نام    = ۸۰٬۰۰۰
}}
۸۰٬۰۰۰
{{میله‌های داده/میله
| عرض = ۸۰
| نام = ۸۰٬۰۰۰
}}
۸۰٬۰۰۰
استفاده از نام به‌جای برچسب در زمان یک‌کاسه کردن میله‌ها می‌تواند مفید باشد.
'''سیب‌ها'''
{{میله‌های داده/میله
| ارتفاع = ۵۰
| رنگ    = red
| نام    = فلوریدا
}}
{{میله‌های داده/میله
| ارتفاع = ۸۰
| رنگ    = green
| نام    = کالیفرنیا
}}
{{میله‌های داده/میله
| ارتفاع = ۴۰
| رنگ    = blue
| نام    = اورگن
}}

سیب‌ها

فلوریدا
کالیفرنیا
اورگن
اما معمولاً استفاده از یک شرح رنگ یک‌کاسه‌شده بهتر است. (دقت کنید که در گروه اصلی تنها به میلهٔ پایینی یک برچسب داده شده است.)
{|
|- style="vertical-align:top;"
|<!-----------------------
--    گروهی از میله‌ها   --
------------------------->
{{میله‌های داده/میله|ارتفاع=۵۰|رنگ=red   }}
{{میله‌های داده/میله|ارتفاع=۸۰|رنگ=green }}
{{میله‌های داده/میله|ارتفاع=۴۰|رنگ=blue|برچسب='''سیب‌ها'''}}
|<!----------------------
--       شرح رنگ       --
------------------------>
{{میله‌های داده/میله|رنگ=red   |نام=فلوریدا  }}
{{میله‌های داده/میله|رنگ=green |نام=کالیفرنیا}}
{{میله‌های داده/میله|رنگ=blue  |نام=اورگن    }}
|}
سیب‌ها
فلوریدا
کالیفرنیا
اورگن

عنوان‌ها

ویرایش

به‌طور پیش‌فرض، هنگامی که نشانگر موس روی میله قرار گیرد، نام انگلیسی رنگ میله در قالب متن نمایش خواهد یافت. این قابلیت برای افراد دارای کوررنگی مفید است.

با این حال، می‌توان با تعیین یک «عنوان» برای میله، اطلاعات به‌مراتب مفیدتری را به مخاطب ارائه داد.

{{میله‌های داده/میله| عرض = ۵۰ | رنگ = red   | نام = فلوریدا   | عنوان = ۵۰}}
{{میله‌های داده/میله| عرض = ۸۰ | رنگ = green | نام = کالیفرنیا | عنوان = ۸۰}}
{{میله‌های داده/میله| عرض = ۴۰ | رنگ = blue  | نام= اورگن      | عنوان = ۴۰}}
فلوریدا
کالیفرنیا
اورگن

این قابلیت به‌ویژه در ساخت شرح رنگ، مثلاً برای نمایش مجموع، می‌تواند مفید باشد.

{{میله‌های داده/میله|رنگ = red   |نام = فلوریدا   | عنوان = ۵٬۰۰۰}}
{{میله‌های داده/میله|رنگ = green |نام = کالیفرنیا | عنوان = ۸٬۰۰۰}}
{{میله‌های داده/میله|رنگ = blue  |نام = اورگن     | عنوان = ۴٬۰۰۰}}
فلوریدا
کالیفرنیا
اورگن

به‌طور جایگزین، با وارد کردن پارامتر نام‌گذاری‌شدهٔ جزئیات می‌توان عنوان را درون پرانتز به انتهای نام چسباند.

اگر در حال ساخت یک الگو مانند میله‌های داده هستید، این قابلیت، به‌واسطهٔ فراهم‌سازی امکان استفاده از پارامتر عنوان برای نمایش اطلاعات جزئی بیشتر دربارهٔ میله در صفحه همزمان با دست نزدن به پیش‌فرض، می‌تواند منجر به انعطاف‌پذیری بیشتر شود.

{{میله‌های داده/میله|رنگ = red   |نام = فلوریدا   | عنوان = ۷٬۰۰۰| جزئیات = بله}}
{{میله‌های داده/میله|رنگ = green |نام = کالیفرنیا | عنوان = ۸٬۰۰۰| جزئیات = بله}}
{{میله‌های داده/میله|رنگ = blue  |نام = اورگن     | عنوان = ۶٬۰۰۰| جزئیات = بله}}
فلوریدا (۷٬۰۰۰)
کالیفرنیا (۸٬۰۰۰)
اورگن (۶٬۰۰۰)