Overriding checkbox form field producing duplicate label and no field in Symfony 4.4

Question

I am having trouble overriding a checkbox field in my Symfony form inside my Twig template.

I am building the field with the following code in my Twig template:

{{ form_row(form.legal, {
   'label' : 'personal.form.fields.legal'|trans,
}) }}

In the same template I have the following block where I am attempting to customise the label. Note the translation above includes HTML which is why I need the raw filter.

{% block _crmpiccobundle_details_legal_label %}
    {% apply spaceless %}
        <label{% with { attr: label_attr } %}{{ block('attributes') }}{% endwith %}>
            {{ label|unescape|raw }}
        </label>
    {% endapply %}
{%- endblock %}

Unfortunately, this doesn't work and bizarrely leaves me with no checkbox and a duplicate label and I can't work out why.

I think you need to add {{- widget|raw }} in front of {{ label|unescape|raw }} — Vyctorya, Apr 07 '21 at 11:50
@Vyctorya Thanks for the comment, but this didn't have any effect. Also, i'm not sure it's valid syntax. — crmpicco, Apr 08 '21 at 02:59

score 0 · Answer 1 · answered Apr 09 '21 at 05:12

Looks like you are using a bootstrap based form theme (like bootstrap_4_layout.html.twig or bootstrap_3_layout.html.twig)

Try doing like this:

{% block _crmpiccobundle_details_legal_label %}
    {%- if widget is defined -%}
        {{ widget|raw }}
        
        {% apply spaceless %}
            <label{% with { attr: label_attr } %}{{ block('attributes') }}{% endwith %}>
                {{ label|unescape|raw }}
            </label>
        {% endapply %}
        
    {%- endif -%}
{%- endblock %}

In bootstrap layout, widget part needs to be wrapped into label, so the theme calls the same block twice, first for _label part and second time for _widget. For the second call, theme provides widget variable, which you have to render yourself (otherwise you wouldn't see your checkbox). Also, you have to suppress label being rendered twice, which could be done just by checking whether widget is defined.

See how the original block also checks whether widget is defined to avoid double label rendering:

https://github.com/symfony/symfony/blob/e2f430dfb4c0c8cdde01ed111f4f0851e268ab5a/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_3_layout.html.twig#L83

Overriding checkbox form field producing duplicate label and no field in Symfony 4.4

1 Answers1