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,66 @@
+..  include:: /Includes.rst.txt
+
+..  _breaking-107677-1760339783:
+
+===========================================================================
+Breaking: #107677 - Drop `prepend` and `append` modes from TCA value picker
+===========================================================================
+
+See :issue:`107677`
+
+Description
+===========
+
+The *prepend* and *append* modes of the value picker specified in TCA and used
+in FormEngine (for example
+:php:`$GLOBALS['TCA']['tx_example']['columns']['example']['config']['valuePicker']['mode']`)
+have been removed.
+
+These modes were designed to insert predefined values before or after the
+existing input value, but they served only niche use cases and caused
+inconsistent behavior across different input types.
+
+Maintaining these modes introduced unnecessary complexity in both
+implementation and accessibility. Prepending or appending content dynamically
+to user input fields could easily lead to unexpected results, break input
+validation, and interfere with assistive technologies such as screen readers.
+Additionally, this approach mixed presentation and data logic in ways that are
+not consistent with modern form handling patterns.
+
+Future improvements to the value picker will focus on a consistent
+*mode=replace* behavior and may be implemented as new form input types to
+provide a more robust and accessible user experience.
+
+Impact
+======
+
+Any value picker TCA configuration using the `mode` options `prepend` or
+`append` will no longer have any effect. TYPO3 ignores these settings, and the
+picker defaults to the standard *replace* behavior.
+
+Affected installations
+======================
+
+Installations using custom field wizard configurations or integrations that
+rely on the value picker with :php:`mode = prepend` or :php:`mode = append`
+are affected.
+
+Migration
+=========
+
+There is no direct replacement for the removed modes.
+
+If your implementation depends on prepending or appending content to existing
+values, implement a **custom input type** or **custom form element** to handle
+this behavior explicitly. This allows you to maintain full control over the
+user interface, data handling, and accessibility.
+
+For most use cases, it is recommended to replace prepend or append logic with
+the standard *replace* value picker behavior or use dedicated UI controls that
+clearly indicate how values are modified.
+
+If the value picker was used to suggest combinable values, consider listing
+these elements in the field description instead so that users can copy and
+paste them manually into the input field.
+
+..  index:: TCA, FullyScanned, ext:backend