Symfony中如何修改ChoiceType单选表单的HTML渲染类？

方法一：自定义表单主题（推荐，灵活可控） #

在渲染表单的模板中，通过覆盖Symfony默认的表单块来定制输出结构和类名：

{# 在表单模板顶部定义表单主题 #}
{% form_theme form _self %}

{# 覆盖expanded模式下ChoiceType的渲染逻辑 #}
{% block choice_widget_expanded %}
    <div {{ block('widget_container_attributes') }}>
        {% for child in form %}
            {# 为每个选项容器添加自定义类，首个选项额外追加mr-1 #}
            <div class="form-check d-inline-block custom-control custom-radio{% if loop.first %} mr-1{% endif %}">
                {# 自定义单选框输入类 #}
                {{ form_widget(child, {'attr': {'class': 'form-check-input custom-control-input'}}) }}
                {# 自定义标签类 #}
                {{ form_label(child, null, {'label_attr': {'class': 'form-check-label required custom-control-label'}}) }}
            </div>
        {% endfor %}
    </div>
{% endblock %}

{# 正常渲染目标表单控件 #}
{{ form_widget(form.test) }}

该方法可完全控制每个元素的HTML结构与类名，适合需要精细定制的场景。

方法二：通过表单构建器配置选项 #

若无需修改HTML结构，仅需追加类名，可在表单构建阶段通过选项直接配置：

$builder->add('test', ChoiceType::class, [
    'choices' => ['a' => 1, 'b' => 2],
    'multiple' => false,
    'mapped' => false,
    'expanded' => true,
    {# 为每个选项容器配置类，首个选项额外添加mr-1 #}
    'choice_attr' => function ($choice, $key, $index) {
        $classList = ['form-check', 'd-inline-block', 'custom-control', 'custom-radio'];
        if ($index === 0) {
            $classList[] = 'mr-1';
        }
        return ['class' => implode(' ', $classList)];
    },
    {# 配置单选框输入的全局类 #}
    'attr' => [
        'class' => 'form-check-input custom-control-input',
    ],
    {# 配置标签的全局类 #}
    'label_attr' => [
        'class' => 'form-check-label required custom-control-label',
    ],
]);

配置完成后，直接使用{{ form_widget(form.test) }}即可生成目标HTML代码。

内容的提问来源于stack exchange，提问作者mbyou