# Inch CI

Creates a fieldset and ol tag wrapping for use around a set of buttons. It can be
called either with a block (in which you can do the usual Rails form stuff, HTML, ERB, etc),
or with a list of named actions. These two examples are functionally equivalent:

    # With a block:
    <% semantic_form_for @post do |f| %>
      ...
      <% f.actions do %>
        <%= f.action :submit %>
        <%= f.action :cancel %>
      <% end %>
    <% end %>

    # With a list of fields:
    <% semantic_form_for @post do |f| %>
      <%= f.actions :submit, :cancel %>
    <% end %>

    # Output:
    <form ...>
      <fieldset class="buttons">
        <ol>
          <li class="action input_action">
            <input type="submit" ...>
          </li>
          <li class="action link_action">
            <a href="...">...</a>
          </li>
        </ol>
      </fieldset>
    </form>

All options except `:name` and `:title` are passed down to the fieldset as HTML
attributes (`id`, `class`, `style`...). If provided, the `:name` or `:title` option is
passed into a `<legend>` inside the `<fieldset>` to name the set of buttons.

@example Quickly add button(s) to the form, accepting all default values, options and behaviors
    <% semantic_form_for @post do |f| %>
      ...
      <%= f.actions %>
    <% end %>

@example Specify which named buttons you want, accepting all default values, options and behaviors
    <% semantic_form_for @post do |f| %>
      ...
      <%= f.actions :commit %>
    <% end %>

@example Specify which named buttons you want, and name the fieldset
    <% semantic_form_for @post do |f| %>
      ...
      <%= f.actions :commit, :name => "Actions" %>
      or
      <%= f.actions :commit, :label => "Actions" %>
    <% end %>

@example Get full control over the action options
    <% semantic_form_for @post do |f| %>
      ...
      <%= f.actions do %>
        <%= f.action :label => "Go", :button_html => { :class => "pretty" :disable_with => "Wait..." }, :wrapper_html => { ... }
      <% end %>
    <% end %>

@example Make your own actions with standard Rails helpers or HTML
    <% semantic_form_for @post do |f| %>
      <%= f.actions do %>
        <li>
          ...
        </li>
      <% end %>
    <% end %>

@example Add HTML attributes to the fieldset
    <% semantic_form_for @post do |f| %>
      ...
      <%= f.actions :commit, :style => "border:1px;" %>
      or
      <%= f.actions :style => "border:1px;" do %>
        ...
      <% end %>
    <% end %>

@option *args :label [String, Symbol]
  Optionally specify text for the legend of the fieldset

@option *args :name [String, Symbol]
  Optionally specify text for the legend of the fieldset (alias for `:label`)

@todo document i18n keys