Dokumentacija: Custom Modal Web Komponente

Kompletna tehnička referenca za svih 8 HTML5 Web Komponenti (HTML struktura, unutrašnji tagovi za CSS stilizaciju, pojedinačni atributi, JavaScript metode i događaji).

0. Instalacija, Auto-load i Globalni CSS Osnova sistema

Biblioteka zahteva samo uključivanje modals.js fajla. Na samom početku izvršavanja, modals.js čita document.currentScript.src, izdvaja tačnu putanju foldera u kom se nalazi i automatski u <head> ubacuje <link rel="stylesheet" href="...modals.css">. Time se u potpunosti zaobilazi eventualni <base href="/"> tag na stranici.

Uključivanje u HTML

<script src="putanja/do/modals.js" defer></script>

Globalne CSS Varijable i Pomoćne Klase

CSS Varijabla / Selektor Podrazumevana vrednost Opis i namena u CSS-u
--modal_backdrop 20, 20, 20 RGB vrednost boje zatamnjene pozadine (::backdrop) iza svih modala. Koristi se unutar rgba(var(--modal_backdrop), 0.5) ili 0.8.
--modal_box_background 98, 98, 98 RGB vrednost boje pozadine dijaloških prozora (modal-box, modal-confirm, modal-alert, modal-wizard, modal-toast).
--modal_box_color 255, 255, 255 RGB vrednost boje teksta, linija razdvajanja i SVG ikonica unutar dijaloških prozora.
body:has(...:popover-open) overflow: hidden Automatski zamrzava skrolovanje glavne stranice dok je otvoren bilo koji blokirajući modal.
body:has(...:popover-open)::after position: fixed; inset: 0; z-index: 20; Fizički, nevidljivi štit preko cele stranice koji sprečava hover efekte i klikove na pozadinske elemente dok je modal otvoren.
.modal-btn Osnovni stil dugmeta Opšta klasa za dugmad unutar modala (padding, заobljene ivice, efekat klika).
.modal-btn-confirm background-color: #3498db Plavo dugme za primarnu akciju / potvrdu.
.modal-btn-cancel background-color: rgba(255,255,255,0.2) Poluprovidno dugme za odustajanje / povratak.

1. <modal-box> — Standardni prozor Osnovni dijalog

Osnovna komponenta za prikazivanje dijaloga, formi, tabela ili obaveštenja. Sama kreira dugme za zatvaranje i upravlja režimima zaključavanja.

Struktura HTML-a

<modal-box id="moj_modal" persistent>
  <modal-header>Naslov prozora</modal-header>
  <modal-main>
    <p>Glavni sadržaj modala koji dobija vertikalni skrol ako pređe visinu ekrana.</p>
  </modal-main>
  <modal-footer>
    <button class="modal-btn modal-btn-cancel" onclick="document.getElementById('moj_modal').hide()">Zatvori</button>
    <button class="modal-btn modal-btn-confirm">Sačuvaj</button>
  </modal-footer>
</modal-box>

Unutrašnji tagovi i CSS selektori u okviru <modal-box>

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-box Piše korisnik Glavni kontejner prozora (dimenzije, background-color, border-radius, padding, box-shadow).
modal-box:popover-open CSS stanje Aktivno stanje kada je modal otvoren (uključuje display: flex; flex-direction: column;).
modal-box::backdrop Pseudo-element Zatamnjena i zamućena pozadina iza modala (background-color i backdrop-filter: blur(5px)).
modal-close Generiše JS Dugme X u gornjem desnom uglu (top: 15px; right: 20px;). Automatski se ubacuje na početak modala.
modal-close svg Generiše JS Vektorska SVG ikonica unutar modal-close dugmeta (dimenzije 30px x 30px, boja fill: currentColor).
modal-header Piše korisnik Gornje zaglavlje prozora (veličina fonta 1.4rem, bold, donja linija border-bottom).
modal-main Piše korisnik Centralni deo prozora za glavni sadržaj (ima flex: 1 i overflow-y: auto za automatsko skrolovanje).
modal-footer Piše korisnik Donji deo prozora namenjen za dugmad (display: flex, gornja linija border-top, razmak gap: 10px).

Podržani HTML Atributi

Atribut Moguće vrednosti Detaljan opis ponašanja
persistent prazno, "true" ili "false" Prebacuje modal u popover="manual" režim. Sprečava zatvaranje modala klikom na sivu pozadinu (backdrop) i pritiskom na taster Escape. Dugme X (<modal-close>) ostaje vidljivo i funkcionalno.
locked prazno, "true" ili "false" Prebacuje modal u popover="manual" režim, sprečava zatvaranje klikom na pozadinu i tasterom Escape, i putem CSS-a sakriva X dugme (display: none !important). Korisnik može zatvoriti modal isključivo ako mu to omogućiš preko JS metode .hide().
forced prazno, "true" ili "false" Najstroži nivo zaključavanja. Ponaša se isto kao locked (nema zatvaranja na pozadinu/ESC i sakriveno je X dugme), ali dodatno aktivira window.onbeforeunload zaštitu koja sprečava korisnika da osveži stranicu (F5 / Reload) ili zatvori karticu pregledača dok je modal otvoren.

JavaScript Metode i Događaji

Metoda / Događaj Parametri Detaljan opis
modal.show() nema Proverava trenutne atribute zaključavanja i otvara modal na ekranu (poziva nativni showPopover()).
modal.hide() nema Zatvara modal (poziva nativni hidePopover()) i vraća skrol glavnoj stranici.
modal.persistent(state) state: true ili false Dinamički postavlja ili uklanja atribut persistent. Može se pozvati i dok je modal već otvoren bez njegovog zatvaranja.
modal.locked(state) state: true ili false Dinamički postavlja ili uklanja atribut locked (trenutno sakriva ili prikazuje X dugme).
modal.forced(state) state: true ili false Dinamički postavlja ili uklanja atribut forced i odmah ažurira beforeunload zaštitu od osvežavanja stranice.
addEventListener('toggle', fn) event objekat Nativni Popover događaj koji se okida pri svakom otvaranju (event.newState === "open") i zatvaranju (event.newState === "closed").

Interaktivni primeri za <modal-box>

Standardni Modal Box

Probaj da klikneš na sivu pozadinu, na X u uglu ili pritisni ESC na tastaturi.

2. <modal-picture> — Prikaz pojedinačne slike Zoom & Fullscreen

Komponenta za prikazivanje slike preko celog ekrana sa automatskim spinerom dok se slika učitava, naprednim zumiranjem u tačku kursora/prstiju, panovanjem i podrškom za Fullscreen API.

Struktura HTML-a

<modal-picture id="moja_slika" zoom persistent>
  <picture>
    <img src="slika-visoke-rezolucije.jpg" alt="Opis slike">
  </picture>
  <picture-title>Naslov slike</picture-title>
  <picture-description>Detaljan opis slike ispod naslova...</picture-description>
</modal-picture>

Unutrašnji tagovi i CSS selektori u okviru <modal-picture>

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-picture Piše korisnik Glavni kontejner preko celog ekrana (width: 100%; height: 100%; background: transparent;).
modal-picture:popover-open CSS stanje Aktivno stanje kada je modal otvoren (display: flex; justify-content: center; align-items: center;).
modal-picture::backdrop Pseudo-element Tamna pozadina iza slike (rgba(var(--modal_backdrop), 0.8) sa backdrop-filter: blur(5px)).
modal-close Generiše JS Belo dugme X u gornjem desnom uglu ekrana (top: 20px; right: 30px;).
modal-fullscreen Generiše JS Belo dugme za Fullscreen režim smešteno levo od X dugmeta (top: 21px; right: 70px;).
modal-loader Generiše JS Animirani kružni spiner na sredini ekrana koji se prikazuje dok se slika ne učita sa servera, a zatim se sam briše.
picture Piše korisnik Omotač oko <img> elementa koji centrira sliku na ekranu.
img Piše korisnik Sama slika (podrazumevano ograničena na max-width: calc(100vw - 140px); max-height: calc(100vh - 144px); object-fit: contain;).
picture-info Generiše JS Donji kontejner sa tamnim gradijentom u koji JS automatski premešta <picture-title> i <picture-description>. Ima pointer-events: none kako ne bi smetao pri prevlačenju zumirane slike.
picture-title Piše korisnik Naslov slike na dnu ekrana (poluprovidna tamna pozadina sa backdrop-filter: blur(5px) i zaobljenim ivicama).
picture-description Piše korisnik Opis slike ispod naslova (manji font 0.9rem, poluprovidna pozadina sa blur efektom).

Podržani HTML Atributi

Atribut Na kom tagu se piše Detaljan opis ponašanja
zoom <modal-picture> Dozvoljava uveličavanje slike u rasponu od 1x do 5x (točkićem miša, tasterima +/- ili štipanjem sa dva prsta). Ne dozvoljava smanjivanje slike ispod njene početne veličine (1x).
zoom-free <modal-picture> Dozvoljava slobodno skaliranje slike u rasponu od 0.2x (umanjenje) do 5x (uvećanje), kao i slobodno prevlačenje (panovanje) čak i kada je slika manja od ekrana.
class="zoom_in" <img> Alternativni način da uključiš standardni zum (1x do 5x) dodavanjem CSS klase direktno na <img> tag umesto atributa na modalu.
class="zoom_free" <img> Alternativni način da uključiš slobodni zum (0.2x do 5x) dodavanjem CSS klase direktno na <img> tag.
persistent <modal-picture> Sprečava zatvaranje modala klikom na tamnu pozadinu oko slike i pritiskom na taster Escape. Dugme X ostaje vidljivo.
locked <modal-picture> Sprečava zatvaranje klikom na pozadinu i tasterom Escape, i sakriva X dugme. Modal se može zatvoriti samo putem JS metode .hide().
forced <modal-picture> Sprečava zatvaranje na pozadinu/ESC, sakriva X dugme i blokira osvežavanje (F5) ili zatvaranje stranice dok je slika otvorena.

JavaScript Metode i Događaji

Metoda / Događaj Parametri Detaljan opis
picModal.show() nema Otvara modal sa slikom i aktivira kontrole tastature za zumiranje i panovanje.
picModal.hide() nema Zatvara modal, resetuje zum i poziciju slike na početne vrednosti (1x) i automatski izlazi iz Fullscreen režima ukoliko je bio aktivan.
picModal.toggleFullscreen() nema Prebacuje prikaz u nativni Fullscreen režim (ili izlazi iz njega) bez zatvaranja modala i bez gubitka trenutnog zuma.
picModal.persistent(state) state: true ili false Dinamički pali ili gasi persistent zaštitu od zatvaranja klikom na pozadinu.
picModal.locked(state) state: true ili false Dinamički pali ili gasi locked režim (sakriva/prikazuje X dugme).
picModal.forced(state) state: true ili false Dinamički pali ili gasi forced režim i zaštitu od osvežavanja stranice.
addEventListener('toggle', fn) event objekat Okida se kada se modal slike otvori (event.newState === "open") ili zatvori (event.newState === "closed").

Interaktivni primeri za <modal-picture>

Pas Standardni Zoom (1x do 5x) Koristi točkić miša, +/- na tastaturi, strelice za pomeranje ili dvoklik za reset. Kanjon Slobodni Zoom-Free (0.2x do 5x) Ovde možeš odzumirati sliku ispod 100% i slobodno je pomerati po ekranu.

4. <modal-confirm> — Potvrdni dijalog Async / Promise

Nasleđuje ModalBox i služi za asinhrono postavljanje pitanja korisniku sa dva odgovora (Potvrdi / Odustani). Vraća Promise<boolean> pa se koristi uz async / await sintaksu.

Struktura HTML-a

<!-- Varijanta 1: Sa unapred definisanim tekstom -->
<modal-confirm id="potvrda_brisanja" title="Brisanje naloga" ok-text="Obriši" cancel-text="Odustani" persistent>
  <modal-main>Da li ste sigurni da želite trajno da obrišete nalog?</modal-main>
</modal-confirm>

<!-- Varijanta 2: Prazan element kom se pitanje i naslov šalju kroz .ask(poruka, naslov) -->
<modal-confirm id="univerzalni_confirm"></modal-confirm>

Unutrašnji tagovi i CSS selektori u okviru <modal-confirm>

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-confirm Piše korisnik Glavni kontejner prozora (nasleđuje izgled modal-box-a, min-width: 320px).
modal-confirm:popover-open CSS stanje Aktivno stanje kada je prozor otvoren (display: flex; flex-direction: column;).
modal-confirm::backdrop Pseudo-element Zatamnjena i zamućena pozadina iza prozora.
modal-close Generiše JS Dugme X u gornjem desnom uglu. Klik na X automatski razrešava Promise sa vrednošću false.
modal-header Piše korisnik ili JS Zaglavlje sa naslovom pitanja. Ako ga ne napišeš u HTML-u, JS ga sam kreira iz atributa title.
modal-main Piše korisnik ili JS Centralni deo u kom stoji tekst pitanja. Ako ga ne napišeš u HTML-u, JS ga sam kreira.
modal-footer Generiše JS Donji kontejner u kom se nalaze dugmad za odustajanje i potvrdu.
button.modal-btn-cancel Generiše JS Dugme za odustajanje (klik vraća false).
button.modal-btn-confirm Generiše JS Plavo dugme za potvrdu (klik vraća true).

Podržani HTML Atributi

Atribut Moguće vrednosti Detaljan opis ponašanja
title Tekst (npr. "Potvrda") Postavlja tekst u automatski generisanom <modal-header> tagu. Podrazumevana vrednost je "Potvrda".
ok-text Tekst (npr. "Da, obriši") Postavlja tekst na plavom dugmetu za potvrdu. Podrazumevana vrednost je "Potvrdi".
cancel-text Tekst (npr. "Ne") Postavlja tekst na dugmetu za odustajanje. Podrazumevana vrednost je "Odustani".
persistent prazno, "true" ili "false" Sprečava zatvaranje dijaloga klikom na sivu pozadinu ili tasterom Escape. Dugme X ostaje vidljivo.
locked prazno, "true" ili "false" Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme, tako da korisnik mora da klikne na jedno od dva ponuđena dugmeta u footeru.
forced prazno, "true" ili "false" Isto kao locked, plus blokira osvežavanje (F5) ili zatvaranje stranice dok korisnik ne odgovori na pitanje.

JavaScript Metode i Događaji

Metoda / Događaj Parametri Detaljan opis
await confirmModal.ask(message, title) message (opciono): tekst pitanja
title (opciono): novi naslov
Otvara modal i vraća Promise<boolean>. Vraća true ako korisnik klikne na dugme za potvrdu, a false ako klikne na Odustani, X, pozadinu ili Escape. Funkcija u kojoj pozivaš await mora biti označena sa async.
confirmModal.show() nema Otvara dijalog bez kreiranja novog Promise-a (korisno ako slušaš događaje confirm i cancel).
confirmModal.hide() nema Zatvara dijalog (ako je bio aktivan Promise, razrešava ga sa false).
confirmModal.persistent(state) state: true ili false Dinamički uključuje ili isključuje persistent režim.
confirmModal.locked(state) state: true ili false Dinamički uključuje ili isključuje locked režim (sakriva/prikazuje X dugme).
confirmModal.forced(state) state: true ili false Dinamički uključuje ili isključuje forced režim.
addEventListener('confirm', fn) CustomEvent Okida se kada korisnik klikne na dugme za potvrdu (event.detail === true).
addEventListener('cancel', fn) CustomEvent Okida se kada korisnik klikne na dugme za odustajanje (event.detail === false).
addEventListener('toggle', fn) event objekat Nativni događaj otvaranja i zatvaranja prozora.

Interaktivni primeri za <modal-confirm>

Status: Čeka se akcija korisnika...
Da li ste sigurni da želite trajno da obrišete izabrani zapis iz baze podataka?

5. <modal-alert> — Statusno obaveštenje Info / Success / Warning / Error

Nasleđuje ModalBox i služi za prikazivanje statusnih poruka sa jednim dugmetom za potvrdu i automatskom SVG ikonicom u zaglavlju.

Struktura HTML-a

<modal-alert id="moj_alert" type="success" title="Uspešno" ok-text="U redu">
  <modal-main>Podaci su uspešno sačuvani!</modal-main>
</modal-alert>

Unutrašnji tagovi i CSS selektori u okviru <modal-alert>

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-alert Piše korisnik Glavni kontejner prozora obaveštenja.
modal-alert:popover-open CSS stanje Aktivno stanje kada je prozor otvoren (display: flex).
modal-alert::backdrop Pseudo-element Zatamnjena i zamućena pozadina iza prozora.
modal-close Generiše JS Dugme X u gornjem desnom uglu.
modal-header Piše korisnik ili JS Zaglavlje u kom se nalaze statusna ikonica i naslov obaveštenja.
span.modal-status-icon Generiše JS Omotač statusne SVG ikonice (26px x 26px) koji se automatski ubacuje na početak modal-header-a kada postoji atribut type.
modal-main Piše korisnik ili JS Centralni deo sa tekstom obaveštenja.
modal-footer Generiše JS Donji deo prozora sa dugmetom za zatvaranje.
button.modal-btn-confirm Generiše JS Dugme za zatvaranje obaveštenja (podrazumevano piše "U redu").

Podržani HTML Atributi

Atribut Moguće vrednosti Detaljan opis ponašanja
type="info" "info" Postavlja plavu informacionu SVG ikonicu (#3498db) u zaglavlje modala.
type="success" "success" Postavlja zelenu SVG ikonicu potvrde/uspeha (#2ecc71) u zaglavlje modala.
type="warning" "warning" Postavlja žutu SVG ikonicu upozorenja — trougao sa uzvičnikom (#f1c40f) u zaglavlje modala.
type="error" "error" Postavlja crvenu SVG ikonicu greške (#e74c3c) u zaglavlje modala.
title Tekst Tekst naslova u <modal-header> tagu (podrazumevano "Obaveštenje").
ok-text Tekst Tekst na dugmetu u footeru (podrazumevano "U redu").
persistent prazno, "true" ili "false" Sprečava zatvaranje obaveštenja klikom na pozadinu i pritiskom na Escape.
locked prazno, "true" ili "false" Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme (korisnik mora da klikne na dugme "U redu").
forced prazno, "true" ili "false" Isto kao locked, plus blokira osvežavanje (F5) ili napuštanje stranice dok je obaveštenje otvoreno.

JavaScript Metode i Događaji

Metoda / Događaj Parametri Detaljan opis
await alertModal.alert(message, title, type) message: tekst poruke
title: naslov
type: 'info' | 'success' | 'warning' | 'error'
Dinamički menja poruku, naslov i ikonicu, otvara modal i vraća Promise<boolean> koji se razrešava sa true tek kada korisnik zatvori prozor.
alertModal.show() nema Otvara postojeći alert modal bez izmene teksta.
alertModal.hide() nema Zatvara alert modal i razrešava aktivni Promise.
alertModal.persistent(state) state: true ili false Dinamički pali ili gasi persistent režim.
alertModal.locked(state) state: true ili false Dinamički pali ili gasi locked režim.
alertModal.forced(state) state: true ili false Dinamički pali ili gasi forced režim.
addEventListener('toggle', fn) event objekat Nativni događaj otvaranja i zatvaranja prozora.

Interaktivni primeri za <modal-alert>

6. <modal-video> — Video i YouTube / Vimeo plejer 16:9 + Start sekunda

Komponenta za prikazivanje lokalnih video fajlova (<video>) ili YouTube/Vimeo snimaka (<iframe>) u 16:9 formatu, sa podrškom za definisanje početne sekunde i automatskim gašenjem zvuka/videa pri zatvaranju modala.

Struktura HTML-a

<!-- Primer 1: Nativni HTML5 video -->
<modal-video id="moj_video" start="10" autoplay>
  <video src="snimak.mp4" controls></video>
  <video-title>Naslov snimka</video-title>
  <video-description>Opis snimka ispod videa...</video-description>
</modal-video>

<!-- Primer 2: Direktno preko src atributa (automatski kreira iframe za YouTube/Vimeo ili video za mp4) -->
<modal-video id="yt_video" src="https://www.youtube.com/embed/aqz-KE-bpKQ" start="25" autoplay>
  <video-title>YouTube Video</video-title>
</modal-video>

Unutrašnji tagovi i CSS selektori u okviru <modal-video>

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-video Piše korisnik Glavni kontejner preko celog ekrana.
modal-video:popover-open CSS stanje Aktivno stanje kada je video modal otvoren (display: flex; justify-content: center; align-items: center;).
modal-video::backdrop Pseudo-element Zatamnjena pozadina iza videa (rgba(var(--modal_backdrop), 0.85) sa blur efektom).
modal-close Generiše JS Belo dugme X u gornjem desnom uglu (top: 20px; right: 30px;).
video-wrapper Generiše JS Kontejner sa odnosom stranica aspect-ratio: 16 / 9, crnom pozadinom, zaobljenim ivicama (border-radius: 8px) i senkom u koji JS automatski pakuje <video> ili <iframe>.
video Piše korisnik ili JS HTML5 video plejer (zauzima width: 100%; height: 100%; unutar video-wrapper-a).
iframe Piše korisnik ili JS Ugrađeni YouTube ili Vimeo iframe plejer (zauzima width: 100%; height: 100%; unutar video-wrapper-a).
picture-info Generiše JS Donji kontejner sa tamnim gradijentom u koji JS automatski smešta naslov i opis videa.
video-title (ili picture-title) Piše korisnik Naslov videa u donjem info bloku.
video-description (ili picture-description) Piše korisnik Opis videa ispod naslova u donjem info bloku.

Podržani HTML Atributi

Atribut Na kom tagu se piše Detaljan opis ponašanja
src <modal-video> URL adresa medija. Ako sadrži youtube.com, youtu.be ili vimeo.com, komponenta automatski kreira <iframe>. U suprotnom kreira HTML5 <video controls> element.
start <modal-video> Broj sekundi od kog video treba da krene pri otvaranju (npr. start="30" kreće od 30. sekunde). Radi i za HTML5 video i za YouTube/Vimeo.
start <video> Alternativno mesto za upisivanje početne sekunde direktno na <video start="30"> tagu unutar modala.
autoplay <modal-video> Automatski pokreće reprodukciju videa čim se modal otvori (kod YouTube/Vimeo plejera automatski dodaje autoplay=1 u URL).
persistent <modal-video> Sprečava zatvaranje video modala klikom na tamnu pozadinu oko plejera i pritiskom na Escape.
locked <modal-video> Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme.
forced <modal-video> Isto kao locked, plus blokira osvežavanje (F5) ili napuštanje stranice dok je video modal otvoren.

JavaScript Metode i Događaji

Metoda / Događaj Parametri Detaljan opis
videoModal.show() nema Otvara modal i pokreće video od početka (ili od sekunde definisane u HTML atributu start).
videoModal.show(startSeconds) startSeconds: broj sekundi (npr. 45) Otvara modal i pokreće video tačno od prosleđene sekunde (ovaj parametar ima prioritet nad HTML atributom start).
videoModal.hide() nema Zatvara modal, pauzira HTML5 video i vraća vreme na 0, odnosno prazni src atribut na <iframe>-u kako bi odmah zaustavio YouTube/Vimeo reprodukciju.
videoModal.persistent(state) state: true ili false Dinamički uključuje ili isključuje persistent režim.
videoModal.locked(state) state: true ili false Dinamički uključuje ili isključuje locked režim (sakriva/prikazuje X dugme).
videoModal.forced(state) state: true ili false Dinamički uključuje ili isključuje forced režim i zaštitu od osvežavanja stranice.
addEventListener('toggle', fn) event objekat Nativni događaj koji se okida pri otvaranju i zatvaranju video modala.

Interaktivni primeri za <modal-video>

HTML5 MP4 Video Primer Zatvaranjem modala video se automatski zaustavlja. YouTube Embed Primer Automatski kreće od 25. sekunde.

7. <modal-toast> i toast() — Iskačuće notifikacije Auto-stacking

Ne-blokirajuća obaveštenja koja se pojavljuju u izabranom uglu ekrana, automatski se slažu jedno iznad/ispod drugog i sama nestaju nakon zadatog broja sekundi. Mogu se pozivati direktno iz JavaScript-a bez pisanja HTML-a.

Struktura HTML-a (Opciono — ako ne koristiš globalnu JS funkciju toast())

<modal-toast id="moj_toast" type="success" duration="4" position="bottom-right">
  Podaci su uspešno sačuvani!
</modal-toast>

Unutrašnji tagovi i CSS selektori u okviru <modal-toast>

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-toast Generiše JS ili piše korisnik Glavni kontejner notifikacije (position: fixed; z-index: 30; min-width: 260px; max-width: 400px;).
modal-toast:popover-open CSS stanje Aktivno stanje otvorene notifikacije sa toastFadeIn animacijom ulaska.
modal-toast::backdrop Pseudo-element Uvek sakriven (display: none) kako notifikacija ne bi zatamnjivala ekran.
span.modal-status-icon Generiše JS Statusna SVG ikonica na levoj strani notifikacije (boja zavisi od type atributa).
toast-content Generiše JS Unutrašnji omotač u koji JS automatski smešta tekst poruke.
modal-close Generiše JS Malo dugme X (20px x 20px) na desnoj strani notifikacije za ručno zatvaranje.

Podržani HTML Atributi

Atribut Moguće vrednosti Detaljan opis ponašanja
type="info" "info" Prikazuje plavu informacionu SVG ikonicu (#3498db).
type="success" "success" Prikazuje zelenu SVG ikonicu uspeha (#2ecc71).
type="warning" "warning" Prikazuje žutu SVG ikonicu upozorenja (#f1c40f).
type="error" "error" Prikazuje crvenu SVG ikonicu greške (#e74c3c).
duration Broj sekundi (npr. "4") ili "0" Određuje posle koliko sekundi će se notifikacija sama zatvoriti. Podrazumevana vrednost je 4. Ako se postavi na 0, notifikacija se neće sama ugasiti dok korisnik ne klikne na X.
position="bottom-right" "bottom-right" Smešta notifikaciju u donji desni ugao ekrana (podrazumevana pozicija). Nove poruke se slažu nagore.
position="bottom-left" "bottom-left" Smešta notifikaciju u donji levi ugao ekrana. Nove poruke se slažu nagore.
position="bottom-center" "bottom-center" Smešta notifikaciju na dno ekrana po sredini. Nove poruke se slažu nagore.
position="top-right" "top-right" Smešta notifikaciju u gornji desni ugao ekrana. Nove poruke se slažu nadole.
position="top-left" "top-left" Smešta notifikaciju u gornji levi ugao ekrana. Nove poruke se slažu nadole.
position="top-center" "top-center" Smešta notifikaciju na vrh ekrana po sredini. Nove poruke se slažu nadole.

JavaScript Metode i Globalne Funkcije

Funkcija / Metoda Parametri Detaljan opis
window.toast(message, type, duration, position) message: tekst
type: 'info' (default)
duration: 4 (default)
position: 'bottom-right' (default)
Globalna funkcija koja dinamički kreira <modal-toast> element u document.body, prikazuje ga, slaže u niz sa ostalim aktivnim porukama i automatski ga uklanja iz DOM-a kada se zatvori.
toastEl.show(message, type, durationSeconds, position) Svi parametri su opcioni Metoda na postojećem <modal-toast> DOM elementu koja ga otvara (uz opcionu promenu teksta, tipa, trajanja ili pozicije).
toastEl.hide() nema Odmah zatvara notifikaciju, briše je iz DOM-a ako je kreirana dinamički i preračunava pozicije preostalih otvorenih notifikacija.
ModalToast.repositionAll(position) position: string pozicije Statička metoda klase koja preračunava visinu i razmak (12px) svih trenutno otvorenih toast poruka u datom uglu ekrana.

Interaktivni primeri za Toast notifikacije

8. <modal-wizard> — Višekoračni čarobnjak (Stepper) Koraci + Validacija

Nasleđuje ModalBox i vodi korisnika kroz više koraka (<wizard-step>). Automatski generiše gornju traku sa indikatorima koraka, upravlja vidljivošću dugmića (Prethodno / Sledeće / Završi) i vrši validaciju polja pre prelaska na naredni korak.

Struktura HTML-a

<modal-wizard id="moj_wizard" persistent>
  <modal-header>Konfiguracija sistema</modal-header>

  <wizard-step title="Mreža">
    <label>IP Adresa servera:</label>
    <input type="text" id="wiz_ip" required placeholder="192.168.1.10">
  </wizard-step>

  <wizard-step title="Kamere">
    <label>Broj kanala (1-16):</label>
    <input type="number" id="wiz_kanali" min="1" max="16" required value="4">
  </wizard-step>

  <wizard-step title="Potvrda">
    <p>Proverite unete podatke i kliknite na dugme za slanje.</p>
  </wizard-step>

  <wizard-previous>Prethodno</wizard-previous>
  <wizard-next>Sledeće</wizard-next>
  <wizard-finish>Pošalji</wizard-finish>
</modal-wizard>

Unutrašnji tagovi i CSS selektori u okviru <modal-wizard>

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-wizard Piše korisnik Glavni kontejner čarobnjaka.
modal-wizard:popover-open CSS stanje Aktivno stanje kada je čarobnjak otvoren (display: flex; flex-direction: column;).
modal-wizard::backdrop Pseudo-element Zatamnjena i zamućena pozadina iza čarobnjaka.
modal-close Generiše JS Dugme X u gornjem desnom uglu.
modal-header Piše korisnik Glavni naslov čarobnjaka na vrhu prozora.
wizard-steps-nav Generiše JS Horizontalna traka sa indikatorima svih koraka koja se automatski ubacuje odmah ispod <modal-header>-a.
.wizard-step-indicator Generiše JS Pojedinačni indikator koraka (sadrži broj i naziv koraka). Podrazumevano je poluprovidan (opacity: 0.45) dok korak ne postane aktivan ili završen.
.wizard-step-indicator.active CSS stanje Indikator trenutno aktivnog koraka (opacity: 1, kružni broj dobija plavu pozadinu #3498db).
.wizard-step-indicator.completed CSS stanje Indikator uspešno pređenog koraka (opacity: 1, kružni broj dobija zelenu pozadinu #2ecc71).
.wizard-step-number Generiše JS Kružni bedž (24px x 24px) sa rednim brojem koraka (1, 2, 3...).
.wizard-step-label Generiše JS Tekstualni naziv koraka pored kružnog broja (preuzet iz title atributa na <wizard-step>).
wizard-step Piše korisnik Kontejner pojedinačnog koraka. Samo trenutno aktivni korak ima display: block, dok su ostali sakriveni.
modal-footer Generiše JS ili piše korisnik Donja traka u koju JS automatski smešta <wizard-previous>, <wizard-next> i <wizard-finish> dugmad.
wizard-previous Piše korisnik ili JS Dugme za povratak na prethodni korak. Na prvom koraku automatski dobija visibility: hidden.
wizard-next Piše korisnik ili JS Plavo dugme (#3498db) za prelazak na sledeći korak. Na poslednjem koraku se automatski sakriva (display: none).
wizard-finish Piše korisnik ili JS Zeleno dugme (#2ecc71) za završetak čarobnjaka. Prikazuje se isključivo na poslednjem koraku.

Podržani HTML Atributi

Atribut Na kom tagu se piše Detaljan opis ponašanja
title <wizard-step> Određuje naziv tog koraka u gornjoj traci indikatora (npr. <wizard-step title="Mreža">). Ako se izostavi, ispisuje se "Korak 1", "Korak 2" itd.
prev-text <modal-wizard> Tekst za dugme "Nazad" ukoliko u HTML-u nije ručno napisan tag <wizard-previous> (podrazumevano "Nazad").
next-text <modal-wizard> Tekst za dugme "Dalje" ukoliko u HTML-u nije ručno napisan tag <wizard-next> (podrazumevano "Sledeće").
finish-text <modal-wizard> Tekst za završno dugme ukoliko u HTML-u nije ručno napisan tag <wizard-finish> (podrazumevano "Završi").
persistent <modal-wizard> Sprečava slučajno zatvaranje čarobnjaka klikom na sivu pozadinu ili pritiskom na Escape.
locked <modal-wizard> Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme, tako da korisnik mora da prođe sve korake do kraja.
forced <modal-wizard> Isto kao locked, plus blokira osvežavanje (F5) ili napuštanje stranice dok se čarobnjak ne završi.

JavaScript Metode i Događaji

Metoda / Događaj Parametri Detaljan opis
wizard.show() nema Otvara čarobnjak na koraku na kom se trenutno nalazi.
wizard.hide() nema Zatvara čarobnjak.
wizard.nextStep() nema Pokreće validaciju trenutnog koraka (HTML5 polja + custom validator + step-validate događaj) i, ako je sve ispravno, prelazi na sledeći korak.
wizard.prevStep() nema Vraća korisnika na prethodni korak bez pokretanja validacije.
wizard.goToStep(index, validateForward) index: broj koraka (od 0)
validateForward: boolean (default true)
Prebacuje prikaz na zadati indeks koraka. Ako je validateForward = true i prelazi se unapred, prvo proverava ispravnost trenutnog koraka.
wizard.reset() nema Vraća čarobnjak na prvi korak (indeks 0) bez pokretanja validacije.
wizard.finish() nema Pokreće validaciju poslednjeg koraka; ako je uspešna, okida događaj wizard-finish i zatvara modal.
wizard.setValidator(fn) fn: (stepIndex, stepEl) => boolean Postavlja tvoju JavaScript funkciju za validaciju. Funkcija dobija indeks trenutnog koraka (0, 1...) i DOM element tog <wizard-step>-a. Ako vrati false, prelazak na sledeći korak se blokira.
wizard.persistent(state) state: true ili false Dinamički uključuje ili isključuje persistent režim.
wizard.locked(state) state: true ili false Dinamički uključuje ili isključuje locked režim.
wizard.forced(state) state: true ili false Dinamički uključuje ili isključuje forced režim.
addEventListener('step-change', fn) CustomEvent Okida se pri svakoj promeni koraka. U event.detail.step nalazi se indeks novog aktivnog koraka.
addEventListener('step-validate', fn) CustomEvent (otkaziv) Okida se pre prelaska na naredni korak. Sadrži event.detail.step i event.detail.stepElement. Pozivanjem event.preventDefault() možeš blokirati prelazak.
addEventListener('wizard-finish', fn) CustomEvent Okida se kada korisnik uspešno klikne na završno dugme (<wizard-finish>) na poslednjem koraku.
addEventListener('toggle', fn) event objekat Nativni događaj otvaranja i zatvaranja prozora.

Interaktivni primer za <modal-wizard>

Podešavanje LPR čvora

Probaj da obrišeš polje ili upišeš 10.0.0.1 pa klikni na "Sledeće" da vidiš validaciju.

Svi parametri su provereni i spremni za upis u konfiguraciju.

Klikni na Pošalji da završiš proces.

Prethodno Sledeće Pošalji