Table Maker Class

Class TableMaker by Karsten J. Mikkelsen (kargo@teliamail.dk)
Version 1.0, June 2002
A class for easy creation of HTML tables

Constructor

TableMaker([$tableAttributes])
$tableAttributes An associative array of attributes for the table tag. No syntax checking is involved, so the attributes must be valid in order to work and will be ignored otherwise. The parameter is optional. The table will have no attributes if $tableAttributes is not supplied.
E.g. array("Border" => 0, "Cellspacing" => 0).

Methods

defineCaption(String $captionString, Array $captionAttributes)

Define the attributes for a table caption. Only one caption can be defined. Attributes are added or overwritten. Previously defined attributes remain unchanged..
$captionString: The caption text.
$captionAttributes: An array of attributes for the <caption> tag, corresponding to $tableAttributes in the constructor.

addCaption (String $captionString [, Array $captionAttributes])

Add a table row (<tr></tr> tags).
$captionString: The text to be displayed as a caption.
$captionAttributes: An array of attributes for the <caption> tag, corresponding to $tableAttributes in the constructor.

defineRow(String $rowID, Array $rowAttributes)

Define the attributes for a table row type. Only works on subsequently added rows. Attributes are added or overwritten. Previously defined attributes remain unchanged if not included.
$rowID: A unique identifier of this row type. Use 'default' to set default attributes.
$rowAttributes: An array of attributes for the <tr> tag, corresponding to $tableAttributes in the constructor.

addRow [(String $rowID] [, Array $rowAttributes])

Add a table row (<tr></tr> tags).
$rowID: A unique identifier of this row type. A row of type $rowID is inserted. Use 'default' or omit parameters to insert a row with default attributes.
$rowAttributes: An array of attributes for the <tr> tag, corresponding to $tableAttributes in the constructor.

defineHeader (String $headerID, Array $headerAttributes)

Define the attributes for a table header type. Only works on subsequently added <th> tags. Attributes are added or overwritten. Previously defined attributes remain unchanged if not included.
$headerID: A unique identifier of this header type. Use 'default' to set default attributes.
$headerAttributes: An array of attributes for the <th> tag, corresponding to $tableAttributes in the constructor.

addHeader ([String $headerData] [, String $headerID] [, Array $headerAttributes])

Add a table header cell (<th></th> tags) with contents.
$headerData: The text that constitutes the header. If omitted, a space character (&nbsp;) is used.
$headerID: A unique identifier of this header type. A data cell of type $headerID is inserted. Use 'default' or omit parameters to insert a header with default attributes.
$headerlAttributes: An array of attributes for the <th> tag, corresponding to $tableAttributes in the constructor.

defineDataCell (String $cellID, Array $cellAttributes)

Define the attributes for a data cell type. Only works on subsequently added <td> tags. Attributes are added or overwritten. Previously defined attributes remain unchanged if not included.
$cellID: A unique identifier of this data cell type. Use 'default' to set default attributes.
$cellAttributes: An array of attributes for the <td> tag, corresponding to $tableAttributes in the constructor.

addData ([String $cellData] [, String $cellID] [, Array $cellAttributes])

Add a data cell (<td></td> tags) with contents.
$cellData: The data to be contained in this data cell. If omitted, a space character (&nbsp;) is used.
$cellID: A unique identifier of this data cell type. A data cell of type $cellID is inserted. Use 'default' or omit parameters to insert a cell with default attributes.
$cellAttributes: An array of attributes for the <td> tag, corresponding to $tableAttributes in the constructor.

String getTable()

Return the table as a string

writeTable()

Write the table into the current document

setIndentation(String $indentString, Integer $tblIndent, Integer $trIndent, Integer $tdIndent, Integer $dataIndent)

Define the indentation string and levels for the HTML code.
$indentString: The string to be used for indentation. The default is one tab charachter ("\t").
$tblIndent, $trIndent, $tdIndent, $dataIndent: The indentation levels for <table>, <tr>, <td> tags and table cell contents, respectively. Use non-negative values.
The default would be defined like this: setIndentation("\t", 1, 2, 3, 4);

setCase(String $newCase)

Change tag case to uppercase, lowercase or uppercase first letter