Help:Tables

Tables may be set up in wiki pages using either HTML table elements, or wikicode. HTML table elements will not be discussed here (see web pages if you're interested). The benefit of wikicode is that the table is made of character symbols. This makes it easier to imagine the table when you work in the editing box.

As a general rule, it is best to avoid using a table unless you need one. Table markup often complicates page editing.

Wiki table markup, or wiki markup or just marks are words used to describe to control codes. Control codes are symbols used that tell wikipedia how to display something. When a person looks at a page in wikipedia, the wiki markup can make the text look special, such as bold, large, or in a table. The person viewing the page does not see the wiki markup. Only the editor (the person that writes the page) sees the wiki markup.

{|

|+

! 

|-

|

|}

• The above marks must start on a new line except the double || and !!
  • Double || and !! marks are used to add more than one cell entry in a line.

• XHTML attributes, Each mark, except table end, optionally accepts one or more XHTML attributes.
  • XHTML attributes must be on the same line as the mark.
  • Separate XHTML attributes from each other with a single space.
  • Cells (| or ||, and ! or !!) and the caption (|+) hold content. Separate attributes from content with a single pipe (|).
    • Cell content may follow on same line or on following lines.
  • Table and row marks ({| and |-) do not hold content. Do not add pipe (|) after their optional attributes. The pipe mark will be deleted.
    • If there is no space between the last attribute and the pipe mark, the last attribute will be deleted!

• Content may be entered on the same line as its cell mark, or on the lines below the cell mark.
  • Centent must follow any optional XHTML attributes.
  • Content that uses wiki markup, such as lists, headers, or nested tables, that needs to start on a new line must be on its own new line.

This is a plain wiki table. It shows the simplest wiki table markup table structure. The table does not have any borders. There is very little spacing between the content.

In the following examples, the table on the left is the table the user will see when they view an article in wikipedia. The box on the right is the wiki markup code entered to create the table.

This is the simplest wiki table markup table structure. The content of each cell is entered one its own line.

{|
|Orange
|Apple
|Banana
|-
|Bread
|Pie
|Cake
|-
|Butter
|Ice cream 
|Milk
|}

To make the wiki markup look more like a table, row content may be entered on one line. This works well for small tables, like this example. Note that the content cells are separated by a double pipe mark (||).

Extra spaces in the cells in the wiki markup can be added. The wiki markup below has extra spaces to make the wiki markup look more like a table. The extra spaces do not affect the table display.

{|
| Orange   || Apple     || Banana
|-
| Bread    || Pie       || Cake
|-
| Butter   || Ice cream || Milk
|}

You can add XHTML attributes tables. Attributes are control codes that define how the table and its data will display.

Placing attributes after the table start tag applies attributes to the entire table.

• For example, a table may look better with a border around the entire table.

{| border="1"
|Orange
|Apple
|12,333.00
|-
|Bread
|Pie
|500.00
|-
|Butter
|Ice cream
|1.00
|}

Attributes can be placed on individual cells.

• For example, one cell can be made highlighted (made to stand out) by changing its background color.
• Note that the attribute must be separated from the cell data with a pipe mark (|).

{| border="1"
|Orange
|Apple
|Banana
|-
|Bread
|Pie
|bgcolor="cyan"|Cake
|-
|Butter
|Ice cream
|Milk
|}

Attributes may be placed on individual rows,.

• For example, one row may be highlighted by changing the color and style of the font (the format used to display letters).

{| border="1"
|Orange
|Apple
|Banana
|-
|Bread
|Pie
|Cake
|- style="font-style:italic;color:red;"
|Butter
|Ice cream
|Milk
|}

For the authoriative source on these, see the W3C's HTML 4.01 Specification page on tables.

CSS style attributes may be used to define how the table and its data will display.

• Just like XHTML attributes, CSS style attributes may be added to the table, row, or cell.
• CSS style attributes can be added with or without other HTML attributes.

{| style="color:green;background-color:yellow;" 
cellpadding="20" cellspacing="0" border="1"
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

One CSS attribute is class. A class named wikitable had been made to display tables in a common format.

• To use this format, add class="wikitable" to the table start tag.
• Most wiki edit windows (were the article data is entered) have a table button. This button will insert a wiki table with the class="wikitable" attribute.

{| class="wikitable"
| Orange   || Apple     || Banana
|-
| Bread    || Pie       || Cake
|-
| Butter   || Ice cream || Milk
|}

Table headings are created by using "!" instead of "|". Headings are usually displayed bold and centered.

• Headings may be placed in any table row.
  • Headings are normally used at the beginning of a table.
• XHTML or CSS attributes and header text must be separated with the "|" character.

{| border="1" cellspacing="0"
! Item !! Amount !! Cost
|-
| Apples || 6 pieces || align="right" | 7.85 
|-
| Bananas || 5 pieces || align="right" | 4.92 
|-
| Mandarins || 8 pieces || align="right" | 8.55 
|-
| Ice cream || 2 pints || align="right" | 4.85 
|-
! colspan="2" | Total: !! align="right" | 26.17 
|}

{| class="wikitable"
! Item !! Amount !! Cost
|-
| Apples || 6 pieces || align="right" | 7.85 
|-
| Bananas || 5 pieces || align="right" | 4.92 
|-
| Mandarins || 8 pieces || align="right" | 8.55 
|-
| Ice cream || 2 pints || align="right" | 4.85 
|-
! colspan="2" | Total: !! align="right" | 26.17 
|}

Table captions are created by using "|+" instead of "|". Captions are usually displayed centered.

• Captions are displayed outside of the table.
  • Captions are normally displayed above the table.
• Captions may be placed in any table row.
  • Captions are normally used at the beginning of a table.
• XHTML or CSS attributes and caption text must be separated with the "|" character.

{| border="1" cellspacing="0"
|+Food complements
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

{| class="wikitable"
|+Food complements
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

XHTML or CSS attributes may be used to change the display of the caption.

{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:red" | Food complements
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Starting a cell on a new line with a negative number may cause an error. The minus sign next to the "|" mark will look like the wiki markup for a new row (|-). To avoid this error, always put a space before a negative number.

• A parameter that evaluates to a negative number will cause the same error.

{| border="1" cellspacing="0" cellpadding="10"
|+Incorrect
|-
|Temperature in winter
|-10 degrees
|-
|Temperature in summer
|90 degrees
|}

{| border="1" cellspacing="0" cellpadding="10"
|+ Correct
|-
| Temperature in winter
| -10 degrees
|-
| Temperature in summer
| 90 degrees
|}

Table borders defined with CSS rather than the border attribute will display wrong in a small number of text browsers.