Review main Ready for review

96515[DOCS] Document form elements in form definitions

Stefan Froemken CR +1 V +1 Expert +1516 −0 updated 11/12/26, 15:17

Commit message

Form elements were previously only documented in the context of form
editor prototypes. A reference for configuring elements directly in
form definitions (*.form.yaml) was missing.

Add a reference chapter for form definition elements:
- Explain the renderables hierarchy and page requirements
- Document common options such as identifier, type, and properties
- Cover validators, variants, and custom Fluid properties
- Detail built-in form elements with practical configuration options

Test this change

Run a command in your clone of the TYPO3 Core. Then try what the change does and vote on Verified in Gerrit. How to review a patch

Check out patch set 5
git fetch https://review.typo3.org/Packages/TYPO3.CMS refs/changes/15/96515/5 && git checkout FETCH_HEAD
Cherry-pick onto main
git fetch https://review.typo3.org/Packages/TYPO3.CMS refs/changes/15/96515/5 && git cherry-pick FETCH_HEAD

Review

  • Code review CR +1 Needs a vote
    • Lina Wolf +1
  • Verified V +1 Needs a vote
    • Lina Wolf +1
    • core-ci +1 CI

Issues 1

Files 2

Review log 1420

  1. Stefan Froemken uploaded patch set 1 10/07/26, 22:03

  2. core-ci voted on patch set 1 V +1 10/07/26, 22:10 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/110421

  3. Lina Wolf commented on patch set 1 CR -1 10/08/26, 05:52

    Please have another look many new headlines without anchor

    Index.rst:186

    Each newly introduced headline has to have a permalink anchor
  4. Stefan Froemken uploaded patch set 2 CR -1 V +1 10/30/26, 20:39

  5. Stefan Froemken commented on patch set 2 10/30/26, 20:40

    Index.rst:186 Reply

    Done
  6. core-ci voted on patch set 2 V -1 10/30/26, 20:47 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/112907

  7. core-ci commented on patch set 2 10/31/26, 06:23 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/112907

  8. Lina Wolf commented on patch set 2 V -1 10/31/26, 07:59

    Index.rst:292

    It seems like the default is actually 'form-element form-element-text mb-3' https://github.com/typo3/typo3/blob/main/typo3/sysext/form/Configuration/Form/Base/FormElements/Text.yaml#L388-L391 I am wondering if it is wise to dupliate the information here it might be better to extract it from the yaml directly with some render-guides element?

    Index.rst:1529

    This would not work as the honeypot is runtime managed
  9. Lina Wolf voted on patch set 2 V 0 CR -1 10/31/26, 07:59

  10. Stefan Froemken uploaded patch set 3 CR -1 V -1 11/11/26, 18:54

  11. Stefan Froemken commented on patch set 3 11/11/26, 18:59

    Index.rst:292 Reply

    Removed, and added it as example.

    Index.rst:1529 Reply

    Done
  12. core-ci voted on patch set 3 V -1 11/11/26, 19:02 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/114136

  13. Stefan Froemken rebased onto patch set 4 V -1 11/11/26, 19:14

  14. Stefan Froemken commented on patch set 4 11/11/26, 19:14

    Rebased
  15. core-ci voted on patch set 4 V +1 11/11/26, 19:23 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/114138

  16. Lina Wolf commented on patch set 4 CR -1 11/12/26, 11:01

    Still contains syntax errors
  17. Lina Wolf commented on patch set 4 11/12/26, 11:01

    Reply Unresolved

    Working on it
  18. Lina Wolf uploaded patch set 5 CR -1 V +1 11/12/26, 15:05

  19. Lina Wolf commented on patch set 5 CR +1 V +1 11/12/26, 15:06

    Made some minor fixes regarding syntax and paths.
  20. core-ci voted on patch set 5 V +1 11/12/26, 15:17 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/114197