View source for Template:Vertical header/doc

{{documentation subpage}}
{{tsh|Verth|Vert header}}
{{lua|Module:Vertical header}}
{|{{table|sort|class=floatright}}
! {{vert header|stp=1|Regular column}}
! {{vert header|stp=1|Vertical value column}}
! {{vert header|stp=1|nb=1|cellstyle=background-color:gold|Thin gold column}}
! {{vert header|nb=1|Unsortable column}}
|-
| 0 || {{vert header|va=middle|1}} || 1 || 2
|-
| 3 || {{vert header|va=middle|5}} || 8 || 13
|-
! {{vert header|va=top|Regular column}}
! {{vert header|va=top|Vertical value column}}
! {{vert header|nb=1|va=top|cellstyle=background-color:gold|Thin gold column}}
! {{vert header|nb=1|va=top|Unsortable column}}
|}
This is a template that helps create vertically oriented column headers in tables. It even works for [[Help:Sorting|sortable]] columns.

Although this template was made with table headers in mind, it can work with regular cells as well.

If the header cells have other attributes, for example, [[Help:Table#Combined use of COLSPAN and ROWSPAN|<code>colspan</code> or <code>rowspan</code>]], there must be no vertical bar <code>|</code> between the attributes and the template call.

== Parameter list ==
* {{code|1}} – The desired text; can contain wikilinks ({{code|[[]]}}). You can escape the equals sign either by using {{tlx|1==}} or by explicitly mentioning the {{code|1{{=}}}} parameter.
* {{code|nb}} – Give any non-empty value in order to apply a {{tlx|nobold}} template to the text.
* {{code|va}} – Vertical alignment ({{code|bottom}}, {{code|top}}, {{code|middle}}). Default is {{code|bottom}}.
* {{code|stp}} – Give any non-empty value in order to apply a top padding to the cell (useful if the header is bottom-aligned; '''required for sortable columns''').
* {{code|mw}} – Manual width; override the default value, which was automatically generated based on the number of line breaks (you can use {{code|<br>}}, {{code|<BR />}} or any other combination).
* {{code|style}} – Additional styles for the {{code|<div/>}} containing the rotated text. May contain double quotes.
* {{code|cellstyle}} – Additional styles for the entire cell. May contain double quotes. '''Use this instead of the cell's {{code|style}} attribute.''' Use {{code|background-color}} instead of {{code|background}} if you need it for the header of a sortable column.

== Examples ==
* {{code|<nowiki>! {{vert header|Your text here}}</nowiki>}} – basic example
* {{code|<nowiki>! {{vert header|nb=1|stp=1|Your text here}}</nowiki>}} – produces an explicitly sortable, no-bold, sortable header 
* {{code|<nowiki>! {{vert header|va=top|Your text here}}</nowiki>}} – produces an unsortable, top-aligned table header
* {{code|<nowiki>! colspan="2" {{vert header|cellstyle=background-color:gold|Your text here}}</nowiki>}} – produces an unsortable header spanning two columns, with a gold background; use no vertical bar after {{code|colspan}}

You can also use the {{code|<nowiki>! {{verth|Your text here}}</nowiki>}} shorthand.

An example below (from [[Help:Sorting]]) with headers that span rows or columns (using ''rowspan'' and ''colspan''). '''Note''' that there is no vertical bar {{code|{{!}}}} between {{code|rowspan{{=}}2}} and {{code|{{((}}vert header...{{))}}}}

{| 
|- style=vertical-align:top;
|
{| class="wikitable sortable"
|-
! rowspan=2 {{vert header|stp=1|name}}
! colspan=2 {{vert header|data columns}}
! rowspan=2 {{vert header|stp=1|another column}}
|-
! {{vert header|stp=1|data}}
! {{vert header|stp=1|more data}}
|-
| cats
| 273
| 53
| 1
|-
| dogs
| 65
| 8,492
| 2
|-
| mice
| 1,649
| 548
| 3
|}
|
<pre>
{| class="wikitable sortable"
|-
! rowspan=2 {{vert header|stp=1|name}}
! colspan=2 {{vert header|data columns}}
! rowspan=2 {{vert header|stp=1|another column}}
|-
! {{vert header|stp=1|data}}
! {{vert header|stp=1|more data}}
|-
| cats
| 273
| 53
| 1
|-
| dogs
| 65
| 8,492
| 2
|-
| mice
| 1,649
| 548
| 3
|}
</pre>
|}

==See also==

* {{tl|Rotate text}}

<includeonly>{{Sandbox other||
[[Category:Table cell templates]]
[[Category:Cross-browser compatibility templates]]
}}</includeonly>