View on GitHub
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