Review main Merged

93292[TASK] Deprecate form editor stage rendering functions

Josua Vogel CR +2 V +2 Hard +507 −444 updated 03/24/26, 06:30

Commit message

The template-based stage rendering approach in the Form Editor is
superseded by the web component-based rendering introduced with
`<typo3-form-form-element-stage-item>` and `<typo3-form-page-stage-item>`
(see Feature #107058). Custom form elements no longer need to register
a `formEditorPartials` Stage entry or subscribe to
`view/stage/abstract/render/template/perform` to obtain a functional
stage representation. The PubSub event itself remains available for
extension authors who require fully custom stage rendering via DOM
manipulation.

Deprecated JavaScript exports from
@typo3/form/backend/form-editor/stage-component:
- eachTemplateProperty()
- renderSimpleTemplate()
- renderSimpleTemplateWithValidators()
- renderCheckboxTemplate()
- renderSelectTemplates()
- renderFileUploadTemplates()
- createAbstractViewFormElementToolbar()

Deprecated Fluid partial templates in
EXT:form/Resources/Private/Backend/Partials/FormEditor/Stage/:
- SimpleTemplate.fluid.html
- SelectTemplate.fluid.html
- FileUploadTemplate.fluid.html
- ContentElement.fluid.html
- Fieldset.fluid.html
- StaticText.fluid.html
- Page.fluid.html
- SummaryPage.fluid.html
- _ElementToolbar.fluid.html
- _UnknownElement.fluid.html

Internal improvements are made alongside the deprecations:

* The `_UnknownElement` fallback lookup and its associated assert in
  `renderNestedSortableListItem()` are removed.

* A new standalone toolbar web component
  `<typo3-form-form-element-stage-item-toolbar>` is introduced.
  It replaces the cloned-`_ElementToolbar`-div approach for legacy custom Stage templates.

Review

  • Code review CR +2 Done
    • Benni Mack +2
    • Sven Liebert +1
  • Verified V +2 Done
    • Benni Mack +2
    • Sven Liebert +1
    • core-ci +1 CI

Issues 1

Files 18

Review log 1219

  1. Josua Vogel uploaded patch set 1 03/20/26, 14:53

  2. Josua Vogel marked it work in progress 03/20/26, 14:53

  3. core-ci voted on patch set 1 V -1 03/20/26, 15:02 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/98305

  4. Josua Vogel uploaded patch set 2 V -1 03/20/26, 16:02

  5. core-ci voted on patch set 2 V -1 03/20/26, 16:15 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/98308

  6. Josua Vogel uploaded patch set 3 V -1 03/20/26, 16:44

  7. core-ci voted on patch set 3 V +1 03/20/26, 16:57 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/98311

  8. Josua Vogel uploaded patch set 4 V +1 03/21/26, 17:02

  9. Josua Vogel marked it ready for review 03/21/26, 17:03

  10. Josua Vogel updated the commit message in patch set 5 03/21/26, 17:04

  11. core-ci voted on patch set 5 V +1 03/21/26, 17:14 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/98355

  12. core-ci voted on patch set 4 V -1 03/21/26, 17:16 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/98354

  13. Josua Vogel updated the commit message in patch set 6 V +1 03/23/26, 06:33

  14. core-ci voted on patch set 6 V +1 03/23/26, 07:19 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/98415

  15. Josua Vogel rebased onto patch set 7 V +1 03/23/26, 07:38

  16. core-ci voted on patch set 7 V +1 03/23/26, 08:16 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/98424

  17. Sven Liebert voted on patch set 7 CR +1 V +1 03/24/26, 06:25

  18. Benni Mack voted on patch set 7 CR +2 V +2 03/24/26, 06:29

  19. Benni Mack merged patch set 8 03/24/26, 06:30