@smartbit4all/ng-client 7.2.1 → 7.2.2

package/HTML-WIDGET.md

@@ -140,6 +140,54 @@ távozását:
 - A `backwards` kitöltés a belépésnél azért jó, mert a vége után a `:hover` és a többi szabály
   ismét mozgathatja az elemet (a `both` vagy a `forwards` animációs értéke felülírná őket).
 
+## A szerver-fázis
+
+A szerver-helyőrző a platform template-dialektusa: `${alias:/útvonal#mező?stratégia}`, mellette a
+`data-sb4-context` (iteráció) és a `data-sb4-if` (feltétel) attribútum. A builder a **nyitásáról**
+ismeri fel — `${alias:/` —, a sima `${name}` neki és a motornak is közömbös szöveg. Literálként
+`${`-nak írd.
+
+Három út oldja fel, és **egyik sem fut magától**:
+
+| Út | Mikor | Hiba esetén |
+|---|---|---|
+| `resolveTemplate(ctx, …)`, és az eredmény megy a `html(...)`-be | a build előtt | elnyel: logol, és a kulcsot vagy üres stringet ad vissza |
+| `h.template(ctx, KEY)` | a widget felépítésekor, kulcsból (lásd *Stíluslap a template-kulcs mellől*) | dob |
+| `h.resolveLater()` + `resolveHtml(ctx, layout)` | a **felépített layouton** | dob |
+
+```java
+SmartComponentLayoutDefinition layout = layoutBuilder(view)
+    .vForm(f -> f.html(h -> h.html(CARD_HTML).resolveLater()))
+    .build();
+resolveHtml(objectApi.contextObject().set("contact", contact), layout);   // PageApiImpl
+```
+
+- A `resolveHtml` bejárja a layout `FORM` / `CONTAINER` fáját és a widgetek gyerek-widgetjeit, és
+  minden HTML widget `html`-jét feloldja **ugyanazzal a ctx-szel**. A `css`, a `root` és a `fields`
+  marad. A gridekhez nem nyúl — egy sor-layout maga is layout, arra külön hívható. Page-en kívül:
+  `ObjectLayouts.resolveHtml(layout, resolver, objectApi, ctx)`; listára is van változata.
+- **Amiben nincs `${alias:/`, ahhoz hozzá sem ér** — az a html nem megy át a motoron, tehát nem is
+  normalizálódik. Ezért bármilyen layoutra ráhívható, és a második futás egy már feloldott
+  widgeten nem csinál semmit.
+- **Helyben módosít.** Ha az adat változik, **építsd újra a layoutot, ne oldd fel újra**: a
+  view-ban tárolt, egyszer már feloldott layoutban nincs mit feloldani, az új ctx-szel hívott
+  második futás némán a régi értékeket hagyja. Aki a feloldatlan eredetit meg akarja tartani,
+  másolaton hívja.
+- **Hangosan bukik** (`IllegalStateException`): ha van `${alias:/`, de nincs template-modul a
+  hostban; és ha a feloldás **után** is maradt — a motor az ismeretlen aliasú helyőrzőt ugyanis
+  szó nélkül benne hagyja. A motor másik két csendes esete megmarad: a hiányzó / `null` mező
+  helyére szóköz kerül, a mezőszintű feloldási hiba helyére a „Feldolgozási hiba" szöveg.
+
+**A `build()` őre.** Az a `${alias:/`, amit a három út egyike sem oldott fel, régen szó nélkül
+kiment a kliensre, és nyersen megjelent. Most a `HtmlWidgetBuilder.build()` `IllegalStateException`-t
+dob rá, kivéve ha a widget `resolveLater()`-t mondott. Ez a `vf.html(String)`, az
+`ObjectLayoutBuilder.html(...)` és a `GridBuilder.htmlColumn(...)` útjára is igaz.
+
+**Üres ctx-szel semmi nem oldódik fel**: a `${…}` literál marad (és a `build()` elbukik rajta), a
+`data-sb4-context` elemek eltűnnek. A grid-szintű sor-layoutnak és az oszlop-sablonnak nincs
+szerver-oldali, soronkénti kontextusa — ott a sorból jövő érték `{{…}}`, a szerveren számolt érték
+pedig a sor egy mezője legyen.
+
 ## A kliens-helyőrzők nyelvtana
 
 Logika-mentes Mustache-részhalmaz. Ugyanezt a nyelvtant olvassa a Java-oldali
@@ -253,6 +301,7 @@ escape-pel), a pipe-ok balról jobbra láncolhatók, a kimenetük is escape-en m
 | Hol | Mi történik |
 |---|---|
 | Java-builder (`build()`) | `IllegalArgumentException`: párosítatlan / keresztezett szekció, raw tag, érvénytelen path vagy `root`, a `root` fölé mutató `../`, ismeretlen pipe, rossz pipe-szintaxis, üres `data-sb4-toolbar` / `data-sb4-action` |
+| Java-builder (`build()`), `resolveHtml` | `IllegalStateException`: feloldatlan szerver-helyőrző (`${alias:/`), lásd *A szerver-fázis* |
 | kliens | nem dob: `console.error`, és a html **feloldatlanul** kerül ki — látható hiba, nem üres kártya |
 
 Egyetlen szándékos különbség: az ismeretlen pipe-név a kliensen csak warn (az érték formázatlanul
@@ -264,7 +313,10 @@ Ha a html átmegy a szerver template-motorján (Jsoup), akkor:
 
 - **egy gyökérelem kötelező** — a gyökér-szintű szöveg és szekció-tag eldobódik;
 - táblázatban **explicit `<tbody>`** kell, különben a parser a `{{#rows}}` után szúr egyet;
-- a whitespace-re (`:empty`, `white-space: pre`) ne építs, a motor átírja.
+- a whitespace-re (`:empty`, `white-space: pre`, `&nbsp;`) ne építs, a motor átírja;
+- a szerverről behelyettesített **érték ne tartalmazzon `{{`-t**: a motor HTML-escape-eli, de a
+  `{{` átmegy rajta, és a kliens helyőrzőnek olvasná (a néző saját adatán oldaná fel);
+- `?stratégia` után is állhat `{{…}}` — a stratégia a `{{`-on nem nyúl át.
 
 ## Toolbar-slot
 

package/fesm2022/smartbit4all-ng-client.mjs

@@ -11621,6 +11621,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
 class SmartformComponent {
     constructor() {
         this.service = inject(SmartFormService);
+        this.changeDetector = inject(ChangeDetectorRef);
         this._destroy$ = new Subject();
         this.originalWidgets = [];
         this.sophisticatedValueChange = new Subject();
@@ -11746,6 +11747,8 @@ class SmartformComponent {
         this.form = this.service.toFormGroup();
         this.syncClientBindings();
         this.service.widgetsChanged();
+        // A form whose widgets were all hidden has no child to mark it for check.
+        this.changeDetector.markForCheck();
     }
     ngOnDestroy() {
         if (this.followsClient) {