Skip to content

docs: B31 - Form events#1668

Merged
pavel-miniutka merged 3 commits into
masterfrom
docs/B31
Jun 11, 2026
Merged

docs: B31 - Form events#1668
pavel-miniutka merged 3 commits into
masterfrom
docs/B31

Conversation

@pavel-miniutka

Copy link
Copy Markdown
Collaborator

No description provided.

pavel-miniutka and others added 3 commits June 8, 2026 13:20
Complete the paradigm article Form_events.md (en + ru):

- Add object-group events: FILTER, ORDER (applied filter/order changed),
  FILTERS, ORDERS, FILTERGROUPS, FILTERS PROPERTY (user-driven).
- Add container events: COLLAPSE, EXPAND, TAB.
- Add CHANGE BEFORE / CHANGE AFTER: events fired immediately before or
  after a specific property's value changes on the form.
- Update handler-multiplicity note: global, object, object-group,
  container, and before/after property-change events accumulate in a list;
  the property/action interaction events (CHANGE, GROUPCHANGE, and similar)
  keep a single handler.
- Fix duplicate link targets: keep only the first occurrence of each
  link target per file (Form_structure.md#currentObject,
  Interactive_view.md#userfilters, Constant.md,
  Property_change_CHANGE.md#changeable).
- Fix doubled word "для для" → "для" (RU typo).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Complete the Event block article Event_block.md (en + ru):

- Add all missing formEventDeclaration / changeEventDeclaration branches:
  [CHANGE] OBJECT, FILTER, ORDER, FILTERS, ORDERS, FILTERGROUPS,
  FILTERS PROPERTY, PROPERTY (sets the CHANGE handler for that property
  on the form, overriding any existing one), PROPERTY BEFORE/AFTER.
  Use formPropertyName as the placeholder for form property draw names.
- Add REPLACE | NOREPLACE modifier: exposed as [replaceMode] in the
  Syntax block with REPLACE/NOREPLACE keyword values and defaults (REPLACE
  for QUERYOK/QUERYCLOSE, NOREPLACE for all others). Note that replaceMode
  does not apply to the no-postfix [CHANGE] PROPERTY form, which always
  replaces its single handler.
- Fix Syntax block: CHANGE objName merged with [CHANGE] OBJECT objName;
  [replaceMode] placeholder replaces the raw [REPLACE | NOREPLACE] form
  (option-bundle rule).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Move the eventType grammar out of the Parameters list and present it
properly in Syntax, then tidy the whole article (en + ru, line-synchronous).

- eventType forms live in an intermediate Syntax block, not inlined in a
  Parameters item.
- No `|` in syntax: the action choice is an intermediate `eventAction`
  rule; BEFORE/AFTER, the object-group events (FILTER/ORDER/FILTERS/ORDERS),
  and the container events (EXPAND/COLLAPSE/TAB) are factored into the
  `eventPhase`, `groupObjectEvent`, and `containerEvent` placeholders, with
  their keyword values described in Parameters (option-bundle rule).
- Parameters describe only syntax and writing mechanics — the per-event
  semantics live in the Form_events paradigm article and are referenced,
  not restated. Reader-visible placeholders (objName, groupObjectName,
  filterGroupName, formPropertyName, componentSelector, intPeriod, FIXED)
  are their own items, each linked to its canonical definition where one
  exists.
- replaceMode parameter (REPLACE/NOREPLACE) with its defaults documented.
- Each link target appears once per file; EN/RU link sets match.

Grammar/semantics verified against LsfLogics.g (formEventDeclaration /
changeEventDeclaration / formContainerEventDeclaration /
scheduleEventDeclaration) and ScriptingFormEntity.addScriptedFormEvents.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@pavel-miniutka pavel-miniutka merged commit 4756e26 into master Jun 11, 2026
1 check passed
@pavel-miniutka pavel-miniutka deleted the docs/B31 branch June 11, 2026 09:44
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.

1 participant