Skip to main content

Reorder

Reorder je komponent, ktorý umožňuje pomocou funkcionality Drag&Drop, zmeniť poradie položky ReorderItem v skupine.

Základné použitie

Atribút Disabled

Atribút disabled sa používa na zakázanie možnosti preusporiadania položiek v rámci Reorder. Keď je tento atribút nastavený, používateľ nebude môcť ťahať položky na zmenu ich poradia.

Rukoväť pre ťahanie

Pridaním elementu do slotu handle položky ReorderItem, môžete definovať špecifickú oblasť, ktorá bude slúžiť ako rukoväť pre ťahanie a preusporiadanie položiek. Toto umožňuje používateľom intuitívnejšie interakcie pri zmene poradia položiek.

Atribút Reverse - Opačné poradie

Atribút reverse sa používa na zmenu smeru preusporiadania položiek v rámci Reorder.

Drop Zóny

DropZone je komponent, ktorý predstavuje zónu určenú pre preusporiadanie obsahu.

Kedy použiť

Použite wje-reorder, keď chcete riešiť daný UI problém konzistentne v rámci WebJET dizajn systému.

Kedy nepoužiť

Nepoužívajte komponent mimo jeho zodpovednosti; pri netypickom prípade radšej zložte viac menších prvkov.

Prístupnosť

Skontrolujte klávesnicové ovládanie, focus stavy, kontrast a zrozumiteľné pomenovanie interaktívnych prvkov.

Odporúčané postupy

  • Preferujte API komponentu pred ručnými DOM zásahmi.
  • Držte sa dizajnových tokenov a konzistentných konvencií pomenovania.
  • Pred nasadením otestujte komponent v reálnych dátových scenároch.

Atribúty a vlastnosti

dragEl

PopisUkladá referenciu na prvok, ktorý sa práve ťahá.
Atribútdrag-el
Typnull
Predvolenénull

items

PopisDefinuje zoznam hodnôt spracovaných vo voľbe items.
Atribútitems
Typarray
Predvolené[]

originalIndex

PopisUkladá pôvodný index položky pred začiatkom presunu.
Atribútoriginal-index
Typnull
Predvolenénull

isDragging

PopisUrčuje, či je voľba is-dragging zapnutá a ovplyvňuje správanie komponentu.
Atribútis-dragging
Typboolean
Predvolenéfalse

offsetX

PopisNastavuje číselnú hodnotu používanú vo voľbe offset-x.
Atribútoffset-x
Typnumber
Predvolené0

offsetY

PopisNastavuje číselnú hodnotu používanú vo voľbe offset-y.
Atribútoffset-y
Typnumber
Predvolené0

cloneEl

PopisUkladá klon prvku použitý ako náhľad pri presúvaní.
Atribútclone-el
Typnull
Predvolenénull

Udalosti

NázovPopis
wje-reorder:changeVyvolá sa pri zmene hodnoty komponentu.

Metódy

attachEventListeners

PopisSpustí metódu attachEventListeners na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(element: any) => void

mouseDown

PopisSpustí metódu mouseDown na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(e: object) => void

touchStart

PopisSpustí metódu touchStart na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(e: any) => void

startDragging

PopisSpustí metódu startDragging na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(clientX: number, clientY: number, target: HTMLElement) => void

mouseMove

PopisSpustí metódu mouseMove na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(e: any) => void

touchMove

PopisSpustí metódu touchMove na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(e: TouchEvent) => void

moveElement

PopisPresunie element na novú pozíciu v dátach komponentu.
Signatúra(pageX: number, pageY: number) => void

mouseUp

PopisSpustí metódu mouseUp na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra() => void

touchEnd

PopisSpustí metódu touchEnd na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra() => void

stopDragging

PopisSpustí metódu stopDragging na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra() => void

dragStart

PopisSpustí metódu dragStart na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(e: DragEvent) => void

createClone

PopisVytvorí clone a pripojí ho do štruktúry komponentu.
Signatúra() => void

isMovingDown

PopisOverí, či je moving down aktuálne pravda.
Signatúra(droppedElement: any) => boolean

dispatchChange

PopisVyvolá vlastnú udalosť z kontextu komponentu.
Signatúra(from: number, to: number, order: Array<number>, orderElements: any) => void

CSS tieňové časti

NázovPopis
nativeŠtýluje koreňovú shadow časť komponentu.

CSS vlastné premenné

Pre tento komponent nie sú dostupné žiadne vlastné CSS vlastnosti.

Sloty

NázovPopis
defaultPredvolený slot pre hlavný obsah komponentu.