Ayzek: 1 revision imported

2018-10-30T01:55:17Z

1 revision imported

203.111.197.204: /* See also */

2017-06-16T00:13:30Z

‎See also

New page

{{align|right|{{edit|Template:Sortable medal image documentation|[edit]}}}}
This template is for including medal symbols in sporting event result tables, while preserving the ability for sort.

==Template series==
The first group of templates show medal images while giving a table sort of 01, 02 or 03, respectively.
*{{tlx|Gold1}} = {{gold1}}
*{{tlx|Silver2}} = {{silver2}}
*{{tlx|Bronze3}} = {{bronze3}}

The second group of templates are show medal images with display text of either Gold, Silver, Bronze. These also give a table sort of 01, 02 or 03, respectively.
*{{tlx|Gold medal}} = {{gold medal}}
*{{tlx|Silver medal}} = {{silver medal}}
*{{tlx|Bronze medal}} = {{bronze medal}}

== Usage ==

Simply insert the template where you would like to see the symbol. No parameters are required.

=== Parameters ===

The link parameter can be used to pass a link to an article to these templates.

Example:
* <code><nowiki>{{</nowiki>gold1|link=''article name''}}</code>

It defaults to null.

=== Sorting ===

These templates use 01, 02 and 03 as the gold, silver, and bronze sort value, respectively. Sorting will operate numerically unless the column also contains any non-numeric text, in which case a text sort may sometimes occur (e.g. "10" is before "3").

To get the desired sort results for other values it may be necessary to use the <code>data-sort-type="..."</code> and <code>data-sort-value="..."</code> attributes. Placing a <code>data-sort-type="number"</code> attribute in the header cell will force a numeric sort. Adding a <code>data-sort-value="..."</code> attribute to a data cell will override the value.

A commonly used but ''now-deprecated'' technique is to use the {{tlx|hs}} or {{tlx|sort}} templates to specify appropriate sort keys to be inserted as hidden text in front of the displayed values. For example, <code><nowiki>{{hs|99}}DQ</nowiki></code> and <code><nowiki>{{sort|99|DQ}}</nowiki></code> both display "DQ" but sort using "99 DQ". A text sort still occurs, but the desired results can be achieved using carefully selected hidden values. Sometimes leading zeros or other tricks may be needed.

See [[Help:Sorting#Configuring the sorting]] for additional details.

== Examples ==

=== Simple case ===

When all ranks are single digit numbers, the templates can be used directly in place of the ranks.

{{col-float|firstcol=50em}}

The following markup:

<pre style="overflow:auto; margin-right: 1em;">
{| class="wikitable sortable" style="text-align:center"
! Rank !! Place
|-
| {{Gold1}} || First
|-
| {{Silver2}} || Second
|-
| {{Bronze3}} || Third
|-
| 4 || Fourth
|-
| 5 || Fifth
|-
| 6 || Sixth
|-
| 7 || Seventh
|-
| 8 || Eighth
|}
</pre>

{{col-float-break}}

...will display as:

{| class="wikitable sortable" style="text-align:center"
! Rank !! Place
|-
| {{Gold1}} || First
|-
| {{Silver2}} || Second
|-
| {{Bronze3}} || Third
|-
| 4 || Fourth
|-
| 5 || Fifth
|-
| 6 || Sixth
|-
| 7 || Seventh
|-
| 8 || Eighth
|}
{{col-float-end}}

=== Handling two-digit rankings, blank, or special values ===

When the rankings contain two-digit rankings, blank, or special values, additional markup may be needed to trigger numeric sorting and/or to explicitly set equivalent sort values. The preferred method is to use the <code>data-sort-type="..."</code> and <code>data-sort-value="..."</code> attributes. Placing a <code>data-sort-type="number"</code> attribute in the header cell will force a numeric sort order. Adding a <code>data-sort-value="..."</code> attribute to a data cell will override the value.

{{col-float|firstcol=50em}}
The following markup:

<pre style="overflow:auto; margin-right: 1em;">
{| class="wikitable sortable" style="text-align:center"
! data-sort-type="number" | Rank !! Place !! Bad Sort !! Older Sort Style
|-
| {{Gold1}} || First || 1 || {{Gold1}}
|-
| {{Silver2}} || Second || 2 || {{Silver2}}
|-
| {{Bronze3}} || Third || 3 || {{Bronze3}}
|-
| 4* || Fourth || 4* || {{Sort|04|4*}}
|-
| 5 || Fifth || 5 || {{Sort|05|5}}
|-
| 10 || Tenth || 10 || 10
|-
| 11 || Eleventh || 11 || 11
|-
| 20 || Twentieth || 20 || 20
|-
| 50 || Fiftieth || 50 || 50
|-
| data-sort-value="96"|NM || No mark || NM || {{Sort|96|NM}}
|-
| data-sort-value="97"|DQ || Disqualified || DQ || {{Sort|97|DQ}}
|-
| data-sort-value="98"|– || Dash || – || {{Hs|98}}–
|-
| data-sort-value="99"| || Empty || || {{Hs|99}}
|}
</pre>

{{col-float-break}}

...will display as:

{| class="wikitable sortable" style="text-align:center"
! data-sort-type="number" | Rank !! Place !! Bad Sort !! Older Sort Style
|-
| {{Gold1}} || First || 1 || {{Gold1}}
|-
| {{Silver2}} || Second || 2 || {{Silver2}}
|-
| {{Bronze3}} || Third || 3 || {{Bronze3}}
|-
| 4* || Fourth || 4* || {{Sort|04|4*}}
|-
| 5 || Fifth || 5 || {{Sort|05|5}}
|-
| 10 || Tenth || 10 || 10
|-
| 11 || Eleventh || 11 || 11
|-
| 20 || Twentieth || 20 || 20
|-
| 50 || Fiftieth || 50 || 50
|-
| data-sort-value="96"|NM || No mark || NM || {{Sort|96|NM}}
|-
| data-sort-value="97"|DQ || Disqualified || DQ || {{Sort|97|DQ}}
|-
| data-sort-value="98"|– || Dash || – || {{Hs|98}}–
|-
| data-sort-value="99"| || Empty || || {{Hs|99}}
|}
{{col-float-end}}

As demonstrated in the rightmost column, the {{tlx|sort}} and {{tlx|hs}} templates can also be used to resolve sorting problems, but this methodology is deprecated.

==Deprecated templates==
The below templates have had their functionality merged into the main templates, as bad sorting is never a useful feature.
*{{tiw|Goca}}
*{{tiw|Sica}}
*{{tiw|Brca}}
*{{tiw|Gold01}}
*{{tiw|Silver02}}
*{{tiw|Bronze03}}

==See also==
*{{tiw|Sort}} — for using names in sortable tables
*{{tiw|Won}} — for using an alternative way to specify awards
*{{tiw|Olympic Gold medal}} — for an alternative Olympic Gold metal icon
*{{tiw|Olympic Silver medal}} — for an alternative Olympic Silver metal icon
*{{tiw|Olympic Bronze medal}} — for an alternative Olympic Bronze metal icon
*[[m:Help:Sorting]]

<noinclude>
[[Category:Template documentation pages]]
</noinclude>

← Older revision	Revision as of 01:55, 30 October 2018
(No difference)

Template:Sortable medal image documentation - Revision history

Ayzek: 1 revision imported

203.111.197.204: /* See also */