Sivusto on käännetty automaattisesti. Jos jokin on epäselvää, katso englanninkielistä dokumentaatiota.
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
Justified Asetteluvaihtoehdot
Waterfall Asetteluvaihtoehdot
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
uljali(harkitse vain selaimen oletusasetusten palauttamista). - Jos
img-elementti ei itse ole suora lapsi, se tarvitsee luokangridzyImage.
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(POISTETTU versiosta 2.6.0 lähtien) |
| gridzySkinFullOverlay live-esikatselu | gridzySkinFullOverlay(POISTETTU versiosta 2.6.0 lähtien) |
| gridzySkinLift live-esikatselu | gridzySkinLift(POISTETTU versiosta 2.6.0 lähtien) |
| gridzySkinMagnifier zoom-toiminto ei sisälly live-esikatselu | gridzySkinMagnifier(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(POISTETTU versiosta 2.6.0 lähtien) |
| gridzySkinCard live-esikatselu | gridzySkinCard(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
| Muuttuva | Oletusarvo | Tiedot |
|---|---|---|
--background | rgba(0, 0, 0, .7) | sallii minkä tahansa CSS-taustaarvon |
--color | rgb(255, 255, 255) | sallii minkä tahansa CSS-väriarvon |
--text-shadow | none | sallii minkä tahansa CSS-tekstivarjon arvon |
gridzySkinFullOverlay
| Muuttuva | Oletusarvo | Tiedot |
|---|---|---|
--background | rgba(0, 0, 0, .7) | sallii minkä tahansa CSS-taustaarvon |
--color | rgb(255, 255, 255) | sallii minkä tahansa CSS-väriarvon |
--text-shadow | none | sallii minkä tahansa CSS-tekstivarjon arvon |
gridzySkinLift
| Muuttuva | Oletusarvo | Tiedot |
|---|---|---|
--background | rgba(0, 0, 0, .7) | sallii minkä tahansa CSS-taustaarvon |
--color | rgb(255, 255, 255) | sallii minkä tahansa CSS-väriarvon |
--text-shadow | 0 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
| Muuttuva | Oletusarvo | Tiedot |
|---|---|---|
--background | rgba(0, 0, 0, .7) | sallii minkä tahansa CSS-taustaarvon |
--color | rgb(255, 255, 255) | sallii minkä tahansa CSS-väriarvon |
Tämä iho ei tue --text-shadow
gridzySkinBlur
| Muuttuva | Oletusarvo | Tiedot |
|---|---|---|
--background | rgba(0, 0, 0, .7) | sallii minkä tahansa CSS-taustaarvon |
--color | rgb(255, 255, 255) | sallii minkä tahansa CSS-väriarvon |
--text-shadow | 0 0 10px rgb(0, 0, 0) | sallii minkä tahansa CSS-tekstivarjon arvon |
gridzySkinCard
| Muuttuva | Oletusarvo | Tiedot |
|---|---|---|
--background | rgba(0, 0, 0, 1) | sallii minkä tahansa CSS-taustaarvon |
--color | rgb(255, 255, 255) | sallii minkä tahansa CSS-väriarvon |
--text-shadow | none | sallii 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
- 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. - 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 nimi | Kuvaus |
|---|---|
gridzyasettaa manuaalisesti | Gridzy löytää automaattisesti tämän luokan elementtejä ja alustaa ne. |
gridzyAnimated | Asetetaan 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 nimi | Kuvaus |
|---|---|
gridzyItem | Asetetaan heti, kun kohteen alustusprosessi alkaa. Ei poisteta koskaan. |
gridzyItemInitializing | Asetetaan 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. |
gridzyItemReady | Korvaa 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. |
gridzyItemLoading | Asetetaan heti, kun kohteen alustusprosessi alkaa. Korvataan gridzyItemComplete heti, kun sisältämät kuvat (yleensä vain yksi) on ladattu täyteen. |
gridzyItemComplete | Korvaa gridzyItemLoading heti, kun sisältämät kuvat (yleensä vain yksi) on ladattu täyteen. Ei poisteta koskaan. |
gridzyItemInitialToVisible | Asetetaan heti, kun kohde alkaa ilmestyä ensimmäisen kerran. Poistetaan heti kun tuote on kokonaan näkyvissä. |
gridzyItemVisible | Asetetaan heti, kun kohde on kokonaan näkyvissä. Poistetaan heti kun tuote alkaa kadota. |
gridzyItemVisibleToHidden | Asetetaan heti, kun kohde alkaa kadota. Poistetaan heti, kun kohde on kokonaan piilotettu. |
gridzyItemHidden | Asetetaan heti, kun kohde on kokonaan piilotettu. Poistetaan heti, kun kohde alkaa ilmestyä. |
gridzyItemHiddenToVisible | Asetetaan heti, kun kohde alkaa ilmestyä (paitsi ensimmäistä kertaa - katso luokka gridzyItemInitialToVisible ). Poistetaan heti kun tuote on kokonaan näkyvissä. |
gridzyItemVisibleToVisible | Asetetaan 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:
- Lisää
widthjaheightyllä kuvatulla tavalla (varmista, että käytät oikeita arvoja) - Korvaa kaikki
srcattribuutitdata-gridzylazysrcmääritteellä alla kuvatulla tavalla (jos sinulla on myössrcsetattribuutteja, korvaa nedata-gridzylazysrcsetmää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ä:
- Laita jokainen
img-elementtidiv-elementtiin
(tai mihin tahansa muuhun elementtiin – katso lisää semanttisesta HTML :stä) - Lisää jokaiseen
img-elementtiin luokkagridzyImage
<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.
}
});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:
event.target tarjoaa Gridzy-säiliöelementin.
event.detail.instance tarjoaa Gridzy-ilmentymän.
Kohdeelementeistä käynnistetyt tapahtumat:
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ä:
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();