html-table 1.5.0 → 1.5.1

data/doc/table_row.rdoc

@@ -1,105 +1,105 @@
-= Description
-   A Table::Row object represents a single <TR></TR> instance for an HTML
-   Table.  Although it is nested under Table, it is not a subclass of Table.
-   It is, however, a subclass of Array.
-
-== Synopsis
-   require "html/table"
-   include HTML
-
-   table = HTML::Table.new
-
-   row1 = Table::Row.new{ |r|
-      r.align   = "left"
-      r.bgcolor = "green"
-      r.content = ["foo","bar","baz"]
-   }
-
-   row2 = Table::Row.new{ |r|
-      r.align   = "right"
-      r.bgcolor = "blue"
-      r.content = "hello world"
-   }
-
-   table.push row1, row2
-
-   row1.content = "foofoo"
-   row1.configure(3){ |d| d.bgcolor = "pink" }
-
-   row1.push Table::Row::Header.new{ |h|
-      h.colspan = 2
-      h.content = "This is a table header"
-   }
-
-   row2.push Table::Row::Header.new{ |h|
-      h.colspan = 2
-      h.content = "This is also a table header"
-   }
-
-   puts table.html
-
-   #### output ####
-   <table>
-      <tr align='left' bgcolor='green'>
-         <td>foo</td>
-         <td>bar</td>
-         <td>baz</td>
-        <td bgcolor='pink'>foofoo</td>
-         <th colspan=2>This is a table header</th>
-      </tr>
-      <tr align='right' bgcolor='blue'>
-        <td>hello world</td>
-         <th colspan=2>This is also a table header</th>
-      </tr>
-   </table>
-
-   See the 'examples' directory for more examples.
-
-== Mixins
-   Table::Row is a subclass of Array and therefore mixes in Enumerable.  It
-   also mixes in Attribute_Handler.
-
-== Class Methods
-Table::Row.new(arg=nil)
-Table::Row.new(arg=nil){ |t| ... }
-    Creates a new table.  You can set attributes for the TableRow by passing
-    a block.
-    
-    If +arg+ is supplied, it is automatically interpreted to be content.
-    This is a shortcut for Table::Row.new{ |r| r.content = '...' }.
-
-== Instance Methods
-Table::Row#[]=(index,obj)
-   Assigns +obj+ to index.  The +obj+ must be a Table::Row::Header or
-   Table::Row::Data object, or a TypeError is raised.
-
-Table::Row#content
-   Returns the HTML content of the TableRow instance, i.e. the stuff between
-   the <TR> and </TR> tags.
-
-Table::Row#content=(args)
-   Because a Table::Row doesn't store any of its own content, the arguments
-   to this method must be a Table::Row::Data object, a Table::Row::Header
-   object, or a String (or an array of any of these).  In the latter case,
-   a single Table::Row::Data object is created for each string.
-
-Table::Row#html
-   Returns the entire HTML content of the TableRow instance.
-
-Table::Row#push(obj)
-   Pushes +obj+ onto the Table::Row. The +obj+ must be a
-   Table::Row::Data or Table::Row::Header object, or a TypeError is
-   raised.
-
-Table::Row#unshift(obj)
-   Unshifts +obj+ onto the Table::Row.  The same rules for push apply
-   to unshift as well.
-
-== Notes
-   String attributes are quoted.  Numeric attributes are not.
-
-   Some attributes have type checking.  Some check for valid arguments.  In
-   the latter case, it is case-insensitive.
-
-   Using a non-standard extension (e.g. "background") will send a warning to
-   STDERR in $VERBOSE (-w) mode.
+= Description
+   A Table::Row object represents a single <TR></TR> instance for an HTML
+   Table.  Although it is nested under Table, it is not a subclass of Table.
+   It is, however, a subclass of Array.
+
+== Synopsis
+   require "html/table"
+   include HTML
+
+   table = HTML::Table.new
+
+   row1 = Table::Row.new{ |r|
+      r.align   = "left"
+      r.bgcolor = "green"
+      r.content = ["foo","bar","baz"]
+   }
+
+   row2 = Table::Row.new{ |r|
+      r.align   = "right"
+      r.bgcolor = "blue"
+      r.content = "hello world"
+   }
+
+   table.push row1, row2
+
+   row1.content = "foofoo"
+   row1.configure(3){ |d| d.bgcolor = "pink" }
+
+   row1.push Table::Row::Header.new{ |h|
+      h.colspan = 2
+      h.content = "This is a table header"
+   }
+
+   row2.push Table::Row::Header.new{ |h|
+      h.colspan = 2
+      h.content = "This is also a table header"
+   }
+
+   puts table.html
+
+   #### output ####
+   <table>
+      <tr align='left' bgcolor='green'>
+         <td>foo</td>
+         <td>bar</td>
+         <td>baz</td>
+        <td bgcolor='pink'>foofoo</td>
+         <th colspan=2>This is a table header</th>
+      </tr>
+      <tr align='right' bgcolor='blue'>
+        <td>hello world</td>
+         <th colspan=2>This is also a table header</th>
+      </tr>
+   </table>
+
+   See the 'examples' directory for more examples.
+
+== Mixins
+   Table::Row is a subclass of Array and therefore mixes in Enumerable.  It
+   also mixes in Attribute_Handler.
+
+== Class Methods
+Table::Row.new(arg=nil)
+Table::Row.new(arg=nil){ |t| ... }
+    Creates a new table.  You can set attributes for the TableRow by passing
+    a block.
+    
+    If +arg+ is supplied, it is automatically interpreted to be content.
+    This is a shortcut for Table::Row.new{ |r| r.content = '...' }.
+
+== Instance Methods
+Table::Row#[]=(index,obj)
+   Assigns +obj+ to index.  The +obj+ must be a Table::Row::Header or
+   Table::Row::Data object, or a TypeError is raised.
+
+Table::Row#content
+   Returns the HTML content of the TableRow instance, i.e. the stuff between
+   the <TR> and </TR> tags.
+
+Table::Row#content=(args)
+   Because a Table::Row doesn't store any of its own content, the arguments
+   to this method must be a Table::Row::Data object, a Table::Row::Header
+   object, or a String (or an array of any of these).  In the latter case,
+   a single Table::Row::Data object is created for each string.
+
+Table::Row#html
+   Returns the entire HTML content of the TableRow instance.
+
+Table::Row#push(obj)
+   Pushes +obj+ onto the Table::Row. The +obj+ must be a
+   Table::Row::Data or Table::Row::Header object, or a TypeError is
+   raised.
+
+Table::Row#unshift(obj)
+   Unshifts +obj+ onto the Table::Row.  The same rules for push apply
+   to unshift as well.
+
+== Notes
+   String attributes are quoted.  Numeric attributes are not.
+
+   Some attributes have type checking.  Some check for valid arguments.  In
+   the latter case, it is case-insensitive.
+
+   Using a non-standard extension (e.g. "background") will send a warning to
+   STDERR in $VERBOSE (-w) mode.

data/doc/table_row_data.rdoc

@@ -1,92 +1,92 @@
-== Description
-   A Table::Row::Data object represents a single <TD></TD> instance for an HTML
-   Table.  For purposes of html-table, it also represents a "column"
-
-== Synopsis
-   require "html/table"
-   require HTML
-    
-   Table::Row.end_tags = false
-   Table::Row::Data.end_tags = false
-
-   table = Table.new{ |t| t.border = 1 }
-   row = Table::Row.new
-
-   col1 = Table::Row::Data.new{ |d|
-      d.abbr    = "test"
-      d.align   = "right"
-      d.content = "hello world"
-   }
-
-   col2 = Table::Row::Data.new{ |d|
-      d.align   = "center"
-      d.content = "Matz rules!"
-   }
-
-   col3 = Table::Row::Data.new{ |d|
-      d.align   = "left"
-      d.content = "Foo!"
-   }
-
-   row.push col1, col2, col3
-
-   puts table.html
-
-   #### output ####
-   <table border=1>
-      <tr>
-         <td abbr='test' align='right'>hello world
-         <td align='center'>Matz rules!
-         <td align='left'>Foo!
-   </table>
-
-   See the 'examples' directory under 'doc' for more examples.
-
-== Mixins
-   Table::Row::Data mixes in Attribute_Handler.    
-
-== Class Methods
-Table::Row::Data.new(arg=nil)
-Table::Row::Data.new(arg=nil){ |t| ... }
-   Creates a new table.  You can set attributes for the Table::Row::Data by
-   passing a block.
-   
-   If +arg+ is supplied, it is automatically interpreted to be content.
-   This is a shortcut for Table::Row::Data.new{ |d| d.content = '...' }.
-
-Table::Row::Data.end_tags
-   Returns true or false to indicate whether end tags are included or not.
-
-Table::Row::Data.end_tags=(bool)
-   Sets whether or not end tags are included in the html.
-
-Table::Row::Data.indent_level
-   Returns the current number of spaces that <TD> tags are indented.  The
-   default is 6.
-
-Table::Row::Data.indent_level=(num)
-   Sets the number of spaces that <TD> tags are indented.
-
-== Instance Methods
-TableData#content
-   Returns the content of the TableData object, i.e. the stuff between <TD>
-   and </TD>.
-
-Table::Row::Data#content=(string)
-   Sets the content for the TableData object, i.e. the stuff between <TD>
-   and </TD>.
-
-Table::Row::Data#html
-   Returns all html content for the TableData instance.
-
-== Notes
-   The end tags for Table::Row::Data objects are are the same line as the
-   begin tags.
-    
-   String attributes are quoted.  Numeric attributes are not.
-
-   Some attributes have type checking.  Some check for valid arguments.  In
-   the latter case, it is case-insensitive.
-
-   Using a non-standard extension (e.g. "background") will send a warning to
-   STDERR in $VERBOSE (-w) mode.
+== Description
+   A Table::Row::Data object represents a single <TD></TD> instance for an HTML
+   Table.  For purposes of html-table, it also represents a "column"
+
+== Synopsis
+   require "html/table"
+   require HTML
+    
+   Table::Row.end_tags = false
+   Table::Row::Data.end_tags = false
+
+   table = Table.new{ |t| t.border = 1 }
+   row = Table::Row.new
+
+   col1 = Table::Row::Data.new{ |d|
+      d.abbr    = "test"
+      d.align   = "right"
+      d.content = "hello world"
+   }
+
+   col2 = Table::Row::Data.new{ |d|
+      d.align   = "center"
+      d.content = "Matz rules!"
+   }
+
+   col3 = Table::Row::Data.new{ |d|
+      d.align   = "left"
+      d.content = "Foo!"
+   }
+
+   row.push col1, col2, col3
+
+   puts table.html
+
+   #### output ####
+   <table border=1>
+      <tr>
+         <td abbr='test' align='right'>hello world
+         <td align='center'>Matz rules!
+         <td align='left'>Foo!
+   </table>
+
+   See the 'examples' directory under 'doc' for more examples.
+
+== Mixins
+   Table::Row::Data mixes in Attribute_Handler.    
+
+== Class Methods
+Table::Row::Data.new(arg=nil)
+Table::Row::Data.new(arg=nil){ |t| ... }
+   Creates a new table.  You can set attributes for the Table::Row::Data by
+   passing a block.
+   
+   If +arg+ is supplied, it is automatically interpreted to be content.
+   This is a shortcut for Table::Row::Data.new{ |d| d.content = '...' }.
+
+Table::Row::Data.end_tags
+   Returns true or false to indicate whether end tags are included or not.
+
+Table::Row::Data.end_tags=(bool)
+   Sets whether or not end tags are included in the html.
+
+Table::Row::Data.indent_level
+   Returns the current number of spaces that <TD> tags are indented.  The
+   default is 6.
+
+Table::Row::Data.indent_level=(num)
+   Sets the number of spaces that <TD> tags are indented.
+
+== Instance Methods
+TableData#content
+   Returns the content of the TableData object, i.e. the stuff between <TD>
+   and </TD>.
+
+Table::Row::Data#content=(string)
+   Sets the content for the TableData object, i.e. the stuff between <TD>
+   and </TD>.
+
+Table::Row::Data#html
+   Returns all html content for the TableData instance.
+
+== Notes
+   The end tags for Table::Row::Data objects are are the same line as the
+   begin tags.
+    
+   String attributes are quoted.  Numeric attributes are not.
+
+   Some attributes have type checking.  Some check for valid arguments.  In
+   the latter case, it is case-insensitive.
+
+   Using a non-standard extension (e.g. "background") will send a warning to
+   STDERR in $VERBOSE (-w) mode.

data/doc/table_row_header.rdoc

@@ -1,7 +1,7 @@
-== Description
-   A Table::Row::Header object represents a single <TH></TH> instance for
-   an HTML Table.
-
-== Notes
-   The Table::Row::Header class is identical in every way to the
-   Table::Row::Data class, except for the begin and end tags.
+== Description
+   A Table::Row::Header object represents a single <TH></TH> instance for
+   an HTML Table.
+
+== Notes
+   The Table::Row::Header class is identical in every way to the
+   Table::Row::Data class, except for the begin and end tags.

data/examples/advanced.rb

@@ -1,128 +1,128 @@
-##############################################################################
-# advanced1.rb
-#
-# For this example we'll use every feature I can think of to come up with
-# the example found in "HTML: The Definitive Guide", pp. 395-396 (O'Reilly
-# & Associates, 3rd ed).
-#
-# You can run this example via the 'example:advanced' rake task.
-##############################################################################
-require 'html/table'
-include HTML
-
-Table::Row::Data.end_tags   = false
-Table::Row::Header.end_tags = false
-
-# Demonstrates the DSL style syntax
-table = Table.new do
-   border      1
-   cellspacing 0
-   cellpadding 0
-   rules       'groups'
-end
-
-# Demonstrates the use of setters after object creation
-caption = Table::Caption.new
-caption.align = "bottom"
-caption.content = "Kumquat versus a poked eye, by gender"
-
-thead = Table::Head.create
-tbody = Table::Body.new
-tfoot = Table::Foot.create
-
-# Add a row with a td and th, then configure after the fact.
-thead.push Table::Row.new{ |r|
-   r.content = Table::Row::Data.new, Table::Row::Header.new
-}
-
-# And again, longhand
-hrow = Table::Row.new
-h1 = Table::Row::Header.new('Eating Kumquats')
-h2 = Table::Row::Header.new('Poke In The Eye')
-hrow.push h1, h2
-thead.push hrow
-
-# Configure a row after the fact
-thead.configure(0,0){ |d|
-   d.colspan = 2
-   d.rowspan = 2
-}
-
-thead.configure(0,1){ |h|
-   h.colspan = 2
-   h.align   = "center"
-   h.content = "Preference"
-}
-
-# Ugly, but just to show you that it's possible
-tbody.push(
-   Table::Row.new{ |r|
-      r.align = "center"
-      r.content = 
-         Table::Row::Header.new{ |h|
-            h.rowspan = 2
-            h.content = "Gender"
-         },
-         Table::Row::Header.new{ |h| h.content = "Male" },
-         "73%",
-         "27%"
-   }
-)
-
-brow = Table::Row.new{ |r| r.align = "center" }
-bheader = Table::Row::Header.new('Female')
-brow.push(bheader,"16%","84%")
-
-tbody.push(brow)
-
-frow = Table::Row.new{ |r|
-   r.content = Table::Row::Data.new{ |d|
-      d.colspan = 4
-      d.align   = "center"
-      d.content = "Note: eye pokes did not result in permanent injury"
-   }
-}
-
-tfoot[0] = frow
-
-table.push thead, tbody, tfoot
-
-# caption is added last, but does the right thing
-table.push caption
-
-puts table.html
-
-=begin
-### OUTPUT ###
-<table border=1 cellspacing=0 cellpadding=0 rules='groups'>
-   <caption align='bottom'>Kumquat versus a poked eye, by gender</caption>
-   <thead>
-   <tr>
-      <td colspan=2 rowspan=2>
-      <th colspan=2 align='center'>Preference
-   </tr>
-   <tr>
-      <th>Eating Kumquats
-      <th>Poke In The Eye
-   </tr>
-   </thead>
-   <tbody>
-   <tr align='center'>
-      <th rowspan=2>Gender
-      <th>Male
-      <td>73%
-      <td>27%
-   </tr>
-   <tr align='center'>
-      <th>Female
-      <td>16%
-      <td>84%
-   </tr>
-   </tbody>
-   <tfoot>
-   <tr>
-      <td colspan=4 align='center'>Note: eye pokes did not result in permanent injury
-   </tr>
-   </tfoot>
-</table>
-=end
+##############################################################################
+# advanced1.rb
+#
+# For this example we'll use every feature I can think of to come up with
+# the example found in "HTML: The Definitive Guide", pp. 395-396 (O'Reilly
+# & Associates, 3rd ed).
+#
+# You can run this example via the 'example:advanced' rake task.
+##############################################################################
+require 'html/table'
+include HTML
+
+Table::Row::Data.end_tags   = false
+Table::Row::Header.end_tags = false
+
+# Demonstrates the DSL style syntax
+table = Table.new do
+   border      1
+   cellspacing 0
+   cellpadding 0
+   rules       'groups'
+end
+
+# Demonstrates the use of setters after object creation
+caption = Table::Caption.new
+caption.align = "bottom"
+caption.content = "Kumquat versus a poked eye, by gender"
+
+thead = Table::Head.create
+tbody = Table::Body.new
+tfoot = Table::Foot.create
+
+# Add a row with a td and th, then configure after the fact.
+thead.push Table::Row.new{ |r|
+   r.content = Table::Row::Data.new, Table::Row::Header.new
+}
+
+# And again, longhand
+hrow = Table::Row.new
+h1 = Table::Row::Header.new('Eating Kumquats')
+h2 = Table::Row::Header.new('Poke In The Eye')
+hrow.push h1, h2
+thead.push hrow
+
+# Configure a row after the fact
+thead.configure(0,0){ |d|
+   d.colspan = 2
+   d.rowspan = 2
+}
+
+thead.configure(0,1){ |h|
+   h.colspan = 2
+   h.align   = "center"
+   h.content = "Preference"
+}
+
+# Ugly, but just to show you that it's possible
+tbody.push(
+   Table::Row.new{ |r|
+      r.align = "center"
+      r.content = 
+         Table::Row::Header.new{ |h|
+            h.rowspan = 2
+            h.content = "Gender"
+         },
+         Table::Row::Header.new{ |h| h.content = "Male" },
+         "73%",
+         "27%"
+   }
+)
+
+brow = Table::Row.new{ |r| r.align = "center" }
+bheader = Table::Row::Header.new('Female')
+brow.push(bheader,"16%","84%")
+
+tbody.push(brow)
+
+frow = Table::Row.new{ |r|
+   r.content = Table::Row::Data.new{ |d|
+      d.colspan = 4
+      d.align   = "center"
+      d.content = "Note: eye pokes did not result in permanent injury"
+   }
+}
+
+tfoot[0] = frow
+
+table.push thead, tbody, tfoot
+
+# caption is added last, but does the right thing
+table.push caption
+
+puts table.html
+
+=begin
+### OUTPUT ###
+<table border=1 cellspacing=0 cellpadding=0 rules='groups'>
+   <caption align='bottom'>Kumquat versus a poked eye, by gender</caption>
+   <thead>
+   <tr>
+      <td colspan=2 rowspan=2>
+      <th colspan=2 align='center'>Preference
+   </tr>
+   <tr>
+      <th>Eating Kumquats
+      <th>Poke In The Eye
+   </tr>
+   </thead>
+   <tbody>
+   <tr align='center'>
+      <th rowspan=2>Gender
+      <th>Male
+      <td>73%
+      <td>27%
+   </tr>
+   <tr align='center'>
+      <th>Female
+      <td>16%
+      <td>84%
+   </tr>
+   </tbody>
+   <tfoot>
+   <tr>
+      <td colspan=4 align='center'>Note: eye pokes did not result in permanent injury
+   </tr>
+   </tfoot>
+</table>
+=end