Module: Formtastic::Helpers::ErrorsHelper

Includes:
LocalizedString
Included in:
FormBuilder
Defined in:
lib/formtastic/helpers/errors_helper.rb

Constant Summary collapse

INLINE_ERROR_TYPES =
[:sentence, :list, :first]

Instance Method Summary collapse

Methods included from LocalizedString

#model_name

Instance Method Details

#semantic_errors(*args) ⇒ Object

Generates an unordered list of error messages on the base object and optionally for a given set of named attribute. This is idea for rendering a block of error messages at the top of the form for hidden/special/virtual attributes (the Paperclip Rails plugin does this), or errors on the base model.

A hash can be used as the last set of arguments to pass HTML attributes to the <ul> wrapper.

Examples:

A list of errors on the base model

<%= semantic_form_for ... %>
  <%= f.semantic_errors %>
  ...
<% end %>

A list of errors on the base and named attributes

<%= semantic_form_for ... %>
  <%= f.semantic_errors :something_special %>
  ...
<% end %>

A list of errors on the base model, with custom HTML attributes

<%= semantic_form_for ... %>
  <%= f.semantic_errors :class => "awesome" %>
  ...
<% end %>

A list of errors on the base model and named attributes, with custom HTML attributes

<%= semantic_form_for ... %>
  <%= f.semantic_errors :something_special, :something_else, :class => "awesome", :onclick => "Awesome();" %>
  ...
<% end %>


42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
# File 'lib/formtastic/helpers/errors_helper.rb', line 42

def semantic_errors(*args)
  html_options = args.extract_options!
  args = args - [:base]
  full_errors = args.inject([]) do |array, method|
    attribute = localized_string(method, method.to_sym, :label) || humanized_attribute_name(method)
    errors = Array(@object.errors[method.to_sym]).to_sentence
    errors.present? ? array << [attribute, errors].join(" ") : array ||= []
  end
  full_errors << @object.errors[:base]
  full_errors.flatten!
  full_errors.compact!
  return nil if full_errors.blank?
  html_options[:class] ||= "errors"
  template.(:ul, html_options) do
    full_errors.map { |error| template.(:li, error) }.join.html_safe
  end
end