QFQ

h1. Renderer Refactoring

{toc}

Branch: https://git.math.uzh.ch/typo3/qfq/-/tree/F17252_Renderer_Refactoring

h2. Motivation

To achieve a more modern look and feel, QFQ Forms should support Bootstrap 5 in addition to the previously used Bootstrap 3.

However, implementing this functionality into the current codebase while still practicing "clean code" is not possible.

Therefore the current code is being refactored to support future expansion.

h2. Concept

Previously, preparation and rendering of the form with all its form elements was handled in AbstractBuildForm.php and BuildFormBootstrap.php.

The new concept introduces many new classes, making the code much more modular.

Most notably: *Separating Configuration and Rendering of Form and FormElements* !

By doing this, new Renderer Classes can be implemented in the future, which use the same AbstractFormElement objects to render the element in a different way (e.g. Bootstrap 5).

h3. Class diagram

See the class diagram below:

!renderer_class_diagram_update_2024.drawio.png!

h3. Sequence Diagram Form and FormElement Instantiation

tbd

h3. Sequence Diagram Rendering

The diagram below describes the rendering process.

* The BaseRenderer (or any specific implementation of it) takes the previously instantiated Form object that describes all aspects of the form that is to be rendered.

!renderer_sequence_diagram_update_2024.drawio.png!