Merge pull request #127 from abap2UI5/claude/update-binding-docs

Update binding docs for the unified two-way _bind

Author: oblomov-dev

docs/advanced/agent.md

@@ -81,7 +81,7 @@ Views, events, binding, navigation, messages — everything goes through the `cl
 |---|---|
 | Views | `view_display`, `view_destroy`, `view_model_update` |
 | Popups / popovers | `popup_display`, `popup_destroy`, `popover_display`, `popover_destroy` |
-| Binding | `_bind( var )` (read-only), `_bind_edit( var )` (two-way) |
+| Binding | `_bind( var )` (read-only), `_bind( var )` (two-way) |
 | Events | `_event( 'NAME' )`, `check_on_event( 'NAME' )`, `get_event_arg( i )` |
 | Navigation | `nav_app_call( app )`, `nav_app_leave( )`, `get_app_prev( )` |
 | Messages | `message_box_display`, `message_toast_display` |
@@ -106,7 +106,7 @@ Translate any UI5 XML example from the [UI5 SDK](https://sapui5.hana.ondemand.co
 |---|---|
 | `<Button text="Send" />` | `->__( n = `Button` a = `text` v = `Send` )` |
 | `press="onPress"` | `a = `press` v = client->_event( `BUTTON_POST` )` |
-| `value="{/name}"` | `a = `value` v = client->_bind_edit( name )` |
+| `value="{/name}"` | `a = `value` v = client->_bind( name )` |
 | `<FeedInput><actions>…</actions></FeedInput>` | `->_( `FeedInput` )->_( `actions` )->__( … )` |
 
 Builder methods:
@@ -132,7 +132,7 @@ CLASS zcl_app_xxx DEFINITION PUBLIC.
 
   PUBLIC SECTION.
     INTERFACES z2ui5_if_app.
-    " bound data (public DATA attributes used by _bind / _bind_edit)
+    " bound data (public DATA attributes used by _bind)
 
   PROTECTED SECTION.
     DATA client TYPE REF TO z2ui5_if_client.
@@ -239,7 +239,7 @@ When an AI needs deeper information than this page provides:
 | Architecture, request roundtrip | [Concept](/technical/concept), [How It All Works](/technical/how_it_all_works) |
 | Lifecycle and `IF` / `ELSEIF` dispatcher pattern | [Cookbook → Life Cycle](/cookbook/event_navigation/life_cycle) |
 | Building views, control choice | [Cookbook → View Definition](/cookbook/view/definition) |
-| Data binding (`_bind`, `_bind_edit`) | [Cookbook → Binding](/cookbook/model/binding) |
+| Data binding (`_bind`) | [Cookbook → Binding](/cookbook/model/binding) |
 | Tables and trees | [Cookbook → Tables](/cookbook/model/tables), [Trees](/cookbook/model/trees) |
 | Events, actions, exceptions | [Cookbook → Event, Navigation](/cookbook/event_navigation/life_cycle) |
 | Popups and popovers | [Cookbook → Popup, Popover](/cookbook/popup_popover/popup) |

docs/configuration/launchpad.md

@@ -57,7 +57,7 @@ Handle view changes and popups through the abap2UI5 backend as usual. But for na
         val   = client->cs_event-cross_app_nav_to_ext
         t_arg = VALUE #(
             ( `{ semanticObject: "Z2UI5_CL_LP_SAMPLE_04", action: "display" }` )
-            ( `$` && client->_bind_edit( nav_params ) ) ) ) )
+            ( `$` && client->_bind( nav_params ) ) ) ) )
 ```
 
 To navigate back to the previous Launchpad app, use `cross_app_nav_to_prev_app`:

docs/configuration/performance.md

@@ -40,7 +40,7 @@ ENDMETHOD.
 ### Suggestions
 Want to tune your app further? A few tips:
 - Call `client->view_display` only when needed. Prefer `client->view_model_update` so the UI5 framework only re-renders controls that have changed.
-- Prefer `client->_bind`; use `client->_bind_edit` only when users need to make changes the backend processes. Otherwise, you'll cause needless data transfers.
+- Bind data with `client->_bind` — the framework sends only the paths the user actually edited back to ABAP (a delta), so read-only and untouched fields cost nothing on the return trip. (`_bind_edit` is an obsolete alias of `_bind`.)
 - Declare public attributes in your app class only for variables shown on the frontend. This keeps the framework from reading unused values.
 - Follow standard ABAP best practices, like cutting loops and choosing sorted tables, just like in any other ABAP project.
 

docs/cookbook/browser_interaction/clipboard.md

@@ -24,7 +24,7 @@ CLASS z2ui5_cl_sample_clipboard IMPLEMENTATION.
 
         client->view_display( z2ui5_cl_xml_view=>factory(
             )->page(
-                )->input( client->_bind_edit( mv_text )
+                )->input( client->_bind( mv_text )
                 )->button(
                     text  = `copy to clipboard`
                     press = client->_event( `COPY` )

docs/cookbook/browser_interaction/soft_keyboard.md

@@ -25,7 +25,7 @@ METHOD z2ui5_if_app~main.
                      )->title( `Keyboard on/off`
                      )->label( `Input`
                      )->input( id               = `ZINPUT`
-                               value            = client->_bind_edit( input )
+                               value            = client->_bind( input )
                                showvaluehelp    = abap_true
                                valuehelprequest = client->_event( `CALL_KEYBOARD` )
                                valuehelpiconsrc = `sap-icon://keyboard-and-mouse` ).

docs/cookbook/device_capabilities/audio.md

@@ -26,7 +26,7 @@ CLASS z2ui5_cl_sample_sound IMPLEMENTATION.
       DATA(view) = z2ui5_cl_xml_view=>factory( ).
       DATA(vbox) = view->page( )->vbox( ).
       vbox->input( id          = `inputApp`
-                   value       = client->_bind_edit( company_code )
+                   value       = client->_bind( company_code )
                    type        = `Number`
                    placeholder = `Company Code`
                    submit      = client->_event( `CHECK_INPUT` ) ).

docs/cookbook/device_capabilities/barcode_scanning.md

@@ -72,12 +72,12 @@ CLASS z2ui5_cl_sample_focus IMPLEMENTATION.
          )->label( `One`
          )->input(
               id     = `id1`
-              value  = client->_bind_edit( one )
+              value  = client->_bind( one )
               submit = client->_event( `ONE_ENTER` )
          )->label( `Two`
          )->input(
               id     = `id2`
-              value  = client->_bind_edit( two )
+              value  = client->_bind( two )
               submit = client->_event( `TWO_ENTER` ) ).
 
       client->view_display( page->stringify( ) ).
@@ -118,7 +118,7 @@ CLASS z2ui5_cl_sample_sound IMPLEMENTATION.
       DATA(view) = z2ui5_cl_xml_view=>factory( ).
       DATA(vbox) = view->page( )->vbox( ).
       vbox->input( id          = `inputApp`
-                   value       = client->_bind_edit( company_code )
+                   value       = client->_bind( company_code )
                    type        = `Number`
                    placeholder = `Company Code`
                    submit      = client->_event( `CHECK_INPUT` ) ).

docs/cookbook/device_capabilities/camera.md

@@ -21,7 +21,7 @@ CLASS z2ui5_cl_demo_app_306 IMPLEMENTATION.
     IF client->check_on_init( ).
       DATA(page) = z2ui5_cl_xml_view=>factory( )->shell( )->page( `abap2UI5 - Device Camera Picture`
                 )->_z2ui5( )->camera_picture(
-                    value    = client->_bind_edit( mv_picture_base )
+                    value    = client->_bind( mv_picture_base )
                     onphoto  = client->_event( `CAPTURE` ) ).
       client->view_display( page->stringify( ) ).
     ENDIF.

docs/cookbook/device_capabilities/geolocation.md

@@ -30,12 +30,12 @@ CLASS z2ui5_cl_sample_geolocation IMPLEMENTATION.
         )->page( )->_z2ui5(
             )->geolocation(
                 finished         = client->_event( `POST` )
-                longitude        = client->_bind_edit( longitude )
-                latitude         = client->_bind_edit( latitude )
-                altitude         = client->_bind_edit( altitude )
-                altitudeaccuracy = client->_bind_edit( altitudeaccuracy )
-                accuracy         = client->_bind_edit( accuracy )
-                speed            = client->_bind_edit( speed )
+                longitude        = client->_bind( longitude )
+                latitude         = client->_bind( latitude )
+                altitude         = client->_bind( altitude )
+                altitudeaccuracy = client->_bind( altitudeaccuracy )
+                accuracy         = client->_bind( accuracy )
+                speed            = client->_bind( speed )
         )->stringify( ) ).
 
     CASE client->get( )-event.

docs/cookbook/device_capabilities/spreadsheet.md

@@ -27,8 +27,8 @@ CLASS z2ui5_cl_sample_upload IMPLEMENTATION.
     client->view_display( z2ui5_cl_xml_view=>factory(
         )->page(
             )->_z2ui5( )->file_uploader(
-                value       = client->_bind_edit( mv_value )
-                path        = client->_bind_edit( mv_path )
+                value       = client->_bind( mv_value )
+                path        = client->_bind( mv_path )
                 placeholder = `filepath here...`
                 upload      = client->_event( `UPLOAD` )
         )->stringify( ) ).