Saqqummersitsineq 2.x


Tunngaviusumik Atuineq

Gridzy-mik filit serverimut upload-erlugit nittartakkannut ilanngukkit (nalinginnaasumik quppernermi immikkoortumi):

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

HTML-kode ilanngukkit (timit immikkoortuani sumiluunniit):

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

Tassa taanna! Tassa tamakkiisumik atuuffiusumik assersuut. Ekstra inissitsiterneq pisariaqanngilaq.

Aaqqissuussineq

Gridzy-mik atornissamut ajornannginnerpaaq tassaavoq, HTML-imik attributit atorlugit. Periarfissat aqqi data-gridzy- -mik siullermik allattariaqarpatit. Taava, toqqagassaq spaceBetween inissinniarlugu, attribut data-gridzy-spaceBetween ilanngukkit.

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

Periarfissat pingaarnerit

StandardværdiNassuiaat
animatetrueAalajangiisarpaa, animationit atorneqarnissaat, grid-ip allanngortinneqarnerani (assersuutigalugu browsererip igalaasartaata annertussusaa allanngortinneqarnerani imaluunniit filterimik inissitsiternermi).
layoutjustifiedLayout atorneqartoq aalajangersarpaa. Gridzy.js 2-p tapersersorpai marluk assigiinngitsut justified aamma waterfall . Taakku tamarmik immikkut namminneq allanik periarfissaqarput, taakkulu tabelip matuma ataani nassaarisinnaavatit.
filter*Assit sorliit takutinneqarnissaat aalajangissavaa. CSS-selektori sunaluunniit uani pingaarnertut atorneqarsinnaavoq. Nalinginnaasumik filterControls aqqutigalugu nammineerluni inissinneqartarpoq (takuuk toqqagassaq tulleq).
Filterit takukkit
filterControlsAalajangiisarpaa form-elementit sorliit assit filterernissaannut atorneqarsinnaanersut. CSS-imik toqqaasoq sunaluunniit, HTML-imi formularimik toqqaasoq, uani pingaarnertut atorneqarsinnaavoq.
Filterit takukkit
autoConsiderScrollBarstrueRullebarrit takussaappata tammarpataluunniit siammasissuseq atorneqarsinnaasoq siumut isiginiarlugu. Innersuussutigineqartarpoq true mik inissinneqarnissaa, automatismi taanna ajornartorsiutinik pilersitsinngippat.

Justified Ilusilersuinermut periarfissat

StandardværdiNassuiaat
autoFontSizefalseBoksit ataasiakkaat font-size-mik piginnaasaat automatiskimik nutartertarpaa, boksip annertussusaa aallaqqaammut tunngavigalugu. Standarditut font-size-mik piginnaasaq erseqqissumik inissinneqarsimanngilaq.
desiredHeight190Element-rekke-t qaffasissusaat kissaatigineqartoq aalajangersarpaa. Ilumut qaffasissuseq naatsorsorneqassaaq annertussuseq pissarsiarineqarsinnaasoq aammalu rækkemi elementit apeqqutaallutik.
hideOnMissingImagetrueBoksit assinik ikkussorneqarsinnaasimanngitsunik imallit toqqortarpai.
spaceBetween4Elementit akornanni ungasissuseq pixelinik aalajangersarpaa.
lastRowAlign
2.3.0-miit
justifiedKingullermik rækkep qanoq pissuseqarnera aalajangersarpaa. Pingaarnertut salliunneqarsinnaasut tassaapput left , center , right aamma justified .
singleRowAlign
2.3.0-miit
justifiedAtaatsimik ataatsimik rækkeqarpat pissusilersuut aalajangersarpaa. Pingaarnertut salliunneqarsinnaasut tassaapput left , center , right aamma justified .
fillLastRow
2.1.0-miit
true2.4.0-miit PISSARSIARSIORNEQARPOQ ( Saqqummersitsinermiit 2.3.0-miit ATUUNNEQARPOQ)
Assit aaqqissuuttarpai taamaalilluni række kingulleq tamakkiisumik immersorneqartarluni. Assit dynamisk ilanngunneqarnissaat pilersaarutigakku, tamanna deaktiverineqarnissaa pitsaasuussinnaavoq.
Ataatsimut rækkenut sunniuteqanngilaq (takuuk fillSingleRow ).
fillSingleRow
2.1.0-miit
true2.4.0-miit PISSARSIARNEQARPOQ ( Saqqummersitsinermiit 2.3.0-miit ATUUNNEQARPOQ )
Ataatsimik rækkeqarpat assilisanik aaqqissuussisarpoq, række tamakkerlugu immersorneqartarluni. Pisinnaappat assinik ataatsimik marlunnilluunniit assilisassiorfimmiittoq, taava tamanna deaktiveriarnissaa pitsaasuussinnaavoq.

Waterfall Layout-imut periarfissat

StandardværdiNassuiaat
autoFontSizefalseBoksit ataasiakkaat font-size-mik piginnaasaat automatiskimik nutartertarpaa, boksip annertussusaa aallaqqaammut tunngavigalugu. Standarditut font-size-mik piginnaasaq erseqqissumik inissinneqarsimanngilaq.
desiredWidth250Kolonnit qanoq annertutiginersut aalajangersarpaa. Ilumut annertussuseq naatsorsorneqassaaq annertussuseq pissarsiarineqarsinnaasoq aammalu kolonnit amerlassusaat apeqqutaallutik.
hideOnMissingImagetrueBoksit assinik ikkussorneqarsinnaasimanngitsunik imallit toqqortarpai.
horizontalOrderfalseNassuiarpaa elementit kolonnini ataasiakkaani strikt ataatsimik elementimik inissinneqarsimasut venstremiit højremut, taava aallarteqqittarpoq venstreste kolonnimi nammineerluni kolonni sorleq inissisimanerusoq. Standarditut elementit kolonnimi minnerpaamik portussusilimmi inissinneqartassapput.
spaceBetween4Elementit akornanni ungasissuseq pixelinik aalajangersarpaa.
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.

Periarfissat siuarsakkat amerlanerusut

Periarfissat siuarsarneqarnerusut pillugit API takuuk.

HTML-imik isumaqarluni

Gridzy-p HTML-imik sananeqaataa ajornannginnerpaaq tassaavoq:

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

Kisianni Gridzy assut fleksibel-iuvoq aammalu HTML-imik sananeqaateqarneq alla atorsinnaavat. Arlallit kisimik eqqarsaatigisariaqarput:

  • Container-elementip meerartai ataasiakkaat grid-imi ataatsimik sinniisuullutik.
  • Container-elementi aamma meeqqani tamarmik taaguuteqarsinnaapput, soorlu ul aamma li (browser-imi atortussat nutarternissaat eqqarsaatigiuk).
  • img element nammineq toqqaannartumik meeqqaunngippat, taava klassi gridzyImage pisariaqartippaa.

Taamaattumik tamanna aamma HTML-imik sananeqaateqarpoq:

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

Pingaartumik qulequttanik ilanngussaqarniaruit HTML-imik sanaartorneq siuarsarneqarsimasoq pisariaqartinneqarpoq. Tamanna pillugu paasisaqarnerorusukkuit Captions & Skins -imi takusinnaavat.

Qulequttat & Skins

Gallerimut allaaserisat ilanngukkusukkukkit, isikkoq aalajangersartariaqarpat. Taamaattumik ilaatigut siusinnerusukkut aalajangerneqarsimasut pissarsiarineqarsinnaapput. Skin ataaseq CSS-imik imaqartoq. Gridzy-mi pingaarnertut filit saniatigut fili una ilannguttariaqarpat (nalinginnaasumik quppernermi immikkoortumi):

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

Aammattaaq HTML-imik sanaartorneq siuarsarneqarsimasoq pisariaqartippatit:

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

HTML-ip sananeqaataa pillugu eqqarsaatersorpat, Semantic HTML -imi takusinnaavat.

Qulequtaq pillugu allagartaq qanoq ittuunersoq atorsinnaavat, qulakkeerlugu klassimik gridzyCaption peqartoq. img elementip klassi gridzyImage pisariaqartippaa.

Assersuut qulaani allassimasoq takutippaa gridzySkinClassic . Allamik atuiniaruit, skin-ip aqqa uku ilaatigut taarserlugu:

Ilaatigut Skins

Klassit atorneqarsinnaasut
gridzySkinBlank
nammineq skin-imik pilersitsinissamut aallaaviulluartoq
live-mik siullermeerneq
gridzySkinBlank
gridzySkinClassic
live-mik siullermeerneq
gridzySkinClassic
gridzySkinClassicLight(Versionimiit 2.6.0-miit atorneqanngilaq)
gridzySkinFullOverlay
live-mik siullermeerneq
gridzySkinFullOverlay
gridzySkinFullOverlayLight(Versionimiit 2.6.0-miit atorneqanngilaq)
gridzySkinLift
live-mik siullermeerneq
gridzySkinLift
gridzySkinLiftLight(Versionimiit 2.6.0-miit atorneqanngilaq)
gridzySkinMagnifier
zoom-imik atuineq ilanngunneqanngilaq
live-mik siullermeerneq
gridzySkinMagnifier
gridzySkinMagnifierLight(Versionimiit 2.6.0-miit atorneqanngilaq)

Skin-it qulaani taaneqartut tamarmik CSS-imik kisimik pisariaqartitsipput, kisianni skinit allat aamma JavaScript-imik pisariaqartitsipput:

<link rel="stylesheet" href="gridzy/skins/gridzySkinBlur/style.min.css" />
<script src="gridzy/skins/gridzySkinBlur/script.min.js"></script>
Klassit atorneqarsinnaasut
gridzySkinBlur
IE-mi sulinngilaq
live-mik siullermeerneq
gridzySkinBlur
gridzySkinBlurLight(Versionimiit 2.6.0-miit atorneqanngilaq)
gridzySkinCard
live-mik siullermeerneq
gridzySkinCard
gridzySkinCardLight(Versionimiit 2.6.0-miit atorneqanngilaq)

Skin Periarfissat

Version 2.6.0-imiit Options-inik skin-it ikkussuunneqarsimasut aaqqissuunnissaannut periarfissaqarpoq. Immikkut ittumik ami apeqqutaatillugu tunuliaqutap qalipaataa, allakkap qalipaataa aamma allakkap qalipaataa inissitissinnaavatit. CSS-ip piginnaasassai atortariaqarpatit soorlu uani takusinnaagitsik:

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

Tapersersorneqartut allanngorartartut aammalu skin-it ataasiakkaat pillugit pingaarnertut pingaarnertut uani takukkit:

gridzySkinClassic
AllanngorartoqStandardværdiPaasissutissaq
--backgroundrgba(0, 0, 0, .7)CSS-imik tunuliaqutaasumik pingaartitsisinnaavoq
--colorrgb(255, 255, 255)CSS-imi farveværdi qanoq ittuunersoq salliuppaa
--text-shadownoneCSS-imik allattuiffimmik-skygge-mik pingaaruteqartumik sumiluunniit salliutitsisinnaavoq
gridzySkinFullOverlay
AllanngorartoqStandardværdiPaasissutissaq
--backgroundrgba(0, 0, 0, .7)CSS-imik tunuliaqutaasumik pingaartitsisinnaavoq
--colorrgb(255, 255, 255)CSS-imi farveværdi qanoq ittuunersoq salliuppaa
--text-shadownoneCSS-imik allattuiffimmik-skygge-mik pingaaruteqartumik sumiluunniit salliutitsisinnaavoq
gridzySkinLift
AllanngorartoqStandardværdiPaasissutissaq
--backgroundrgba(0, 0, 0, .7)CSS-imik tunuliaqutaasumik pingaartitsisinnaavoq
--colorrgb(255, 255, 255)CSS-imi farveværdi qanoq ittuunersoq salliuppaa
--text-shadow0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0)CSS-imik allattuiffimmik-skygge-mik pingaaruteqartumik sumiluunniit salliutitsisinnaavoq
gridzySkinMagnifier
AllanngorartoqStandardværdiPaasissutissaq
--backgroundrgba(0, 0, 0, .7)CSS-imik tunuliaqutaasumik pingaartitsisinnaavoq
--colorrgb(255, 255, 255)CSS-imi farveværdi qanoq ittuunersoq salliuppaa

Una skin --text-shadow tapersersorneqanngilaq

gridzySkinBlur
AllanngorartoqStandardværdiPaasissutissaq
--backgroundrgba(0, 0, 0, .7)CSS-imik tunuliaqutaasumik pingaartitsisinnaavoq
--colorrgb(255, 255, 255)CSS-imi farveværdi qanoq ittuunersoq salliuppaa
--text-shadow0 0 10px rgb(0, 0, 0)CSS-imik allattuiffimmik-skygge-mik pingaaruteqartumik sumiluunniit salliutitsisinnaavoq
gridzySkinCard
AllanngorartoqStandardværdiPaasissutissaq
--backgroundrgba(0, 0, 0, 1)CSS-imik tunuliaqutaasumik pingaartitsisinnaavoq
--colorrgb(255, 255, 255)CSS-imi farveværdi qanoq ittuunersoq salliuppaa
--text-shadownoneCSS-imik allattuiffimmik-skygge-mik pingaaruteqartumik sumiluunniit salliutitsisinnaavoq

Skin-it aalajangersimasut tamarmik allattukkanik pisariunngitsunik kisimik tapersersuisarput. Nammineq aammalu annertunerusumik skin-inik pilersitsisinnaavutit. Style Gridzy -mik takusaqarsinnaavutit.

Stil Gridzy

Pisariaqartitannut naleqqutinngippat skin predefined-iusoq nammineq style-ersinnaavat.

Ajornannginnerpaaq tassaavoq siullermik skin-imik pioreersumik kopieqarnissaq namminerlu pisariaqartitannut naleqqussarnissaq. Siusinnerusukkut aalajangerneqarsimasoq skin gridzySkinBlank nalinginnaasumik tunngaviusumik tunngaveqarsinnaavoq kiisalu CSS-imi allakkiamik pitsaasumik tunniussisinnaalluni:

/** 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-imi klassit gridzySkinBlank , gridzyImage aamma gridzyCaption nassaarisinnaavatit . Gridzy nammineq taakku klassit pisariaqartinngilai. Taakku styling-imut kisimik atorneqartarput taamaattumillu piumagukku peersinnaavatit imaluunniit taaguuteqalersinnaavatit.

Tamatuma saniatigut CSS-klassi gridzyItem nassaarisinnaavat. Gridzyp klassi una automatiskimik pingaarnertut containerip elementiata meeqqanut toqqaannartumik tamanut inissippaa. Taava, klassi una atorlugu galleriimi atortussat stilersinnaavatit.

Mind Pingaarutillit

  1. Nioqqutissap imarisai tamakkiisumik akissuteqarfigineqartariaqarmata. Eqqarsaatigiuk elementip annertussusaa qularnanngitsumik allanngortinneqassasoq. Pixel-it taarserlugit procentit atorlugit. Aammalu Gridzy-mi layout-imik toqqagassaq autoFontSize -mik takuuk, taanna font-size-mik item-boksip angissusianut ataqatigiissitsisarpoq.
  2. Nioqqutissat ataasiakkaat aalajangersimasumik aspektratioqartariaqarmata. Nioqqutip aspektratio allanngortinneqassanngilaq aammalu grid-ip naatsorsornissaanut pisariaqarpoq. Taamaattumik atortoq automatiskimik aalajangersimasumik aspektratiomik peqanngippat, taava manuelt predefine-risinnaavat (assersuutigalugu css aqqutigalugu).

Ilaatigut Gridzyp inissititernissaa sioqqullugu atortut imarisaat stilernissaat ajornannginnerusinnaavoq. Tamanna pillugu klassi gridzy imaluunniit Gridzy javascript-fil-i piffissap ilaani peerlugu.

Tassa taanna! Tassa nammineq aminnik sanaartornissamut pisariaqartinneqartoq. Amerlanerpaartaasa predefined skins-it tamanna annerusumik atortarpaat.

Kisianni amerlanerusunik peqarsinnaavoq piumagukku ...

Siuarsakkat Skins

Gridzy CSS-klassinik amerlanerusunik atuisarpoq, gridzyItem kisimi atortarpai. Amerlanersaat automatiskimik inissinneqassapput aammalu styling-imut aamma atorsinnaavatit.

Pingaarnertut container-klassit

Klasse AqqaNassuiaat
gridzy
manuelt inissinniarlugu
Gridzyp automatiskimik klassimik taanna atorlugu elementit nassaarisarpai, taakkulu inissititertarlugit.
gridzyAnimatedAutomatiskimik inissinneqassaaq, toqqagassaq animate true . Klassi taanna manuelt inissinneqarpat, toqqagassaq animate aamma automatiskimik true nngortinneqassaaq (minnerunngitsumik erseqqissumik false -mut inissinneqarpat).

Item Klassit

Klasse AqqaNassuiaat
gridzyItemAtorneqassaaq soorlu atortoq inissitsiternermik aallartitsilerpat. Qangaluunniit peerneqassanngilaq.
gridzyItemInitializingAtorneqassaaq soorlu atortoq inissitsiternermik aallartitsilerpat. Taarserneqassaaq gridzyItemReady -mik, soorlu atortoq tamakkerlugu inissinneqareerpat. Imaanngilaq assit tamakkiisumik ikkussorneqarsimasut (takuuk gridzyItemLoading ), kisiannili atortoq takuneqarsinnaalernissaanut piareersimavoq.
gridzyItemReadygridzyItemInitializing taarsersinnaavaa, soorlu atortoq tamakkerlugu aallartisarneqareerpat. Qangaluunniit peerneqassanngilaq. Imaanngilaq assit tamakkiisumik ikkussorneqarsimasut (takuuk gridzyItemComplete ), kisiannili atortoq takuneqarsinnaalernissaanut piareersimavoq.
gridzyItemLoadingAtorneqassaaq soorlu atortoq inissitsiternermik aallartitsilerpat. Taarserneqassaaq gridzyItemComplete -mik, assit imarisaannik (nalinginnaasumik ataaseq) tamakkiisumik ikkussorneqareerpata.
gridzyItemCompletegridzyItemLoading taarsersinnaavaa, assit imarisaannik (nalinginnaasumik ataaseq) tamakkiisumik ikkussorneqareerpata. Qangaluunniit peerneqassanngilaq.
gridzyItemInitialToVisibleSiullerpaamik atortoq saqqummertalerpat inissinneqassaaq. Nioqqutissaq tamakkerlugu takuneqarsinnaalerpat peerneqassaaq.
gridzyItemVisibleNioqqutissaq tamakkiisumik takuneqarsinnaalerpat inissinneqassaaq. Nioqqutissaq tammartalerpat peerneqassaaq.
gridzyItemVisibleToHiddenNioqqutissaq tammartalerpat inissinneqassaaq. Nioqqutissaq tamakkerlugu toqqorsimappat peerneqassaaq.
gridzyItemHiddenNioqqutissaq tamakkerlugu toqqorsimalerpat inissinneqassaaq. Nioqqutissaq saqqummertalerpat peerneqassaaq.
gridzyItemHiddenToVisibleInissiaq saqqummersinneqalerpat inissinneqassaaq (siullerpaamik saqqummerneq minillugu – takuuk klassi gridzyItemInitialToVisible ). Nioqqutissaq tamakkerlugu takuneqarsinnaalerpat peerneqassaaq.
gridzyItemVisibleToVisibleIkkussorneqassaaq soorlu grid-imi arlaannik allanngortitsisoqarpat, kisianni atortoq nammineq tassaavoq aamma takuneqarsinnaalluni. Allanngortitsinermik animationi naammassippat peerneqassaaq.

Standarditut suliassaq takussutissaq aammalu assilisassat takuneqarsinnaasut aammalu tammarsinnaasut pillugit animationit Gridzy-p pingaarnertut CSS-filianit aalajangerneqartarput.

CSS-klassit taakku qulaani taaneqartut atorlugit nammineq suliassanik takussutissiaq aamma animationit stilersinnaavatit. Gridzy-p CSS-imik pingaarnertut filianut qiviarsinnaavutit, paasiniarlugu suna override-ertariaqarsimanerlugu. Annilaangassuteqanngilaq, suna tamari tassani allaaserineqarluarsimavoq.

Lastning-imik pitsanngorsaaneq

Assit amerlasuut atorlugit Gridzyp sukkanerusumik grid-imik sanaartornissaanut ikiorsinnaagukku isumassarsiatsialaavoq.

Assit Jumping-imik pinaveersaartitsineq

Gridzyp assit tamarmik aspektratio-at pisariaqartippaa, grid-imik naatsorsueqqissaarnissamut. Tamakku kinguneqartitsipput jumping elementinik, assilisassat ilaat piareersimappata allallu piareersimanngippata. Assit amerlanerulerpata, tamanna sunniut pissanganarnerusinnaavoq.

Pissusilersuut tamanna pinaveersaartinniarlugu img -elementinut tamanut width aamma height attributit ikkukkit. Pingaaruteqarpoq assilisassiat ataasiakkaat eqqortumik inissinneqarnissaat, taamaanngippat assilisassat atornerlunneqarsinnaapput. Pissutsit eqqortut tassaapput assilisassiat ataasiakkaat aallaqqaammut siammasissusaat aamma portussusaat:

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

Tamatuma kingorna Gridzyp assilisassiat ilumut qanoq annertutiginersut ilisimasariaqanngikkaluarlugit grid-i toqqaannartumik naatsorsorsinnaavaa.

Lazy Lastning

Assit takuneqarsinnaasumiittut kisimik ikkussinnaagukkit, malittarisassat uku malittariaqarpatit:

  1. Qulaani allaaserineqartutut width aamma height ilisarnaatit ilanngukkit (qulakkeerlugu pingaarnerit eqqortut atorlugit)
  2. src piginnaasassai tamarmik data-gridzylazysrc imik taarserlugit soorlu ataani takutinneqartoq (aamma srcset piginnaasaqarpat, data-gridzylazysrcset imik taarserlugit).
<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>

Tamakku kingorna assilisassat takussutissap eqqaani imaluunniit iluaniilerpata ikkussorneqassapput.

Processimik takussutissiaq

Processindikatori tassaavoq assilisassiap ikkunneqarnerani takuneqartartoq animationimik ikonimik mikisumik. Qulequttat & skins atorlugit, suliassaq pillugu takussutissiaq nammineerluni takutinneqassaaq. Taamaattoqanngippat naleqqussaanerit ilaat pisariaqartippatit:

  1. img -elementit ataasiakkaat div -elementimut ikkukkit
    (imaluunniit allamut – semantisk HTML takuuk annertunerusumik paasisaqarusukkuit)
  2. img element-inut ataasiakkaanut klassi gridzyImage ilanngukkit
<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>

Tamatuma kingorna process-imik takussutissat takusariaqarpatit, assilisassat piffissaq atorlugu ikkussorneqarnissaat.

Filterit

Gridzy-mi filterit assut pitsaasuupput kisiannili pissaanilissuit. Qanoq ittumik filterimik pisariaqartitsigaluaruit, assut ilimanaateqarpoq taanna piviusunngortinneqarsinnaasoq. Pisariaqartinneqartoq tassaavoq, CSS-imik aamma HTML-imik allagartanik arlalinnik ...

Tassa assersuut funktionel:

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

Trin-imik trin-imik sanaartorpugut

1. Siullermik Gridzy-p HTML-imik sananeqaataa nalinginnaasoq pisariaqartipparput aammalu gallerimi atortunut tamanut klassinik aqqinik inissitsissalluta kingorna filtereqarsinnaajumalluta

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

Assersuummi tassani elementinut ataasiakkaanut klassi ataaseq atortarparput. Kisianni aamma elementimut ataatsimut klassinik arlalinnik inissitsissinnaavutit, elementi taanna filterit arlallit aqqutigalugit nassaarineqarsinnaassappat.

2. Taava ilannguttarpagut toortagassat ilaat aqqutigalugit filterit allanngortissinnaavagut taava

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

Knappiit taarserlugit aamma formularimi allat atorsinnaavatit soorlu checkboksit, radioknappi, toqqakkat il.il.

Soorlu takusinnaagitsik, toortagassat pingaarnerit tassaapput nalinginnaasumik CSS-imik toqqaasartut. Naammassigutta taamatut toortagaq toorlugu assit CSS-imik toqqagassaq tassunga naleqquttut takutinneqassapput. Teknikkikkut filter toqqagassaq taanna pingaarnertut inissippaa.

Aammattaaq toqqakkat annertunerujussuit atorsinnaavatit. Assersuutigalugu :not(.animals) aamma sulisinnaavoq, soorlu aamma .animals.people aamma .animals, .people .

3. Kingullermik toortagassat div container-imi kapslertarpagut Gridzy-llu gallerianut atassuteqartarlugit, filterControls imik toqqagassaq atorlugu:

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

Soorlu takusinnaagitsik aamma filterControls -imut CSS-imik toqqagassaq atortarparput. div container id mik attributeqartoq taamaallaat CSS-imik toqqaasoq taanna aqqutigalugu toortagassat toqqagassaanerat ajornannginnerulersinniarlugu atorneqarpoq.

Tassa taanna!

JavaScript-imik aaqqiissummik piumasaqarpat, API -mik takuuk.

API

Naak Gridzy nammineq API-qartoq, amerlanertigut taanna atorlugu suliarineqarsinnaavoq, DOM-imik atornerluineq atorlugu. Gridzyp maluginiassavaa aammalu grid-i naleqqussarlugu. Kisianni aamma API-mik assut pingaaruteqartumik peqarpoq ...

DOM-imik atornerluineq

Dokumentobjektmodelip (DOM) atorneqarneranut tamanut siullermik containerip elementia pisariaqartipparput:

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

Assit ilanngukkit

Pingaaruteqarpoq meeqqap elementiata nutaap tamakkiisumik sananeqarnissaa aammalu immerneqarnissaa, container-elementimut ilanngunnginnerani. Taamaattoqanngippat Gridzy-p eqqortumik annertussusillit paasiniarsinnaanngilai.

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

Assit peerlugit

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

Periarfissat allanngortikkit

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

DOM-imik atornerluineq pillugu annertunerusumik MDN web docs -imi nassaarisinnaavat. Aamma DOM-imut Aallaqqaasiut pissarsiarineqarsinnaavoq.

Piginnittuusoq API

API atorniarlugu siullermik Gridzy-mik instansimik pisariaqartitsivugut, taanna Gridzy-mik container-elementimut atassuteqarpoq:

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

Periarfissaq pissarsiariuk

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

Periarfissat Tamaasa pissarsiariuk

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

Toqqakkat toqqarlugit

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

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

Filterimik atuineq

Filterimik atuineq tassaavoq toqqagassaq filter CSS-imik toqqaasinnaasumik inissitsiterneq:

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

Callback-imik funktionit ilanngukkit

2.4.0-miit ATUUNNEQARPOQ
Taarsiullugu Events-it nutaaliaasut aammalu fleksiblerusut atorlugit. Immikkoortoq tulleq takuuk.

Gridzy.js 2-mi callback-imik suliaqarnermut periarfissat ilaat tapersersorneqarput. Taakku kisimik API-mik piginnittumik aqqutigalugu inissinneqarsinnaapput, kisianni soorlu aamma allat periarfissat:

// 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.
  }
});
Nassuiaat
onBeforeOptionsChangedCallback-funktion, toqqagassat inissinneqarnissaat sioqqullugu toqqaannartumik saaffiginnittartoq.
onOptionsChangedCallback-funktion, toqqagassat inissinneqarnerata kingorna toqqaannartumik saaffiginnittartoq.
onBeforeRenderCallback-funktion, taanna toqqaannartumik rendering sioqqullugu saaffigineqartarpoq.
onRenderCallback-funktion, rendering-ip kingorna toqqaannartumik saaffiginnittartoq.

Pisartut atorlugit

2.4.0-miit

Gridzy-mi pisut atorsinnaavatit soorlu JavaScript-imi pisut nalinginnaasut:

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

Pisartut ilaat Gridzy-mik container-elementimi atorneqartarput aammalu pisut allat container-elementip iluani item-elementit ataasiakkaat atorlugit atorneqartarlutik.

Gridzy-mik container-elementimi pisut:

Nassuiaat
gridzyBeforeInitGalleri aallartitsineq sioqqullugu ikuallannerit.
gridzyInitGalleri inissinneqarnerata kingorna ikuallannerit.
gridzyBeforeOptionsChangedToqqagassat inissinneqarnissaat sioqqullugu ikuallaasarpoq.
gridzyOptionsChangedToqqagassat inissinneqarnerata kingorna ikuallappoq.
gridzyBeforeRenderRendering sioqqullugu ikuallaasarpoq.
gridzyRenderRendering-ip kingorna ikuallaasarpoq.
Uani pisussat ilaat misigisimagukkit, tapersersuinermik qinnuteqaat nassiuk .

event.target Gridzy-mik container-element-imik neqerooruteqarpoq.
event.detail.instance Gridzy-mik instansimik tunniussivoq.

Item-elementit pillugit pisut:

Nassuiaat
gridzyItemBeforeInitNioqqutissat inissinneqarnissaat sioqqullugu ikuallaasartoq.
gridzyItemInitNioqqutissap inissinneqarnerata kingorna ikuallattoqarpoq.
gridzyItemLoadingNioqqutissaq ikkunneqalerpat ikuallattarpoq.
gridzyItemReadyNioqqutissaq grid-imik naatsorsuinermut piareersimappat ikuallattarpoq. Taamaattumik aspektratio ilisimaneqarpoq, kisianni assi suli ilanngunneqarsinnaavoq.
gridzyItemCompleteItem-imi assi tamakkerlugu ikkussorneqarpat ikuallattarpoq.
Uani pisussat ilaat misigisimagukkit, tapersersuinermik qinnuteqaat nassiuk .

event.target element-element-i ataaseq neqeroorutigisarpaa.
event.detail.instance Gridzy-mik instansimik tunniussivoq.

API – Nunarsuaq tamakkerlugu

Gridzy-p instansiinit namminersortunik funktioninik ilaatigut peqarpoq. Taamaattumik siusinnerusukkut instansimik pissarsinissaq pisariaqanngilaq.

Standard-imik toqqagassaq pissarsiariuk

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

Pissarsiariuk Tamaasa Standard-imik toqqagassat

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

Set Standard-imik toqqagassat

Tamanna Gridzy-mik instansit tamarmik aallartisarneqareersut toqqagassaannik inissitsissanngilaq, kisiannili instansit nutaat tunngavigalugit aalajangersaavoq. Kisiannili instansimik pioreersumik toqqagassaq pingaarnertut null aqqutigalugu nutarterneqassappat, taanna pingaarnertut pingaarnertut atortussaavoq.

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

Tamanna atorsinnaavat nunarsuaq tamakkerlugu toqqagassat inissinniarlugit, DOM piareersimannginnerani sianerfigigukku. Taamaattumik optionsit attributitut inissinneqarnissaat pisariaqartinngilat.

Automatismet

Gridzy.js 2-mi automatismit tamarmik atuuffeqarpata, periutsit ataaniittut pisariaqanngilaq. Kisianni automatismit qaminneqarsinnaapput Gridzy atorlugu traditionellermik:

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

Periarfissat ilaat data-gridzy- attributit aqqutigalugit imaluunniit setOptions() aqqutigalugu inissinneqarsinnaanngillat, logiskimik pissuteqarluni:

StandardværdiNassuiaat
autoInitOnDomReadytrueQuppernerup ikkussorneqarnerani klassimik gridzy mik elementit nassaarisarpai aammalu inissitsitertarlugit.

Gridzy.setDefaultOptions()
autoInitOnDomMutation
MutationTakunnittartoq
trueElementit nutaat klasse gridzy mik DOM-imi takussaalerpata nassaarisarpai aammalu inissititertarlugit. (assersuutigalugu quppernermik nuutsitsinerit atorlugit)

Gridzy.setDefaultOptions()
autoSyncChildListMutation
MutationTakunnittartoq
trueMeeqqat elementit (assit) ilanngunneqarnerat imaluunniit peerneqarnerat paasiniartarpai, aammalu grid-i nammineerluni nutartertarlugu.

data-grizy- aqqutigalugu inissinneqarsinnaavoq, new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
useOptionAttributestruedata-gridzy- attributit nalinginnaasumik atorneqartarnersut atorneqartannginnersulluunniit aalajangersarpai. Tamanna false toqqagassat aatsaat piginnittumik API aqqutigalugu inissinneqarsinnaapput.

Atorneqarsinnaavoq new Gridzy() , setOptions() , Gridzy.setDefaultOptions() aqqutigalugit.
autoSyncAttributesMutation
MutationTakunnittartoq
truedata-gridzy- attributit allanngornerat maluginiartarpaa, aammalu grid-i nammineerluni nutartertarlugu. Aammattaaq paasiniartarpaa gridzyAnimated klassi ilanngunneqarsimanersoq imaluunniit peerneqarsimanersoq aammalu style attribut-imik allanngortitsisoqarsimanersoq. useOptionAttributes false , taava style attribut-ip allanngornera kisimi paasiniartarpaa.

data-grizy- aqqutigalugu inissinneqarsinnaavoq, new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncChildClassMutation
MutationTakunnittartoq
trueMeeqqat elementit tamarmik class attributit allanngornerat paasiniartarpaa (assit). Filternut tunngatillugu attuumassuteqartoq.

data-grizy- aqqutigalugu inissinneqarsinnaavoq, new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncImageMutation
MutationTakunnittartoq

2.5.0-miit
trueAssit tamarmik src -attributit allanngornerat paasiniartarpaa. React-imik imaluunniit atuakkiorfinnik nalinginnaasunik atorneqartillugu attuumassuteqarpoq.

data-grizy- aqqutigalugu inissinneqarsinnaavoq, new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoRenderOnResize
Annertussuseq allanngortiguk

2.6.0-miit
trueElementip annertussusaata allanngornera maluginiartarpaa. Akissuteqarsinnaasumik ilusilersuinermut tunngatillugu attuumassuteqartoq. (Version 2.6.0 sioqqullugu igalaap annertussusaanik allanngortitsinermik tusarnaartartoq atorneqarpoq)

data-grizy- aqqutigalugu inissinneqarsinnaavoq, new Gridzy() , setOptions() , Gridzy.setDefaultOptions()

Aallartitsineq Manuelt

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

Instansimik aserorterineq

Nalinginnaasumik oqaatigineqartoq, Gridzy-mik inissitsiternerup akerleriissumik.

gridzyInstance.destroy();
gridzyInstance = null;

Meeqqat allattorsimaffiat manuelt synkroniseriuk

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

Synkronisering ataatsimik meeqqamik elementimik manuelt

Nalinginnaasumik pisariaqartinneqanngilaq, qaqutigoortorujussuarni allani.

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

Synkronisering Attributer Manuelt

Maluginiaruk useOptionAttributes toqqagassaq tamatumunnga true .

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

Force-mik suliaqarneq

Nalinginnaasumik pisariaqanngilaq, automatismit tamarmik qaminneqarsimagaluartut

gridzyInstance.render();