TableFormattingRulesJwd

Enter a topic name to show or a new topic name to create; then press Enter

Table Formatting Features

Basic tables are done like this:

 ||Region||Sales||
 ||East||$100||
 ||West||$500||

which appears like this:

Region Sales
East $100
West $500

Rich table formatting allows control over the following advanced table formatting features:

These rich formatting options are specified using a table formatting expression immediately after the || characters for a cell. The table formatting expression is delimited by { and } (curly-brace characters). Formatting that applies to the whole table must appear prior to the first cell (though it can be duplicated and will be ignored in the other cells).


Table Formatting Rules and Examples

Center - T^

A table can be centered using the table formatting expression T^. For example,

 ||{T^}Region||Sales||
 ||East||$100||
 ||West||$500||

which appears like this:

Region Sales
East $100
West $500

Floating Tables - T[ and T]

A table can be configured to float on the left or right with surrounding content wrapped around. This is done with T[ and T]. For example,

 ||{T[}Region||Sales||
 ||East||$100||
 ||West||$500||

which appears like this:

Region Sales
East $100
West $500

Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table.

Or, floating on the right:

 ||{T]}Region||Sales||
 ||East||$100||
 ||West||$500||

which appears like this:

Region Sales
East $100
West $500

Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table. Notice that this text wraps around the table.

Border = T-

By default, a table is given a border. You can hide the border using T-. For example:

 ||{T-}Region||Sales||
 ||East||$100||
 ||West||$500||

which appears like this:

Region Sales
East $100
West $500

Width

You can specify the preferred width of the table (as a percentage of the whole display area for the topic) using TWxx, where xx is the percentage. For example,

 ||{TW25}One Quarter||
 ||This is the story of a man named bill.  This is the story ....||

produces:

One Quarter
This is the story of a man named bill. This is the story of a man named bill. This is the story of a man named bill. This is the story of a man named bill.

whereas:

 ||{TW90}Ninety Percent||
 ||This is the story of a man named bill.  This is the story ....||

produces:

Ninety Percent
This is the story of a man named bill. This is the story of a man named bill. This is the story of a man named bill. This is the story of a man named bill.

Table Cell Wrap - T~

 ||{T~TW25}Wrap One Quarter||
 ||This_is_a_long_unbroken_text_that_would_not_wrap_without_the_additional_control||

produces:

Wrap One Quarter
This_is_a_long_unbroken_text_that_would_not_wrap_without_the_additional_control

Cell Formatting Features

Row and column spans - Cnnn and Rnnn

Sometimes you want a cell to span more than one column or row. This can be achieved by specifying the Cnnn and Rnnn options.

For example:

 ||{R2}Region||{C2}Sales||
 ||Q1||Q2||
 ||East||$100||$800||
 ||West||$500||$9000||

which causes the Sales cell to span two columns and the Region cell to span two rows:

Region Sales
Q1 Q2
East $100 $800
West $500 $9000

Cell content alignment - [ ^ ]

You can control the alignment in a cell by using [ (left), ] (right) and ^ (center). Note the position of the word Sales in each of the following three examples:

First row:

 ||{[C2}Sales||
Sales
Q1 Q2
$100 $800
$500 $9000

First row:

 ||{^C2}Sales||
Sales
Q1 Q2
$100 $800
$500 $9000

First row:

 ||{]C2}Sales||
Sales
Q1 Q2
$100 $800
$500 $9000

Cell highlighting - !

By including the '!' table formatting rule, you can cause cells to be highlighted. This is useful, for example, in header rows and for other cells that you want to highlight:

 ||{^!C2}Sales||
 ||Q1||Q2||
 ||$100||$800||
 ||$500||{!}$9000||

produces:

Sales
Q1 Q2
$100 $800
$500 $9000

Width

You can specify the preferred width of the column (as a percentage of the width of the whole table) using Wxx, where xx is the percentage. For example,

 ||{W75}Q1||Q2||Q3||Q4||
 ||$100||$800||$500||$900||
 ||$500||$9000||$500||$900||

produces:

Q1 Q2 Q3 Q4
$100 $800 $500 $900
$500 $9000 $500 $900

Breaking - +

By default, content will be word wrapped in table cell. You can disable this behavior for special circumstances by using the + table formatting rule.

For example, in the following table the wrapping is disabled in the left hand cell, while the right hand cell is normal.

 ||{+} The quick ... || The quick ... ||
The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog.

Note that you may need to make your browser window narrower to see the impact of this.

Colored Cells - color

color can be used to set the background color of a table cell to the given color. You can use either named colors (like 'red', 'green', etc.) or hex colors ('# FF0000' or '#00 FF00').

Some examples:

 ||{*red*}RED RED RED||
 ||{*lightgreen*}LIGHT GREEN||
 ||{*#c0c0c0*}LIGHT GREY||

produces:

RED RED RED
LIGHT GREEN
LIGHT GREY

Note: colored cells requires build 1699 or later

Combining formatting expressions

If you want to combine two or more of these features (example: Floating Right without Border), you have to insert all expressions in the brace.

 ||{T[T-}'''This is left''' (y)||

produces:

This is left emoticons/y.gif
 ||{T]T-}'''This is right''' (y)||

produces:

This is right emoticons/y.gif

I used this Feature also to align Images. You make a Table without borders and floating right, and the only thing that is in the table is the link to the image.


Version: 2   Revised: 2013-08-27 12:42:57 Last Updated by: jwd Rename Show Links to Topic