[Form] Customizing Error Output

[dlondero]

Looks like there's a typo when explaining how to customize error output for global errors in forms.

In the docs you can read:

To override how errors are rendered for all fields, simply copy, paste and customize the form_errors fragment.

and just a few lines below:

To customize only the markup used for these errors, follow the same directions as above, but now call the block form_errors (Twig) / the file form_errors.html.php (PHP).

Both changes apply to form_errors...is that right?

[mtrojanowski]

Actually it was not a typo but some leftovers from the 2.0. documentation. In Sf 2.0. you used two different blocks for customizing errors: field_errors and form_errors with the former applied to fields and the latter to global errors.

As of Sf 2.1. you use only form_errors block and differentiate between different types of errors by checking the value of compound.

From the Upgrade 2.1. doc:

Before:

{% block form_errors %}
    {% spaceless %}
        ... form code ...
    {% endspaceless %}
{% endblock form_errors %}

{% block field_errors %}
    {% spaceless %}
        ... field code ...
    {% endspaceless %}
{% endblock field_errors %}

After:

{% block form_errors %} 
    {% spaceless %}
        {% if compound %}
             ... form code ...
        {% else %}
              ... field code ...
        {% endif %}
    {% endspaceless %}
{% endblock form_errors %}

[dlondero]

I wonder why that's not here. Or am I looking in the wrong place?

[mtrojanowski]

By default the errors are rendered in the same way regardless of the fact if it's a field or global error.

[dlondero]

That's right, so adding that (the compound thingy I mean) to the docs is a must have IMHO.