Ainin: 1 revision imported from :wikipedia:en:Template:Pie_chart/doc

2022-08-14T12:05:14Z

1 revision imported from wikipedia:en:Template:Pie_chart/doc

← Older revision	Revision as of 14:05, 14 August 2022
(No difference)

wikipedia:en>Dcljr: /* Limitations */ just 100

2022-03-12T22:47:41Z

Limitations: just 100

New page

{{Documentation subpage}}

__NOTOC__
This is a template that draws [[pie chart]]s using a single image, a lot of (inline) CSS code generated by parser functions, and ''absolutely no JavaScript''. Some details of how it works are given [[#How it works|below]].

=== Usage ===
The labels, values, and colors 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>
{{Pie chart
| thumb =
| radius =
| caption=
| footer =
| label1 =
| value1 =
| color1 =
| label2 =
| value2 =
| color2 =
| label3 =
| value3 =
| color3 =
| label4 =
| value4 =
| color4 =
| label5 =
| value5 =
| color5 =
| label6 =
| value6 =
| color6 =
| other =
| other-color =
}}
</nowiki></pre>

===Parameters===
{{Pie chart
| radius = 100
| caption = Default colors
| label1 = {{gcolor|1}} | value1 = 7
| label2 = {{gcolor|2}} | value2 = 7
| label3 = {{gcolor|3}} | value3 = 7
| label4 = {{gcolor|4}} | value4 = 7
| label5 = {{gcolor|5}} | value5 = 7
| label6 = {{gcolor|6}} | value6 = 7
| label7 = {{gcolor|7}} | value7 = 7
| label8 = {{gcolor|8}} | value8 = 7
| label9 = {{gcolor|9}} | value9 = 7
| label10 = {{gcolor|10}} | value10 = 7
| label11 = {{gcolor|11}} | value11 = 7
| label12 = {{gcolor|12}} | value12 = 7
| label13 = {{gcolor|13}} | value13 = 7
| label14 = {{gcolor|14}} | value14 = 7
| other = y
}}
* {{para|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 {{para|thumb|left}}.
* {{para|radius}} specifies the radius of the pie chart in pixels. Do not include a "px" suffix. If omitted, it will default to 100.
* {{para|caption}} specifies a string of text that appears on a line just before the legend.
* {{para|footer}} specifies a string of text that appears ''below'' the legend.
* {{para|other}}, if set equal to any visible string (even "0" or "no"), an "Other" item will appear in the legend, corresponding to the final slice that makes the values add up to 100. (If the total is already over 100, then the "Other" percentage will be negative.)
* {{para|other-color}} can be used to override the default white color of the "Other" slice.
* Each {{para|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 {{para|value''N''}} is the percentage that the slice represents. Do ''not'' include the percent sign (e.g., for eighty percent, use the value "80", not "80%" or ".80"). Collectively, the values must add to 100 or less (in the latter case, a final slice completes the pie, whether {{para|other}} is specified or not). Also note that each value is shown in the legend exactly as written, without any rounding or other reformatting.
* Each {{para|color''N''}} is a [[Web colors|CSS color code or name]]. If omitted, the default color palette seen in the pie chart to the right is used. If you need to graph more than 14 values (not counting the "Other" slice), then you should specify {{para|color15}} onwards in the template call.

=== Limitations ===
* Google Chrome and Safari do not appear to [[Spatial anti-aliasing|anti-alias]] borders, so the lines are a bit jagged. (For Chrome, this issue seems to be resolved, as of version 26.)
* Due to how the graphing is implemented, it is not possible to save a copy of the chart using the browser's "Save Image" function (however, a [[screenshot]] can be taken).
* If {{para|other}} is set, the final slice is always labeled as "Other" in the legend. This is not configurable. If you don't like that, just add to the template call another slice with the appropriate value (to sum to 100) and the desired label, and don't use {{para|other}}.
* No labels can be put on the slices themselves.
* The maximum number of slices that can be displayed is '''30'''.
* Currently the default colors used for slices 15 onwards are all the same as the default color of slice 14.
* If the specified values add to 100 and {{para|other}} is set, the calculated percentage for that slice can sometimes turn out to be very strange (e.g., "1.4210854715202E-14%" instead of "0%")

{{-}}

=== Examples ===
The following code generates the pie chart shown at right. Note that the default chart size and colors are used, and the value of "1" for the "other" parameter is only used for its "truth value" as a visible string—i.e., to say, yes, we want an "Other" entry in the legend (the same chart would result if "0" were used).
{{Pie chart
|value1 = 42
|label1 = One
|value2 = 32
|label2 = Two
|value3 = 12
|label3 = Three
|value4 = 3
|label4 = Four
|value5 = 2
|label5 = Five
|value6 = 1
|label6 = Six
|other = 1
}}
<pre style="overflow:auto">
{{Pie chart
|value1 = 42
|label1 = One
|value2 = 32
|label2 = Two
|value3 = 12
|label3 = Three
|value4 = 3
|label4 = Four
|value5 = 2
|label5 = Five
|value6 = 1
|label6 = Six
|other = 1
}}
</pre>

Here's a more real-world example.
{{Pie chart
| caption= [[Religion in the Czech Republic]] in 2001.
| label1 = [[Atheist]]s and [[agnostic]]s
| value1 = 59
| color1 = darkgreen
| label2 = [[Catholic]]s
| value2 = 26.8
| color2 = brown
| label3 = [[Protestant]]s
| value3 = 2.5
| color3 = #08f
| other = yes
| other-color = silver
}}
<pre style="overflow:auto">
{{Pie chart
| caption= [[Religion in the Czech Republic]] in 2001.
| label1 = [[Atheist]]s and [[agnostic]]s
| value1 = 59
| color1 = darkgreen
| label2 = [[Catholic]]s
| value2 = 26.8
| color2 = brown
| label3 = [[Protestant]]s
| value3 = 2.5
| color3 = #08f
| other = yes
| other-color = silver
}}
</pre>

=== How it works ===
This template 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 [[miter join]]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:
* Inside a square element of (2 * radius)x(2 * radius) pixels
* with <code>border-radius: radiuspx</code> for a circular shape
* with a white (or other specified color) background visible in the empty space that occurs if the "other" slice is present
* and 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 {{tlx|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.
{{-}}

=== See also ===
* {{tl|Brick chart}}
* {{tl|Composition bar}}
* [[Module:Chart]]

{{collapse top|Formatted/colorized template source for Template:Pie chart}}
{{#invoke:FormatTemplate|format}}
{{collapse bottom}}
{{collapse top|Formatted/colorized template source for Template:Pie chart/slice}}
{{#invoke:FormatTemplate|format|page=Template:Pie chart/slice}}
{{collapse bottom}}
{{collapse top|Formatted/colorized template source for Template:Legend}}
{{#invoke:FormatTemplate|format|page=Template:Legend}}
{{collapse bottom}}
{{collapse top|Formatted/colorized template source for Template:Trim}}
{{#invoke:FormatTemplate|format|page=Template:Trim}}
{{collapse bottom}}
{{Template:Graph, chart and plot templates}}
<includeonly>{{Sandbox other|
| 
[[Category:Chart, diagram and graph formatting and function templates]]
[[Category:Graph, chart and plot templates]]
}}</includeonly>

Template:Pie chart/doc - Revision history

Ainin: 1 revision imported from :wikipedia:en:Template:Pie_chart/doc

wikipedia:en>Dcljr: /* Limitations */ just 100