Template:Aligned table

Template documentation[view] [edit] [history] [purge]

This template uses Lua:

Module:Aligned table (sandbox)

Known limitations

It is not currently recommended to combine use of this template with conventional table syntax due to differing approaches.
It is not possible to use a custom header line which contains rowspan elements.
When used in a multi-page transclusion (see usage notes below) , no indvidual page numbers will be displayed next to the relevant table portions,

(owing to interaction limitations with Proofread Page and LST).

Full syntax

For parameter explanations, see table below.

{{Aligned table
| cols =
| fullwidth =
| class =
| style =
| colwidth =
| leftright =
| colstyle =
| colalign =
| rowstyle =
| title =
| titlestyle =
| above =
| abovestyle =
| nobody =
| nofooter =
| noheader =

<!--for Cth column:-->
| colCwidth =
| colwidthC =
| colCclass =
| colclassC =
| classC =
| colCalign =
| alignC =
| colCstyle =
| colstyleC =
| styleC =
| colCnowrap =
| colnowrapC =
| nowrapC =
| colCheader =

<!--for Rth row:-->
| rowRclass =
| rowclassR =
| rowRstyle =
| rowstyleR =
| rowRheader =
| aboveR =
| aboveRnormal =
| aboveRclass =
| aboveRstyle =

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

| (cell 1,1) | (cell 1,2) | ... | ...
| (cell 2,1) | (cell 2,2) | ... | ...
}}

Usage over multiple Page:

First Page (content) :

{{Aligned table
| nofooter=yes <!--  required if data extends over more than one page. -->
| row1header=yes <!-- to mark first row as the headers.  -->
| (cell 1,1) | (cell 1,2) | ... | ...
| (cell 2,1) | (cell 2,2) | ... | ...
}}

First Page (footer) :

{{Aligned table|noheader=yes|nobody=yes}}

Continuing pages (header):

{{Aligned table
| nofooter=yes <!--  required if data extends over more than one page.-->
| row1header=yes <!-- to mark first row as the headers.  -->
| (header call 1,1) | (header cell 1,2)|... |...
}}

Continuing pages (body):

{{Aligned table
| noheader=yes; nofooter=yes <!--  required if data extends over more than one page.-->
... 
| (data cell x,1) | (data cell x,2)|... |... 
| (data cell x+1,1) | (data cell x+1,2)|... |... 
}}

Continuing pages (footer) as for first page. Last page header as for continuing pages.

Last page body.

{{Aligned table
| noheader=yes; <!--  required if data extends over more than one page. nofooter line is absent -->
... 
| (data cell x,1) | (data cell x,2)|... |... 
| (data cell x+1,1) | (data cell x+1,2)|... |... 
}}
{{nop}}<!-- Optional but needed in some instances to create an appropriate break.-->

Parameters

Parameter	Description	Examples	Default
cols	Number of columns in the table.	`\|cols=4`	2
fullwidth	Set to anything ("on", "true", "yes", etc) to ensure table spans entire width available. (Effect is to remove border-spacing and add width:100% to the table's styling.)	`\|fullwidth=on`	not set
class	CSS/HTML class/es applied to the table.	`\|class=wikitable \|class=infobox \|class=sortable nowrap \|class=sidebar`	none
style	CSS styling applied to the table.	`\|style=width:80%;background:transparent;`	none
colwidth	Width of each column (or include "width:...;" in `colstyle`).	`\|colwidth=6.0em \|colwidth=25%`	not set (only applied if no relevant col`C`width or colwidth`C` present)
colstyle	CSS styling applied to each column.	`\|colstyle=background:transparent;`	none
colalign	Alignment (left/right/center/justify) applied as "text-align:" prepended to all column stylings.	`\|colalign=justify`	none set
rowstyle	CSS styling applied to each row (includes "above`R`" rows.)	`\|rowstyle=text-align:center;`	none
title	text to be applied as overall table caption.	`\|title=Summary of Data`	not caption
titlestyle	CSS styling applied to table caption.	`\|titlestyle=font-style:italic;font-variant:small-caps;`	empty
above	text to be applied as full span (covers all columns) table header.	`\|above=Precis discussing the following…`	no spanning header
abovestyle	CSS styling applied to spanning header cell.	`\|avovestyle=background:color:grey`	empty
leftright	Set to anything ("on", "true", "yes", etc) in place of `\|col1align=left` and `\|col2align=right`	`\|leftright=on`	not set
col`C`width	Width of column number `C` (or include "width:...;" in `colCstyle`).	`\|col2width=9.0em \|col3width=35%`	none set
colwidth`C`	Width of column number `C` (or include "width:...;" in `colCstyle`).	`\|colwidth4=5em \|colwidth5=50%`	none set
col`C`class	Class/es applied to column number `C`.	`\|col1class=navbox-group`	"
colclass`C`	Class/es applied to column number `C`.	`\|colclass3=prose`	"
class`C`	Class/es applied to column number `C`.	`\|class4=redalert`	"
col`C`align	Alignment (left\right\center) for column `C`'s cell contents (or include "text-align:...;" in `colCstyle`).	`\|col4align=right`	none set
align`C`	Alignment (left\right\center) for column `C`'s cell contents (or include "text-align:...;" in `colCstyle`).	`\|align4=right`	none set
col`C`nowrap	Set to anything ("on", "true", "yes", etc) to add "white-space:nowrap;" to column `C`'s cell styling (i.e. to prevent lines within its cells from wrapping; or include "nowrap" in `colCclass` or "white-space:nowrap;" in `colCstyle`).	`\|col5nowrap=on`	"
colnowrap`C`	Set to anything ("on", "true", "yes", etc) to add "white-space:nowrap;" to column `C`'s cell styling (i.e. to prevent lines within its cells from wrapping; or include "nowrap" in `colCclass` or "white-space:nowrap;" in `colCstyle`).	`\|colnowrap2=on`	"
nowrap`C`	Set to anything ("on", "true", "yes", etc) to add "white-space:nowrap;" to column `C`'s cell styling (i.e. to prevent lines within its cells from wrapping; or include "nowrap" in `colCclass` or "white-space:nowrap;" in `colCstyle`).	`\|nowrap6=on`	"
col`C`style	CSS styling applied to column number `C`.	`\|col4style=font-style:italic;`	"
colstyle`C`	CSS styling applied to column number `C`.	`\|colstyle3=font-weight:bold;`	"
style`C`	CSS styling applied to column number `C`.	`\|colstyle2=background-color:gold;`	"
col`C`header	Set to any value (e.g. `Y`) to change col's cells from data cells to table headers (headings).	`\|col1header=on`	not set
row`R`class	Class/es applied to row number `R`.	`\|row10class=navbox-abovebelow`	none set
rowclass`R`	Class/es applied to row number `R`.	`\|rowclass3=references-small`	none set
row`R`style	CSS styling applied to row number `R`.	`\|row2style=font-weight:bold;`	"
rowstyle`R`	CSS styling applied to row number `R`.	`\|rowstyle6=color:green;`	"
row`R`header	Set to any value (e.g. `Y`) to change row's cells from data cells to table headers (headings).	`\|row1header=on`	not set
above`R`	text to be applied as full span (covers all columns) entry above nominated row.	`\|above5=Section II: A New Start`	empty/no spanning entry
above`R`normal	Unset indicates spanning entry will be inserted as a table header cell with all that implies (centred; bold etc.) If set to anything ("on", "true", "yes", etc) spanning entry will be instead inserted as a standard table cell and only explicitly specified CSS classes or styling will be applied.	`\|above5normal=yes`	empty
above`R`class	Class/es to be applied to spanning entry above row number `R`.	`\|above5class=quote`	empty
above`R`class	CSS styling to be applied to spanning entry above row number `R`.	`\|above5style=text-align:center`	empty
class`R`.`C`	Class/es applied to cell in row `R`, column `C`. Overrides any other class attributions (`rowRclass`, `colCclass`).	`\|class1.2=adr`	none set
style`R`.`C`	CSS styling applied to cell in row `R`, column `C`. Overrides any more general styling (`leftright`, `colCalign`, `rowRstyle`, etc).	`\|style5.3=text-align:right;`	"
noheader	Used to suppress generation of table header in page namespace	`\| noheader=yes`	`<table>` is included
nofooter	Used to suppress generation of a table footer in page namespace	`\| nofooter=yes`	`</table>` is included
nobody	Used to suppress generation of a table contents	`\| nobody=yes`	Only `<table></table>` is emitted. This can be used when spanning tables over multiple pages. ( see below)
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.	`\| Azerbaijan \| Malta \| Zaire`	empty

Examples

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

A	1	a
B	2	b

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

AAA	aa	123	12345
B	bbbbb	1234	2

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

AAA	123
B	2

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

U	#	l
A	1	a
B	2	b

Known limitations

Full syntax

Usage over multiple Page:

Parameters

Examples

See also