Difference: TablePlugin (15 vs. 16)

Revision 162002-12-17 - PeterThoeny

Line: 1 to 1
 

Table Plugin

Gives extra control of table display:

  • Allows sorting
  • Changing table properties like border width, cell spacing and cell padding
Changed:
<
<
  • Changing background color for header cells
  • Changing background color for data cells - colors can alternate
  • Behaviour can be specified for a specific table using %TABLE{...}% or with global preferences
>
>
  • Changing background color and text color for header cells
  • Changing background color and text color for data cells - colors can alternate
  • Table attributes can be set and overridden in this order:
    • Default TABLEATTRIBUTES Plugin setting in this topic.
    • A TABLEATTRIBUTES preferences setting on site-level (TWikiPreferences) or web-level (any WebPreferences), e.g.
      • Set TABLEATTRIBUTES = tableborder="0" cellpadding="1" ...
    • Before a table using %TABLE{...}%
 
Added:
>
>

Sorting

Click on column heading text to sort by a column. Initial column will be sorted in descending order, click again to get ascending order. The type of data in the cell is determined automatically:

  • date if format is:
    • dd MMM YYY - hh:mm
    • dd-MMM-YY or dd-MM-YYYY (can be / or space in place of -)
    • MMM is Jan, Feb, etc
  • number is digits, with optional decimal point
  • otherwise treated as text
 

TablePlugin Global Settings

Line: 20 to 34
 
  • Set DEBUG to 1 to get debug messages in data/debug.txt. Default: 0
    • Set DEBUG = 0
Deleted:
<
<
  • Table border width. Default: 1
    • Set TABLEBORDER = 1

  • Table cell padding. Default: 0
    • Set CELLPADDING = 0

  • Table cell spacing. Default: 1
    • Set CELLSPACING = 1

  • Table width, e.g. 100% for relative, 640 for absolute width. Default: (not set)
    • Set TABLEWIDTH =

  • Vertical alignment of cells. Set to: top, middle, bottom or baseline; default: (empty)
    • Set VALIGN =

  • Table header cell alignment. Set to: left, center, right or justify; default: (empty)
    • Set HEADERALIGN =

  • Table data cell alignment. Set to: left, center, right or justify; default: (empty)
    • Set DATAALIGN =

  • Background color of header cells ('*'s around text). Choose one of the StandardColors. Default: #99CCCC
    • Set HEADER_BG =

  • Text color of header cells ('*'s around text). Default: not specified, e.g. determined by the browser
    • Set HEADER_COLOR =

  • Background color of table rows, two alternate colors. Default: #FFFFCC, #FFFFFF
    • Set DATA_BG = #FFFFCC, #FFFFFF

  • Text color of table rows, alternate colors. Default: not specified, e.g. determined by the browser
    • Set DATA_COLOR =
 
  • Make sortable:
    • #Set SORT = attachments
    • Set SORT = all
    • #Set SORT = none
Changed:
<
<

Sorting

>
>
  • Default table attributes:
    • Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="1" headerbg="#99CCCC" databg="#FFFFCC, #FFFFFF"
 
Deleted:
<
<
Click on column heading text to sort by a column. Initial column will be sorted in descending order, click again to get ascending order. The type of data in the cell is determined automatically:

  • date if format is:
    • dd MMM YYY - hh:mm
    • dd-MMM-YY or dd-MM-YYYY (can be / or space in place of -)
    • MMM is Jan, Feb, etc
  • number is digits, with optional decimal point
  • otherwise treated as text
 
Changed:
<
<

Per Table Settings

>
>

Table Attributes

 
Changed:
<
<
On line before the table use %TABLE{...}%:
>
>
Attributes are defined as a TABLEATTRIBUTES Plugin setting in this topic, a TABLEATTRIBUTES preferences setting, or on line before the table using %TABLE{...}%:
 
Argument Comment Example
sort Set table sorting on or off sort="on"
Line: 92 to 66
 
headerrows Number of header rows to exclude from sort; default 1 headerrows="1"
footerrows Number of footer rows to exclude from sort; default 0 footerrows="1"
Changed:
<
<
All default to the global setting
>
>
The %TABLE{...}% settings override TABLEATTRIBUTES preferences settings, which override the TABLEATTRIBUTES Plugin settings.
 

Example

Line: 128 to 102
 

Plugin Info

Plugin Author: JohnTalintyre, PeterThoeny
Changed:
<
<
Plugin Version: 15 Dec 2002
>
>
Plugin Version: 17 Dec 2002
 
Change History:
<-- specify latest version first -->
 
Added:
>
>
17 Dec 2002: PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting
 
15 Dec 2002: PTh: Added headerrows and footerrows params (TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann)
09 Dec 2002: PTh: Added headercolor and datacolor parameters
05 Jun 2002: PTh: Added "none" value to databg parameter (suggested by TWiki:Main/TaitCyrus); fixed sorting by stripping HTML tags, removing links and making sort ignore case (suggested by TWiki:Main/ShawnBradford)
Line: 149 to 124
 Related Topics: TWikiPreferences, TWikiPlugins, StandardColors

-- JohnTalintyre - 07 Oct 2001

Changed:
<
<
-- PeterThoeny - 15 Dec 2002
>
>
-- PeterThoeny - 17 Dec 2002
 
META FILEATTACHMENT attr="" comment="Up arrow" date="1005707580" name="up.gif" path="C:\Data\Temp\up.gif" size="876" user="PeterThoeny" version="1.1"
META FILEATTACHMENT attr="" comment="Down arrow" date="1005707591" name="down.gif" path="C:\Data\Temp\down.gif" size="869" user="PeterThoeny" version="1.1"
META FILEATTACHMENT attr="" comment="Diamond symbol" date="1005707607" name="diamond.gif" path="C:\Data\Temp\diamond.gif" size="881" user="PeterThoeny" version="1.1"
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TablePlugin.