Review main Merged

87433[FEATURE] Introduce breadcrumb component

Benjamin Kott CR +2 V +2 Nightmare +2493 −49 updated 10/22/25, 10:21

Commit message

This introduces a new breadcrumb component
for the TYPO3 backend that provides contextual
navigation in the document header of backend
modules.

The component features a provider-based
architecture with dedicated providers for
records and FAL resources, a BreadcrumbFactory
for common controller scenarios, and a new
ModuleResolver service for consistent module
detection across the backend.

Key features:
* Automatic context detection (pages, content, files)
* Complete page tree hierarchy navigation
* Module-aware routing (preserves current module)
* Support for custom suffix nodes (e.g., "New Record")
* Responsive design with automatic dropdown

The breadcrumb component automatically displays when
editing or creating records, browsing file storages,
or working with multiple records. It helps users
understand their location and navigate back through
hierarchies with a single click.

The API is marked @internal until v15 LTS to allow
for stabilization.

Review

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

Issues 2

Files 37

Show 17 more files

Review log 65114

Show 4889 earlier messages
  1. Benjamin Kott uploaded patch set 1 12/11/24, 10:52

  2. core-ci voted on patch set 1 V -1 12/11/24, 11:00 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/70913

  3. Benjamin Kott uploaded patch set 2 V -1 01/07/25, 15:54

  4. core-ci voted on patch set 2 V -1 01/07/25, 16:03 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72050

  5. Benjamin Kott uploaded patch set 3 V -1 01/08/25, 12:24

  6. core-ci voted on patch set 3 V -1 01/08/25, 12:33 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72090

  7. Benjamin Kott uploaded patch set 4 V -1 01/08/25, 16:18

  8. core-ci voted on patch set 4 V -1 01/08/25, 16:25 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72104

  9. Benjamin Kott uploaded patch set 5 V -1 01/09/25, 11:56

  10. core-ci voted on patch set 5 V -1 01/09/25, 12:03 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72138

  11. Benjamin Kott uploaded patch set 6 V -1 01/14/25, 16:20

  12. core-ci voted on patch set 6 V -1 01/14/25, 16:29 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72470

  13. Benjamin Kott uploaded patch set 7 V -1 01/15/25, 14:18

  14. core-ci voted on patch set 7 V -1 01/15/25, 14:26 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72529

  15. Benjamin Kott uploaded patch set 8 V -1 01/16/25, 11:22

  16. core-ci voted on patch set 8 V -1 01/16/25, 11:30 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72555

  17. Benjamin Kott uploaded patch set 9 V -1 01/16/25, 15:04

  18. Benjamin Kott uploaded patch set 10 01/16/25, 15:11

  19. core-ci voted on patch set 9 V -1 01/16/25, 15:12 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72563

  20. core-ci voted on patch set 10 V -1 01/16/25, 15:18 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72564

  21. Benjamin Kott uploaded patch set 11 V -1 01/17/25, 08:07

  22. Benjamin Kott uploaded patch set 12 01/17/25, 08:12

  23. core-ci voted on patch set 11 V -1 01/17/25, 08:13 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72597

  24. Benjamin Kott uploaded patch set 13 01/17/25, 08:13

  25. Benjamin Kott uploaded patch set 14 01/17/25, 08:14

  26. core-ci voted on patch set 12 V -1 01/17/25, 08:22 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72598

  27. core-ci voted on patch set 13 V -1 01/17/25, 08:22 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72599

  28. core-ci voted on patch set 14 V -1 01/17/25, 08:24 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72600

  29. Andreas Kienast commented on patch set 14 01/17/25, 08:41

    breadcrumb.ts:283

    You're comparing collections, not single nodes here. I'd suggest to rename the method to `areNodeCollectionsEqual` or alike...

    breadcrumb.ts:298

    ... thus this can be named `areNodesEqual`.
  30. Benjamin Kott uploaded patch set 15 V -1 01/20/25, 08:23

  31. core-ci voted on patch set 15 V -1 01/20/25, 08:29 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72704

  32. Benjamin Kott uploaded patch set 16 V -1 01/20/25, 09:29

  33. core-ci voted on patch set 16 V -1 01/20/25, 09:36 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72713

  34. Benjamin Kott uploaded patch set 17 V -1 01/20/25, 09:38

  35. Benjamin Kott commented on patch set 16 01/20/25, 09:39

    breadcrumb.ts:283 Reply

    Done

    breadcrumb.ts:298 Reply

    Done
  36. core-ci voted on patch set 17 V -1 01/20/25, 09:44 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72715

  37. Benjamin Kott uploaded patch set 18 V -1 01/20/25, 14:36

  38. core-ci voted on patch set 18 V -1 01/20/25, 14:42 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72731

  39. Benjamin Kott uploaded patch set 19 V -1 01/21/25, 13:37

  40. core-ci voted on patch set 19 V -1 01/21/25, 13:46 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72787

  41. Benjamin Kott updated the commit message in patch set 20 V -1 01/22/25, 07:13

  42. core-ci voted on patch set 20 V -1 01/22/25, 07:22 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/72822

  43. Andreas Kienast commented on patch set 20 01/22/25, 07:46

    Interesting issue: when I expand the width of the file tree to its max and then open "Filelist" again, I get an error: > Uncaught ResizeObserver loop completed with undelivered notifications.
  44. Andreas Kienast commented on patch set 20 01/22/25, 08:28

    Breadcrumb.php:166

    How can this happen? Smells like a FAL flaw?

    DocHeaderComponent.php:23

    Please no. EXT:styleguide is a dev dependency and doesn't exist in the tarball packages.
  45. Benjamin Kott updated the commit message in patch set 21 V -1 02/11/25, 12:50

  46. core-ci voted on patch set 21 V -1 02/11/25, 13:00 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/73976

  47. Benjamin Kott uploaded patch set 22 V -1 03/03/25, 11:39

  48. Benjamin Kott uploaded patch set 23 03/03/25, 11:48

  49. Benjamin Kott commented on patch set 23 03/03/25, 11:48

    DocHeaderComponent.php:23 Reply

    Done
  50. core-ci voted on patch set 22 V -1 03/03/25, 11:58 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/75007

  51. core-ci voted on patch set 23 V -1 03/03/25, 12:05 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/75010

  52. Benjamin Kott uploaded patch set 24 V -1 03/06/25, 07:52

  53. core-ci voted on patch set 24 V -1 03/06/25, 08:01 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/75206

  54. Benjamin Kott uploaded patch set 25 V -1 05/27/25, 06:40

  55. core-ci voted on patch set 25 V -1 05/27/25, 06:52 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/79542

  56. Benjamin Franzke uploaded patch set 26 V -1 07/25/25, 11:59

  57. core-ci voted on patch set 26 V -1 07/25/25, 12:13 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/82317

  58. Benjamin Franzke uploaded patch set 27 V -1 07/25/25, 13:24

  59. core-ci voted on patch set 27 V -1 07/25/25, 13:36 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/82321

  60. Benjamin Franzke uploaded patch set 28 V -1 07/28/25, 07:11

  61. core-ci voted on patch set 28 V -1 07/28/25, 07:24 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/82408

  62. Benjamin Franzke uploaded patch set 29 V -1 07/28/25, 07:31

  63. core-ci voted on patch set 29 V -1 07/28/25, 07:41 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/82409

  64. Benjamin Franzke commented on patch set 29 07/28/25, 07:49

    Breadcrumb.php:166 Reply

    Yes, kinda, ``Folder::getParentFolder()` can only return a `Folder`, not `null`, therefore it returns `/` when retrieving the parent of `/`. For that reason the check `$parent instanceof FolderInterface` is actually a no-op (and now removed)
  65. Benjamin Franzke uploaded patch set 30 V -1 07/28/25, 07:56

  66. Benjamin Franzke uploaded patch set 31 07/28/25, 08:07

  67. core-ci voted on patch set 30 V +1 07/28/25, 08:10 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/82410

  68. core-ci voted on patch set 31 V +1 07/28/25, 08:16 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/82411

  69. Benjamin Franzke uploaded patch set 32 V +1 09/25/25, 11:50

  70. Benjamin Franzke rebased onto patch set 33 09/25/25, 11:50

  71. core-ci voted on patch set 32 V +1 09/25/25, 12:16 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/85508

  72. core-ci voted on patch set 33 V -1 09/25/25, 12:22 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/85511

  73. Benjamin Franzke uploaded patch set 34 V -1 10/06/25, 09:16

  74. core-ci voted on patch set 34 V -1 10/06/25, 09:38 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/86067

  75. Benni Mack uploaded patch set 35 V -1 10/17/25, 07:36

  76. core-ci voted on patch set 35 V -1 10/17/25, 07:51 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/86869

  77. Benjamin Kott uploaded patch set 36 V -1 10/20/25, 14:25

  78. core-ci voted on patch set 36 V -1 10/20/25, 14:41 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87087

  79. Benni Mack commented on patch set 36 10/20/25, 15:53

    I need to check: - how to hand in the request object - enable breadcrumb with the resource Otherwise, I'd say, let's get this one in.
  80. Benni Mack uploaded patch set 37 V -1 10/20/25, 19:04

  81. Benni Mack updated the commit message in patch set 38 10/20/25, 19:07

  82. core-ci voted on patch set 37 V -1 10/20/25, 19:20 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87112

  83. core-ci voted on patch set 38 V -1 10/20/25, 19:23 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87113

  84. Benni Mack uploaded patch set 39 V -1 10/20/25, 19:30

  85. core-ci voted on patch set 39 V -1 10/20/25, 19:39 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87116

  86. Benni Mack uploaded patch set 40 V -1 10/20/25, 19:45

  87. core-ci voted on patch set 40 V -1 10/20/25, 19:53 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87118

  88. Benni Mack uploaded patch set 41 V -1 10/20/25, 20:11

  89. core-ci voted on patch set 41 V +1 10/20/25, 20:19 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87120

  1. Benni Mack updated the commit message in patch set 42 V +1 10/21/25, 11:14

  2. Benni Mack uploaded patch set 43 10/21/25, 11:18

  3. Benni Mack voted on patch set 43 CR +1 V +1 10/21/25, 11:18

  4. core-ci voted on patch set 42 V +1 10/21/25, 11:28 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87175

  5. core-ci voted on patch set 43 V -1 10/21/25, 11:38 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87177

  6. Oli Bartsch uploaded patch set 44 CR +1 V +1 10/21/25, 12:49

  7. Oli Bartsch uploaded patch set 45 10/21/25, 12:49

  8. Oli Bartsch commented on patch set 45 CR -1 10/21/25, 12:49

    Still checking
  9. core-ci voted on patch set 44 V -1 10/21/25, 13:00 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87185

  10. core-ci voted on patch set 45 V -1 10/21/25, 13:00 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87186

  11. Benjamin Franzke uploaded patch set 46 CR -1 V -1 10/21/25, 19:45

  12. core-ci voted on patch set 46 V +1 10/21/25, 19:53 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87198

  13. Benjamin Franzke voted on patch set 46 CR +1 V +1 10/21/25, 19:53

  14. Georg Ringer voted on patch set 46 V +1 10/21/25, 20:15

  15. Oli Bartsch commented on patch set 46 CR -1 10/21/25, 20:19

    Please wait, still streamlining the PHP part.
  16. Oli Bartsch uploaded patch set 47 CR +1 V +1 10/21/25, 21:38

  17. core-ci voted on patch set 47 V -1 10/21/25, 21:53 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87203

  18. Oli Bartsch uploaded patch set 48 V -1 10/22/25, 08:42

  19. core-ci voted on patch set 48 V -1 10/22/25, 08:51 Core CI is not happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87222

  20. Oli Bartsch uploaded patch set 49 V -1 10/22/25, 08:52

  21. core-ci voted on patch set 49 V +1 10/22/25, 08:59 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/87223

  22. Oli Bartsch commented on patch set 49 CR +1 V +1 10/22/25, 09:01

    Reply

    Done
  23. Oli Bartsch commented on patch set 49 10/22/25, 09:08

    Reply

    Done
  24. Benni Mack commented on patch set 49 CR +2 V +2 10/22/25, 10:21

    Reply

    Done
  25. Benni Mack merged patch set 50 10/22/25, 10:21