View source for Template:Aligned table/doc

{{Documentation subpage}}
{{Lua|icononly=on |Module:Aligned table}}
<!----Please place categories where indicated at the bottom of this page and interwikis in Wikidata---->
The purpose is of this template is for generating simple tables in locations where standard table markup is either not possible, without significant use of the {{tld|!}} magic word (e.g., with a {{tl|sidebar}} template), or cumbersome (due to the repetitive use of specification of the same style statement in each row). This template should <u>not</u> be used to replace standard table markup in articles.  This template is meant to be complementary to {{tl|infobox}} or {{tl|sidebar}}, and <u>not</u> a replacement for {{tl|infobox}} or {{tl|sidebar}}.

A simpler method to include a table in a template that does not directly support table markup is to create the table in a sub-template using standard markup and transclude it.

== Full syntax ==

For parameter explanations, see table below.

<pre style="overflow:auto;">
{{Aligned table
| cols =
| fullwidth =
| class =
| style =
| colwidth =
| leftright =
| rightleft =
| colstyle =
| rowstyle =

<!--for Cth column:-->
| colCwidth =
| colCclass =
| colCalign =
| colCstyle =
| colCnowrap =

<!--for Rth row:-->
| rowRclass =
| rowRstyle =
| rowRheader =

<!--for cell R,C:-->
| classR.C =
| styleR.C =

| (cell 1,1) | (cell 1,2) | ... | ...
| (cell 2,1) | (cell 2,2) | ... | ...
}}
</pre>

== Parameters ==
<div style="overflow:auto;">
{{Aligned table
 |cols=4 |class=wikitable |style=line-height:1.35em;
 |colstyle=padding-right:1.0em;
 |col2width=40.0em
 |col4style=padding-left:1.0em;text-align:center;

 |row1header=on
 | Parameter
 | Description
 | Examples
 | Default

 <!-------Overall-------->
 | cols
 | Number of columns in the table.
 | <code><nowiki> |cols=4 </nowiki></code>
 | 2

 | fullwidth
 | {{nowrap|If set (to anything, "on", "true", "yes", etc.), ensures table spans entire width available.}}

(Effect is to remove border-spacing and add width:100% to the table's styling.)
 | <code><nowiki> |fullwidth=on </nowiki></code>
 | ''Not set''

 | class
 | CSS/HTML class/es applied to the table.
 | <code><nowiki> |class=wikitable &nbsp; |class=infobox</nowiki><br /><nowiki>|class=sortable nowrap &nbsp; |class=sidebar</nowiki></code>
 | ''Not set''

 | style
 | CSS styling applied to the table.
 | <code>{{nowrap|<nowiki> |style=width:80%;background:transparent; </nowiki>}}</code>
 | ''Not set''

 | colwidth
 | Width of each column (or include "width:...;" in <kbd>colstyle</kbd>).
 | <code><nowiki> |colwidth=6.0em &nbsp; |colwidth=25%</nowiki></code>
 | ''Not set''

 | colstyle
 | CSS styling prepended to the cell style for each column.
 | <code><nowiki> |colstyle=background:transparent; </nowiki></code>
 | ''Not set''

 | rowstyle
 | CSS styling applied to each row.
 | <code><nowiki> |rowstyle=text-align:center; </nowiki></code>
 | vertical-align:top;

 <!-------Columns-------->
 | leftright
 | If set (to anything, "on", "true", "yes", etc.) is equivalent to <kbd><nowiki>|col1align=left</nowiki></kbd> and <kbd><nowiki>|col2align=right</nowiki></kbd>
 | <code><nowiki> |leftright=on </nowiki></code>
 | ''Not set''

 | rightleft
 | If set (to anything, "on", "true", "yes", etc.) is equivalent to <kbd><nowiki>|col1align=right</nowiki></kbd> and <kbd><nowiki>|col2align=left</nowiki></kbd>
 | <code><nowiki> |rightleft=on </nowiki></code>
 | ''Not set''

 | col{{var|C}}width
 | CSS width property of cell in column {{var|C}} (or include "width:...;" in <kbd>col{{var|C}}style</kbd>).
 | <code><nowiki> |col2width=9.0em &nbsp; |col3width=35%</nowiki></code>
 | ''Not set''

 | col{{var|C}}class
 | Classes added to cell in column {{var|C}}.
 | <code><nowiki> |col1class=navbox-group </nowiki></code>
 | '' Not set''

 | col{{var|C}}align
 | CSS text-align property (left{{\}}right{{\}}center) of cell in column {{var|C}}'s cell contents (or include "text-align:...;" in <kbd>col{{var|C}}style</kbd>).
 | <code><nowiki> |col4align=right </nowiki></code>
 | ''Not set''

 | col{{var|C}}nowrap
 | If set (to anything, "on", "true", "yes", etc.) adds "white-space:nowrap;" to the CSS style of cell in column {{var|C}} (i.e., to prevent lines within its cells from wrapping; or include "nowrap" in <kbd>col{{var|C}}class</kbd> or "white-space:nowrap;" in <kbd>col{{var|C}}style</kbd>).
 | <code><nowiki> |col5nowrap=on </nowiki></code>
 | 

 | col{{var|C}}style
 | CSS style appended to cell in column {{var|C}}.
 | <code><nowiki> |col4style=font-style:italic; </nowiki></code>
 | ''Not set''


 | col{{var|C}}header
 | If set (to any value), changes cells in column {{var|C}} to table headers (headings).
 | <code><nowiki> |col1header=on </nowiki></code>
 | ''Not set''

 <!--------Rows---------->
 | row{{var|R}}class
 | Classes applied to row {{var|R}}.
 | <code><nowiki> |row10class=navbox-abovebelow </nowiki></code>
 | ''Not set''

 | row{{var|R}}style
 | CSS styling applied to row {{var|R}}.
 | <code><nowiki> |row2style=font-weight:bold; </nowiki></code>
 |

 | row{{var|R}}header
 | If set (to any value), changes cells in row {{var|R}} to table headers (headings).
 | <code><nowiki> |row1header=on </nowiki></code>
 | ''Not set''

 <!--------Cells--------->
 | class{{var|R}}.{{var|C}}
 | Classes applied to cell in row {{var|R}}, column {{var|C}}. Overrides any other class attributions (<kbd>row{{var|R}}class</kbd>, <kbd>col{{var|C}}class</kbd>).
 | <code><nowiki> |class1.2=adr </nowiki></code>
 | ''Not set''

 | style{{var|R}}.{{var|C}}
 | CSS styling applied to cell in row {{var|R}}, column {{var|C}}. Overrides any more general styling (<kbd>leftright</kbd>, <kbd>col{{var|C}}align</kbd>, <kbd>row{{var|R}}style</kbd>, etc).
 | <code><nowiki> |style5.3=text-align:right; </nowiki></code>
 | ''Not set''

 | {{sans-serif|''Unnamed parameters''}}
 | Each unnamed parameter is taken to be the next cell in the table, starting at the table's top left corner and working left to right from top to bottom.
 | <code>{{!}} Azerbaijan {{!}} Malta {{!}} Zaire</code>
 | ''Not set''
}}</div>

== Examples ==

<pre>
{{Aligned table
|cols=3 |class=wikitable
| A | 1 | a
| B | 2 | b
}}
</pre>
{{Aligned table
|cols=3 |class=wikitable
| A | 1 | a
| B | 2 | b
}}

<pre>
{{Aligned table
|cols=4 |class=wikitable
|col1align=center |col2align=center
|col3align=right  |col4align=right
| AAA | aa    | 123  | 12345
| B   | bbbbb | 1234 | 2
}}
</pre>
{{Aligned table
|cols=4 |class=wikitable
|col1align=center |col2align=center
|col3align=right  |col4align=right
| AAA | aa    | 123  | 12345
| B   | bbbbb | 1234 | 2
}}

<pre>
{{Aligned table
|class=wikitable |style=width:20em;
|col1align=center |col2align=right
| AAA | 123
| B   | 2
}}
</pre>
{{Aligned table
|class=wikitable |style=width:20em;
|col1align=center |col2align=right
| AAA | 123
| B   | 2
}}

<pre>
{{Aligned table
|cols=3 |class=wikitable sortable
|row1header=y
| U | # | l
| A | 1 | a
| B | 2 | b
}}
</pre>
{{Aligned table
|cols=3 |class=wikitable sortable
|row1header=y
| U | # | l
| A | 1 | a
| B | 2 | b
}}

<pre>
{{Aligned table
|cols=3 |class=wikitable sortable
|row1header=y
| U | # | l
| A | 1 | a
| B | 2 | b
|   |   |  
| C | 3 | c
}}
</pre>
{{Aligned table
|cols=3 |class=wikitable sortable
|row1header=y
| U | # | l
| A | 1 | a
| B | 2 | b
|   |   |  
| C | 3 | c
}}
<includeonly>{{Sandbox other||
[[Category:Table templates]]
}}</includeonly>