Formularios Multistep en Symfony 7.4: Más flexibilidad y control
Symfony 7.4 introduce una poderosa mejora en su sistema de formularios: los formularios multistep, también conocidos como form flows. Esta nueva funcionalidad permite dividir formularios extensos en varios pasos conectados, mejorando la experiencia del usuario y la organización del código.
🔍 ¿Qué son los Form Flows?
Los form flows siguen los mismos principios que los formularios tradicionales de Symfony, pero permiten estructurar el proceso en etapas. Cada paso se define como un formulario independiente y se agrega al flujo mediante el método addStep().
$builder->addStep('personal', UserSignUpPersonalType::class);
$builder->addStep('professional', UserSignUpProfessionalType::class);
$builder->addStep('account', UserSignUpAccountType::class);
La clase del formulario extiende AbstractFlowType y utiliza buildFormFlow() en lugar de buildForm().
🧠 Validación por paso
Symfony activa automáticamente el grupo de validación correspondiente al paso actual, lo que permite aplicar reglas específicas en cada etapa del formulario:
#[Valid(groups: ['personal'])] public Personal $personal = new Personal();
🧭 Navegación entre pasos
La navegación se gestiona con botones especializados que extienden ButtonFlowType:
- NextFlowType: avanzar al siguiente paso
- PreviousFlowType: volver al paso anterior
- ResetFlowType: reiniciar el flujo
- FinishFlowType: finalizar el formulario
Estos botones admiten opciones avanzadas como skip, back_to, include_if y clear_submission, ideales para flujos condicionales.
🧪 Ejemplo de uso en controlador
$flow = $this->createForm(UserSignUpType::class, new UserSignUp())
->handleRequest($request);
if ($flow->isSubmitted() && $flow->isValid() && $flow->isFinished()) {
// Procesar datos
}
📚 Recursos adicionales
Mientras se finaliza la documentación oficial, puedes explorar:
- La presentación “FormFlow: Build Stunning Multistep Forms” de SymfonyOnline 2025
- Una demo funcional con ejemplos prácticos
Este avance se inspira en el trabajo de Silas Joisten y Christian Raue, mantenedor del popular CraueFormFlowBundle.
New in Symfony 7.4: Multi-Step Forms (Symfony Blog)
Deja un comentario: