Skip to content

Timer: document the third START_TIMER argument that keeps the busy indicator down - #342

Merged
oblomov-dev merged 2 commits into
mainfrom
claude/peaceful-pascal-4z2w4v
Sep 27, 2026
Merged

oblomov-dev merged 2 commits into
mainfrom
claude/peaceful-pascal-4z2w4v

Conversation

@oblomov-dev

Copy link
Copy Markdown
Member

abap2UI5/abap2UI5#2799 gave cs_event-start_timer an optional third argument: X keeps the busy indicator down for the tick. This PR documents it.

Changes

  • cookbook/browser_interaction/timer.md: a one-line pointer in the intro and a new section, "Without the Busy Indicator".
    • Example: a TICK handler that re-arms with ( TICK) (5000) (X ).
    • When to use it (a background poll, a carousel or ticker nobody waits on) and when not to (a tick the user is waiting for).
    • The flag belongs to the tick that call arms, so a repeating timer passes it every time.
    • Write `X`, not abap_true: t_arg is a string table, and abaplint rejects ( abap_true ) as a row.
    • Only the overlay goes. A click during the tick is still dropped, like check_no_busy on an _event( ) wire.
  • resources/deprecations.md: under "Invisible custom controls", a migration note. A Timer whose finished wire used s_ctrl-check_no_busy migrates to the same flag on cs_event-start_timer. It is marked next release, because 1.145.0 reads only two arguments.
  • resources/api.md and public/api/client-api.json: regenerated with npm run generate:api from core main (e5c3fb3). The only change is the new cs_event-start_timer paragraph.

Checks

  • npm run check: all 15 gates pass.
    • test 271/271; build 35,802 internal links, none dead.
    • check:examples 70 examples compile against main; check:api-reference matches main.
    • check:version could only compare the three local places (the GitHub release API answered 403); the tags confirm 1.145.0.
  • After the wording change to deprecations.md, check:line-length, check:vocabulary, check:conventions, check:api-names and build were re-run; all pass.

On the next framework release: replace the next release marker in deprecations.md with the version number.

🤖 Generated with Claude Code

https://claude.ai/code/session_014bLQZPXbB8xmewCNmnBJaG


Generated by Claude Code

abap2UI5#2799 (e5c3fb3 on main) lets follow_up_action(
cs_event-start_timer ) take an optional third t_arg, `X` - the tick's
check_no_busy. A poll or a carousel whose backend call takes longer
than a second no longer flashes the full-screen busy overlay.

- cookbook/browser_interaction/timer.md: a section on the flag - when
  to use it (a background poll, a carousel or ticker nobody is waiting
  on), that it belongs to the tick each call arms, why it is written
  `X` and not abap_true (abaplint's check_syntax rejects a c value as a
  string_table row - checked against main with the check:examples
  setup), and that only the overlay goes: a click that lands during the
  tick is still dropped by the busy guard and raises the overlay at
  once. The page's opening points to it.
- resources/deprecations.md: under Invisible custom controls, a pointer
  from the Timer control's check_no_busy wire to the flag, marked
  *next release* - 1.145.0 reads two arguments and ignores a third.
- resources/api.md, public/api/client-api.json: regenerated with
  `npm run generate:api` (A2UI5_HOME at a clone of abap2UI5 main), as
  AGENTS.md prescribes when check:api-reference fails - it did, on the
  new cs_event-start_timer paragraph of the follow_up_action ABAP Doc.
  That paragraph is the whole diff.

The release notes get no entry: resources/changelog.md is written per
release and has no unreleased section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014bLQZPXbB8xmewCNmnBJaG
The obsolete Timer must not be used, so the note no longer describes how to
use it - it tells the reader that a Timer with check_no_busy migrates to the
same flag on cs_event-start_timer.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014bLQZPXbB8xmewCNmnBJaG
@oblomov-dev
oblomov-dev merged commit 3044cbf into main Sep 27, 2026
1 check passed
@oblomov-dev
oblomov-dev deleted the claude/peaceful-pascal-4z2w4v branch September 27, 2026 18:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants