نمایش مبدأ برای الگو:نمودار گرد/توضیحات

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{آغاز چپ‌چین}}
__NOTOC__
{{زیرصفحه توضیحات}}
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE -->
__NOTOC__

=== کاربرد ===
The labels and values of up to 30 slices may be specified. All the parameters for six slices are included below; to include more slices, copy the code for one of the others, changing the digit at the end of each parameter name.
<pre><nowiki>
{{نمودار گرد
| thumb = 
| caption = 
| other = 
| label1 =remember 
| value1 =16.6
| color1 =2
| label2 =understand
| value2 =16.6
| color2 =3 
| label3 =apply
| value3 =16.6 
| color3 =5 
| label4 =analyze
| value4 =16.6
| color4 =6
| label5 =evaluate
| value5 =16.6
| color5 =9
| label6 =design
| value6 =16.6
| color6 =10
}}
</nowiki></pre>

* The parameter {{پارا|thumb}} specifies which side of the page the chart is floated to and defaults to <code>right</code>, as with image files. To make the chart appear on the ''left'' side of the page, specify {{پارا|thumb|left}}.
* The parameter {{پارا|caption}} specifies a string of text that appears on a line just before the legend.
* The parameter {{پارا|other}}, if specified, will cause an "Other" item to appear in the legend.
* Each {{پارا|label''N''}} is a string of text that appears in the legend entry for a slice. Omitting it will cause a legend entry to not be shown for that slice.
* Each {{پارا|value''N''}} is the percentage that the slice represents. Do ''not'' include the percent sign. Also note that it is shown in the legend as written (just after the label), without any rounding or other reformatting.
* Each {{پارا|color''N''}} is a [[رنگ‌های وب]]. If omitted, it will default to the following hues:
{{فهرست چندستونی|colwidth=10em|
# {{زیرنویس نقشه|red|red}}
# {{زیرنویس نقشه|green|green}}
# {{زیرنویس نقشه|blue|blue}}
# {{زیرنویس نقشه|yellow|yellow}}
# {{زیرنویس نقشه|fuchsia|fuchsia}}
# {{زیرنویس نقشه|aqua|aqua}}
# {{زیرنویس نقشه|brown|brown}}
# {{زیرنویس نقشه|orange|orange}}
# {{زیرنویس نقشه|purple|purple}}
# {{زیرنویس نقشه|sienna|sienna}}
}}

=== Limitations ===
* Minor issues with printing exist. We also need to implement a good fallback for use with the [[امامت‌پدیا:کتاب‌ها]].
* The values need to be percentages.
* Google Chrome and Safari do not appear to [[ضد پلگی]] borders, so the lines are a bit jagged. (For Chrome, this issue seems to be resolved; tested with version 26.)
* No labels can be put on the slices themselves.
* Inherently, it is not possible to save a copy of the chart using the browser's "Save Image" function.
* Max. number of slices that can be displayed: '''30'''

=== How it works ===
{{نمودار گرد
|other = yes
|value1 = 42
|label1 = One
|value2 = 32
|label2 = Two
|value3 = 12
|label3 = Three
|value4 = 3
|label4 = Four
|value5 = 2
|label5 = Five
|value6 = 1
|label6 = Six
}}

This is an ''experimental'' template that draws pie charts using a single image, a lot of (inline) CSS code generated by parser functions, and ''absolutely no JavaScript''. It uses a technique for [http://erezsh.wordpress.com/2008/07/31/drawing-diagonal-lines-with-css/ drawing diagonal lines in CSS] exploiting the fact that borders set on elements are [[اتصال فارسی]]ed. Thus, it is possible to set one border to an opaque color, with the others fully transparent, to form a diagonal line. The angle of the line can be controlled by adjusting the widths of two adjacent borders (one of them opaque) relative to each other.

Pie slices are drawn in clockwise order in a counterclockwise direction. These pie slices are positioned:
* Below a [[:File:Circle frame.svg|200×200px image]] having a transparent circle on a light-colored background (same as the background color used for CSS class <code>thumbinner</code>)
* Inside a container element with <code>overflow: hidden;</code> set
This allows only the part of each slice that is inside the circle to be visible on the page.

Most of the code in {{الگوب|Pie chart/slice}} is divided into five sections, the first four corresponding to quadrants of the circle and the last to cleanly cover the case in which one slice occupies 100% of the chart.
{{پاک‌کن}}

=== Example ===
{{نمودار گرد
| caption=[[Religion in the Czech Republic]] as of 2001.
| other = yes
| label1 = [[خداناباوری]]s and [[ندانم‌گرایی]]
| value1 = 59
| color1 = silver
| label2 = [[کلیسای کاتولیک]]
| value2 = 26.8
| color2 = #008
| label3 = [[پروتستانتیسم]]
| value3 = 2.5
| color3 = #08f
}}
The following example of [[الگو:نمودار گرد]] generates the pie chart shown at right. 
<pre style="overflow:auto">
 {{نمودار گرد
 | caption=[[Religion in the Czech Republic]] as of 2001.
 | other = yes
 | label1 = [[خداناباوری]]s and [[ندانم‌گرایی]]
 | value1 = 59 | color1 = silver
 | label2 = [[کلیسای کاتولیک]]
 | value2 = 26.8 | color2 = #008
 | label3 = [[پروتستانتیسم]]
 | value3 = 2.5 | color3 = #08f
 }}
</pre>

=== See also ===
* {{پیوند الگو|Brick chart}}
* {{پیوند الگو|Composition bar}}
* [[پودمان:Chart]]
* [[پودمان:Plotter]]

{{بالای تاشو|Formatted/colorized template source for Template:Pie chart}}
{{#invoke:FormatTemplate|format}}
{{پایین تاشو}}
{{بالای تاشو|Formatted/colorized template source for Template:Pie chart/slice}}
{{#invoke:FormatTemplate|format|page=Template:Pie chart/slice}}
{{پایین تاشو}}
{{بالای تاشو|Formatted/colorized template source for Template:Legend}}
{{#invoke:FormatTemplate|format|page=Template:Legend}}
{{پایین تاشو}}
{{بالای تاشو|Formatted/colorized template source for Template:Trim}}
{{#invoke:FormatTemplate|format|page=Template:Trim}}
{{پایین تاشو}}
{{Template:Graph, chart and plot templates}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[رده:الگو:کارکردهای نمودار، نقشه، و قالب‌بندی گرافیکی]]
[[رده:الگو:طرح خطی، چارت سازمانی و طرح]]
}}</includeonly>