Web stranica je automatski prevedena. Ako nešto nije jasno, pogledajte englesku dokumentaciju.
Osnovna upotreba
Otpremite Gridzy datoteke na svoj server i dodajte ih na svoju web stranicu (obično u odjeljku zaglavlja):
<link rel="stylesheet" href="gridzy/gridzy.min.css" />
<script src="gridzy/gridzy.min.js"></script>Dodajte HTML kod (bilo gdje u dijelu tijela):
<div class="gridzy">
<img src="https://loremflickr.com/640/480?random=1" alt="a random image" />
<img src="https://loremflickr.com/480/640?random=2" alt="another random image" />
<img src="https://loremflickr.com/640/640?random=3" alt="yet another random image" />
<img src="https://loremflickr.com/640/480?random=4" alt="a random image again" />
<img src="https://loremflickr.com/640/480?random=5" alt="one last random image" />
</div>To je to! To je potpuno funkcionalan primjer. Nije potrebna dodatna inicijalizacija.
Konfiguracija
Najlakši način da konfigurišete Gridzy je da koristite samo HTML atribute. Trebate samo staviti prefiks imena opcija sa data-gridzy- . Dakle, da postavite opciju spaceBetween , samo dodajte atribut data-gridzy-spaceBetween .
<div class="gridzy" data-gridzy-spaceBetween="20" data-gridzy-desiredHeight="400">
<img src="https://loremflickr.com/640/480?random=1" alt="a random image" />
<img src="https://loremflickr.com/480/640?random=2" alt="another random image" />
<img src="https://loremflickr.com/640/640?random=3" alt="yet another random image" />
<img src="https://loremflickr.com/640/480?random=4" alt="a random image again" />
<img src="https://loremflickr.com/640/480?random=5" alt="one last random image" />
</div>Glavne opcije
Justified Opcije rasporeda
Waterfall Opcije rasporeda
Više naprednih opcija
Za naprednije opcije pogledajte API .
Semantički HTML
Najjednostavnija HTML struktura Gridzyja je ova:
<div class="gridzy">
<img src="https://loremflickr.com/640/480?random=1" alt="a random image" />
<img src="https://loremflickr.com/480/640?random=2" alt="another random image" />
<img src="https://loremflickr.com/640/640?random=3" alt="yet another random image" />
<img src="https://loremflickr.com/640/480?random=4" alt="a random image again" />
<img src="https://loremflickr.com/640/480?random=5" alt="one last random image" />
</div>Međutim, Gridzy je vrlo fleksibilan i možete koristiti gotovo bilo koju drugu HTML strukturu. Postoji samo nekoliko tačaka koje treba uzeti u obzir:
- Svako dijete elementa kontejnera predstavlja jednu stavku u mreži.
- I element kontejnera i njegovi potomci mogu biti bilo koje vrste oznake, kao što su
ulili(samo razmislite o resetovanju zadanih postavki pretraživača). - Ako
imgelement sam po sebi nije direktno dijete, potrebna mu je klasagridzyImage.
Dakle, ovo je također funkcionalna HTML struktura:
<ul class="gridzy">
<li>
<span>
<img class="gridzyImage" src="https://loremflickr.com/640/480?random=1" alt="a random image" />
</span>
</li>
<li>
<span>
<img class="gridzyImage" src="https://loremflickr.com/480/640?random=2" alt="another random image" />
</span>
</li>
<li>
<span>
<img class="gridzyImage" src="https://loremflickr.com/640/640?random=3" alt="yet another random image" />
</span>
</li>
<li>
<span>
<img class="gridzyImage" src="https://loremflickr.com/640/480?random=4" alt="a random image again" />
</span>
</li>
<li>
<span>
<img class="gridzyImage" src="https://loremflickr.com/640/480?random=5" alt="one last random image" />
</span>
</li>
</ul>Pogotovo ako želite da dodate natpise, potrebna vam je napredna HTML struktura. Da biste saznali više o tome, pogledajte titlove i skinove .
Naslovi i skinovi
Ako želite dodati natpise u svoju galeriju, morate definirati izgled. Stoga su dostupni neki unaprijed definirani skinovi. Svaki skin koji se sastoji od CSS datoteke. Morate dodati ovu datoteku uz glavne Gridzy datoteke (obično u odjeljku zaglavlja):
<link rel="stylesheet" href="gridzy/skins/gridzySkinClassic/style.min.css" />Nadalje, potrebna vam je napredna HTML struktura:
<div class="gridzy gridzySkinClassic">
<figure>
<img class="gridzyImage" src="https://loremflickr.com/640/480?random=1" alt="a random image" />
<figcaption class="gridzyCaption">a caption text</figcaption>
</figure>
<figure>
<img class="gridzyImage" src="https://loremflickr.com/480/640?random=2" alt="another random image" />
<figcaption class="gridzyCaption">another caption text</figcaption>
</figure>
<figure>
<img class="gridzyImage" src="https://loremflickr.com/640/640?random=3" alt="yet another random image" />
<figcaption class="gridzyCaption">yet another caption text</figcaption>
</figure>
<figure>
<img class="gridzyImage" src="https://loremflickr.com/640/480?random=4" alt="a random image again" />
<figcaption class="gridzyCaption">a caption text again</figcaption>
</figure>
<figure>
<img class="gridzyImage" src="https://loremflickr.com/640/480?random=5" alt="one last random image" />
<figcaption class="gridzyCaption">one last caption text</figcaption>
</figure>
</div>Ako se pitate o HTML strukturi, pogledajte Semantički HTML .
Za natpis možete koristiti bilo koju vrstu oznake, samo se uvjerite da ima klasu gridzyCaption . Elementu img potrebna je klasa gridzyImage .
Gornji primjer pokazuje kožu gridzySkinClassic . Da biste koristili drugi, samo zamijenite naziv kože s jednim od ovih:
Included Skins
| Dostupne klase | |
|---|---|
| gridzySkinBlank dobra polazna tačka za kreiranje sopstvene kože pregled uživo | gridzySkinBlank |
| gridzySkinClassic pregled uživo | gridzySkinClassic(ZASTARELO od verzije 2.6.0) |
| gridzySkinFullOverlay pregled uživo | gridzySkinFullOverlay(ZASTARELO od verzije 2.6.0) |
| gridzySkinLift pregled uživo | gridzySkinLift(ZASTARELO od verzije 2.6.0) |
| gridzySkinMagnifier funkcija zumiranja nije uključena pregled uživo | gridzySkinMagnifier(ZASTARELO od verzije 2.6.0) |
Svim gornjim skinovima je potreban samo CSS fajl, ali postoje i dodatni skinovi koji takođe zahtevaju JavaScript fajl:
<link rel="stylesheet" href="gridzy/skins/gridzySkinBlur/style.min.css" />
<script src="gridzy/skins/gridzySkinBlur/script.min.js"></script>| Dostupne klase | |
|---|---|
| gridzySkinBlur ne radi u IE pregled uživo | gridzySkinBlur(ZASTARELO od verzije 2.6.0) |
| gridzySkinCard pregled uživo | gridzySkinCard(ZASTARELO od verzije 2.6.0) |
Opcije kože
Od verzije 2.6.0 postoje opcije za konfiguraciju ugrađenih skinova. Ovisno o specifičnoj koži, možete postaviti boju pozadine, boju teksta i sjenu teksta. Morate samo koristiti CSS prilagođena svojstva kao što možete vidjeti ovdje:
<div class="gridzy gridzySkinClassic" style="--background: rgba(0, 80, 117, .8); --color: rgb(238, 238, 238); ">
<figure>
<img class="gridzyImage" src="https://loremflickr.com/640/480?random=1" alt="a random image" />
<figcaption class="gridzyCaption">a caption text</figcaption>
</figure>
<figure>
<img class="gridzyImage" src="https://loremflickr.com/480/640?random=2" alt="another random image" />
<figcaption class="gridzyCaption">another caption text</figcaption>
</figure>
...
</div>Ovdje pogledajte podržane varijable i zadane vrijednosti za svaki skin:
gridzySkinClassic
| Varijabilna | Zadana vrijednost | Informacije |
|---|---|---|
--background | rgba(0, 0, 0, .7) | dozvoljava bilo koju pozadinu CSS-a |
--color | rgb(255, 255, 255) | dozvoljava bilo koju vrijednost CSS boje |
--text-shadow | none | dozvoljava bilo koju CSS vrijednost sjene teksta |
gridzySkinFullOverlay
| Varijabilna | Zadana vrijednost | Informacije |
|---|---|---|
--background | rgba(0, 0, 0, .7) | dozvoljava bilo koju pozadinu CSS-a |
--color | rgb(255, 255, 255) | dozvoljava bilo koju vrijednost CSS boje |
--text-shadow | none | dozvoljava bilo koju CSS vrijednost sjene teksta |
gridzySkinLift
| Varijabilna | Zadana vrijednost | Informacije |
|---|---|---|
--background | rgba(0, 0, 0, .7) | dozvoljava bilo koju pozadinu CSS-a |
--color | rgb(255, 255, 255) | dozvoljava bilo koju vrijednost CSS boje |
--text-shadow | 0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0) | dozvoljava bilo koju CSS vrijednost sjene teksta |
gridzySkinMagnifier
| Varijabilna | Zadana vrijednost | Informacije |
|---|---|---|
--background | rgba(0, 0, 0, .7) | dozvoljava bilo koju pozadinu CSS-a |
--color | rgb(255, 255, 255) | dozvoljava bilo koju vrijednost CSS boje |
Ova koža ne podržava --text-shadow
gridzySkinBlur
| Varijabilna | Zadana vrijednost | Informacije |
|---|---|---|
--background | rgba(0, 0, 0, .7) | dozvoljava bilo koju pozadinu CSS-a |
--color | rgb(255, 255, 255) | dozvoljava bilo koju vrijednost CSS boje |
--text-shadow | 0 0 10px rgb(0, 0, 0) | dozvoljava bilo koju CSS vrijednost sjene teksta |
gridzySkinCard
| Varijabilna | Zadana vrijednost | Informacije |
|---|---|---|
--background | rgba(0, 0, 0, 1) | dozvoljava bilo koju pozadinu CSS-a |
--color | rgb(255, 255, 255) | dozvoljava bilo koju vrijednost CSS boje |
--text-shadow | none | dozvoljava bilo koju CSS vrijednost sjene teksta |
Sve unapred definisane maske podržavaju samo jednostavne tekstualne natpise. Možete kreirati vlastite i složenije skinove. Molimo pogledajte Style Gridzy .
Style Gridzy
Ako nijedna unaprijed definirana koža ne odgovara vašim potrebama, možete stilizirati svoju.
Najlakši način je da prvo kopirate postojeći skin i prilagodite ga svojim potrebama. Unaprijed definirani skin gridzySkinBlank obično bi pružio dobru osnovu kao i dobru dokumentaciju u CSS datoteci:
/** SKIN Blank **/
/* all gallery items (direct children of the main container element) */
.gridzySkinBlank > .gridzyItem {
overflow: hidden;
}
/* all gallery images (predefined in Gridzy's main CSS file, but can be overridden) */
.gridzySkinBlank .gridzyImage {
}
/* all gallery captions (just create your very own style) */
.gridzySkinBlank .gridzyCaption {
margin: 0;
padding: .5em;
opacity: 0;
display: flex;
justify-content: center;
align-items: center;
text-align: center;
position: absolute;
z-index: 1;
top: 0;
left: 0;
width: 100%;
height: 100%;
box-sizing: border-box;
transition: opacity .5s;
overflow: auto;
background: rgba(0, 0, 0, .7);
color: rgb(255, 255, 255);
}
.gridzySkinBlank > .gridzyItem:hover .gridzyCaption {
opacity: 1;
}U CSS datoteci ćete pronaći klase gridzySkinBlank , gridzyImage i gridzyCaption . Sam Gridzy ne treba ove časove. Koriste se samo za stilizovanje, pa ih možete ukloniti ili preimenovati ako želite.
Dodatno ćete pronaći CSS klasu gridzyItem . Gridzy automatski postavlja ovu klasu svim direktnim potomcima glavnog elementa kontejnera. Dakle, možete koristiti ovu klasu za stiliziranje stavki vaše galerije.
Pazite na važne stvari
- Sadržaj stavke bi trebao biti u potpunosti odgovarajući. Uzmite u obzir da će se veličina elementa definitivno promijeniti. Koristite procentualne vrijednosti umjesto vrijednosti piksela. I pogledajte opciju Gridzy izgleda
autoFontSize, koja veže veličinu fonta za veličinu okvira stavke. - Svaka stavka treba da ima dobro definisan omjer širine i visine. Omjer stranica se nikada neće promijeniti i potreban je za izračunavanje mreže. Dakle, ako stavka nema automatski dobro definisan omjer širine i visine, unaprijed je definirajte ručno (npr. putem css-a).
U nekim slučajevima može biti lakše stilizirati sadržaj stavki prije nego što se Gridzy inicijalizira. Za ovo jednostavno uklonite klasu gridzy ili Gridzy javascript datoteku.
To je to! To je sve što vam treba da izgradite svoju vlastitu kožu. Većina predefiniranih skinova ne koristi više od ovoga.
Ali moglo bi biti više ako želite…
Advanced Skins
Gridzy koristi više CSS klasa nego samo gridzyItem . Većina njih će se automatski postaviti i možete ih koristiti i za stiliziranje.
Klase glavnih kontejnera
| Ime klase | Opis |
|---|---|
gridzypodesiti ručno | Gridzy automatski pronalazi elemente sa ovom klasom i inicijalizira ih. |
gridzyAnimated | Biće postavljen automatski ako je opcija animate true . Ako se ova klasa postavi ručno, opcija animate će također automatski dobiti true (osim ako je eksplicitno postavljena na false ). |
Klase stavki
| Ime klase | Opis |
|---|---|
gridzyItem | Biće postavljeno čim stavka započne proces inicijalizacije. Nikada neće biti uklonjena. |
gridzyItemInitializing | Biće postavljeno čim stavka započne proces inicijalizacije. Biće zamijenjen gridzyItemReady čim se stavka potpuno inicijalizira. Ne znači da su slike potpuno učitane (pogledajte gridzyItemLoading ), ali je stavka spremna da postane vidljiva. |
gridzyItemReady | Zamijenit će gridzyItemInitializing čim se stavka potpuno inicijalizira. Nikada neće biti uklonjena. Ne znači da su slike potpuno učitane (pogledajte gridzyItemComplete ), ali je stavka spremna da postane vidljiva. |
gridzyItemLoading | Biće postavljeno čim stavka započne proces inicijalizacije. Biće zamijenjen gridzyItemComplete čim se sadržane slike (obično samo jedna) potpuno učitaju. |
gridzyItemComplete | Zamijenit će gridzyItemLoading čim se sadržane slike (obično samo jedna) potpuno učitaju. Nikada neće biti uklonjena. |
gridzyItemInitialToVisible | Biće postavljeno čim se stavka počne pojavljivati prvi put. Biće uklonjen čim predmet bude potpuno vidljiv. |
gridzyItemVisible | Biće postavljeno čim stavka bude u potpunosti vidljiva. Biće uklonjen čim stavka počne da nestaje. |
gridzyItemVisibleToHidden | Biće postavljeno čim stavka počne da nestaje. Biće uklonjen čim se stavka potpuno sakrije. |
gridzyItemHidden | Postavit će se čim se stavka potpuno sakrije. Biće uklonjen čim se stavka počne pojavljivati. |
gridzyItemHiddenToVisible | Biće postavljeno čim se stavka počne pojavljivati (osim kada se pojavljuje prvi put – pogledajte klasu gridzyItemInitialToVisible ). Biće uklonjen čim predmet bude potpuno vidljiv. |
gridzyItemVisibleToVisible | Postavit će se čim se nešto promijeni u mreži, ali je sama stavka bila i ostala vidljiva. Biće uklonjen čim se završi animacija promjene. |
Prema zadanim postavkama, indikator procesa i animacije za pojavljivanje i nestajanje slika unaprijed su definirani u glavnom CSS fajlu Gridzy.
Sa ovim gore navedenim CSS klasama možete stilizirati svoj vlastiti indikator procesa i animacije. Usudite se da pogledate u Gridzy glavnu CSS datoteku, da shvatite šta biste morali da zaobiđete. Bez straha, tamo je sve dobro dokumentovano.
Optimizirajte učitavanje
Ako koristite mnogo slika, mogla bi biti dobra ideja pomoći Gridzyju da brže izgradi mrežu.
Sprečavanje skakanja slika
Gridzyju je apsolutno potreban omjer širine i visine svih slika da bi izračunao mrežu. Ova činjenica rezultira skakanjem elemenata ako su neke slike spremne, a druge nisu. Što više slika ima, ovaj efekat može biti neugodniji.
Da biste spriječili ovo ponašanje, samo postavite atribute width i height za sve img elemente. Važno je postaviti ispravne vrijednosti za svaku pojedinačnu sliku, inače bi slike bile izobličene. Ispravne vrijednosti su originalna širina i visina odgovarajuće slike:
<div class="gridzy">
<img src="https://loremflickr.com/640/480?random=1" width="640" height="480" alt="a random image" />
<img src="https://loremflickr.com/480/640?random=2" width="480" height="640" alt="another random image" />
<img src="https://loremflickr.com/640/640?random=3" width="640" height="640" alt="yet another random image" />
<img src="https://loremflickr.com/640/480?random=4" width="640" height="480" alt="a random image again" />
<img src="https://loremflickr.com/640/480?random=5" width="640" height="480" alt="one last random image" />
</div>Nakon toga Gridzy može odmah izračunati mrežu bez potrebe da zna stvarne veličine slika.
Lazy Loading
Da biste učitali samo slike koje su u vidljivom okviru za prikaz, samo slijedite ove korake:
- Umetnite atribute
widthiheightkao što je gore opisano (pazite da koristite ispravne vrijednosti) - Zamijenite sve atribute
srcsadata-gridzylazysrckao što je prikazano ispod (ako imate i atributesrcset, zamijenite ih sadata-gridzylazysrcset).
<div class="gridzy">
<img data-gridzylazysrc="https://loremflickr.com/640/480?random=1" width="640" height="480" alt="a random image" />
<img data-gridzylazysrc="https://loremflickr.com/480/640?random=2" width="480" height="640" alt="another random image" />
<img data-gridzylazysrc="https://loremflickr.com/640/640?random=3" width="640" height="640" alt="yet another random image" />
<img data-gridzylazysrc="https://loremflickr.com/640/480?random=4" width="640" height="480" alt="a random image again" />
<img data-gridzylazysrc="https://loremflickr.com/640/480?random=5" width="640" height="480" alt="one last random image" />
</div>Nakon ovih koraka slike će se učitati čim se nađu u blizini ili unutar prozora za prikaz.
Indikator procesa
Indikator procesa je mala animirana ikona koja se pojavljuje dok se slika učitava. Ako koristite titlove i skinove , indikator procesa će se automatski prikazati. Inače su vam potrebna neka podešavanja:
- Stavite svaki
imgelement udivelement
(ili u bilo koji drugi element – pogledajte semantički HTML za više) - Dodajte klasu
gridzyImagesvakomimgelementu
<div class="gridzy">
<div><img src="https://loremflickr.com/640/480?random=1" class="gridzyImage" alt="a random image" /></div>
<div><img src="https://loremflickr.com/480/640?random=2" class="gridzyImage" alt="another random image" /></div>
<div><img src="https://loremflickr.com/640/640?random=3" class="gridzyImage" alt="yet another random image" /></div>
<div><img src="https://loremflickr.com/640/480?random=4" class="gridzyImage" alt="a random image again" /></div>
<div><img src="https://loremflickr.com/640/480?random=5" class="gridzyImage" alt="one last random image" /></div>
</div>Nakon toga trebali biste vidjeti indikatore procesa ako je potrebno vrijeme za učitavanje slika.
Filteri
Filteri u Gridzy-u su prilično jednostavni, ali moćni. Bez obzira kakav filter vam je potreban, vrlo je vjerovatno da je izvodljiv. Sve što vam treba je, malo CSS-a i nekoliko HTML elemenata obrasca…
Evo funkcionalnog primjera:
<div id="myFilterControls">
<button value="*">All</button>
<button value=".animals">Animals</button>
<button value=".architecture">Architecture</button>
<button value=".people">People</button>
</div>
<div class="gridzy" data-gridzy-filterControls="#myFilterControls button">
<img class="animals" src="https://loremflickr.com/640/480/animals?random=1" alt="a random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=1" alt="a random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=1" alt="a random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=2" alt="another random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=2" alt="another random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=2" alt="another random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=3" alt="yet another random animal image" />
</div>Izgradimo ga korak po korak
1. Prvo nam treba uobičajena HTML struktura Gridzyja i postaviti imena klasa za sve stavke galerije kako bismo ih kasnije mogli filtrirati
<div class="gridzy">
<img class="animals" src="https://loremflickr.com/640/480/animals?random=1" alt="a random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=1" alt="a random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=1" alt="a random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=2" alt="another random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=2" alt="another random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=2" alt="another random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=3" alt="yet another random animal image" />
</div>U ovom primjeru koristimo samo jednu klasu za svaki element. Ali također možete postaviti više klasa za jedan element, ako se taj element može pronaći preko više filtera.
2. Zatim dodajemo nekoliko dugmadi preko kojih možemo promijeniti filtere
<button value="*">All</button>
<button value=".animals">Animals</button>
<button value=".architecture">Architecture</button>
<button value=".people">People</button>
<div class="gridzy">
<img class="animals" src="https://loremflickr.com/640/480/animals?random=1" alt="a random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=1" alt="a random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=1" alt="a random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=2" alt="another random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=2" alt="another random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=2" alt="another random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=3" alt="yet another random animal image" />
</div>Umjesto dugmadi, možete koristiti i druge elemente obrasca kao što su okviri za potvrdu, radio dugmad, polja za odabir i tako dalje.
Kao što vidite, vrijednosti dugmadi su uobičajeni CSS selektori. Čim završimo, klik na takvo dugme će prikazati slike koje odgovaraju tom CSS selektoru. Tehnički, jednostavno postavlja opciju filter na ovu vrijednost.
Možete koristiti i mnogo složenije selektore. Na primjer :not(.animals) bi također funkcionirao, kao i .animals.people i .animals, .people .
3. Na kraju, mi inkapsuliramo dugmad u div kontejner i povezujemo ih sa Gridzy galerijom, postavljanjem opcije filterControls :
<div id="myFilterControls">
<button value="*">All</button>
<button value=".animals">Animals</button>
<button value=".architecture">Architecture</button>
<button value=".people">People</button>
</div>
<div class="gridzy" data-gridzy-filterControls="#myFilterControls button">
<img class="animals" src="https://loremflickr.com/640/480/animals?random=1" alt="a random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=1" alt="a random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=1" alt="a random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=2" alt="another random animal image" />
<img class="architecture" src="https://loremflickr.com/640/480/arch?random=2" alt="another random architecture image" />
<img class="people" src="https://loremflickr.com/640/480/people?random=2" alt="another random people image" />
<img class="animals" src="https://loremflickr.com/640/480/animals?random=3" alt="yet another random animal image" />
</div>Kao što vidite, koristimo i CSS selektor za opciju filterControls . Kontejner div s atributom id služi samo da olakša odabir dugmadi preko tog CSS selektora.
To je to!
Ako više volite JavaScript rješenje, pogledajte API .
API
Iako Gridzy ima svoj API, većina stvari se može uraditi bez njega, jednostavno manipulisanjem DOM-om. Gridzy će to primijetiti i prilagoditi mrežu. Ali postoji i veoma moćan API…
Manipulisanje DOM-om
Za sve manipulacije Document Object Model (DOM) prvo nam je potreban element kontejnera:
// get the container element
var gridzyElement = document.querySelector('.gridzy');Dodaj slike
Važno je u potpunosti izgraditi i popuniti novi podređeni element prije nego što ga dodate elementu kontejnera. Inače Gridzy ne može otkriti tačne dimenzije.
// create a new img element
var newImage = document.createElement('img');
// add src attribute (!! before you add it to the container element !!)
newImage.src = 'https://loremflickr.com/640/480';
// add it as last element to the container element
gridzyElement.appendChild(newImage);
// or as first element (or anywhere in between)
gridzyElement.insertBefore(newImage, gridzyElement.firstChild);Ukloni slike
// remove the first image
gridzyElement.removeChild(gridzyElement.firstElementChild);Promjena opcija
// change the spaceBetween option to a specific value
gridzyElement.setAttribute('data-gridzy-spaceBetween', '10');
// change the layout option to a specific value
gridzyElement.setAttribute('data-gridzy-layout', 'waterfall');
// reset the spaceBetween option to its default value
gridzyElement.removeAttribute('data-gridzy-spaceBetween');Više o manipulaciji DOM-om možete pronaći u MDN web dokumentima . Dostupan je i Uvod u DOM .
Vlasnički API
Da bismo koristili API, prvo nam je potrebna Gridzy instanca, koja je vezana za Gridzy element kontejnera:
// get the Gridzy instance
var gridzyInstance = document.querySelector('.gridzy').gridzy;Get Option
// get the value of a single option
var currentLayout = gridzyInstance.getOption('layout');Preuzmite sve opcije
// get all option values as an object
var currentOptions = gridzyInstance.getOptions();Postavite opcije
// set specific option values
gridzyInstance.setOptions({
spaceBetween: 10,
layout: 'waterfall'
});
// or reset options to their default values
gridzyInstance.setOptions({
spaceBetween: null,
layout: null
});Primijeni filter
Primjena filtera je samo postavljanje filter opcija koji može biti bilo koji važeći CSS selektor:
// set the filter to match items with class "animals"
gridzyInstance.setOptions({
filter: '.animals'
});
// reset the filter to match all items again
gridzyInstance.setOptions({
filter: '*'
});
// set the filter to match items without class "animals"
gridzyInstance.setOptions({
filter: ':not(.animals)'
});
// set the filter to match items with class "animals" or "people"
gridzyInstance.setOptions({
filter: '.animals, .people'
});
// set the filter to match items that have both classes, "animals" and "people"
gridzyInstance.setOptions({
filter: '.animals.people'
});Dodajte funkcije povratnog poziva
ZASTARJELO od verzije 2.4.0
Umjesto toga koristite moderne i fleksibilnije događaje . Pogledajte sljedeći odjeljak za detalje.
Gridzy.js 2 podržava neke opcije za funkcije povratnog poziva. Mogu se postaviti samo putem vlasničkog API-ja, ali baš kao i druge opcije:
// same as set other options
gridzyInstance.setOptions({
onOptionsChanged: function() {
// will be executed each time the options have changed.
},
onBeforeOptionsChanged: function() {
// will be executed, before new options take effect.
}
});Koristite događaje
od verzije 2.4.0
Gridzy događaje možete koristiti baš kao i uobičajene JavaScript događaje:
document.addEventListener('gridzyOptionsChanged', function(event) {
// will be executed each time the options have changed.
});
document.addEventListener('gridzyBeforeOptionsChanged', function(event) {
// will be executed, before new options take effect.
});Neki događaji se aktiviraju na elementu kontejnera Gridzy, a drugi događaji se aktiviraju na pojedinačnim elementima stavke unutar elementa kontejnera.
Događaji pokrenuti na elementu kontejnera Gridzy:
event.target pruža element kontejnera Gridzy.
event.detail.instance pruža Gridzy instancu.
Događaji pokrenuti na elementima predmeta:
event.target pruža odgovarajući element stavke.
event.detail.instance pruža Gridzy instancu.
API – globalno
Postoje neke funkcije koje su nezavisne od Gridzy instanci. Dakle, ne moramo da dobijemo instancu ranije.
Nabavite zadanu opciju
// get the default value of a single option
var defaultLayout = Gridzy.getDefaultOption('layout');Preuzmite sve zadane opcije
// get all default option values as an object, including the default layout options of the default layout
var defaultOptions = Gridzy.getDefaultOptions();
// or get all default option values, including the default layout options of a specific layout
var defaultOptions = Gridzy.getDefaultOptions('waterfall');Postavite zadane opcije
Ovo ne postavlja opcije za sve već inicijalizirane Gridzy instance, već definira osnovu za nove instance. Međutim, ako bi opcija postojeće instance bila resetirana preko vrijednosti null , koristila bi se nova zadana vrijednost.
// set default option values
Gridzy.setDefaultOptions({
spaceBetween: 10,
layout: 'waterfall'
});Ovo možete koristiti za globalno postavljanje opcija, ako ga pozovete prije nego što DOM bude spreman. Dakle, više ne biste trebali postavljati opcije kao atribute.
Automatizmi
Sve dok su svi automatizmi Gridzy.js 2 aktivni, nema potrebe za dole navedenim metodama. Ali automatizmi se mogu isključiti kako bi se Gridzy koristio na tradicionalniji način:
// disable automatic initializations
Gridzy.setDefaultOptions({
autoInitOnDomReady: false,
autoInitOnDomMutation: false
});
// or switch off all mutation observers
Gridzy.setDefaultOptions({
autoInitOnDomMutation: false,
autoSyncChildListMutation: false,
autoSyncAttributesMutation: false,
autoSyncChildClassMutation: false,
autoSyncImageMutation: false
});Neke od ovih opcija se ne mogu postaviti putem data-gridzy- atributa ili putem setOptions() , iz logičnih razloga:
Inicijalizujte ručno
// initialize a new Gridzy instance
var gridzyInstance = new Gridzy(document.querySelector('.gridzy'), {
spaceBetween: 10,
layout: 'waterfall'
});Uništi instancu
Grubo rečeno, suprotno od inicijalizacije Gridzyja.
gridzyInstance.destroy();
gridzyInstance = null;Ručno sinhronizujte podređenu listu
// after child elements (images) are added to or removed from the DOM.
gridzyInstance.syncChildList();Ručno sinhronizirajte jedan podređeni element
Obično nije potrebno, osim u vrlo rijetkim slučajevima.
// after child elements (images) are added to the DOM and only one of them should be synced to Gridzy.
gridzyInstance.syncChild(childElement);Ručno sinhronizujte atribute
Imajte na umu da opcija useOptionAttributes mora biti true za ovo.
// after data-gridzy- attributes have changed
gridzyInstance.syncAttributes();Force Rendering
Obično nije potrebno, čak i ako su svi automatizmi isključeni
gridzyInstance.render();