Template:Sort/doc

2017-05-25T21:58:57Z

203.111.197.204: sort method deprecated

{{documentation subpage}}
{{Ombox|type=content|text=This template is '''deprecated'''. Table sort keys should now be defined using the <code>data-sort-value</code> attribute, like so: <code><nowiki>| data-sort-value="Doe, John" | John Doe</nowiki></code>. Please see {{Section link|WP:SORT|Specifying a sort key for a cell}} for details.}}

This template is for manually adjusting sorting order in sortable tables by specified sortkeys.

;Usage:
* <code><nowiki>{{</nowiki>sort | 1 = {{{sort value}}} | 2 = {{{displayed value}}} }}</code> → {{sort | 1 = {{{sort value}}} | 2 = {{{displayed value}}} }}
The first parameter is the sortkey; the second parameter is the wikitext of what has to be displayed. By default, this is the sortkey with link brackets:
* <code><nowiki>{{</nowiki>sort | 1 = {{{displayed value}}} }}</code> → {{sort | 1 = {{{displayed value}}} }}
A table using this template should use it in all rows.

This template works by placing a hidden sortkey before the visible text. The hiding of the sortkey is achieved through [[Help:Cascading style sheets#Non-display|CSS]]: <nowiki><span style="display:none" class="sortkey">hidden text</span></nowiki>. The CSS class allows custom sort scripts to parse and get the sort key, and remove it from the DOM if needed (for some accessibility tools).

=====Example=====
<pre>
|{{sort|Brothers Karamazov|[[The Brothers Karamazov]]}}
</pre>

;Sorting by numerical value, date, etc.
See [[Help:Sorting#Numerical sorting problems]] and [[meta:Help:Sorting#Sort modes]]

;Equal rank
If you simply code as the second parameter an indicator that two items are equally ranked, e.g. "4=", the template interpreter will treat this as an additional parameter (i.e. parameter 4, which it will then not use). You must explicitly code this as parameter 2:

<pre>{{sort|4|2=4=}}</pre>

==See also==
* {{tiw|Sortname}}—for using names in sortable tables (using "last name, first name" as default sort key)
* {{tiw|dts}}—for using dates in sortable tables
* {{tiw|nts}}—for using alphabetic sort mode for numbers in sortable tables
* {{tiw|hs}}—for providing a hidden sort value for cells in a table
* [[Help:Sorting]]
* [[meta:Help:Sorting]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
[[Category:Sorting templates|{{PAGENAME}}]]
}}</includeonly>

Brunswick MD History - User contributions [en]

Template:Sort/doc