TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,52 @@
+..  include:: /Includes.rst.txt
+
+..  _feature-109031:
+
+=================================================
+Feature: #109031 - Page position select component
+=================================================
+
+See :issue:`109031`
+
+Description
+===========
+
+A new component has been added, based on the `page-browser`, that allows
+a page to be selected and an insertion position to be defined. Possible
+positions are `inside` and `after`.
+
+Features
+--------
+
+*   When a page node in the tree is selected insertion options are displayed.
+    Options include `Insert` and `After`. `After` is applicable to all
+    child pages.
+
+*   On first render, the selected node is scrolled into view
+    using `scrollNodeIntoViewIfNeeded`.
+
+*   The component emits a custom event
+    `typo3:page-position-select-tree:insert-position-change` whenever the
+    insertion position changes. The event payload contains `pageUid` (the
+    selected page ID) and `position` (the chosen insertion position),
+    allowing other modules to react accordingly.
+
+Example usage
+=============
+
+..  code-block:: html
+
+    <typo3-backend-component-page-position-select
+        activePageId="1"
+        insertPosition="inside"
+    >
+    </typo3-backend-component-page-position-select>
+
+Impact
+======
+
+This component can be used anywhere in the backend where page selection and
+insertion position are needed, replacing previous workflows
+with more intuitive controls.
+
+..  index:: Backend