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, događaji, globalni JS API i dinamičko kreiranje putem document.createElement).

0. Instalacija, Auto-load, Zvuk 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. Iz iste putanje učitava se i zvučni fajl pop_sound.mp3 za notifikacije.

Uključivanje u HTML

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

Automatska provera dozvole za zvuk pri prvom učitavanju (LocalStorage)

Prilikom prvog učitavanja stranice (na događaj DOMContentLoaded), skripta proverava da li u localStorage postoji ključ toast_sound_enabled. Ukoliko je vrednost null (korisnik prvi put pristupa aplikaciji), automatski iskače zaključani modal.confirm dijalog sa pitanjem da li želi zvučna obaveštenja, a odgovor se trajno čuva kao "true" ili "false".

// Ručna promena ili provera statusa zvuka u bilo kom trenutku iz JS-a:
localStorage.setItem('toast_sound_enabled', 'true');  // Uključi zvuk
localStorage.setItem('toast_sound_enabled', 'false'); // Isključi zvuk
localStorage.removeItem('toast_sound_enabled');       // Resetuj (ponovo će pitati pri sledećem osvežavanju)

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, zaobljene 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>

Dinamičko kreiranje kroz JS (document.createElement)

function otvoriDinamickiBox() {
  const box = document.createElement('modal-box');
  box.setAttribute('persistent', 'true');

  box.innerHTML = `
    <modal-header>Dinamički Modal Box</modal-header>
    <modal-main>
      <p>Ovaj prozor je kreiran isključivo kroz JavaScript pomoću document.createElement('modal-box').</p>
    </modal-main>
    <modal-footer>
      <button class="modal-btn modal-btn-confirm" id=" zatvori_dyn_box">U redu</button>
    </modal-footer>
  `;

  document.body.appendChild(box);

  // Automatsko brisanje iz DOM-a kada se modal zatvori
  box.addEventListener('toggle', (e) => {
    if (e.newState === 'closed') box.remove();
  });

  box.querySelector('#zatvori_dyn_box').addEventListener('click', () => box.hide());
  box.show();
}

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 / JS 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>

Dinamičko kreiranje kroz JS (document.createElement)

Pošto je konstruktor klase ModalPicture očišćen od direktnog postavljanja atributa (prebačeno u connectedCallback), element se može bezbedno kreirati u memoriji, popuniti slikom i tekstom i tek onda ubaciti u document.body:

function otvoriDinamickuSliku(imgUrl, naslov, opis) {
  const picModal = document.createElement('modal-picture');
  picModal.setAttribute('zoom', '');

  picModal.innerHTML = `
    <picture><img src="${imgUrl}" alt="${naslov}"></picture>
    <picture-title>${naslov}</picture-title>
    <picture-description>${opis}</picture-description>
  `;

  document.body.appendChild(picModal);

  picModal.addEventListener('toggle', (e) => {
    if (e.newState === 'closed') picModal.remove();
  });

  picModal.show();
}

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 / JS 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> i modal.confirm() — Potvrdni dijalog Async / Promise + Locked

Nasleđuje ModalBox i služi za asinhrono postavljanje pitanja korisniku sa dva odgovora (Potvrdi / Odustani). Dijalog je automatski zaključan (locked="true" i bez X dugmeta) kako bi korisnik morao da izabere jednu od ponuđenih opcija. Podržava i statusnu SVG ikonicu (info, success, warning, error), vraća Promise<boolean> i pri zatvaranju ispisuje detaljan izveštaj u konzolu pregledača.

Način 1: Pozivanje direktno iz JavaScript-a (Bez pisanja HTML-a)

// A) Pomoću async / await (preporučeno)
const odgovor = await modal.confirm(
  "Da li ste sigurni da želite trajno da obrišete ovaj zapis?", // message
  "Brisanje zapisa",                                           // title (default: 'Potvrda')
  "Da, obriši",                                                // okButton (default: 'Potvrdi')
  "Odustani",                                                  // cancelButton (default: 'Odustani')
  "e"                                                          // type: 'i'|'info', 's'|'success', 'w'|'warning', 'e'|'error'
);

if (odgovor) {
  toast("Zapis je obrisan!", "s");
}

// B) Pomoću .then() sintakse (ili preko globalnog aliasa confirm())
modal.confirm("Da li želite da uključite zvuk?", "Podešavanje", "Uključi", "Ne želim", "i")
  .then((zeliZvuk) => {
    console.log("Korisnik je izabrao:", zeliZvuk);
  });

Način 2: Struktura u HTML-u ili preko document.createElement('modal-confirm')

<!-- Varijanta u HTML-u -->
<modal-confirm id="potvrda_brisanja" type="warning" title="Brisanje naloga" ok-text="Obriši" cancel-text="Odustani">
  <modal-main>Da li ste sigurni da želite trajno da obrišete nalog?</modal-main>
</modal-confirm>

<script>
  // Ručno kreiranje preko document.createElement
  const el = document.createElement('modal-confirm');
  el.setAttribute('ok-text', 'Prihvatam');
  el.setAttribute('cancel-text', 'Odbijam');
  document.body.appendChild(el);
  const rez = await el.ask('Da li prihvatate nove uslove korišćenja?', 'Uslovi korišćenja', 'info');
  el.remove();
</script>

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

Tag / Selektor Poreklo Opis i šta stilizuje u CSS-u
modal-confirm Generiše JS ili piše korisnik Glavni kontejner prozora (nasleđuje izgled modal-box-a, min-width: 320px). Automatski dobija locked="true".
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 (ne reaguje na klik jer je modal zaključan).
modal-header Piše korisnik ili JS Zaglavlje sa statusnom SVG ikonicom i naslovom pitanja. Ako ga ne napišeš u HTML-u, JS ga sam kreira iz atributa title.
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 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
type "info", "success", "warning", "error" Postavlja odgovarajuću obojenu SVG ikonicu u zaglavlje potvrdnog dijaloga.
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".
locked Podrazumevano "true" Automatski je uključen na svakom <modal-confirm> elementu (uklonjeno X dugme, blokiran klik na pozadinu i ESC).
forced prazno, "true" ili "false" Dodatno blokira osvežavanje (F5) ili zatvaranje stranice dok korisnik ne odgovori na pitanje.

JavaScript Metode, Globalni Pozivi i Događaji

Metoda / Globalna funkcija Parametri Detaljan opis
await modal.confirm(message, title, okButton, cancelButton, type) message: tekst
title: 'Potvrda'
okButton: 'Potvrdi'
cancelButton: 'Odustani'
type: 'warning' (ili 'i', 's', 'w', 'e')
Globalna funkcija koja dinamički kreira <modal-confirm> u document.body, čeka odgovor korisnika, briše element iz DOM-a, ispisuje formatirani CONFIRM log u konzolu (sa vremenom, izvorom, pitanjem i odgovorom) i vraća Promise<boolean>.
await confirmModal.ask(message, title, type) message (opciono)
title (opciono)
type (opciono)
Metoda na postojećem DOM elementu. Otvara modal i vraća Promise<boolean> (true za potvrdu, false za odustajanje).
confirmModal.show() / .hide() nema Otvara ili zatvara postojeći dijalog.
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).

Interaktivni primeri za <modal-confirm> i modal.confirm()

Status: Čeka se akcija korisnika... (Otvori i F12 Konzolu da vidiš log!)
Da li ste sigurni da želite trajno da obrišete izabrani zapis iz baze podataka?

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

Nasleđuje ModalBox i služi za prikazivanje važnih statusnih poruka sa jednim dugmetom za potvrdu i automatskom SVG ikonicom u zaglavlju. Kao i modal-confirm, automatski je zaključan (locked="true", bez X dugmeta i bez zatvaranja na pozadinu) kako korisnik ne bi slučajno propustio obaveštenje.

Način 1: Pozivanje direktno iz JavaScript-a (Bez pisanja HTML-a)

// Pozivanje globalne funkcije sa skraćenim ili punim nazivom tipa ('i', 's', 'w', 'e')
await modal.alert(
  "Vaša sesija ističe za 2 minuta. Sačuvajte izmene.", // message
  "Upozorenje sistema",                                // title (default: 'Obaveštenje')
  "Razumem",                                           // okButton (default: 'U redu')
  "w"                                                  // type (default: 'info')
);
console.log("Korisnik je pročitao obaveštenje i kliknuo na dugme.");

Način 2: Struktura u HTML-u ili preko document.createElement('modal-alert')

<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 Generiše JS ili piše korisnik Glavni kontejner prozora obaveštenja (automatski zaključan sa locked="true").
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-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 potvrdu.
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" (ili "i" kroz JS) Postavlja plavu informacionu SVG ikonicu (#3498db) u zaglavlje modala.
type="success" "success" (ili "s" kroz JS) Postavlja zelenu SVG ikonicu potvrde/uspeha (#2ecc71) u zaglavlje modala.
type="warning" "warning" (ili "w" kroz JS) Postavlja žutu SVG ikonicu upozorenja — trougao sa uzvičnikom (#f1c40f) u zaglavlje modala.
type="error" "error" (ili "e" kroz JS) 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").
locked Podrazumevano "true" Automatski postavljen — sakriva X dugme i sprečava zatvaranje na pozadinu/ESC (korisnik mora da klikne na dugme u footeru).

JavaScript Metode i Globalni Pozivi

Metoda / Globalna funkcija Parametri Detaljan opis
await modal.alert(message, title, okButton, type) message: tekst
title: 'Obaveštenje'
okButton: 'U redu'
type: 'info' (ili 'i', 's', 'w', 'e')
Globalna funkcija koja dinamički kreira <modal-alert>, prikazuje ga, čeka da korisnik klikne na dugme, briše element iz DOM-a i ispisuje ALERT grupu u konzolu pregledača.
await alertModal.alert(message, title, type) message, title, type Metoda na postojećem HTML <modal-alert> elementu koja ažurira sadržaj, otvara modal i vraća Promise<boolean>.
alertModal.show() / .hide() nema Otvara ili zatvara postojeći alert modal.

Interaktivni primeri za <modal-alert> i 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>

Dinamičko kreiranje kroz JS (document.createElement)

function otvoriDinamickiVideo(srcUrl, pocetnaSekunda = 0) {
  const vidModal = document.createElement('modal-video');
  vidModal.setAttribute('src', srcUrl);
  vidModal.setAttribute('autoplay', '');

  vidModal.innerHTML = `
    <video-title>Dinamički Video Plejer</video-title>
    <video-description>Kreiran kroz document.createElement('modal-video') sa startom od ${pocetnaSekunda}s.</video-description>
  `;

  document.body.appendChild(vidModal);

  vidModal.addEventListener('toggle', (e) => {
    if (e.newState === 'closed') vidModal.remove();
  });

  vidModal.show(pocetnaSekunda);
}

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 / JS 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 modal.toast() / toast() — Iskačuće notifikacije Auto-stacking + OS Notif

Ne-blokirajuća obaveštenja koja se pojavljuju u jednom od 6 uglova/pozicija ekrana, automatski se slažu jedno iznad/ispod drugog, pauziraju tajmer dok je kursor miša iznad njih, emituju zvučni signal (ako je odobren u localStorage), šalju sistemsku OS notifikaciju sa obojenim SVG-om kada kartica pregledača nije u fokusu i beleže formatiranu grupu u DevTools konzoli.

Način 1: Pozivanje kroz JS funkciju toast() ili modal.toast()

// Redosled parametara: toast(message, type = 'info', duration = 10, position = 'bottom-right')
// Podržane skraćenice za type: 'i' (info), 's' (success), 'w' (warning), 'e' (error)

toast("Sistem je spreman za rad.");                             // Info, 10s, bottom-right
toast("Podaci su uspešno sačuvani!", "s", 5, "bottom-center");  // Success, 5s, bottom-center
toast("Kritična greška na čvoru!", "e", 0, "top-right");        // Duration 0 = trajni toast (dok se ne klikne X)

Način 2: Struktura u HTML-u ili preko document.createElement('modal-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 i Vrednosti Parametara

Atribut / Parametar Moguće vrednosti Detaljan opis ponašanja
type="info" "info" ili "i" Prikazuje plavu informacionu SVG ikonicu (#3498db).
type="success" "success" ili "s" Prikazuje zelenu SVG ikonicu uspeha (#2ecc71).
type="warning" "warning" ili "w" Prikazuje žutu SVG ikonicu upozorenja (#f1c40f).
type="error" "error" ili "e" Prikazuje crvenu SVG ikonicu greške (#e74c3c).
duration Broj sekundi (default 10) ili 0 Određuje posle koliko sekundi će se notifikacija sama zatvoriti. Prelaskom miša preko notifikacije (mouseenter) tajmer se pauzira, a sklanjanjem miša (mouseleave) daje još 3 sekunde. Ako se postavi na 0, notifikacija je trajna i ostaje na ekranu sve dok korisnik ručno 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
modal.toast(message, type, duration, position)
ili skraćeno:
toast(message, type, duration, position)
message: tekst
type: 'info' (default)
duration: 10 (default)
position: 'bottom-right' (default)
Globalna funkcija koja dinamički kreira <modal-toast> element, ispisuje log grupu u konzolu, pušta zvuk, šalje sistemsku notifikaciju ako tab nije u fokusu i automatski uklanja element 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>

Dinamičko kreiranje kroz JS (document.createElement)

function otvoriDinamickiWizard() {
  const wiz = document.createElement('modal-wizard');
  wiz.setAttribute('persistent', 'true');
  wiz.setAttribute('prev-text', 'Nazad');
  wiz.setAttribute('next-text', 'Dalje');
  wiz.setAttribute('finish-text', 'Sačuvaj');

  wiz.innerHTML = `
    <modal-header>Dinamički Čarobnjak</modal-header>
    <wizard-step title="Korak 1"><p>Prvi korak kreiran kroz JS.</p></wizard-step>
    <wizard-step title="Korak 2"><p>Drugi korak kreiran kroz JS.</p></wizard-step>
  `;

  document.body.appendChild(wiz);

  wiz.addEventListener('wizard-finish', () => toast('Dinamički čarobnjak završen!', 's'));
  wiz.addEventListener('toggle', (e) => {
    if (e.newState === 'closed') wiz.remove();
  });

  wiz.show();
}

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 / JS 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

9. Globalni JS API, document.createElement() i Console Log Napredna integracija

Sve komponente su usklađene sa W3C Web Components specifikacijom (nijedna klasa ne postavlja atribute unutar constructor() metode, već isključivo u connectedCallback()), što omogućava direktno kreiranje bilo kog modala putem document.createElement() bez greške NotSupportedError.

Pregled globalnog window.modal objekta i skraćenica

Globalni poziv Alias (Skraćenica) Povratna vrednost Opis
modal.toast(msg, type, dur, pos) toast(msg, type, dur, pos) HTMLElement (<modal-toast>) Kreira i prikazuje iskačuću notifikaciju, pušta zvuk, šalje OS notifikaciju u pozadini i loguje u konzolu.
await modal.alert(msg, title, okBtn, type) await alert(msg, title, okBtn, type)* Promise<boolean> (true) Kreira zaključani statusni dijalog bez X dugmeta, čeka klik na dugme, briše se iz DOM-a i loguje u konzolu.
await modal.confirm(msg, title, okBtn, cancelBtn, type) await confirm(msg, title, okBtn, cancelBtn, type)* Promise<boolean> (true / false) Kreira zaključani potvrdni dijalog bez X dugmeta, čeka izbor korisnika, briše se iz DOM-a i loguje pitanje i odgovor u konzolu.

*Napomena za aliase window.alert i window.confirm: Ukoliko uključiš globalne aliase za alert i confirm, imaj na umu da oni vraćaju Promise, pa se pri proveri rezultata obavezno pozivaju sa await confirm(...) ili confirm(...).then(...).

Struktura automatskog Console Log-a (DevTools)

Svaki poziv modal.toast(), modal.alert() i modal.confirm() automatski parsira new Error().stack kako bi pronašao tačnu skriptu, liniju i kolonu iz koje je funkcija pozvana (ili prepoznao Console (DevTools) ako je okinuto ručno iz konzole) i beleži vreme u milisekundu (YYYY-MM-DD HH:mm:ss.ms):

Funkcija Izgled zaglavlja grupe (console.groupCollapsed) Stavke unutar grupe
modal.toast() INFO Prvih 20 karaktera... Time: 2026-11-01 15:04:12.045
Source: https://sajt.rs/app.js:42:5
Info: Ceo tekst poruke
modal.alert() ALERT WARNING Prvih 20 karaktera... Time: 2026-11-01 15:05:00.112
Source: https://sajt.rs/app.js:88:3
Alert: Ceo tekst upozorenja
modal.confirm() CONFIRM ERROR Prvih 20 karaktera... Time: 2026-11-01 15:06:30.890
Source: Console (DevTools)
Question: Tekst postavljenog pitanja
Answer: Da, obriši (true) (zeleno) ili Odustani (false) (crveno)