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,84 @@
+
+.. include:: /Includes.rst.txt
+
+.. _feature-66047:
+
+=======================================================
+Feature: #66047 - Introduce JavaScript notification API
+=======================================================
+
+See :issue:`66047`
+
+Description
+===========
+
+The Flashmessages API has been moved from `TYPO3.Flashmessages` to `top.TYPO3.Flashmessages` in TYPO3 CMS 7.0.
+
+Now we introduce the new JavaScript Notification API and remove the refactoring of the FlashMessage API which was made for TYPO3 CMS 7.0.
+
+The compatibility layer for TYPO3.FlashMessage has changed to use the new Notification API and will be removed with TYPO3 v9 as before.
+
+The new Notification API works similar to old Flashmessages, you can use it from the Top-Frame, where is it loaded one time for the complete backend.
+
+Please look at the examples section in this document for more details.
+
+
+Migration
+=========
+
+The affected 3rd party extensions must be modified to use `top.TYPO3.Notification` instead of `top.TYPO3.Flashmessages`.
+
+Examples:
+
+1) Old and new syntax in general
+
+.. code-block:: javascript
+
+	// Old and deprecated:
+	top.TYPO3.Flashmessages.display(TYPO3.Severity.notice)
+
+	// New and the only correct way:
+	top.TYPO3.Notification.notice(title, message)
+
+
+2) Notice notification
+
+.. code-block:: javascript
+
+	// duration is optional, default is 5 seconds
+	top.TYPO3.Notification.notice(title, message, duration)
+
+
+3) Info notification
+
+.. code-block:: javascript
+
+	// duration is optional, default is 5 seconds
+	top.TYPO3.Notification.info(title, message, duration)
+
+
+4) Success notification
+
+.. code-block:: javascript
+
+	// duration is optional, default is 5 seconds
+	top.TYPO3.Notification.success(title, message, duration)
+
+
+5) Warning notification
+
+.. code-block:: javascript
+
+	// duration is optional, default is 5 seconds
+	top.TYPO3.Notification.warning(title, message, duration)
+
+
+6) Error notification
+
+.. code-block:: javascript
+
+	// duration is optional, default is 0 seconds which means sticky!
+	top.TYPO3.Notification.error(title, message, duration)
+
+
+.. index:: JavaScript, Backend