https://sourceforge.net/p/ctabledynamic/wiki/ClassDescription/Recent changes to ClassDescriptionenMon, 27 Feb 2012 14:26:38 -0000https://sourceforge.net/p/ctabledynamic/wiki/ClassDescription/<pre>--- v19 +++ v20 @@ -93,42 +93,47 @@ For example, when the dataset is empty or when there is only one row in the dataset, the header column cell will not be clickable (no need to sort). * **$activecol** The current active column header. This column header will use the content pattern $activelink instead of his own $link. This active column is identified by the array key of $arrTH. It can be a number or a name (see $arrTH description). * **$activelink** The content pattern to apply to the active column header (if $rowcount>$rowcountmin) - * **$arrTH** Iss a stack designed to store the column headers definitions. It's an array of cTableHead objects. +* **$arrTD** Is a stack designed to store the column cells definitions. It's an array of cTableData objects. + +Examples of column headers: The cTableHead object (described here after) has 3 basic properties: a content, an id attribute and a class attribute (other html attributes can be added with the AddAttr method) $t->arrTH[0] = new cTableHead('Name','hd0','head'); $t->arrTH[1] = new cTableHead('Given names','hd1','head'); $t->arrTH[2] = new cTableHead('Address','hd2','head'); Here we store the column headers with a numerical key (the column order: 0,1,2...). When working with a database, it's more easy to use the database fieldname as key. For example: $t->arrTH['name'] = new cTableHead('Name','hd0','head'); $t->arrTH['firstname'] = new cTableHead('Given names','hd1','head'); $t->arrTH['address'] = new cTableHead('Address','hd2','head'); When displaying these column headers, $t->GetTHrow() generates: <tr> <th id="hd0" class="head">Name</th> <th id="hd1" class="head">Given name</th> <th id="hd3" class="head">Address</th> </tr> -* **$arrTD** Is a stack designed to store the column cells definitions. It's an array of cTableData objects. - -The cTableData object (described here after) has 3 basic properties: a content, an id attribute and a class attribute (other html attributes can be added with the AddAttr method) + +Examples of column data: + + The cTableData object (described here after) has 3 basic properties: + a content, an id attribute and a class attribute + (other html attributes can be added with the AddAttr method) $t->arrTD[0] = new cTableData('Smith','','cell'); $t->arrTD[1] = new cTableData('John','','cell'); $t->arrTD[2] = new cTableData('Wallstreet','','cell'); -When displaying these columns, this generates: + When displaying these columns, this generates: <tr> <th class="cell">Name</th> </pre>q-codeMon, 27 Feb 2012 14:26:38 -0000https://sourceforge.net421236d0409378edb7bf19b462283802dfe10a62https://sourceforge.net/p/ctabledynamic/wiki/ClassDescription/<pre>--- v18 +++ v19 @@ -96,52 +96,55 @@ * **$arrTH** Iss a stack designed to store the column headers definitions. It's an array of cTableHead objects. -The cTableHead object (described here after) has 3 basic properties: a content, an id attribute and a class attribute (other html attributes can be added with the AddAttr method) - + The cTableHead object (described here after) has 3 basic properties: + a content, an id attribute and a class attribute + (other html attributes can be added with the AddAttr method) + $t->arrTH[0] = new cTableHead('Name','hd0','head'); $t->arrTH[1] = new cTableHead('Given names','hd1','head'); $t->arrTH[2] = new cTableHead('Address','hd2','head'); -Here we store the column headers with a numerical key (the column order: 0,1,2...). -When working with a database, it's more easy to use the database fieldname as key. For example: + Here we store the column headers with a numerical key (the column order: 0,1,2...). + When working with a database, it's more easy to use the database fieldname as key. + For example: $t->arrTH['name'] = new cTableHead('Name','hd0','head'); $t->arrTH['firstname'] = new cTableHead('Given names','hd1','head'); $t->arrTH['address'] = new cTableHead('Address','hd2','head'); -When displaying these column headers, $t->GetTHrow() generates: + When displaying these column headers, $t->GetTHrow() generates: <tr> <th id="hd0" class="head">Name</th> <th id="hd1" class="head">Given name</th> <th id="hd3" class="head">Address</th> </tr> * **$arrTD** Is a stack designed to store the column cells definitions. It's an array of cTableData objects. The cTableData object (described here after) has 3 basic properties: a content, an id attribute and a class attribute (other html attributes can be added with the AddAttr method) $t->arrTD[0] = new cTableData('Smith','','cell'); $t->arrTD[1] = new cTableData('John','','cell'); $t->arrTD[2] = new cTableData('Wallstreet','','cell'); When displaying these columns, this generates: <tr> <th class="cell">Name</th> <th class="cell">Given name</th> <th class="cell">Address</th> </tr> Note: When working with database, we will not use these simple declarations. We will rather used advanced methods allowing to automate columns creation or to fill the contents of several cells. -* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** overrides `cTableEntity::End()`. This method closes the table entity (i.e. returns `</table>` tag). The options allow removing the columns, column headers or default row: +* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** overrides `cTableEntity::End()`. This method closes the table entity (i.e. returns the `</table>` tag). The options allow removing the columns, column headers or default row: * $bUnsetData true allows removing the data column definitions (cTableData objects `<td>` stored in $this->arrTD) * $bUnsetHead true allows removing the header column definitions (cTableHead objects `<th>` stored in $this->arrTH) * $bUnsetRow true allows removing the default row definition (cTableRow object `<tr>` stored in $this->row) - * When you want to re-use the same table several times, these options allow cleaning the only data cells (or header, row) definitions. If you want reset the entire table, just create a new instance instead of using these options. + * When you want to re-use the same table several times, these options allow cleaning the data cells (or header, row) definitions. If you want reset the entire table, just create a new instance instead of using these options. #### Methods: </pre>q-codeMon, 27 Feb 2012 14:23:54 -0000https://sourceforge.net87f67f123a3ebf35bbf8df9be9927dd3cde22b1chttps://sourceforge.net/p/ctabledynamic/wiki/ClassDescription/<pre>--- v17 +++ v18 @@ -137,7 +137,7 @@ When working with database, we will not use these simple declarations. We will rather used advanced methods allowing to automate columns creation or to fill the contents of several cells. -* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** [overrides cTableEntity::End()] This method closes the table entity (i.e. returns `</table>` tag). The options allow removing the columns, column headers or default row +* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** overrides `cTableEntity::End()`. This method closes the table entity (i.e. returns `</table>` tag). The options allow removing the columns, column headers or default row: * $bUnsetData true allows removing the data column definitions (cTableData objects `<td>` stored in $this->arrTD) * $bUnsetHead true allows removing the header column definitions (cTableHead objects `<th>` stored in $this->arrTH) * $bUnsetRow true allows removing the default row definition (cTableRow object `<tr>` stored in $this->row) </pre>q-codeMon, 27 Feb 2012 14:20:03 -0000https://sourceforge.net8d0f9d6e51458bb1ec7262b7074d6fb3e0605ec0https://sourceforge.net/p/ctabledynamic/wiki/ClassDescription/<pre>--- v15 +++ v16 @@ -156,14 +156,14 @@ The following advanced methods allows changing all columns at once (you can change the entity, the content or an attribute). -* **ChangeTHentity**($arr,$bCreateColumn,$bNamedColumn): Allows changing the entity in all column header. For example to use the tag <td> instead of the default `<th>` as column headers. +* **ChangeTHentity**($arr,$bCreateColumn,$bNamedColumn): Allows changing the entity in all column header. For example to use the tag `<td>` instead of the default `<th>` as column headers. * **ChangeTDentity**($arr,$bCreateColumn,$bNamedColumn(): Idem for the column cells. ChangeTHcontent($arr,$bCreateColumn,$bNamedColumn): Allows changing the content of all the column headers at once. It also make possible to create the column headers (if not yet defined) * **ChangeTDcontent**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. * **ChangeTHattr**($arr,$bCreateColumn,$bNamedColumn): Allows changing one attribute value in each column headers (or add one attribute and his value) * **ChangeTDattr**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. -* **About these advanced methods** They will apply the values provided by $arr, but two options: +* **About these advanced methods** They will apply the values provided by $arr, but two options are available: * $bCreateColumn, when true, will create the missing column objects. * $bNamedColumn, when true, will identify the column by the array-key. When false, the method applies the values of $arr in the sequential order. </pre>q-codeMon, 27 Feb 2012 14:13:52 -0000https://sourceforge.net30ab24d05edce403b83cb4145c11bb7e73e59e30https://sourceforge.net/p/ctabledynamic/wiki/ClassDescription/<pre></pre>q-codeMon, 27 Feb 2012 13:57:59 -0000https://sourceforge.net1ba1abed401f0373fe43277e9ea3c2f6068d13f7https://sourceforge.net/p/ctabledynamic/wiki/PageClass/<pre>--- v13 +++ v14 @@ -161,7 +161,9 @@ ChangeTHcontent($arr,$bCreateColumn,$bNamedColumn): Allows changing the content of all the column headers at once. It also make possible to create the column headers (if not yet defined) * **ChangeTDcontent**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. * **ChangeTHattr**($arr,$bCreateColumn,$bNamedColumn): Allows changing one attribute value in each column headers (or add one attribute and his value) -* **ChangeTDattr**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. These methods will apply the values provided by $arr, but two options: +* **ChangeTDattr**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. + +* **About these advanced methods** They will apply the values provided by $arr, but two options: * $bCreateColumn, when true, will create the missing column objects. * $bNamedColumn, when true, will identify the column by the array-key. When false, the method applies the values of $arr in the sequential order. </pre>q-codeMon, 27 Feb 2012 13:55:40 -0000https://sourceforge.netda898a8c70621992367e59aab9702788f7733848https://sourceforge.net/p/ctabledynamic/wiki/PageClass/<pre>--- v12 +++ v13 @@ -155,13 +155,13 @@ #### The advanced methods: The following advanced methods allows changing all columns at once (you can change the entity, the content or an attribute). + * **ChangeTHentity**($arr,$bCreateColumn,$bNamedColumn): Allows changing the entity in all column header. For example to use the tag <td> instead of the default `<th>` as column headers. * **ChangeTDentity**($arr,$bCreateColumn,$bNamedColumn(): Idem for the column cells. ChangeTHcontent($arr,$bCreateColumn,$bNamedColumn): Allows changing the content of all the column headers at once. It also make possible to create the column headers (if not yet defined) * **ChangeTDcontent**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. * **ChangeTHattr**($arr,$bCreateColumn,$bNamedColumn): Allows changing one attribute value in each column headers (or add one attribute and his value) -* **ChangeTDattr**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. - These methods will apply the values provided by $arr, but two options: - - $bCreateColumn, when true, will create the missing column objects. - - $bNamedColumn, when true, will identify the column by the array-key. When false, the method applies the values of $arr in the sequential order. +* **ChangeTDattr**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. These methods will apply the values provided by $arr, but two options: + * $bCreateColumn, when true, will create the missing column objects. + * $bNamedColumn, when true, will identify the column by the array-key. When false, the method applies the values of $arr in the sequential order. </pre>q-codeMon, 27 Feb 2012 13:54:00 -0000https://sourceforge.nete07b886550add780307227cff922f0d9b2ab58achttps://sourceforge.net/p/ctabledynamic/wiki/PageClass/<pre>--- v11 +++ v12 @@ -137,13 +137,11 @@ When working with database, we will not use these simple declarations. We will rather used advanced methods allowing to automate columns creation or to fill the contents of several cells. -* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** [overrides cTableEntity::End()] This method closes the table entity (i.e. returns `</table>` tag). - The options allow removing the columns, column headers or default row: - $bUnsetData true allows removing the data column definitions (cTableData objects `<td>` stored in $this->arrTD) - $bUnsetHead true allows removing the header column definitions (cTableHead objects `<th>` stored in $this->arrTH) - $bUnsetRow true allows removing the default row definition (cTableRow object `<tr>` stored in $this->row) - When you want to re-use the same table several times, these options allow cleaning the only data cells (or header, row) definitions. - If you want reset the entire table, just create a new instance instead of using these options. +* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** [overrides cTableEntity::End()] This method closes the table entity (i.e. returns `</table>` tag). The options allow removing the columns, column headers or default row + * $bUnsetData true allows removing the data column definitions (cTableData objects `<td>` stored in $this->arrTD) + * $bUnsetHead true allows removing the header column definitions (cTableHead objects `<th>` stored in $this->arrTH) + * $bUnsetRow true allows removing the default row definition (cTableRow object `<tr>` stored in $this->row) + * When you want to re-use the same table several times, these options allow cleaning the only data cells (or header, row) definitions. If you want reset the entire table, just create a new instance instead of using these options. #### Methods: </pre>q-codeMon, 27 Feb 2012 13:50:56 -0000https://sourceforge.net32e65627d8f6bb757fd0e82ac9c238357bb07f1fhttps://sourceforge.net/p/ctabledynamic/wiki/PageClass/<pre>--- v10 +++ v11 @@ -69,98 +69,100 @@ * **$dynamicValues** Defines a list of cell values and the corresponding attribute-values. Example: `$t->arrTD['col3']->dynamicValues = array('positive'=>'background-color:green', 'negative'=>'background-color:red');` -#### Methods +#### Methods: + * **AddDynamicAttr($attr,$value)** This searches in $dynamicValues the corresponding attribute-value, and apply it to the attribute $attr. Example: `$t->arrTD['col1']->AddDynamicAttr('style',($this->content<0 ? 'negative' : 'positive'));` ------------- CLASS: cTable (extends cTableEntity) ------------- `$t = new cTable('table1','class1');` When creating an instance of cTable we can assign directly two basic html attributes, the 'id' and the 'class'. Other attributes can be inserted with the AddAttr() method. This principle is also applicable for all other objects (like a `<tr>, <td>, or <th>`). #### Properties: * **$row** Stores the default table row definition. It's a cTableRow object. It is not mandatory to instantiated the cTableRow object. If missing, it will be instantiated automatically by the methods GetTHrow() and GetTDrow(). * **$rowcount, $rowcountmin** Stores the number of rows in this table and the minimum number of rows to apply a link in the column headers. For example, when the dataset is empty or when there is only one row in the dataset, the header column cell will not be clickable (no need to sort). * **$activecol** The current active column header. This column header will use the content pattern $activelink instead of his own $link. This active column is identified by the array key of $arrTH. It can be a number or a name (see $arrTH description). * **$activelink** The content pattern to apply to the active column header (if $rowcount>$rowcountmin) * **$arrTH** Iss a stack designed to store the column headers definitions. It's an array of cTableHead objects. The cTableHead object (described here after) has 3 basic properties: a content, an id attribute and a class attribute (other html attributes can be added with the AddAttr method) $t->arrTH[0] = new cTableHead('Name','hd0','hd'); $t->arrTH[1] = new cTableHead('Given names','hd1','hd'); $t->arrTH[2] = new cTableHead('Address','hd2','hd'); Here we store the column headers with a numerical key (the column order: 0,1,...). When working with a database, it's more easy to use the database fieldname as key. For example: $t->arrTH['name'] = new cTableHead('Name','hd0','head'); $t->arrTH['firstname'] = new cTableHead('Given names','hd1','head'); $t->arrTH['address'] = new cTableHead('Address','hd2','head'); When displaying these column headers, $t->GetTHrow() generates: - `<tr><th id="hd0" class="head">Name</th><th id="hd1" class="head">Given name</th><th id="hd3" class="head">Address</th></tr>` + <tr> + <th id="hd0" class="head">Name</th> + <th id="hd1" class="head">Given name</th> + <th id="hd3" class="head">Address</th> + </tr> * **$arrTD** Is a stack designed to store the column cells definitions. It's an array of cTableData objects. The cTableData object (described here after) has 3 basic properties: a content, an id attribute and a class attribute (other html attributes can be added with the AddAttr method) $t->arrTD[0] = new cTableData('Smith','','cell'); $t->arrTD[1] = new cTableData('John','','cell'); $t->arrTD[2] = new cTableData('Wallstreet','','cell'); When displaying these columns, this generates: - `<tr><th class="cell">Name</th><th class="cell">Given name</th><th class="cell">Address</th></tr>` + <tr> + <th class="cell">Name</th> + <th class="cell">Given name</th> + <th class="cell">Address</th> + </tr> Note: When working with database, we will not use these simple declarations. We will rather used advanced methods allowing to automate columns creation or to fill the contents of several cells. -* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** [overrides cTableEntity::End()] This method closes the table entity (i.e. returns </table> tag). +* **End($bUnsetData,$bUnsetHead,$bUnsetRow)** [overrides cTableEntity::End()] This method closes the table entity (i.e. returns `</table>` tag). The options allow removing the columns, column headers or default row: - $bUnsetData true allows removing the data column definitions (cTableData objects <td> stored in $this->arrTD) - $bUnsetHead true allows removing the header column definitions (cTableHead objects <th> stored in $this->arrTH) - $bUnsetRow true allows removing the default row definition (cTableRow object <tr> stored in $this->row) + $bUnsetData true allows removing the data column definitions (cTableData objects `<td>` stored in $this->arrTD) + $bUnsetHead true allows removing the header column definitions (cTableHead objects `<th>` stored in $this->arrTH) + $bUnsetRow true allows removing the default row definition (cTableRow object `<tr>` stored in $this->row) When you want to re-use the same table several times, these options allow cleaning the only data cells (or header, row) definitions. If you want reset the entire table, just create a new instance instead of using these options. - -#### Method: AddAttr($attr,$value) - See description in cTableEntity base class. - -#### Method: GetTHrow($id,$class) - This method returns the formatted column headers as one string. (e.g. <tr><th>...</th><th>...</th></tr>) - If the $row property is not defined, this method creates the cTableRow object (with attributes $id and $class). - If the $row property is already defined, this method will use the existing cTableRow object (arguments $id and $class are useless) - -#### Method: GetTDrow($id,$class) - This method returns the formatted column row as one string. (e.g. <tr><td>...</td><td>...</td></tr>) - If the $row property is not defined, this method creates the cTableRow object (with attributes $id and $class). - If the $row property is already definied, this method will use the existing cTableRow object (arguments $id and $class are useless) - -#### Method: GetTHnames() - This returns the column header names in an array, where the array-key is the column key (i.e. the $arrTH key) and the array-value is the column header name (i.e. the <th> content). +#### Methods: + +* **AddAttr($attr,$value)** See description in cTableEntity base class. +* **GetTHrow($id,$class)** This method returns the formatted column headers as one string. (e.g. `<tr><th>...</th><th>...</th></tr>`) If the $row property is not defined, this method creates the cTableRow object (with attributes $id and $class). If the $row property is already defined, this method will use the existing cTableRow object (arguments $id and $class are useless) + +* **GetTDrow($id,$class)** This method returns the formatted column row as one string. (e.g. `<tr><td>...</td><td>...</td></tr>`) If the $row property is not defined, this method creates the cTableRow object (with attributes $id and $class). If the $row property is already definied, this method will use the existing cTableRow object (arguments $id and $class are useless) + +* **GetTHnames()** This returns the column header names in an array, where the array-key is the column key (i.e. the $arrTH key) and the array-value is the column header name (i.e. the `<th>` content). #### The advanced methods: - The following advanced methods allows changing all columns at once (you can change the entity, the content or an attribute). - ChangeTHentity($arr,$bCreateColumn,$bNamedColumn): Allows changing the entity in all column header. For example to use the tag <td> instead of the default <th> as column headers. - ChangeTDentity$arr,$bCreateColumn,$bNamedColumn(): Idem for the column cells. - ChangeTHcontent($arr,$bCreateColumn,$bNamedColumn): Allows changing the content of all the column headers at once. It also make possible to create the column headers (if not yet defined) - ChangeTDcontent($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. - ChangeTHattr($arr,$bCreateColumn,$bNamedColumn): Allows changing one attribute value in each column headers (or add one attribute and his value) - ChangeTDattr($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. + +The following advanced methods allows changing all columns at once (you can change the entity, the content or an attribute). +* **ChangeTHentity**($arr,$bCreateColumn,$bNamedColumn): Allows changing the entity in all column header. For example to use the tag <td> instead of the default `<th>` as column headers. +* **ChangeTDentity**($arr,$bCreateColumn,$bNamedColumn(): Idem for the column cells. +ChangeTHcontent($arr,$bCreateColumn,$bNamedColumn): Allows changing the content of all the column headers at once. It also make possible to create the column headers (if not yet defined) +* **ChangeTDcontent**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. +* **ChangeTHattr**($arr,$bCreateColumn,$bNamedColumn): Allows changing one attribute value in each column headers (or add one attribute and his value) +* **ChangeTDattr**($arr,$bCreateColumn,$bNamedColumn): Idem for the column cells. These methods will apply the values provided by $arr, but two options: - $bCreateColumn, when true, will create the missing column objects. - $bNamedColumn, when true, will identify the column by the array-key. When false, the method applies the values of $arr in the sequential order. </pre>q-codeMon, 27 Feb 2012 13:48:36 -0000https://sourceforge.netc840e5b4a58906aaa47c9779cb8dffa0edcdcebahttps://sourceforge.net/p/ctabledynamic/wiki/PageClass/<pre>--- v8 +++ v9 @@ -29,89 +29,89 @@ #### Notes: The cTableEntity is not instantiated directly. The code will rather instantiate other classes that extend this class (see classes documentation here after). -When creating a new entity (for example a <table> entity) you can insert directly the 'id' and 'class' attribute values. To add other attributes, use AddAttr() method. +When creating a new entity (for example a `<table>` entity) you can insert directly the 'id' and 'class' attribute values. To add other attributes, use AddAttr() method. Example: `$t = new cTable('table1','users');` This creates a cTable object and will show `<table id="table1" class="users">` when using the Start() method. ---------------- CLASS: cTableRow (extends cTableEntity) ---------------- -An instance of cTableRow is row object (i.e. a cTableEntity representing a <tr> entity). +An instance of cTableRow is row object (i.e. a cTableEntity representing a `<tr>` entity). See cTableEntity for the description of the properties and methods. ---------------- CLASS: cTableHead (extends cTableEntity) ---------------- -An instance of cTableHead is a column header object (i.e. a cTableEntity representing a <th> entity). +An instance of cTableHead is a column header object (i.e. a cTableEntity representing a `<th>` entity). #### Properties: * **$content** Stores the column header content. * **$link** Stores the column header pattern that must be applied to the content (when there are several rows in the dataset). Example: `$this->link = '<a href="page.php?order=col1">%s</a>';` When the row is displayed, this column content will show a link allowing to click this column header (to change the sort order). ----------------- CLASS: cTableData (extends cTableEntity) ----------------- -An instance of cTableData is a column cell object (i.e. a cTableEntity representing a <td> entity). +An instance of cTableData is a column cell object (i.e. a cTableEntity representing a `<td>` entity). This class also allows defining a list of attribute values that must be applied to certain cells content. For example, in a column, we want a background color for some specific values: Here after, we show how to get a green background for positive value, and a red background when the cell content is negative. #### Properties: * **$content** Stores the column content. * **$dynamicValues** Defines a list of cell values and the corresponding attributes values. -Example: $t->arrTD['col1']->dynamicValues = array('positive'=>'background-color:green','negative'=>'background-color:red'). +Example: `$t->arrTD['col1']->dynamicValues = array('positive'=>'background-color:green','negative'=>'background-color:red');` #### Methods #### Method: AddDynamicAttr($attr,$value) This searches in $dynamicValues the corresponding value, and apply this new value to the attribute $attr. -Ex: $t->arrTD['col1']->AddDynamicAttr('style',($this->content<0 ? 'negative' : 'positive')); +Ex: `$t->arrTD['col1']->AddDynamicAttr('style',($this->content<0 ? 'negative' : 'positive'));` ------------- CLASS: cTable (extends cTableEntity) ------------- -$t = new cTable('table1','class1'); +`$t = new cTable('table1','class1');` When creating an instance of cTable we can assign directly two basic html attributes, the 'id' and the 'class'. Other attributes can be inserted with the AddAttr() method. -This principle is also applicable for all other objects (like a <tr>, <td>, or <th>). +This principle is also applicable for all other objects (like a `<tr>, <td>, or <th>`). #### Properties: * **$row** Stores the default table row definition. It's a cTableRow object. It is not mandatory to instantiated the cTableRow object. If missing, it will be instantiated automatically by the methods GetTHrow() and GetTDrow(). * **$rowcount, $rowcountmin** Stores the number of rows in this table and the minimum number of rows to apply a link in the column headers. For example, when the dataset is empty or when there is only one row in the dataset, the header column cell will not be clickable (no need to sort). * **$activecol** The current active column header. This column header will use the content pattern $activelink instead of his own $link. This active column is identified by the array key of $arrTH. It can be a number or a name (see $arrTH description). * **$activelink** The content pattern to apply to the active column header (if $rowcount>$rowcountmin) #### Property: $arrTH $arrTH is a stack designed to store the column headers definitions. It's an array of cTableHead objects. The cTableHead object (described here after) has 3 basic properties: a content, an id attribute and a class attribute (other html attributes can be added with the AddAttr method) $t->arrTH[0] = new cTableHead('Name','hd0','hd'); $t->arrTH[1] = new cTableHead('Given names','hd1','hd'); $t->arrTH[2] = new cTableHead('Address','hd2','hd'); - Here we store the column headers with a numerical key (the column order: 0,1,...). - When working with a database, it's more easy to use the database fieldname as key. For example: +Here we store the column headers with a numerical key (the column order: 0,1,...). +When working with a database, it's more easy to use the database fieldname as key. For example: $t->arrTH['name'] = new cTableHead('Name','hd0','head'); $t->arrTH['firstname'] = new cTableHead('Given names','hd1','head'); $t->arrTH['address'] = new cTableHead('Address','hd2','head'); - When displaying these column headers, $t->GetTHrow() generates: - - <tr><th id="hd0" class="head">Name</th><th id="hd1" class="head">Given name</th><th id="hd3" class="head">Address</th></tr> +When displaying these column headers, $t->GetTHrow() generates: + + `<tr><th id="hd0" class="head">Name</th><th id="hd1" class="head">Given name</th><th id="hd3" class="head">Address</th></tr>` #### Property: $arrTD $arrTD is a stack designed to store the column cells definitions. It's an array of cTableData objects. </pre>q-codeMon, 27 Feb 2012 13:29:29 -0000https://sourceforge.netf443a136673d31f150afd5f464fc25d9f27d31d0