Versio 2.x


Peruskäyttö

Lataa Gridzy-tiedostot palvelimellesi ja lisää ne verkkosivustollesi (yleensä head-osiossa):

<link rel="stylesheet" href="gridzy/gridzy.min.css" />
<script src="gridzy/gridzy.min.js"></script>

Lisää HTML-koodi (mihin tahansa tekstiosaan):

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

Siinä se! Tämä on täysin toimiva esimerkki. Ylimääräistä alustusta ei tarvita.

Kokoonpano

Helpoin tapa määrittää Gridzy on käyttää vain HTML-attribuutteja. Sinun tarvitsee vain lisätä vaihtoehtojen nimien eteen data-gridzy- . Joten aseta spaceBetween -vaihtoehto lisäämällä attribuutti 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>

Päävaihtoehdot

OletusarvoKuvaus
animatetrueMäärittää, käytetäänkö animaatioita ruudukon muuttuessa (esimerkiksi selainikkunan kokoa muuttaessa tai suodatinta määritettäessä).
layoutjustifiedMäärittää käytetyn asettelun. Gridzy.js 2 tukee kahta eri asettelua justified ja waterfall . Jokaisella niistä on omat lisäoptioparametrinsa, jotka löydät tämän taulukon alta.
filter*Määrittää, mitkä kuvat näytetään. Arvona voidaan käyttää mitä tahansa CSS-valitsinta. Asetetaan yleensä automaattisesti filterControls (katso seuraava vaihtoehto).
Tutustu suodattimiin
filterControlsMäärittää, mitä lomakeelementtejä voidaan käyttää kuvien suodattamiseen. Arvona voidaan käyttää mitä tahansa CSS-valitsinta, joka valitsee HTML-lomakeelementtejä.
Tutustu suodattimiin
autoConsiderScrollBarstrueVoit ennustaa käytettävissä olevan leveyden, jos vierityspalkit ilmestyvät tai katoavat. On aina suositeltavaa jättää se päälle true , ellei tämä automatismi aiheuta ongelmia.

Justified Asetteluvaihtoehdot

OletusarvoKuvaus
autoFontSizefalsePäivittää automaattisesti kunkin laatikon font-size-ominaisuuden alkuperäisen laatikon koon perusteella. Oletuksena font-size-ominaisuutta ei ole asetettu erikseen.
desiredHeight190Määrittää elementtirivien halutun korkeuden. Todellinen korkeus lasketaan käytettävissä olevan leveyden ja rivin elementtien mukaan.
hideOnMissingImagetruePiilottaa laatikot, jotka sisältävät kuvia, joita ei voitu ladata.
spaceBetween4Määrittää elementtien välisen etäisyyden pikseleinä.
lastRowAlign
versiosta 2.3.0 lähtien
justifiedMäärittää viimeisen rivin toiminnan. Sallitut arvot ovat left , center , right ja justified .
singleRowAlign
versiosta 2.3.0 lähtien
justifiedMäärittää toiminnan, jos riviä on vain yksi. Sallitut arvot ovat left , center , right ja justified .
fillLastRow
versiosta 2.1.0 lähtien
truePOISTETTU versiosta 2.4.0 lähtien (POISTU versiosta 2.3.0 lähtien )
Järjestää kuvat niin, että viimeinen rivi on aina täysin täytetty. Jos aiot liittää kuvia dynaamisesti, tämä voi olla hyvä idea poistaa käytöstä.
Ei vaikuta yksittäisiin riveihin (katso fillSingleRow ).
fillSingleRow
versiosta 2.1.0 lähtien
truePOISTETTU versiosta 2.4.0 lähtien (POISTU versiosta 2.3.0 lähtien )
Jos riviä on vain yksi, se järjestää kuvat niin, että rivi on aina kokonaan täytetty. Jos voi käydä niin, että galleriassa on vain yksi tai kaksi kuvaa, tämä voi olla hyvä idea poistaa käytöstä.

Waterfall Asetteluvaihtoehdot

OletusarvoKuvaus
autoFontSizefalsePäivittää automaattisesti kunkin laatikon font-size-ominaisuuden alkuperäisen laatikon koon perusteella. Oletuksena font-size-ominaisuutta ei ole asetettu erikseen.
desiredWidth250Määrittää sarakkeiden halutun leveyden. Todellinen leveys lasketaan käytettävissä olevan leveyden ja sarakkeiden lukumäärän mukaan.
hideOnMissingImagetruePiilottaa laatikot, jotka sisältävät kuvia, joita ei voitu ladata.
horizontalOrderfalseMäärittää, että elementit sijoitetaan tiukasti yksi elementti jokaiseen sarakkeeseen vasemmalta oikealle ja alkaa sitten uudelleen vasemmanpuoleisesta sarakkeesta riippumatta siitä, kummassa sarakkeessa on enemmän paikkaa. Oletuksena elementit sijoitetaan aina pienimmän korkeuden omaavaan sarakkeeseen.
spaceBetween4Määrittää elementtien välisen etäisyyden pikseleinä.
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.

Lisää lisäasetuksia

Katso lisäasetukset API:sta .

Semanttinen HTML

Gridzyn yksinkertaisin HTML-rakenne on tämä:

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

Gridzy on kuitenkin erittäin joustava ja voit käyttää melkein mitä tahansa muuta HTML-rakennetta. On vain muutama huomioitavaa:

  • Jokainen säilöelementin ali edustaa yhtä alkiota ruudukossa.
  • Sekä säilöelementti että sen alat voivat olla mitä tahansa tagityyppiä, kuten ul ja li (harkitse vain selaimen oletusasetusten palauttamista).
  • Jos img -elementti ei itse ole suora lapsi, se tarvitsee luokan gridzyImage .

Tämä on siis myös toimiva HTML-rakenne:

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

Varsinkin jos haluat lisätä kuvatekstejä, tarvitset kehittyneen HTML-rakenteen. Saat lisätietoja siitä katsomalla Tekstitykset ja ulkoasut .

Tekstitykset ja skinit

Jos haluat lisätä kuvatekstejä galleriaasi, sinun on määritettävä ulkoasu. Siksi joitain ennalta määritettyjä skinejä on saatavana. Jokainen skin koostuu CSS-tiedostosta. Sinun on lisättävä tämä tiedosto tärkeimpien Gridzy-tiedostojen lisäksi (yleensä head-osiossa):

<link rel="stylesheet" href="gridzy/skins/gridzySkinClassic/style.min.css" />

Lisäksi tarvitset edistyneen HTML-rakenteen:

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

Jos mietit HTML-rakennetta, katso Semantic HTML .

Kuvatekstissä voit käyttää minkä tahansa tyyppistä tunnistetta, varmista vain, että siinä on luokka gridzyCaption . img elementti tarvitsee luokan gridzyImage .

Yllä oleva esimerkki näyttää ihon gridzySkinClassic . Jos haluat käyttää toista, korvaa ihon nimi jollakin seuraavista:

Mukana Skinit

Saatavilla olevat luokat
gridzySkinBlank
hyvä lähtökohta oman ihon luomiselle
live-esikatselu
gridzySkinBlank
gridzySkinClassic
live-esikatselu
gridzySkinClassic
gridzySkinClassicLight(POISTETTU versiosta 2.6.0 lähtien)
gridzySkinFullOverlay
live-esikatselu
gridzySkinFullOverlay
gridzySkinFullOverlayLight(POISTETTU versiosta 2.6.0 lähtien)
gridzySkinLift
live-esikatselu
gridzySkinLift
gridzySkinLiftLight(POISTETTU versiosta 2.6.0 lähtien)
gridzySkinMagnifier
zoom-toiminto ei sisälly
live-esikatselu
gridzySkinMagnifier
gridzySkinMagnifierLight(POISTETTU versiosta 2.6.0 lähtien)

Kaikki yllä olevat skinit tarvitsevat vain CSS-tiedoston, mutta on myös muita skinejä, jotka vaativat myös JavaScript-tiedoston:

<link rel="stylesheet" href="gridzy/skins/gridzySkinBlur/style.min.css" />
<script src="gridzy/skins/gridzySkinBlur/script.min.js"></script>
Saatavilla olevat luokat
gridzySkinBlur
ei toimi IE:ssä
live-esikatselu
gridzySkinBlur
gridzySkinBlurLight(POISTETTU versiosta 2.6.0 lähtien)
gridzySkinCard
live-esikatselu
gridzySkinCard
gridzySkinCardLight(POISTETTU versiosta 2.6.0 lähtien)

Ihovaihtoehdot

Versiosta 2.6.0 lähtien on olemassa vaihtoehtoja sisäänrakennettujen skinien määrittämiseen. Tietystä ihosta riippuen voit määrittää taustavärin, tekstin värin ja tekstin varjon. Sinun tarvitsee vain käyttää mukautettuja CSS-ominaisuuksia, kuten näet täältä:

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

Tarkista kunkin skinin tuetut muuttujat ja oletusarvot täältä:

gridzySkinClassic
MuuttuvaOletusarvoTiedot
--backgroundrgba(0, 0, 0, .7)sallii minkä tahansa CSS-taustaarvon
--colorrgb(255, 255, 255)sallii minkä tahansa CSS-väriarvon
--text-shadownonesallii minkä tahansa CSS-tekstivarjon arvon
gridzySkinFullOverlay
MuuttuvaOletusarvoTiedot
--backgroundrgba(0, 0, 0, .7)sallii minkä tahansa CSS-taustaarvon
--colorrgb(255, 255, 255)sallii minkä tahansa CSS-väriarvon
--text-shadownonesallii minkä tahansa CSS-tekstivarjon arvon
gridzySkinLift
MuuttuvaOletusarvoTiedot
--backgroundrgba(0, 0, 0, .7)sallii minkä tahansa CSS-taustaarvon
--colorrgb(255, 255, 255)sallii minkä tahansa CSS-väriarvon
--text-shadow0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0)sallii minkä tahansa CSS-tekstivarjon arvon
gridzySkinMagnifier
MuuttuvaOletusarvoTiedot
--backgroundrgba(0, 0, 0, .7)sallii minkä tahansa CSS-taustaarvon
--colorrgb(255, 255, 255)sallii minkä tahansa CSS-väriarvon

Tämä iho ei tue --text-shadow

gridzySkinBlur
MuuttuvaOletusarvoTiedot
--backgroundrgba(0, 0, 0, .7)sallii minkä tahansa CSS-taustaarvon
--colorrgb(255, 255, 255)sallii minkä tahansa CSS-väriarvon
--text-shadow0 0 10px rgb(0, 0, 0)sallii minkä tahansa CSS-tekstivarjon arvon
gridzySkinCard
MuuttuvaOletusarvoTiedot
--backgroundrgba(0, 0, 0, 1)sallii minkä tahansa CSS-taustaarvon
--colorrgb(255, 255, 255)sallii minkä tahansa CSS-väriarvon
--text-shadownonesallii minkä tahansa CSS-tekstivarjon arvon

Kaikki ennalta määritetyt ulkoasut tukevat vain yksinkertaisia tekstityksiä. Voit luoda omia ja monimutkaisempia skinejä. Ole hyvä ja katso Style Gridzy .

Tyyli Gridzy

Jos mikään ennalta määritetty iho ei sovi tarpeisiisi, voit muotoilla oman.

Helpoin tapa on kopioida ensin olemassa oleva skini ja mukauttaa se omiin tarpeisiisi. Ennalta määritetty skin gridzySkinBlank tarjoaa yleensä hyvän perustan sekä hyvän dokumentaation CSS-tiedostossa:

/** 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;
}

CSS-tiedostosta löydät luokat gridzySkinBlank , gridzyImage ja gridzyCaption . Gridzy ei itse tarvitse näitä luokkia. Niitä käytetään vain muotoiluun, joten voit poistaa tai nimetä ne uudelleen, jos haluat.

Lisäksi löydät CSS-luokan gridzyItem . Gridzy asettaa tämän luokan automaattisesti kaikille pääsäiliöelementin suorille jälkeläisille. Joten voit käyttää tätä luokkaa galleriasi kohteiden tyyliin.

Muista tärkeitä asioita

  1. Kohteen sisällön tulee olla täysin reagoiva. Ota huomioon, että elementin koko muuttuu varmasti. Käytä prosenttiarvoja pikseliarvojen sijaan. Ja katso Gridzy-asetteluvaihtoehtoa autoFontSize , joka sitoo fontin koon kohdelaatikon kokoon.
  2. Jokaisella esineellä tulee olla hyvin määritelty kuvasuhde. Kohteen kuvasuhde ei koskaan muutu, ja sitä tarvitaan ruudukon laskemiseen. Joten jos kohteella ei ole automaattisesti tarkkaa kuvasuhdetta, määritä se etukäteen manuaalisesti (esim. css:n kautta).

Joissakin tapauksissa voi olla helpompi muotoilla kohteiden sisältöä ennen kuin Gridzy alustaa. Poista vain luokan gridzy tai Gridzy javascript-tiedosto väliaikaisesti tätä varten.

Siinä se! Se on kaikki mitä tarvitset oman ihosi rakentamiseen. Suurin osa ennalta määritetyistä skineistä ei käytä tätä enempää.

Mutta niitä voisi olla enemmänkin, jos haluat…

Advanced Skins

Gridzy käyttää enemmän CSS-luokkia kuin vain gridzyItem . Suurin osa niistä asetetaan automaattisesti, ja voit käyttää niitä myös muotoiluun.

Pääkonttiluokat

Luokan nimiKuvaus
gridzy
asettaa manuaalisesti
Gridzy löytää automaattisesti tämän luokan elementtejä ja alustaa ne.
gridzyAnimatedAsetetaan automaattisesti, jos vaihtoehto animate on true . Jos tämä luokka asetetaan manuaalisesti, myös animate -vaihtoehto tulee automaattisesti true (paitsi jos se on nimenomaisesti asetettu arvoon false ).

Tuoteluokat

Luokan nimiKuvaus
gridzyItemAsetetaan heti, kun kohteen alustusprosessi alkaa. Ei poisteta koskaan.
gridzyItemInitializingAsetetaan heti, kun kohteen alustusprosessi alkaa. Korvataan gridzyItemReady heti, kun kohde on alustettu kokonaan. Ei tarkoita, että kuvat olisivat ladattu täyteen (katso gridzyItemLoading ), mutta kohde on valmis tulemaan näkyviin.
gridzyItemReadyKorvaa gridzyItemInitializing heti, kun kohde on alustettu kokonaan. Ei poisteta koskaan. Ei tarkoita, että kuvat olisivat ladattu täyteen (katso gridzyItemComplete ), mutta kohde on valmis tulemaan näkyviin.
gridzyItemLoadingAsetetaan heti, kun kohteen alustusprosessi alkaa. Korvataan gridzyItemComplete heti, kun sisältämät kuvat (yleensä vain yksi) on ladattu täyteen.
gridzyItemCompleteKorvaa gridzyItemLoading heti, kun sisältämät kuvat (yleensä vain yksi) on ladattu täyteen. Ei poisteta koskaan.
gridzyItemInitialToVisibleAsetetaan heti, kun kohde alkaa ilmestyä ensimmäisen kerran. Poistetaan heti kun tuote on kokonaan näkyvissä.
gridzyItemVisibleAsetetaan heti, kun kohde on kokonaan näkyvissä. Poistetaan heti kun tuote alkaa kadota.
gridzyItemVisibleToHiddenAsetetaan heti, kun kohde alkaa kadota. Poistetaan heti, kun kohde on kokonaan piilotettu.
gridzyItemHiddenAsetetaan heti, kun kohde on kokonaan piilotettu. Poistetaan heti, kun kohde alkaa ilmestyä.
gridzyItemHiddenToVisibleAsetetaan heti, kun kohde alkaa ilmestyä (paitsi ensimmäistä kertaa - katso luokka gridzyItemInitialToVisible ). Poistetaan heti kun tuote on kokonaan näkyvissä.
gridzyItemVisibleToVisibleAsetetaan heti, kun jokin ruudukossa muuttuu, mutta itse kohde oli ja pysyi näkyvissä. Poistetaan heti, kun muutosanimaatio on valmis.

Oletusarvoisesti prosessin ilmaisin ja animaatiot ilmaantuville ja katoaville kuville on määritetty valmiiksi Gridzy-CSS-päätiedostossa.

Näillä yllä mainituilla CSS-luokilla voit muotoilla omia prosessiindikaattoreita ja animaatioita. Tutustu Gridzyn CSS-päätiedostoon ymmärtääksesi, mitä sinun pitäisi ohittaa. Ei pelkoa, siellä on kaikki hyvin dokumentoitu.

Optimoi lataus

Jos käytät monia kuvia, voisi olla hyvä idea auttaa Gridzyä rakentamaan verkkoa nopeammin.

Estä kuvien hyppiminen

Gridzy tarvitsee ehdottomasti kaikkien kuvien kuvasuhteen ruudukon laskemiseen. Tämä tosiasia johtaa hyppiviin elementteihin, jos jotkut kuvat ovat valmiita ja toiset eivät. Mitä enemmän kuvia on, sitä ärsyttävämpi tämä vaikutus voi olla.

Voit estää tämän toiminnan asettamalla width ja height kaikille img -elementeille. On tärkeää asettaa oikeat arvot jokaiselle yksittäiselle kuvalle, muuten kuvat vääristyvät. Oikeat arvot ovat vastaavan kuvan alkuperäinen leveys ja korkeus:

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

Tämän jälkeen Gridzy voi laskea ruudukon välittömästi ilman, että tarvitsee tietää kuvien todellista kokoa.

Laiska lataus

Jos haluat ladata vain näkyvässä kuvaportissa olevat kuvat, noudata näitä ohjeita:

  1. Lisää width ja height yllä kuvatulla tavalla (varmista, että käytät oikeita arvoja)
  2. Korvaa kaikki src attribuutit data-gridzylazysrc määritteellä alla kuvatulla tavalla (jos sinulla on myös srcset attribuutteja, korvaa ne data-gridzylazysrcset määritteellä).
<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>

Näiden vaiheiden jälkeen kuvat latautuvat heti, kun ne ovat näkymän lähellä tai sisällä.

Prosessin ilmaisin

Prosessin ilmaisin on pieni animoitu kuvake, joka tulee näkyviin kuvan latautuessa. Jos käytät kuvatekstejä ja skinejä , prosessin ilmaisin näytetään automaattisesti. Muuten tarvitset joitain säätöjä:

  1. Laita jokainen img -elementti div -elementtiin
    (tai mihin tahansa muuhun elementtiin – katso lisää semanttisesta HTML :stä)
  2. Lisää jokaiseen img -elementtiin luokka gridzyImage
<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>

Sen jälkeen sinun pitäisi nähdä prosessin ilmaisimet, jos kuvien latautuminen kestää jonkin aikaa.

Suodattimet

Gridzyn suodattimet ovat melko yksinkertaisia, mutta tehokkaita. Riippumatta siitä, millaisen suodattimen tarvitset, on erittäin todennäköistä, että se on toteutettavissa. Tarvitset vain vähän CSS:ää ja muutaman HTML-lomakeelementin…

Tässä toiminnallinen esimerkki:

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

Rakennetaan se askel askeleelta

1. Tarvitsemme ensin Gridzyn tavanomaisen HTML-rakenteen ja asetamme luokkanimet kaikille galleriakohteille, jotta voimme suodattaa ne jälkeenpäin

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

Tässä esimerkissä käytämme vain yhtä luokkaa jokaiselle elementille. Voit myös asettaa useita luokkia yhdelle elementille, jos elementin pitäisi olla löydettävissä useiden suodattimien kautta.

2. Sitten lisäämme joitain painikkeita, joiden kautta voimme sitten vaihtaa suodattimia

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

Painikkeiden sijasta voit käyttää myös muita lomakeelementtejä, kuten valintaruutuja, valintanappeja, valintakenttiä ja niin edelleen.

Kuten näet, painikkeiden arvot ovat tavallisia CSS-valitsimia. Heti kun olemme lopettaneet, tällaisen painikkeen napsauttaminen näyttää CSS-valitsinta vastaavat kuvat. Teknisesti se yksinkertaisesti asettaa filter tähän arvoon.

Voit myös käyttää paljon monimutkaisempia valitsimia. Esimerkiksi :not(.animals) toimisi myös samoin kuin .animals.people ja .animals, .people .

3. Lopuksi kapseloimme painikkeet div säiliöön ja sitomme ne Gridzy-galleriaan asettamalla filterControls vaihtoehdon:

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

Kuten näet, käytämme myös CSS-valitsinta filterControls -vaihtoehdossa. div säilö, jossa on id attribuutti, auttaa vain helpottamaan painikkeiden valintaa CSS-valitsimella.

Siinä se!

Jos pidät JavaScript-ratkaisusta, tutustu API .

API

Vaikka Gridzyllä on oma API, useimmat asiat voidaan tehdä ilman sitä, yksinkertaisesti manipuloimalla DOM:ia. Gridzy huomaa sen ja säätää ruudukkoa. Mutta on myös erittäin tehokas API…

DOM:n manipulointi

Kaikkia Document Object Model (DOM) -käsittelyjä varten tarvitsemme ensin säiliöelementin:

// get the container element
var gridzyElement = document.querySelector('.gridzy');

Lisää kuvia

On tärkeää rakentaa ja täyttää kokonaan uusi alielementti ennen kuin lisäät sen säilöelementtiin. Muuten Gridzy ei pysty tunnistamaan oikeita mittoja.

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

Poista kuvat

// remove the first image
gridzyElement.removeChild(gridzyElement.firstElementChild);

Muuta asetuksia

// 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');

Lisätietoja DOM:n manipuloinnista löytyy MDN Web Docsista . Saatavilla on myös DOM:n esittely .

Oma sovellusliittymä

API:n käyttöä varten tarvitsemme ensin Gridzy-instanssin, joka on sidottu Gridzy-säiliöelementtiin:

// get the Gridzy instance
var gridzyInstance = document.querySelector('.gridzy').gridzy;

Hanki vaihtoehto

// get the value of a single option
var currentLayout = gridzyInstance.getOption('layout');

Hanki kaikki vaihtoehdot

// get all option values as an object
var currentOptions = gridzyInstance.getOptions();

Aseta asetukset

// set specific option values
gridzyInstance.setOptions({
  spaceBetween: 10,
  layout: 'waterfall'
});

// or reset options to their default values
gridzyInstance.setOptions({
  spaceBetween: null,
  layout: null
});

Käytä suodatinta

Suodattimen käyttäminen on vain filter asettamista, joka voi olla mikä tahansa kelvollinen CSS-valitsin:

// 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'
});

Lisää takaisinsoittotoimintoja

KÄYTETTY versiosta 2.4.0 lähtien
Käytä sen sijaan nykyaikaisia ja joustavampia tapahtumia . Katso lisätietoja seuraavasta osiosta.

Gridzy.js 2 tukee joitakin takaisinsoittotoimintojen vaihtoehtoja. Ne voidaan asettaa vain patentoidun API:n kautta, mutta aivan kuten muutkin vaihtoehdot:

// 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.
  }
});
Kuvaus
onBeforeOptionsChangedTakaisinsoittotoiminto, joka kutsutaan suoraan ennen asetusten asettamista.
onOptionsChangedTakaisinsoittotoiminto, joka käynnistyy heti asetusten asettamisen jälkeen.
onBeforeRenderTakaisinsoittotoiminto, joka kutsutaan suoraan ennen renderöintiä.
onRenderTakaisinsoittotoiminto, joka käynnistyy välittömästi renderoinnin jälkeen.

Käytä tapahtumia

versiosta 2.4.0 lähtien

Voit käyttää Gridzy-tapahtumia aivan kuten tavallisia JavaScript-tapahtumia:

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.
});

Jotkut tapahtumat käynnistetään Gridzy-säiliöelementissä ja toiset tapahtumat säiliöelementin yksittäisissä nimikeelementeissä.

Gridzy-säiliöelementissä käynnistetyt tapahtumat:

Kuvaus
gridzyBeforeInitSyttyy ennen gallerian alustusta.
gridzyInitSyttyy gallerian alustuksen jälkeen.
gridzyBeforeOptionsChangedSyttyy ennen asetusten asettamista.
gridzyOptionsChangedSyttyy asetusten asettamisen jälkeen.
gridzyBeforeRenderSyttyy ennen renderöimistä.
gridzyRenderSyttyy renderoinnin jälkeen.
Jos unohdat tapahtumia täällä, lähetä tukipyyntö .

event.target tarjoaa Gridzy-säiliöelementin.
event.detail.instance tarjoaa Gridzy-ilmentymän.

Kohdeelementeistä käynnistetyt tapahtumat:

Kuvaus
gridzyItemBeforeInitSyttyy ennen kohteen alustusta.
gridzyItemInitSyttyy kohteen alustuksen jälkeen.
gridzyItemLoadingSyttyy, kun kohde alkaa latautua.
gridzyItemReadySyttyy, kun kohde on valmis ruudukkolaskentaa varten. Kuvasuhde on siis tiedossa, mutta kuva saattaa silti latautua.
gridzyItemCompleteSyttyy, kun kohteen kuva on ladattu täyteen.
Jos unohdat tapahtumia täällä, lähetä tukipyyntö .

event.target tarjoaa vastaavan alkioelementin.
event.detail.instance tarjoaa Gridzy-ilmentymän.

API – Maailmanlaajuinen

Jotkut toiminnot ovat riippumattomia Gridzy-esiintymistä. Joten meidän ei tarvitse saada esimerkkiä aikaisemmin.

Hanki oletusvaihtoehto

// get the default value of a single option
var defaultLayout = Gridzy.getDefaultOption('layout');

Hanki kaikki oletusasetukset

// 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');

Aseta oletusasetukset

Tämä ei aseta kaikkien jo alustettujen Gridzy-ilmentymien asetuksia, mutta määrittää perustan uusille ilmentymille. Jos olemassa olevan ilmentymän vaihtoehto kuitenkin nollattaisiin arvon null avulla, se käyttää uutta oletusarvoa.

// set default option values
Gridzy.setDefaultOptions({
  spaceBetween: 10,
  layout: 'waterfall'
});

Voit käyttää tätä asetusten asettamiseen maailmanlaajuisesti, jos kutsut sitä ennen kuin DOM on valmis. Joten sinun ei enää tarvitse asettaa vaihtoehtoja määritteiksi.

Automatismit

Niin kauan kuin kaikki Gridzy.js 2:n automatismit ovat aktiivisia, alla olevia menetelmiä ei tarvita. Mutta automatismit voidaan kytkeä pois päältä, jotta Gridzyä voidaan käyttää perinteisemmällä tavalla:

// 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
});

Joitakin näistä vaihtoehdoista ei voida asettaa data-gridzy- attribuuttien tai setOptions() -toiminnon avulla loogisista syistä:

OletusarvoKuvaus
autoInitOnDomReadytrueTunnistaa elementit, joissa on gridzy sivua latautuessaan, ja alustaa ne.

Asetettavissa Gridzy.setDefaultOptions()
autoInitOnDomMutation
MutationObserver
trueHavaitsee uudet elementit luokan gridzy heti kun ne ilmestyvät DOM:iin ja alustaa ne. (esim. sivusiirtymien käytöstä)

Asetettavissa Gridzy.setDefaultOptions()
autoSyncChildListMutation
MutationObserver
trueTunnistaa, lisätäänkö tai poistetaanko alielementtejä (kuvia), ja päivittää ruudukon automaattisesti.

Asetettavissa data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() avulla
useOptionAttributestrueMäärittää, käytetäänkö data-gridzy- attribuutteja yleisesti vai ei. Jos tämä on false asetukset voidaan asettaa vain patentoidun API:n kautta.

Asetettavissa kautta new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncAttributesMutation
MutationObserver
trueHavaitsee data-gridzy- attribuuttien muutokset ja päivittää ruudukon automaattisesti. Tunnistaa myös, lisätäänkö tai poistetaanko gridzyAnimated -luokka ja tapahtuuko style muutoksia. Jos useOptionAttributes on false , se havaitsee vain style muutokset.

Asetettavissa data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() avulla
autoSyncChildClassMutation
MutationObserver
trueHavaitsee muutokset kaikkien lapsielementtien (kuvien) class . Koskee suodattimia.

Asetettavissa data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() avulla
autoSyncImageMutation
MutationObserver

versiosta 2.5.0 lähtien
trueTunnistaa kaikkien kuvien src attribuuttien muutokset. Olennainen käytettäessä Reactin tai vastaavien kirjastojen kanssa.

Asetettavissa data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() avulla
autoRenderOnResize
ResizeObserver

versiosta 2.6.0 lähtien
trueTunnistaa elementin leveyden muutokset. Relevanssia responsiivisen suunnittelun kannalta. (Ennen versiota 2.6.0 käytettiin ikkunan koon muutostapahtuman kuuntelua)

Asetettavissa data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() avulla

Alusta manuaalisesti

// initialize a new Gridzy instance
var gridzyInstance = new Gridzy(document.querySelector('.gridzy'), {
  spaceBetween: 10,
  layout: 'waterfall'
});

Tuhoa esiintymä

Karkeasti sanottuna Gridzyn alustamisen vastakohta.

gridzyInstance.destroy();
gridzyInstance = null;

Synkronoi lapsiluettelo manuaalisesti

// after child elements (images) are added to or removed from the DOM.
gridzyInstance.syncChildList();

Synkronoi yksittäinen lapsielementti manuaalisesti

Yleensä ei tarvita, paitsi erittäin harvoissa tapauksissa.

// after child elements (images) are added to the DOM and only one of them should be synced to Gridzy.
gridzyInstance.syncChild(childElement);

Synkronoi määritteet manuaalisesti

Huomaa, että useOptionAttributes -vaihtoehdon on oltava true tässä.

// after data-gridzy- attributes have changed
gridzyInstance.syncAttributes();

Pakota renderöinti

Yleensä ei tarvita, vaikka kaikki automatiikat olisi kytketty pois päältä

gridzyInstance.render();