Verzija 2.x


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

Zadana vrijednostOpis
animatetrueOdređuje da li se animacije trebaju koristiti kada se mreža promijeni (na primjer, kada se mijenja veličina prozora preglednika ili kada se postavlja filter).
layoutjustifiedDefinira korišteni izgled. Gridzy.js 2 podržava dva različita izgleda justified i waterfall . Svaki od njih ima svoje dodatne parametre opcija koje možete pronaći ispod ove tabele.
filter*Određuje koje slike treba prikazati. Ovdje se kao vrijednost može koristiti bilo koji CSS-selektor. Obično se postavlja automatski preko filterControls (pogledajte sljedeću opciju).
Pogledajte Filteri
filterControlsOdređuje koji se elementi forme mogu koristiti za filtriranje slika. Ovdje se kao vrijednost može koristiti bilo koji CSS selektor koji bira elemente HTML obrasca.
Pogledajte Filteri
autoConsiderScrollBarstrueZa predviđanje dostupne širine ako se trake za pomicanje pojave ili nestanu. Uvijek se preporučuje da ga ostavite true osim ako ovaj automatizam ne uzrokuje probleme.

Justified Opcije rasporeda

Zadana vrijednostOpis
autoFontSizefalseAutomatski ažurira svojstvo veličine fonta svakog okvira na osnovu originalne veličine okvira. Podrazumevano svojstvo veličine fonta nije eksplicitno postavljeno.
desiredHeight190Definira željenu visinu redova elemenata. Stvarna visina će se izračunati ovisno o dostupnoj širini i elementima u redu.
hideOnMissingImagetrueSakriva okvire koji sadrže slike koje se ne mogu učitati.
spaceBetween4Definira udaljenost između elemenata u pikselima.
lastRowAlign
od verzije 2.3.0
justifiedDefinira ponašanje posljednjeg reda. Dozvoljene vrijednosti su left , center , right i justified .
singleRowAlign
od verzije 2.3.0
justifiedDefinira ponašanje ako postoji samo jedan red. Dozvoljene vrijednosti su left , center , right i justified .
fillLastRow
od verzije 2.1.0
trueUKLONO od verzije 2.4.0 (ZASTARELO od verzije 2.3.0 )
Raspoređuje slike tako da je zadnji red uvijek potpuno popunjen. Ako planirate dinamički dodavati slike, bilo bi dobro da to deaktivirate.
Nema efekta na pojedinačne redove (pogledajte fillSingleRow ).
fillSingleRow
od verzije 2.1.0
trueUKLONO od verzije 2.4.0 (ZASTARELO od verzije 2.3.0 )
Ako postoji samo jedan red, on raspoređuje slike tako da red uvijek bude potpuno popunjen. Ako se može dogoditi da imate samo jednu ili dvije slike u galeriji, bilo bi dobro da to deaktivirate.

Waterfall Opcije rasporeda

Zadana vrijednostOpis
autoFontSizefalseAutomatski ažurira svojstvo veličine fonta svakog okvira na osnovu originalne veličine okvira. Podrazumevano svojstvo veličine fonta nije eksplicitno postavljeno.
desiredWidth250Definira željenu širinu kolona. Stvarna širina će se izračunati ovisno o dostupnoj širini i broju stupaca.
hideOnMissingImagetrueSakriva okvire koji sadrže slike koje se ne mogu učitati.
horizontalOrderfalseDefinira da se elementi postavljaju striktno po jedan element u svakoj koloni s lijeva na desno, a zatim ponovo počinje u krajnjoj lijevoj koloni nezavisno u kojoj koloni je više mjesta. Elementi će po defaultu uvijek biti smješteni u stupac s najmanjom visinom.
spaceBetween4Definira udaljenost između elemenata u pikselima.
singleRowAlign
since version 2.7.0
justifiedDefines the behavior when not all columns can be filled due to too few images. Allowed values are left, center, right and justified.

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 ul i li (samo razmislite o resetovanju zadanih postavki pretraživača).
  • Ako img element sam po sebi nije direktno dijete, potrebna mu je klasa gridzyImage .

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
gridzySkinClassicLight(ZASTARELO od verzije 2.6.0)
gridzySkinFullOverlay
pregled uživo
gridzySkinFullOverlay
gridzySkinFullOverlayLight(ZASTARELO od verzije 2.6.0)
gridzySkinLift
pregled uživo
gridzySkinLift
gridzySkinLiftLight(ZASTARELO od verzije 2.6.0)
gridzySkinMagnifier
funkcija zumiranja nije uključena
pregled uživo
gridzySkinMagnifier
gridzySkinMagnifierLight(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
gridzySkinBlurLight(ZASTARELO od verzije 2.6.0)
gridzySkinCard
pregled uživo
gridzySkinCard
gridzySkinCardLight(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
VarijabilnaZadana vrijednostInformacije
--backgroundrgba(0, 0, 0, .7)dozvoljava bilo koju pozadinu CSS-a
--colorrgb(255, 255, 255)dozvoljava bilo koju vrijednost CSS boje
--text-shadownonedozvoljava bilo koju CSS vrijednost sjene teksta
gridzySkinFullOverlay
VarijabilnaZadana vrijednostInformacije
--backgroundrgba(0, 0, 0, .7)dozvoljava bilo koju pozadinu CSS-a
--colorrgb(255, 255, 255)dozvoljava bilo koju vrijednost CSS boje
--text-shadownonedozvoljava bilo koju CSS vrijednost sjene teksta
gridzySkinLift
VarijabilnaZadana vrijednostInformacije
--backgroundrgba(0, 0, 0, .7)dozvoljava bilo koju pozadinu CSS-a
--colorrgb(255, 255, 255)dozvoljava bilo koju vrijednost CSS boje
--text-shadow0 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
VarijabilnaZadana vrijednostInformacije
--backgroundrgba(0, 0, 0, .7)dozvoljava bilo koju pozadinu CSS-a
--colorrgb(255, 255, 255)dozvoljava bilo koju vrijednost CSS boje

Ova koža ne podržava --text-shadow

gridzySkinBlur
VarijabilnaZadana vrijednostInformacije
--backgroundrgba(0, 0, 0, .7)dozvoljava bilo koju pozadinu CSS-a
--colorrgb(255, 255, 255)dozvoljava bilo koju vrijednost CSS boje
--text-shadow0 0 10px rgb(0, 0, 0)dozvoljava bilo koju CSS vrijednost sjene teksta
gridzySkinCard
VarijabilnaZadana vrijednostInformacije
--backgroundrgba(0, 0, 0, 1)dozvoljava bilo koju pozadinu CSS-a
--colorrgb(255, 255, 255)dozvoljava bilo koju vrijednost CSS boje
--text-shadownonedozvoljava 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

  1. 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.
  2. 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 klaseOpis
gridzy
podesiti ručno
Gridzy automatski pronalazi elemente sa ovom klasom i inicijalizira ih.
gridzyAnimatedBić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 klaseOpis
gridzyItemBiće postavljeno čim stavka započne proces inicijalizacije. Nikada neće biti uklonjena.
gridzyItemInitializingBić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.
gridzyItemReadyZamijenit ć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.
gridzyItemLoadingBiće postavljeno čim stavka započne proces inicijalizacije. Biće zamijenjen gridzyItemComplete čim se sadržane slike (obično samo jedna) potpuno učitaju.
gridzyItemCompleteZamijenit će gridzyItemLoading čim se sadržane slike (obično samo jedna) potpuno učitaju. Nikada neće biti uklonjena.
gridzyItemInitialToVisibleBiće postavljeno čim se stavka počne pojavljivati prvi put. Biće uklonjen čim predmet bude potpuno vidljiv.
gridzyItemVisibleBiće postavljeno čim stavka bude u potpunosti vidljiva. Biće uklonjen čim stavka počne da nestaje.
gridzyItemVisibleToHiddenBiće postavljeno čim stavka počne da nestaje. Biće uklonjen čim se stavka potpuno sakrije.
gridzyItemHiddenPostavit će se čim se stavka potpuno sakrije. Biće uklonjen čim se stavka počne pojavljivati.
gridzyItemHiddenToVisibleBić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.
gridzyItemVisibleToVisiblePostavit ć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:

  1. Umetnite atribute width i height kao što je gore opisano (pazite da koristite ispravne vrijednosti)
  2. Zamijenite sve atribute src sa data-gridzylazysrc kao što je prikazano ispod (ako imate i atribute srcset , zamijenite ih sa data-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:

  1. Stavite svaki img element u div element
    (ili u bilo koji drugi element – pogledajte semantički HTML za više)
  2. Dodajte klasu gridzyImage svakom img elementu
<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.
  }
});
Opis
onBeforeOptionsChangedFunkcija povratnog poziva koja se poziva direktno prije postavljanja opcija.
onOptionsChangedFunkcija povratnog poziva koja se poziva direktno nakon podešavanja opcija.
onBeforeRenderFunkcija povratnog poziva koja se poziva direktno prije renderiranja.
onRenderFunkcija povratnog poziva koja se poziva direktno nakon renderiranja.

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:

Opis
gridzyBeforeInitPali se prije inicijalizacije galerije.
gridzyInitPali se nakon inicijalizacije galerije.
gridzyBeforeOptionsChangedPali prije postavljanja opcija.
gridzyOptionsChangedPali nakon podešavanja opcija.
gridzyBeforeRenderPali prije renderiranja.
gridzyRenderPali nakon renderiranja.
Ako propustite neki događaj ovdje, pošaljite zahtjev za podršku .

event.target pruža element kontejnera Gridzy.
event.detail.instance pruža Gridzy instancu.

Događaji pokrenuti na elementima predmeta:

Opis
gridzyItemBeforeInitPali se prije inicijalizacije stavke.
gridzyItemInitPali se nakon inicijalizacije stavke.
gridzyItemLoadingPali se kada se stavka počne učitavati.
gridzyItemReadyPali se kada je stavka spremna za proračun mreže. Dakle, omjer je poznat, ali slika se možda još uvijek učitava.
gridzyItemCompletePokreće se kada je slika stavke potpuno učitana.
Ako propustite neki događaj ovdje, pošaljite zahtjev za podršku .

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:

Zadana vrijednostOpis
autoInitOnDomReadytrueDetektuje elemente sa klasom gridzy pri učitavanju stranice i inicijalizira ih.

Podesivo putem Gridzy.setDefaultOptions()
autoInitOnDomMutation
MutationObserver
trueDetektuje nove elemente sa klasom gridzy čim se pojave u DOM-u i inicijalizira ih. (npr. o korištenju prijelaza stranica)

Podesivo putem Gridzy.setDefaultOptions()
autoSyncChildListMutation
MutationObserver
trueOtkriva da li su podređeni elementi (slike) dodani ili uklonjeni i automatski ažurira mrežu.

Podesivo putem data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
useOptionAttributestrueDefinira da li se atributi data-gridzy- općenito koriste ili ne. Ako je ovo false opcije se mogu postaviti samo putem vlasničkog API-ja.

Podesivo putem new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncAttributesMutation
MutationObserver
trueOtkriva promjene atributa data-gridzy- i automatski ažurira mrežu. Također otkriva da li je gridzyAnimated klasa dodana ili uklonjena i ako dođe do promjena atributa style . Ako je useOptionAttributes false , detektuje samo promjene atributa style .

Podesivo putem data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncChildClassMutation
MutationObserver
trueDetektira promjene atributa class svih podređenih elemenata (slika). Relevantno u vezi sa filterima.

Podesivo putem data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncImageMutation
MutationObserver

od verzije 2.5.0
trueDetektira promjene src atributa svih slika. Relevantno kada se koristi s React-om ili sličnim bibliotekama.

Podesivo putem data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoRenderOnResize
ResizeObserver

od verzije 2.6.0
trueOtkriva promjene širine elementa. Relevantno u vezi sa responzivnim dizajnom. (Prije verzije 2.6.0 korišten je slušatelj događaja za promjenu veličine prozora)

Podesivo putem data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()

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();