این الگو برای رسم یک «میله» بههمراه یک حاشیهٔ خاکستری ۱ پیکسلی بهمنظور استفاده در نمودار میلهای کاربرد دارد.
رنگ میله بهطور پیشفرض خاسکتری روشن است و عرض و ارتفاع داخلی آن برابر با ۲۰ پیکسل است.
برای تعیین رنگ میله باید از پارامتر نامگذاریشدهٔ رنگ استفاده شود.
{{میلههای داده/میله|رنگ=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 |نام = اورگن | عنوان = ۶٬۰۰۰| جزئیات = بله}}
|
|