Docs: use follow_up_action( val, t_arg ) instead of eF strings

claude · claude · commit 376fe0062fb1 · 2026-07-15T23:32:23.000Z
Follow the framework change that folds action->gen into follow_up_action: examples now pass the frontend event and arguments directly via follow_up_action( val = ... t_arg = ... ) rather than assembling an .eF( ) string by hand. follow_up_action.md documents both ways (event+args and raw JS); action.md stays the obsolete page and shows the plain rename as the migration. vitepress build passes (no dead links). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015vTnxZtHiAd4tiqMvxFdgJ
diff --git a/docs/configuration/launchpad.md b/docs/configuration/launchpad.md
@@ -34,7 +34,9 @@ ENDIF.
 Change the Launchpad shell title from ABAP at any time with the `set_title_launchpad` frontend event:
 
 ```abap
-client->follow_up_action( |.eF('SET_TITLE_LAUNCHPAD', 'My Dynamic Title')| ).
+client->follow_up_action(
+    val   = z2ui5_if_client=>cs_event-set_title_launchpad
+    t_arg = VALUE #( ( `My Dynamic Title` ) ) ).
 ```
 
 #### Read Startup Parameters
diff --git a/docs/cookbook/browser_interaction/clipboard.md b/docs/cookbook/browser_interaction/clipboard.md
@@ -31,7 +31,9 @@ CLASS z2ui5_cl_sample_clipboard IMPLEMENTATION.
             )->stringify( ) ).
 
       WHEN client->check_on_event( `COPY` ).
-        client->follow_up_action( |.eF('CLIPBOARD_COPY', '{ mv_text }')| ).
+        client->follow_up_action(
+            val   = client->cs_event-clipboard_copy
+            t_arg = VALUE #( ( mv_text ) ) ).
         client->message_toast_display( `copied` ).
 
     ENDCASE.
diff --git a/docs/cookbook/browser_interaction/focus.md b/docs/cookbook/browser_interaction/focus.md
@@ -25,7 +25,7 @@ This is useful for guided data entry, barcode scanning, or any flow where the ne
 
 #### Basic Usage
 
-After processing an event, call `client->follow_up_action( )` with the `SET_FOCUS` frontend event and the id of the input to focus next. (The value bindings on the inputs are omitted here to keep the focus logic clear — see [Barcode Scanning](/cookbook/device_capabilities/barcode_scanning) for the same form with bound inputs.)
+After processing an event, call `client->follow_up_action( )` with `cs_event-set_focus` and the id of the input to focus next. (The value bindings on the inputs are omitted here to keep the focus logic clear — see [Barcode Scanning](/cookbook/device_capabilities/barcode_scanning) for the same form with bound inputs.)
 
 ```abap
 METHOD z2ui5_if_app~main.
@@ -45,10 +45,12 @@ METHOD z2ui5_if_app~main.
       client->view_display( page->stringify( ) ).
 
     ELSEIF client->check_on_event( `ONE_ENTER` ).
-        client->follow_up_action( |.eF('SET_FOCUS', 'id2')| ).
+        client->follow_up_action( val   = client->cs_event-set_focus
+                        t_arg = VALUE #( ( `id2` ) ) ).
 
     ELSEIF client->check_on_event( `TWO_ENTER` ).
-        client->follow_up_action( |.eF('SET_FOCUS', 'id1')| ).
+        client->follow_up_action( val   = client->cs_event-set_focus
+                        t_arg = VALUE #( ( `id1` ) ) ).
 
     ENDIF.
 
@@ -62,7 +64,8 @@ After the user presses Enter in `id1`, the backend fires `set_focus` for `id2` a
 To position the caret inside the field or pre-select a range, pass the start and end offsets as additional arguments:
 
 ```abap
-client->follow_up_action( |.eF('SET_FOCUS', 'id1', '0', '5')| ).
+client->follow_up_action( val   = client->cs_event-set_focus
+                t_arg = VALUE #( ( `id1` ) ( `0` ) ( `5` ) ) ).
 ```
 
 #### Barcode Scanning
diff --git a/docs/cookbook/browser_interaction/scrolling.md b/docs/cookbook/browser_interaction/scrolling.md
@@ -52,9 +52,11 @@ CLASS z2ui5_cl_sample_scrolling IMPLEMENTATION.
 
     CASE client->get( )-event.
       WHEN `SCROLL_TOP`.
-        client->follow_up_action( |.eF('SCROLL_TO', 'id_page', '0')| ).
+        client->follow_up_action( val   = client->cs_event-scroll_to
+                        t_arg = VALUE #( ( `id_page` ) ( `0` ) ) ).
       WHEN `SCROLL_BOTTOM`.
-        client->follow_up_action( |.eF('SCROLL_TO', 'id_page', '99999')| ).
+        client->follow_up_action( val   = client->cs_event-scroll_to
+                        t_arg = VALUE #( ( `id_page` ) ( `99999` ) ) ).
     ENDCASE.
 
   ENDMETHOD.
@@ -64,19 +66,22 @@ ENDCLASS.
 The arguments for `scroll_to` are `id`, `scrollTop` (y, px), `scrollLeft` (x, px, optional), and `behavior` (optional):
 
 ```abap
-client->follow_up_action( |.eF('SCROLL_TO', 'id_page', '500', '0', 'smooth')| ).
+client->follow_up_action( val   = client->cs_event-scroll_to
+                t_arg = VALUE #( ( `id_page` ) ( `500` ) ( `0` ) ( `smooth` ) ) ).
 ```
 
 #### Scroll an Element into View
 
 To reveal a specific control — e.g. a row after a search — use `scroll_into_view` with the target control's id:
 
 ```abap
-client->follow_up_action( |.eF('SCROLL_INTO_VIEW', 'id_row_42')| ).
+client->follow_up_action( val   = client->cs_event-scroll_into_view
+                t_arg = VALUE #( ( `id_row_42` ) ) ).
 ```
 
 Additional optional arguments mirror the browser's `scrollIntoView` options: `behavior` (`smooth` | `auto` | `instant`), `block` (`start` | `center` | `end` | `nearest`), `inline` (`nearest` | `start` | `center` | `end`):
 
 ```abap
-client->follow_up_action( |.eF('SCROLL_INTO_VIEW', 'id_row_42', 'smooth', 'center')| ).
+client->follow_up_action( val   = client->cs_event-scroll_into_view
+                t_arg = VALUE #( ( `id_row_42` ) ( `smooth` ) ( `center` ) ) ).
 ```
diff --git a/docs/cookbook/browser_interaction/soft_keyboard.md b/docs/cookbook/browser_interaction/soft_keyboard.md
@@ -36,7 +36,8 @@ METHOD z2ui5_if_app~main.
 
     CASE client->get( )-event.
       WHEN `CALL_KEYBOARD`.
-        client->follow_up_action( |.eF('KEYBOARD_SET_MODE', 'ZINPUT', 'none')| ).
+        client->follow_up_action( val   = client->cs_event-keyboard_set_mode
+                        t_arg = VALUE #( ( `ZINPUT` ) ( `none` ) ) ).
       WHEN `BACK`.
         client->nav_app_leave( ).
     ENDCASE.
diff --git a/docs/cookbook/browser_interaction/timer.md b/docs/cookbook/browser_interaction/timer.md
@@ -8,7 +8,9 @@ Fire a backend event after a delay with the `start_timer` frontend event. Handy
 Pass the event name to fire and the delay in milliseconds:
 
 ```abap
-client->follow_up_action( |.eF('START_TIMER', 'REFRESH', '2000')| ).
+client->follow_up_action(
+    val   = client->cs_event-start_timer
+    t_arg = VALUE #( ( `REFRESH` ) ( `2000` ) ) ).
 ```
 
 After 2 seconds the browser triggers a backend roundtrip with the event name `REFRESH`, which you handle via `check_on_event` like any other event.
@@ -36,12 +38,14 @@ CLASS z2ui5_cl_sample_timer IMPLEMENTATION.
             )->page( `abap2UI5 - Timer`
                 )->text( client->_bind( counter )
             )->stringify( ) ).
-        client->follow_up_action( |.eF('START_TIMER', 'TICK', '2000')| ).
+        client->follow_up_action( val   = client->cs_event-start_timer
+                        t_arg = VALUE #( ( `TICK` ) ( `2000` ) ) ).
 
       WHEN client->check_on_event( `TICK` ).
         counter = counter + 1.
         client->view_model_update( ).
-        client->follow_up_action( |.eF('START_TIMER', 'TICK', '2000')| ).
+        client->follow_up_action( val   = client->cs_event-start_timer
+                        t_arg = VALUE #( ( `TICK` ) ( `2000` ) ) ).
 
     ENDCASE.
 
@@ -57,10 +61,12 @@ A single `start_timer` call fires once — perfect for a deferred action like op
 
 ```abap
 WHEN client->check_on_event( `BUTTON_OPEN_NEW_TAB` ).
-  client->follow_up_action( |.eF('START_TIMER', 'FIRE_OPEN_TAB', '500')| ).
+  client->follow_up_action( val   = client->cs_event-start_timer
+                  t_arg = VALUE #( ( `FIRE_OPEN_TAB` ) ( `500` ) ) ).
 
 WHEN client->check_on_event( `FIRE_OPEN_TAB` ).
-  client->follow_up_action( |.eF('OPEN_NEW_TAB', 'https://www.google.com/search?q=abap2ui5')| ).
+  client->follow_up_action( val   = client->cs_event-open_new_tab
+                  t_arg = VALUE #( ( `https://www.google.com/search?q=abap2ui5` ) ) ).
 ```
 
 #### Replacing a Pending Timer
diff --git a/docs/cookbook/browser_interaction/title.md b/docs/cookbook/browser_interaction/title.md
@@ -23,7 +23,9 @@ METHOD z2ui5_if_app~main.
             )->stringify( ) ).
 
       WHEN client->check_on_event( `RENAME` ).
-        client->follow_up_action( |.eF('SET_TITLE', 'Invoice 4711')| ).
+        client->follow_up_action(
+            val   = client->cs_event-set_title
+            t_arg = VALUE #( ( `Invoice 4711` ) ) ).
 
     ENDCASE.
 
@@ -35,7 +37,9 @@ METHOD z2ui5_if_app~main.
 When the app runs inside an SAP Fiori Launchpad shell, use the dedicated `set_title_launchpad` event instead. It forwards the title to the shell's `ShellUIService` rather than setting `document.title`:
 
 ```abap
-client->follow_up_action( |.eF('SET_TITLE_LAUNCHPAD', 'Invoice 4711')| ).
+client->follow_up_action(
+    val   = client->cs_event-set_title_launchpad
+    t_arg = VALUE #( ( `Invoice 4711` ) ) ).
 ```
 
 Use `set_title` for the browser tab/window title (standalone) and `set_title_launchpad` for the launchpad shell title.
diff --git a/docs/cookbook/browser_interaction/url_handling.md b/docs/cookbook/browser_interaction/url_handling.md
@@ -16,7 +16,9 @@ DATA(lv_search) = client->get( )-s_config-search.
 Open a URL in a new browser tab via a frontend event:
 ```abap
 DATA(lv_url) = `https://www.abap2UI5.org`.
-client->follow_up_action( |.eF('OPEN_NEW_TAB', '{ lv_url }')| ).
+client->follow_up_action(
+    val   = client->cs_event-open_new_tab
+    t_arg = VALUE #( ( lv_url ) ) ).
 ```
 
 #### Browser History
diff --git a/docs/cookbook/device_capabilities/audio.md b/docs/cookbook/device_capabilities/audio.md
@@ -39,7 +39,8 @@ CLASS z2ui5_cl_sample_sound IMPLEMENTATION.
 
     IF client->get( )-event = `CHECK_INPUT`.
       IF company_code IS INITIAL.
-        client->follow_up_action( |.eF('PLAY_AUDIO', '/SAP/PUBLIC/BC/ABAP/mime_demo/bam.wav')| ).
+        client->follow_up_action( val   = client->cs_event-play_audio
+                        t_arg = VALUE #( ( `/SAP/PUBLIC/BC/ABAP/mime_demo/bam.wav` ) ) ).
         client->message_box_display( type = `error` text = `Input is empty!` ).
       ELSE.
         CLEAR company_code.
diff --git a/docs/cookbook/device_capabilities/barcode_scanning.md b/docs/cookbook/device_capabilities/barcode_scanning.md
@@ -86,9 +86,11 @@ CLASS z2ui5_cl_sample_focus IMPLEMENTATION.
 
     CASE client->get( )-event.
       WHEN `ONE_ENTER`.
-        client->follow_up_action( |.eF('SET_FOCUS', 'id2')| ).
+        client->follow_up_action( val   = client->cs_event-set_focus
+                        t_arg = VALUE #( ( `id2` ) ) ).
       WHEN `TWO_ENTER`.
-        client->follow_up_action( |.eF('SET_FOCUS', 'id1')| ).
+        client->follow_up_action( val   = client->cs_event-set_focus
+                        t_arg = VALUE #( ( `id1` ) ) ).
     ENDCASE.
 
   ENDMETHOD.
@@ -129,7 +131,8 @@ CLASS z2ui5_cl_sample_sound IMPLEMENTATION.
 
     IF client->get( )-event = `CHECK_INPUT`.
       IF company_code IS INITIAL.
-        client->follow_up_action( |.eF('PLAY_AUDIO', '/SAP/PUBLIC/BC/ABAP/mime_demo/bam.wav')| ).
+        client->follow_up_action( val   = client->cs_event-play_audio
+                        t_arg = VALUE #( ( `/SAP/PUBLIC/BC/ABAP/mime_demo/bam.wav` ) ) ).
         client->message_box_display( type = `error` text = `Input is empty!` ).
       ELSE.
         CLEAR company_code.
diff --git a/docs/cookbook/device_capabilities/pdf.md b/docs/cookbook/device_capabilities/pdf.md
@@ -41,7 +41,10 @@ ENDMETHOD.
 To let the user save the PDF rather than view it inline, use the [file download](./upload_download.md) pattern:
 
 ```abap
-client->follow_up_action( |.eF('DOWNLOAD_B64_FILE', 'data:application/pdf;base64,{ lv_base64 }', 'invoice_4711.pdf')| ).
+client->follow_up_action(
+    val   = client->cs_event-download_b64_file
+    t_arg = VALUE #( ( `data:application/pdf;base64,` && lv_base64 )
+                     ( `invoice_4711.pdf` ) ) ).
 ```
 
 ::: tip
diff --git a/docs/cookbook/device_capabilities/spreadsheet.md b/docs/cookbook/device_capabilities/spreadsheet.md
@@ -118,7 +118,9 @@ Convert an internal table to an XLSX file and download it to the frontend:
         ( count = `3` value = `red` descr = `this is a description` ) ).
 
         DATA(lv_file) = lcl_help=>xlsx_get_by_itab( lt_tab ).
-        client->follow_up_action( |.eF('DOWNLOAD_B64_FILE', '{ lv_file }', 'test.xlsx')| ).
+        client->follow_up_action(
+            val   = client->cs_event-download_b64_file
+            t_arg = VALUE #( ( lv_file ) ( `test.xlsx` ) ) ).
     ENDIF.
 
 ENDMETHOD.
@@ -218,7 +220,9 @@ Instead of the XLSX API above (which can change between releases), consider the
       ( count = `3` value = `red` descr = `this is a description` ) ).
 
     DATA(lv_file) = lcl_help=>xlsx_get_by_itab( lt_tab ).
-    client->follow_up_action( |.eF('DOWNLOAD_B64_FILE', '{ lv_file }', 'test.xlsx')| ).
+    client->follow_up_action(
+      val   = client->cs_event-download_b64_file
+      t_arg = VALUE #( ( lv_file ) ( `test.xlsx` ) ) ).
   ENDIF.
 
 ENDMETHOD.
diff --git a/docs/cookbook/device_capabilities/upload_download.md b/docs/cookbook/device_capabilities/upload_download.md
@@ -66,7 +66,9 @@ See also `Z2UI5_CL_DEMO_APP_186`:
         `/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQj` &&
         `LYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=`.
 
-        client->follow_up_action( |.eF('DOWNLOAD_B64_FILE', '{ lv_content }', '{ lv_name }')| ).
+        client->follow_up_action(
+            val   = client->cs_event-download_b64_file
+            t_arg = VALUE #( ( lv_content ) ( lv_name ) ) ).
     ENDCASE.
 
 ENDMETHOD.
diff --git a/docs/cookbook/event_navigation/action.md b/docs/cookbook/event_navigation/action.md
@@ -5,8 +5,9 @@ outline: [2, 4]
 
 ::: warning Do Not Use Anymore
 `client->action->gen( )` is obsolete. Use
-[`client->follow_up_action( )`](/cookbook/expert_more/follow_up_action) instead.
-It schedules the same frontend event, called from the backend.
+[`client->follow_up_action( )`](/cookbook/expert_more/follow_up_action) instead —
+it takes the same frontend event and arguments and now covers this case
+directly.
 :::
 
 ## What Changed
@@ -20,16 +21,16 @@ client->action->gen(
     t_arg = VALUE #( ( `https://github.com/abap2UI5` ) ) ).
 ```
 
-The replacement passes the same frontend event as a `follow_up_action` string.
-`.eF('<EVENT>'<, args>)` calls the event; each argument is a quoted string:
+`follow_up_action( )` now accepts the same `val` and `t_arg`, so the migration is
+a plain rename:
 
 ```abap
-client->follow_up_action( |.eF('OPEN_NEW_TAB', 'https://github.com/abap2UI5')| ).
+client->follow_up_action(
+    val   = client->cs_event-open_new_tab
+    t_arg = VALUE #( ( `https://github.com/abap2UI5` ) ) ).
 ```
 
-`val` was one of the frontend events from `z2ui5_if_client=>cs_event` (see
-[Frontend](./frontend.md)) — the event id is simply its upper-case name
-(`cs_event-open_new_tab` → `OPEN_NEW_TAB`). `t_arg` carried the arguments the
-event expects; they now follow the event name in the `.eF( )` call.
-
-See sample `Z2UI5_CL_DEMO_APP_180` for a complete example.
+`val` is one of the frontend events from `z2ui5_if_client=>cs_event` (see
+[Frontend](./frontend.md)); `t_arg` carries the arguments the event expects. See
+[Follow-up Action](/cookbook/expert_more/follow_up_action) for the full details
+and sample `Z2UI5_CL_DEMO_APP_180` for a complete example.
diff --git a/docs/cookbook/expert_more/app_state_share.md b/docs/cookbook/expert_more/app_state_share.md
@@ -74,7 +74,7 @@ CLASS z2ui5_cl_sample_share IMPLEMENTATION.
 
       WHEN client->check_on_event( `BUTTON_POST` ).
 
-        client->follow_up_action( |.eF('CLIPBOARD_APP_STATE')| ).
+        client->follow_up_action( z2ui5_if_client=>cs_event-clipboard_app_state ).
         client->message_toast_display( `clipboard copied` ).
 
     ENDCASE.
diff --git a/docs/cookbook/expert_more/custom_controls.md b/docs/cookbook/expert_more/custom_controls.md
@@ -4,7 +4,7 @@ outline: [2, 4]
 # Custom Controls (Obsolete)
 
 ::: warning Mostly Not Needed Anymore
-Earlier versions of abap2UI5 required custom UI5 controls to cover common browser interactions — setting the page title, moving focus, scrolling, copying to the clipboard, opening new tabs, and so on. These are now built into the framework as **frontend events**, callable from ABAP via `client->follow_up_action( )`. The custom controls that used to wrap these behaviors are obsolete.
+Earlier versions of abap2UI5 required custom UI5 controls to cover common browser interactions — setting the page title, moving focus, scrolling, copying to the clipboard, opening new tabs, and so on. These are now built into the framework as **frontend events**, callable from ABAP via `client->follow_up_action( client->cs_event-... )`. The custom controls that used to wrap these behaviors are obsolete.
 
 :::
 
@@ -28,7 +28,8 @@ The table below lists custom controls that are no longer necessary and the built
 Instead of writing a custom control, call the matching action after an event:
 
 ```abap
-client->follow_up_action( |.eF('SET_TITLE', 'Invoice 4711')| ).
+client->follow_up_action( val   = client->cs_event-set_title
+                t_arg = VALUE #( ( `Invoice 4711` ) ) ).
 ```
 
 See the linked cookbook pages above for the full argument list of each action.
diff --git a/docs/cookbook/expert_more/follow_up_action.md b/docs/cookbook/expert_more/follow_up_action.md
@@ -8,25 +8,49 @@ action that runs on the frontend — set the browser title, move focus, scroll,
 copy to the clipboard, and so on. `client->follow_up_action( )` schedules such a
 frontend action; it runs in the browser right after the response arrives.
 
+## Frontend event + arguments
+
+The usual way: pass a built-in frontend event as the first parameter `val` and
+its arguments in `t_arg`. The framework assembles the frontend call for you.
+
 ```abap
 METHOD z2ui5_if_app~main.
 
-    client->follow_up_action( |.eF('OPEN_NEW_TAB', 'https://github.com/abap2UI5')| ).
+    client->follow_up_action(
+        val   = client->cs_event-set_title
+        t_arg = VALUE #( ( `Invoice 4711` ) ) ).
 
 ENDMETHOD.
 ```
 
-The string you pass is the frontend call executed after the roundtrip.
-`.eF('<EVENT>'<, args>)` invokes one of the built-in frontend events (see
-[Frontend](/cookbook/event_navigation/frontend)) — for example `SET_TITLE`,
-`SET_FOCUS`, `SCROLL_TO`, `START_TIMER`, `DOWNLOAD_B64_FILE`, `PLAY_AUDIO`. Each
-argument is passed as a quoted string:
+`val` is one of the frontend events from `z2ui5_if_client=>cs_event` (see
+[Frontend](/cookbook/event_navigation/frontend)) — for example `set_title`,
+`set_focus`, `scroll_to`, `start_timer`, `download_b64_file`, `play_audio`.
+`t_arg` carries the arguments the event expects; events without arguments need
+no `t_arg`:
 
 ```abap
-client->follow_up_action( |.eF('SET_TITLE', 'Invoice 4711')| ).
+client->follow_up_action( client->cs_event-history_back ).
 ```
 
-See the dedicated cookbook pages under [Browser Interaction](/cookbook/browser_interaction/title)
-and [Device Capabilities](/cookbook/device_capabilities/upload_download) for the
-argument list of each event, and sample `Z2UI5_CL_DEMO_APP_180` for a complete
-example.
+See the dedicated cookbook pages under
+[Browser Interaction](/cookbook/browser_interaction/title) and
+[Device Capabilities](/cookbook/device_capabilities/upload_download) for the
+argument list of each event.
+
+## Raw JavaScript
+
+The second way: pass a raw JavaScript expression as `val` (without `t_arg`). It
+runs as-is in the browser. This is only needed for hand-written custom scripts
+and is **discouraged** — see [Custom JS](/cookbook/expert_more/custom_js) for
+the security implications.
+
+```abap
+client->follow_up_action( `myFunction()` ).
+```
+
+`follow_up_action( )` decides which way applies from the content of `val`: a
+plain event name (only `A-Z`, `a-z`, `0-9`, `_`) becomes a frontend event call,
+anything containing JavaScript syntax runs verbatim.
+
+See sample `Z2UI5_CL_DEMO_APP_180` for a complete example.
diff --git a/docs/cookbook/expert_more/odata.md b/docs/cookbook/expert_more/odata.md
diff --git a/docs/cookbook/model/size_limit.md b/docs/cookbook/model/size_limit.md
