class FieldTable

A simple HTML table with three columns: label, contents, and (optionally) note. Each row is called a field. The last row can optionally contain “buttons” (actually any widget will do) that are all shown in the 2nd column. It's all surrounded with a fieldset element for a title.

In ASCII art, it looks something like this:

There are two ways to create a FieldTable.

Pass a block in to the constructor.
Make a subclass.

In both cases you'll want to call the “field” and “button” methods on the table. This sets up the contents which will be rendered later during #content. If you make a subclass (#2) you can do this either in the constructor or in the content method before you call super.

The FieldTable is surrounded by a fieldset element whose legend is the “title” instance variable. Inside this fieldset is a table element. Each field (row of the table) has a label (th), a content cell (td), and an optional note (td).

If you call “button” you can pass in a block that'll get rendered inside the 2nd column of the last row. The idea here is that you might want to make an HTML form that has a bunch of buttons at the bottom (Save, Cancel, Clear) and these all go in the same cell, with no label for the row.

TODO: error messages? @author Alex Chaffee

Public Class Methods

new(*args) { |self| ... } click to toggle source

Pass in a block and it'll get called with a pointer to this table, so you can call 'field' and 'button' to configure it

# File lib/erector/widgets/field_table.rb, line 77
def initialize(*args)
  super
  @fields = []
  @buttons = []
  yield self if block_given? # invoke the configuration block
end

Public Instance Methods

button(&button_proc) click to toggle source

TODO: allow passing in a widget instead of a block

# File lib/erector/widgets/field_table.rb, line 69
def button(&button_proc)
  @buttons << button_proc
end

content() click to toggle source

# File lib/erector/widgets/field_table.rb, line 84
def content
  fieldset :class => "field_table" do
    legend @title
    table :width => '100%' do
      @fields.each do |f|
        widget f
      end
      unless @buttons.empty?
        tr :class => "field_table_buttons" do
          td :colspan => 2, :align => "right" do          
            table :class => 'layout' do
              tr do
                @buttons.each do |button|
                  td :class => "field_table_button" do
                    button.call
                  end
                end
              end
            end
          end
        end
      end
    end
  end
end

field(label = nil, note = nil, &contents) click to toggle source

Define a field, containing a label, optional note, and block for the contents

TODO: allow passing in a widget instead of a block

# File lib/erector/widgets/field_table.rb, line 60
def field(label = nil, note = nil, &contents)
  @fields << Field.new(:label => label, :note => note, &contents)
end