From 5350f4960ebd9ae715ec8ee95fac31764e6f45fb Mon Sep 17 00:00:00 2001 From: PeterThoeny Date: Tue, 17 Dec 2002 22:38:12 +0000 Subject: [PATCH] none --- TWiki/TablePlugin.mdwn | 138 +++++++++++++++++++++---------------------------- 1 file changed, 58 insertions(+), 80 deletions(-) diff --git a/TWiki/TablePlugin.mdwn b/TWiki/TablePlugin.mdwn index 8a8c3b5..0104b49 100644 --- a/TWiki/TablePlugin.mdwn +++ b/TWiki/TablePlugin.mdwn @@ -4,9 +4,24 @@ Gives extra control of table display: - Allows sorting - Changing table properties like border width, cell spacing and cell padding -- 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{...}%` + +## 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 ## %TOPIC% Global Settings @@ -18,58 +33,17 @@ Plugin settings are stored as preferences variables. To reference a plugin setti - Set DEBUG to 1 to get debug messages in `data/debug.txt`. Default: `0` - Set DEBUG = 0 -- 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 -## 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 +- Default table attributes: + - Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="1" headerbg="#99CCCC" databg="#FFFFCC, #FFFFFF" -## Per Table Settings +## Table Attributes -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{...}%`: @@ -164,7 +138,7 @@ On line before the table use `%TABLE{...}%`:
-All default to the global setting +The `%TABLE{...}%` settings override `TABLEATTRIBUTES` preferences settings, which override the `TABLEATTRIBUTES` Plugin settings. ## Example @@ -280,74 +254,78 @@ Line before table: `%TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacin Plugin Version: - 15 Dec 2002 + 17 Dec 2002 Change History:   - 15 Dec 2002: - PTh: Added headerrows and footerrows params (TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) + 17 Dec 2002: + PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting - 09 Dec 2002: - PTh: Added headercolor and datacolor parameters + 15 Dec 2002: + PTh: Added headerrows and footerrows params (TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) - 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) + 09 Dec 2002: + PTh: Added headercolor and datacolor parameters - 13 Mar 2002: - PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection + 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) - 12 Mar 2002: - PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value + 13 Mar 2002: + PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection - 05 Jan 2002: - PTh: Fixed sorting bug of cells with leading white space + 12 Mar 2002: + PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value - 06 Dec 2001: - PTh: Fixed date sorting bug
03 Dec 2001 PTh: Fixed sort="off" bug and more + 05 Jan 2002: + PTh: Fixed sorting bug of cells with leading white space - 29 Nov 2001: - PTh: Fixed Perl warnings + 06 Dec 2001: + PTh: Fixed date sorting bug
03 Dec 2001 PTh: Fixed sort="off" bug and more - 16 Nov 2001: - PTh: Added table border, cell spacing, cell padding, gif files + 29 Nov 2001: + PTh: Fixed Perl warnings - 07 Oct 2001: - JT: Initial version + 16 Nov 2001: + PTh: Added table border, cell spacing, cell padding, gif files - CPAN Dependencies: - none + 07 Oct 2001: + JT: Initial version - Other Dependencies: + CPAN Dependencies: none - Perl Version: - 5.0 + Other Dependencies: + none + + + Perl Version: + 5.0 - Plugin Home: - http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% + Plugin Home: + http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% - Feedback: - http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev + Feedback: + http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev **_Related Topics:_** [[TWikiPreferences]], [[TWikiPlugins]], [[StandardColors]] --- [[JohnTalintyre]] - 07 Oct 2001
-- [[PeterThoeny]] - 15 Dec 2002
+-- [[JohnTalintyre]] - 07 Oct 2001
-- [[PeterThoeny]] - 17 Dec 2002
-- 1.9.4