symfony-collection
A jQuery plugin for managing dynamic form collections in Symfony applications with add, delete, move, and drag-drop functionality.
What is symfony-collection?
Symfony Collection is a jQuery plugin that manages dynamic form collections in Symfony applications. It provides an interface for adding, deleting, moving, and reordering collection elements while handling the underlying field name updates and DOM manipulation required by Symfony's form system.
Symfony developers building forms with dynamic collections, such as multi-field inputs, nested forms, or repeatable sections that require user interaction for management.
It simplifies the complex JavaScript needed to manage Symfony form collections, offering drag-drop support, customizable buttons, and seamless integration with Symfony's form themes and Doctrine entities.
Overview
[NOT MAINTAINED] A jQuery plugin that manages adding, deleting and moving elements from a Symfony form collection
Use Cases
Best For
- Managing dynamic form collections in Symfony applications
- Implementing drag-and-drop reordering for form elements
- Building nested or multi-level form collections
- Creating repeatable input sections with add/remove functionality
- Integrating position-aware collections with Doctrine entities
- Customizing form collection UI with Twig templates
Not Ideal For
- Projects using modern JavaScript frameworks like React or Vue.js, as it's tightly coupled with jQuery and Symfony's form system.
- Applications requiring zero client-side JavaScript or full server-side rendering, since the plugin depends on jQuery for dynamic interactions.
- Teams seeking a lightweight, framework-agnostic solution, due to its dependencies on jQuery and Symfony-specific integration.
- High-performance web apps where minimizing JavaScript overhead is critical, given jQuery's size and the plugin's DOM manipulation.
Pros & Cons
Pros
Automatically handles field name updates and DOM manipulation aligned with Symfony's form collections, reducing the need for custom JavaScript as described in the basic usage section.
Allows full control over button placement, styling, and behavior through configuration options and Twig themes, with examples for custom layouts and drag-drop support.
Integrates with jQuery UI for intuitive reordering when available, including customizable sortable options via the drag_drop_settings.
Provides before/after callbacks for add, remove, and move operations, enabling custom validation or side effects without modifying core plugin code.
Cons
Requires jQuery and optionally jQuery UI, adding bloat and compatibility issues for modern projects using lighter libraries or framework-specific tools.
Configuring nested collections or custom form themes involves multiple steps, careful selector management, and manual file placement, as highlighted in the installation and advanced usage sections.
Designed exclusively for Symfony applications, making it unusable with other PHP frameworks or non-PHP projects without significant adaptation.
Frequently Asked Questions
Related Projects
jquery-ui-railsjQuery UI for the Rails asset pipeline
jquery-railsA gem to automate using jQuery with Rails
PHP front end setup without NodeTutorial how to combine BowerPHP, Mini-Asset and Robo.li into a PHP front end asset building pipeline
cheeriojQuery for server-side manipulations. It makes possible to construct jQuery instance from HTML string then query and manipulate it. Does not implement ajax and effects API
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.