..  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