Skip to main content

Color Picker

shadow

Color picker je element, ktorý zobrazuje farebnú paletu a umožňuje používateľom vybrať jednu z jej farieb. Zobrazuje hex kód vybranej farby, ktorý je používateľom možné jednoducho skopírovať.

Základné použitie

Kedy použiť

Použite wje-color-picker, keď používateľ zadáva hodnotu, vyberá možnosti alebo vykonáva akciu vo formulári.

Kedy nepoužiť

Nepoužívajte ho len ako vizuálny dekoratívny prvok bez interakcie. V takom prípade uprednostnite prezentačné komponenty.

Prístupnosť

Vždy prepojte komponent s popisom (label/aria-label), zachovajte ovládanie klávesnicou a pri validačných chybách zobrazte zrozumiteľnú správu.

Odporúčané postupy

  • Majte jednotné validačné pravidlá a error stavy naprieč celým formulárom.
  • Pri asynchrónnych operáciách zobrazte stav načítania alebo disabled stav.
  • Pri zložitých formulároch preferujte menšie sekcie a okamžitú spätnú väzbu.

Atribúty a vlastnosti

inputEditable

PopisUrčuje, či je voľba input-editable zapnutá a ovplyvňuje správanie komponentu.
Atribútinput-editable
Typboolean
Predvolené-

Udalosti

NázovPopis
wje-color-picker:selectVyvolá sa pri výbere položky.

Metódy

parseSwatches

PopisSpustí metódu parseSwatches na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(value: string) => string[]

createSwatches

PopisVytvorí swatches a pripojí ho do štruktúry komponentu.
Signatúra(node: any) => void

setSliders

PopisNastaví sliders a aplikuje súvisiace zmeny stavu.
Signatúra(color: any) => void

dimension

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

getPointerPosition

PopisVráti pointer position z aktuálneho stavu komponentu.
Signatúra(e: any) => \{x: number, y: number\}

setMarkerPosition

PopisNastaví marker position a aplikuje súvisiace zmeny stavu.
Signatúra(x: any, y: any) => void

clampMarkerPosition

PopisSpustí metódu clampMarkerPosition na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra(x: number, y: number) => \{x: number, y: number\}

setColorAtPosition

PopisNastaví color at position a aplikuje súvisiace zmeny stavu.
Signatúra(x: any, y: any, alpha: any) => *|tinycolor

getHueAreaColor

PopisVráti hue area color z aktuálneho stavu komponentu.
Signatúra(color: string) => string

CSS tieňové časti

NázovPopis
anchorŠtýluje shadow časť anchor.
pickerŠtýluje shadow časť picker.
markerŠtýluje shadow časť marker.
color-areaŠtýluje shadow časť color-area.
hueŠtýluje shadow časť hue.
alphaŠtýluje shadow časť alpha.
color-previewŠtýluje shadow časť color-preview.
inputŠtýluje shadow časť input.

CSS vlastné premenné

NázovPopis
--wje-color-picker-areaVlastná CSS premenná na štýlovanie komponentu (area).
--wje-color-picker-valueVlastná CSS premenná na štýlovanie komponentu (value).
--wje-color-picker-swatchVlastná CSS premenná na štýlovanie komponentu (swatch).
--wje-color-picker-sizeVlastná CSS premenná na štýlovanie komponentu (size).
--wje-color-picker-radiusVlastná CSS premenná, ktorá riadi zaoblenie rohov.

Sloty

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