tidy_table 0.0.4 → 0.0.5

data/History.txt

@@ -1,3 +1,7 @@
+== 0.0.5 / 2007-11-14
+
+* Added :title option in initializer. Emits header row spanning all columns.
+
 == 0.0.4 / 2007-06-27
 
 * Changed default table class name to 'tidy_table' for consistency.

data/lib/tidy_table.rb

@@ -1,7 +1,18 @@
 ##
-# Yet another library to convert an ActiveRecord array (or any struct) and output a simple HTML table.
+# This is yet another library to convert an ActiveRecord array (or any struct) 
+# to an HTML table.
 #
-# Can also send the fields back to a block for special formatting.
+# You get a table with a bunch of CSS classes automatically applied (or 
+# customize it with your own classes and ids). For example, first_row (is also
+# a th tag), first_column, last_column, even & odd (for rows).
+#
+# Other tags like thead and tbody may be added in the future.
+#
+# Simple example with an ActiveRecord object:
+#
+#   <%= TidyTable.new(@records).to_html(%w(title description created_at)) %>
+#
+# You also format the row values with a block:
 #
 #   <%= TidyTable.new(@records, :table_class => "revenue_report").to_html(%w(resource visits min max)) do |row|
 #     [
@@ -12,10 +23,14 @@
 #     ]
 #   end %>
 #
+# Or in HAML:
+#
+#   = TidyTable.new(@records, :table_class => "revenue_report").to_html(%w(resource visits min max)) do |row|
+#     - [ row.resource, number_with_delimiter(row.visit_count), row.min, row.max ]
 
 class TidyTable
 
-  VERSION = '0.0.4'
+  VERSION = '0.0.5'
 
   ##
   # Make a new TidyTable with a data array and CSS options.
@@ -24,6 +39,9 @@ class TidyTable
   # * :first_row_class -- Defaults to 'first_row'
   # * :first_column_class -- Defaults to 'first_column'
   # * :last_column_class -- Defaults to 'last_column'
+  # * :title -- Title for this table. Emits an extra header row 
+  #             spanning all columns.
+  # * :title_class -- CSS class for the title th. Default: 'title'
   #
   # You also get 'even' and 'odd' for free (rows only).
   
@@ -33,7 +51,8 @@ class TidyTable
       :table_class => "tidy_table",
       :first_row_class => "first_row",
       :first_column_class => "first_column",
-      :last_column_class => "last_column"
+      :last_column_class => "last_column",
+      :title_class => "title"
     }.merge(options)
   end
 
@@ -55,6 +74,13 @@ class TidyTable
     output = []
     output << %(<table class="#{@options[:table_class]}">)
 
+    # Title
+    if @options.has_key?(:title)
+      output << %(<tr class="#{@options[:first_row_class]}">)
+      output << %(<th class="#{@options[:title_class]} #{@options[:first_row_class]} #{@options[:first_column_class]}" colspan="#{fields.length}">#{@options[:title]}</th>)
+      output << %(</tr>)
+    end
+
     # First row (header)
     output << %(<tr class="#{@options[:first_row_class]}">)
     fields.each_with_index do |field, index|

data/spec/tidy_table_spec.rb

@@ -58,4 +58,10 @@ describe TidyTable do
     }.should raise_error(ArgumentError)
   end
 
+  it "should show title" do
+    t = TidyTable.new(@records, :title => "Report of Doom")
+    output = t.to_html([:title, :description])
+    output.should match(/Report of Doom/)
+  end
+
 end

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.0
+rubygems_version: 0.9.4
 specification_version: 1
 name: tidy_table
 version: !ruby/object:Gem::Version 
-  version: 0.0.4
-date: 2007-06-27 00:00:00 -07:00
+  version: 0.0.5
+date: 2007-11-14 00:00:00 -08:00
 summary: Yet another library for converting a struct into an HTML table.
 require_paths: 
 - lib
@@ -59,5 +59,5 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.2.1
+        version: 1.3.0
     version: