Election box begin/sandbox

{{{title}}}
Party		Candidate	Votes	%	±%

File:Test Template Info-Icon.svg Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:Election box begin/doc.

File:Lua-Logo.svg

This template uses Lua:

Module:Political party

These election box templates are for displaying a list of candidates and results for any election. They produce tables like this (figures are just examples; they are not meant to work mathematically):

2005 general election: Strangford
Party		Candidate	Votes	%	±%
	Conservative	John Smith	101,549	63.8	+6.2
	Labour	Jane Johnson	52,201	31.6	−8.2
Majority			153,700	72.4	+5.4
Turnout			9,999	50.0	+10.0
Registered electors			319,998		+3.6

Usage and parameter list for Election box begin [edit]

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Election box begin in articles based on its TemplateData.

TemplateData for Election box begin

A template to start the box for showing election results; part of the 'Election box' series

Parameter		Description	Type	Status
Election title	`title`	The title of the election to display as a heading above the rest of the box.	String	required
Candidate title	`candidatetitle`	The type of candidate(s) elected depending on the electoral system; it can be e.g. the top candidate on a party list.	String	optional
Float	`float`	Alignment for floating the table; use left, right, center, or none (default)	String	optional

Usage

Basic

There are three basic templates:

The begin and end templates start and end a table with appropriate columns and formatting. The candidate template is used once for each candidate and contributes a row to the table.

When using this template please use the election box end template rather than simply inserting |} at the end of the election box.

For example:

 {{Election box begin |title=[[2005 United Kingdom general election|2005 general election]]: Strangford}}
 {{Election box candidate
   |party      = Labour
   |candidate  = Tony Blair
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box candidate
   |party      = Conservative
   |candidate  = Michael Howard
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box end}}

Will create this:

2005 general election: Strangford
Party		Candidate	Votes	%	±%
	Labour	Tony Blair	9,999	50.0	+10.0
	Conservative	Michael Howard	9,999	50.0	+10.0

Party links

See Template:Election box candidate with party link for usage and set-up.

Majority and turnout

Three further templates:

can be added to record the majority, turnout and number of registered electors for an election. (In this context, "majority" refers to the winning margin between the first and second placed candidates.)

For example:

 ...
 {{Election box majority
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box turnout
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box registered electors|
   |reg. electors = 19,998
   |ref           =
   |change        = +2.3
 }}
 {{Election box end}}

Will create this:

2005 general election: Strangford
Party		Candidate	Votes	%	±%
	Labour	Tony Blair	9,999	50.0	+10.0
	Conservative	Michael Howard	9,999	50.0	+10.0
Majority			9,999	50.0	+10.0
Turnout			9,999	50.0	+10.0
Registered electors			19,998		+2.3

Election outcome

Finally there are two templates:

that can be used to summarize the outcome of an election, in terms of whether the incumbent holds the seat or whether it is lost to another party.

For example:

 ...
 {{Election box hold with party link
   |winner     = Labour Party (UK)
   |swing      = +10.0
 }}

 or...

 {{Election box gain with party link
   |winner     = Conservative Party (UK)
   |loser      = Labour Party (UK)
   |swing      = +10.0
 }}
 {{Election box end}}

Will create this:

2005 general election: Strangford
Party		Candidate	Votes	%	±%
	Labour	Tony Blair	9,999	50.0	+10.0
	Conservative	Michael Howard	9,999	50.0	+10.0
Majority			9,999	50.0	+10.0
Turnout			9,999	50.0	+10.0
Registered electors			19,998		+9.9
	Labour hold		Swing	+10.0

or this...

2005 general election: Strangford
Party		Candidate	Votes	%	±%
	Labour	Tony Blair	9,999	50.0	+10.0
	Conservative	Michael Howard	9,999	50.0	+10.0
Majority			9,999	50.0	+10.0
Turnout			9,999	50.0	+10.0
Registered electors			19,998		+9.9
	Conservative gain from Labour		Swing	+10.0

Notes:

The swing parameter represents Peter Snow's Swingometer measure, i.e. the percentage change (or swing) in the vote since the last election.
When preparing the tables in advance of an election, it may be convenient to include these two templates but commented out (using  ) until the outcome is known.
Potentially there is a need for versions of these templates that do not have the party link mechanism. However, it can be argued that any party that has a successful candidate deserves an article about them and the full /meta/color treatment. The one obvious exception to this is, of course, independent candidates, who won't actually have a party. If / when there's a need, just create a non party link version of these templates.
When |change= represents a decrease, use a minus sign (−), not a hyphen (-).

List of templates