Module: TableHelper

Defined in:: lib/table_helper.rb,
lib/table_helper/row.rb,
lib/table_helper/body.rb,
lib/table_helper/cell.rb,
lib/table_helper/footer.rb,
lib/table_helper/header.rb,
lib/table_helper/version.rb,
lib/table_helper/body_row.rb,
lib/table_helper/html_element.rb,
lib/table_helper/collection_table.rb

Overview

Provides a set of methods for turning a collection into a table

Defined Under Namespace

Classes: Body, BodyRow, Cell, CollectionTable, Footer, Header, HtmlElement, Row, RowBuilder

Constant Summary collapse

VERSION =

'0.3.0'

Instance Method Summary collapse

#collection_table(collection, klass = nil, html_options = {}, &block) ⇒ Object

Generates a new table for the given collection.

Instance Method Details

#collection_table(collection, klass = nil, html_options = {}, &block) ⇒ `Object`

Generates a new table for the given collection.

Basic Example

This example shows the most basic usage of collection_table which takes information about a collection, the objects in them, the columns defined for the class, and generates a table based on that.

Suppose you have a table generated by a migration like so:

class CreatePeople < ActiveRecord::Base
  def self.up
    create_table do |t|
      t.string :first_name
      t.string :last_name
      t.integer :company_id
      t.string :role
    end
  end
end

…then invoking the helper within a view:

<%= collection_table Person.find(:all) %>

…is compiled to (formatted here for the sake of sanity):

<table cellpadding="0" cellspacing="0" class="posts ui-collection">
<thead>
  <tr>
    <th class="person-first_name" scope="col">First Name</th>
    <th class="person-last_name" scope="col">Last Name</th>
    <th class="person-company_id" scope="col">Company</th>
    <th class="person-role" scope="col">Role</th>
  </tr>
</thead>
<tbody>
  <tr class="person ui-collection-result">
    <td class="person-first_name">John</td>
    <td class="person-last_name">Doe</td>
    <td class="person-company_id">1</td>
    <td class="person-role">President</td>
  </tr>
  <tr class="person ui-collection-result">
    <td class="first_name">Jane</td>
    <td class="last_name">Doe</td>
    <td class="company_id">1</td>
    <td class="role">Vice-President</td>
  </tr>
</tbody>
<table>

Advanced Example

This example below shows how collection_table can be customized to show specific headers, content, and footers.

<%=
  collection_table(@posts, :id => 'posts', :class => 'summary') do |t|
    t.header :title
    t.header :category
    t.header :author
    t.header :publish_date, 'Date<br \>Published'
    t.header :num_comments, '# Comments'
    t.header :num_trackbacks, '# Trackbacks'

    t.rows.alternate = :odd
    t.rows.each do |row, post, index|
      row.category       post.category.name
      row.author         post.author.name
      row.publish_date   time_ago_in_words(post.published_at)
      row.num_comments   post.comments.empty? ? '-' : post.comments.size
      row.num_trackbacks post.trackbacks.empty? ? '-' : post.trackbacks.size
    end
  end
%>