Tree List: Expand/Collapse

Nazaj: predstavitveni pregled

Stanje: [Live].

osnovna pogodba Tree Lista že razumljena (expanded/childrenKey).

Dualizem odjemalec/strežnik, tako kot pri razvrščanju: $opts['expandUrl'] ponuja rezervni način brez JS (analogno sortUrl-u pri dataGrid() Sorting-u); ob prisotnem JavaScriptu scripts/treelist.js prevzame razširjanje/strnjevanje na strani odjemalca, brez ponovnega nalaganja strani.

$expandUrl = static fn (string $key, bool $expand) => wl($ID, ['toggle' => $key, 'x' => $expand ? 1 : 0]);
echo $widgets->treeList($columns, $rows, [
    'rowKey'    => 'id',
    'expanded'  => $_SESSION['treelist_expanded'] ?? [],
    'expandUrl' => $expandUrl,
]);

Vsaka nadrejena vrstica nosi vidno povezavo za razširjanje/strnjevanje (.wk-treelist__toggle, ▶/▼, z dinamičnim aria-label „razširi„/„strni“) v svojem prvem stolpcu: $opts['expandUrl'](string $key, bool $expand) priskrbi strežniški URL, ki posodobi $opts['expanded'] za naslednji izris.

Razširi vse / strni vse: expandUrl se samodejno izriše kot orodna vrstica nad seznamom (klic toolbar()), gumbi pokličejo isti callable s psevdoključema *all oziroma *none; strežnik nastavi expanded na vse ključe nadrejenih vrstic oziroma na prazno polje. To so navadne povezave, brez posebnega primera glede na posamezno vrstico.

Plast odjemalca (scripts/treelist.js): že izrisana (strežniško razširjena) poddrevesa se na strani odjemalca strnejo in ponovno razširijo brez ponovnega nalaganja (atribut hidden, sinhronizacija aria-expanded); razširjanje strežniško strnjene vrstice še vedno sledi povezavi — njeni otroci so namerno odsotni iz DOM (meja izrisa iz osnove).

Glej odsek 4; obravnavalnik zaslona posodobi expanded iz parametra toggle/x (oziroma nastavi vse/nobenega pri *all/*none) in znova izriše.

• Strnjevanje na strani odjemalca je čisto vizualno — strežniško stanje (expanded) se spremeni šele prek povezav; po ponovnem nalaganju spet velja strežniško stanje.

Preklop za razširjanje/strnjevanje je nativna, fokusirljiva povezava z dinamičnim aria-label — upravljanje s tipkovnico in bralnikom zaslona deluje brez dodatne kode; aria-expanded na vrstici sledi stanju.

Simptom: „Razširi vse„ deluje, vendar se posamezne vrstice po ponovnem nalaganju znova strnejo.

Vzrok: obravnavalnik zaslona ne shrani expanded trajno (npr. pozabljena seja).

Rešitev: shraniti expanded na strani strežnika in ga posredovati pri izrisu (odsek 4).

• predstavitveni pregled — vsaka kategorija
• Tree List: osnove — pogodba expanded/childrenKey
• DataGrid: sorting — vzor za dualizem odjemalec/strežnik