TreeView: Drag & Drop

Nazaj: predstavitveni pregled

Stanje: [Live]. Vir: lib/plugins/wkfluentui/helper/widgets.php (povezave za premikanje) in lib/plugins/wkfluentui/scripts/treeview.js (plast vlečenja). Referenca: DevExpress-ov drag&drop drevesa (premikanje vozlišč med skupinami).

osnovna pogodba TreeViewa že razumljena; vsako premakljivo vozlišče potrebuje key; klicatelj priskrbi POST-končno točko za premike.

Najprej vidni gumbi, vlečenje kot plast nad njimi: povezavi za premikanje gor/dol (reorderUrl) sta primarna, s tipkovnico upravljiva in brez JS delujoča pot. HTML5 vlečenje in spuščanje pride izključno dodatno (reorderAction) in nikoli ne nadomesti gumbov — vlečenje ni upravljivo za uporabnike tipkovnice (načelo iz layout → Mehanika postavitve).

echo $widgets->tree($nodes, [
    'reorderUrl'    => static fn (string $key, string $op) => wl($ID, ['move' => $key, 'dir' => $op]),
    'reorderAction' => wl($ID, ['do' => 'move']),
]);

• $opts['reorderUrl'] — callable(string $key, string $op): string z op ∈ up/down: izriše na vozlišče s key dve vidni povezavi za premikanje (.wk-tree__move, z aria-label). Strežnik izvede premik ob klicu URL-ja.
• $opts['reorderAction'] (URL) — aktivira plast vlečenja: korensko <ul> nosi data-wk-reorder-action; scripts/treeview.js naredi key-vozlišča vlečljiva in ob spustitvi pošlje dinamični obrazec z wk-tree-move (premaknjeno vozlišče), wk-tree-ref (ciljno vozlišče), wk-tree-pos (before/after) in sectok-om iz JSINFO — anonimne seje nimajo žetona, tam ostane pri povezavah.

Varnost (zavezujoče): strežnik ponovno preveri vsak premik — preveriti sectok (checkSecurityToken()), izključiti cikle, preveriti cilj glede na ACL uporabnika (brez premika v skupino, ki je ACL uporabnika ne pokriva) — isto pravilo kot pri vsaki množični akciji (glej Množične akcije → stran strežnika).

Glej odsek 4; klicateljev POST-obravnavalnik prebere wk-tree-move/ wk-tree-ref/wk-tree-pos, preveri sectok in ACL ter izvede premik.

• Spustitev na lastno poddrevo se na strani odjemalca prezre — preverjanje ciklov kljub temu ostaja obveznost strežnika (manipuliran POST zaobide odjemalca).
• Premikanje med drevesi (dve instanci tree()) ni del pogodbe.

Vidni povezavi ▲/▼ (z aria-label „Premakni navzgor/navzdol„) vedno ostaneta primarna, s tipkovnico upravljiva pot — vlečenje in spuščanje je čista plast udobnosti za miško.

Simptom: vlečenje se začne, spustitev pa nima učinka.

Vzrok: ni sectok-a (anonimna seja) ali manjka reorderAction — plast vlečenja se takrat namerno onemogoči.

Rešitev: preveriti prijavo; nastaviti reorderAction; povezavi ▲/▼ delujeta ne glede na to vedno.

• predstavitveni pregled — vsaka kategorija
• TreeView: osnove — osnovna pogodba tree()
• DataGrid: Data Editing (množična dejanja) — pravilo strežniške validacije za premikalne akcije