如何确保 Symfony 表单不包含不必要的元素?

How to make sure that a Symfony form does not contain unnecessary elements?

我是 Symfony 的初学者,所以这个问题对于那些对这个框架更有经验的人来说可能很简单。

我正在构建表单,并且我在表单中有几种可能的项目类型。目前这些是:

不过,以后还会有更多的项目。以前,该项目将所有项目生成到它们的位置(文本、html 和图像)并隐藏特定表单项目不需要的项目(最多需要一个)。但是,我打算避免添加不需要的项目。由于我不知道在buildForm点任意项目是运行是文本,html还是图像,所以在这一点上它们都被添加了(我知道这是违反直觉,但这是我尝试重构的代码):

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder->add('layoutTypeInput', TextType::class);

    $builder->add('blockTypeOutput', EntityType::class, array(
        'class' => 'MyPageBundle:BlockTypeOutput',
        'choice_label' => 'titleHu',
        'required' => false,
        'placeholder' => 'Válassz blokk kimenetet!',
        'empty_data' => null,
    ));

    $builder->add('text', TextType::class, $this->getBlockTypeOptions('text'));

    $builder->add('html', TextareaType::class, $this->getBlockTypeOptions('html'));

    $builder->add('image', ImageSelectType::class, $this->getBlockTypeOptions('image'));

    $builder->addEventListener(FormEvents::POST_SET_DATA, array($this, 'onPostSetData'));
    $builder->addEventListener(FormEvents::PRE_SUBMIT, array($this, 'onPreSubmit'));
}

现在,我有一个函数可以删除 form:

中不必要的元素
private function removeUnnecessaryItems(\Symfony\Component\Form\FormInterface $form, $key)
{
    $keys = ['text', 'html', 'image'];
    foreach ($keys as $k) {
        if ($key !== $k) $form->remove($k);
    }
}

在里面 onPostSetData 我这样称呼它:

    $this->removeUnnecessaryItems($form, $inputObject->getLayoutTypeIdText());

最后,在树枝中,我确定应该将什么生成为以下形式:

            {% for ioLayoutBlock in form.ioLayoutBlocks %}
                <div class="row">
                    <div class="col-xs-12 col-md-3">
                        {{ form_errors(ioLayoutBlock.layoutTypeInput) }}
                        {{ioLayoutBlock.layoutTypeInput.vars.label}}
                    </div>
                    {{ form_widget(ioLayoutBlock.layoutTypeInput, {'attr' : {'class':'hidden'}}) }}
                    <div class="col-xs-12 col-sm-6 col-md-5">
                        {{ form_errors(ioLayoutBlock.blockTypeOutput) }}
                        {{ form_widget(ioLayoutBlock.blockTypeOutput, {'attr' : {'class':'blockTypeOutput'}}) }}
                    </div>
                    <div class="col-xs-12 col-sm-6 col-md-4">
                        {% if ioLayoutBlock.text is defined %}
                            {{ form_errors(ioLayoutBlock.text) }}
                            {{ form_widget(ioLayoutBlock.text, {'attr':{'class':'hidden uniqueInput ioLayoutBlock_text' }}) }}
                        {% elseif ioLayoutBlock.html is defined %}
                            {{ form_errors(ioLayoutBlock.html) }}
                            {% if layout.layoutType.name == 'userHTML' %}
                                <div class="input-group ioLayoutBlock_html hidden">
                                    <a class="input-group-addon myAdminForm" target="_blank" data-my-href="page/{{ page.id }}/wysiwyg/{{ layout.id }}"><span class="glyphicon glyphicon-pencil"></span></a>
                                    {{ form_widget(ioLayoutBlock.html, {'attr':{'class':'uniqueInput wysiwyg' }}) }}
                                </div>
                            {% else %}
                                {{ form_widget(ioLayoutBlock.html, {'attr':{'class':'hidden uniqueInput wysiwyg ioLayoutBlock_html' }}) }}
                            {% endif %}
                        {% elseif ioLayoutBlock.image is defined %}
                            {{ form_errors(ioLayoutBlock.image) }}
                            {{ form_widget(ioLayoutBlock.image, {'attr':{'class':'hidden uniqueInput ioLayoutBlock_image' }}) }}
                        {% endif %}
                    </div>
                </div>
            {% endfor %}

如果我加载页面,一切都会正确显示,但不幸的是,当我尝试提交 form 时,它给出了

的错误

This form should not contain extra fields.

是我拥有的 form 物品的倍数。如果我在 onPostSetData 中注释掉对 removeUnnecessaryItems 的调用,然后从树枝中删除条件,例如:

{% if ioLayoutBlock.text is defined %}

然后一切正常,但这就是重构之前的工作方式。理想情况下,我想避免在 buildForm 处添加这么多不必要的东西,但我不知道如何在那里加载任何有意义的数据以确定项目的类型。或者,我想确保在我知道它们类型的事件中成功删除这些项目,而不会出现我上面描述的提交时的表单错误。所以,我的问题是:如何在不被提交错误阻止的情况下避免在我的表单中生成各种不必要的东西?

我的方法是给你的表单一个参数

$form = $this->createForm(DynamicType::class, $user, [
    'layout_type_id' => $layoutTypeIdText,
]),

然后根据参数添加字段

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $this->layout_type = $options['LayoutTypeId'];
    // [...]
    if ($this->layout_type !== 'text' )
        $builder->add('text', TextType::class, $this->getBlockTypeOptions('text'));
        // [...]
    ;
}
public function configureOptions(OptionsResolver $resolver)
{
    $resolver->setDefaults([
        // [...]
        'layout_type_id' => null,
    ]);
}

使用这种方法,好处是您不必在 twig 中复制您的逻辑,表单会获得它需要的字段,因此您可以使用

呈现表单
{{ form_start(form) }}
{{ form_widget(form) }}
{{ form_end(form) }}

对于您的特定情况,您需要避免在 buildForm 中添加项目,以处理 onPreSubmit 中的默认空值(因为如果项目未在 buildForm 中添加,则不会调用转换器)并添加有效项目在预提交。

你使用表单监听器是正确的,它们是你的用例的方式。 我看到 2 个子场景:

  • 表单数据来自模型,你在控制器中填充它
  • 一个新项目被添加到表单中,client-side(通过原型)。

我从您的示例代码中了解到,用户无法动态添加新项目。如果你想这样做,代码略有不同。

仍然是第一种情况。诀窍不是删除,而是在 PRE_SET_DATA 侦听器中添加表单:

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder->add('layoutTypeInput', TextType::class);

    $builder->add('blockTypeOutput', EntityType::class, array(
        'class' => 'MyPageBundle:BlockTypeOutput',
        'choice_label' => 'titleHu',
        'required' => false,
        'placeholder' => 'Válassz blokk kimenetet!',
        'empty_data' => null,
    ));

    $builder->addEventListener(FormEvents:: PRE_SET_DATA, array($this, 'onPreSetData'));
    // ...
}

public function onPreSetData(FormEvent $event)
{
    $data = $event->getData(); // This contains model data (ie., from controller)
    $form = $event->getForm();

    $type = 'image'; // Read type from your model

    $formType = $this->getFormTypeForType($type);

    $builder->add($type, formType, $this->getBlockTypeOptions($type));
}

private function getFormTypeForType($type)
{
    switch ($type) {
        case 'image':
            return ImageSelectType::class;
        // ...
        default:
            // Up to you, you can decide on setting a default type or enforcing that the type is correct
            throw new \RuntimeException('Unsupported type');
    }
}

使用该代码,您可以保留相同的 Twig。

我不确定你想用 layoutTypeInputblockTypeOutput 做什么。也许我们在这里只是部分回答,请不要犹豫发布完整的用例。