Musyobo 2.x


Kubelesya Ntalisyo

Kobikka ma fayela aa Gridzy ku seva yako mpawo uwabike awebbusayiti yako (kanjikanji muchibeela chamutwe):

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

Bikka kkodi ya HTML (kufwumbwa muchibeela chamubili):

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

Mbombubo! Eechi nchikozyano chibeleka loko. Kunyina kutalisya kumbi kuyandika.

Kubamba

Nzila nguba yakubamba Gridzy, nkubelesya buyo bube bwa HTML. Weelede buyo kubikka data-gridzy- kunembo lyamazina aakusala. Aboobo, kuti ubikke busena spaceBetween , bikka biyo kaambo kakuti 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>

Nzila Zipati

Muulo uubikkidweBupanduluzi
animatetrueZilasala kuti naa zifwanikiso zyeelede kubelesegwa aawo gridi niyakachincha (mbuli, aawo kuchincha bupati bwawindo lya browser naakuti aawo notubikka filter).
layoutjustifiedKupandulula nzila yakubelesya. Gridzy.js 2 ilagwasyilizya nzila zyobile zyaandeene justified a waterfall . Chimwi achimwi chazyo chili azintu zyakwe zyakuyungizya, eezyo nzyokonzya kujana munsi aatebulu eeli.
filter*Usala kuti zifwanikiso nzi zyeelede kutondezyegwa. kufumbwa CSS-selector ilakonzya kubelesegwa mbuli mpindu aawa. Chiindi chiingi chibikkwa alikke kwiinda mukubelesya filterControls (langa nzila itobela).
Langa Zisefa
filterControlsKusala kuti nzintu nzi zikonzya kubelesegwa kusefa zifwanikiso. Kusala kuli koonse kwa CSS, ooko kusala zibeela zya HTML, kulakonzya kubelesegwa mbuli mpindu aawa.
Langa Zisefa
autoConsiderScrollBarstrueKuyeyela bupati buliwo ikuti naa ma scroll bars alibonya naa kuzimaana. Lyoonse nkubotu kuti uchileke kachili true kunze kwakuti eechi chintu chilikke chaleta mapenzi.

Justified Nzila zyakusala

Muulo uubikkidweBupanduluzi
autoFontSizefalseChilachincha bupati bwamabala aabbokesi lyomwe lyomwe kweendelanya abwaanda bwabbokesi lyakusaanguna. Mbuli mbukweelede, bupati bwamabala tabubikkidwe antangalala pe.
desiredHeight190Kupandulula bulamfu buyanda bwamilongo yazintu. Bulamfu bwini buyoobalilwa kweendelanya abwaamba buliko azintu zili mumulongo.
hideOnMissingImagetrueKusisa mabbokesi ajisi zifwanikiso zitakonzyi kubikwa.
spaceBetween4Kupandulula musinzo akati kazintu muma pixels.
lastRowAlign
kuzwa mubbuku lya 2.3.0
justifiedZipandulula kuchita kwamulongo wamamanino. Izyeelelo zizumizyidwe zili left , center , right antoomwe a justified .
singleRowAlign
kuzwa mubbuku lya 2.3.0
justifiedZipandulula kuchita kuti kakuli buyo mulongo omwe. Izyeelelo zizumizyidwe zili left , center , right antoomwe a justified .
fillLastRow
kuzwa mubbuku lya 2.1.0
trueKUZWA kuzwa muchibaka 2.4.0 (KAKAZWA kuzwa mubbuku lya 2.3.0 )
Ubamba zifwanikiso kuchitila kuti mulongo wamamanino kauzwide. Kuti koyanda kuyungizya zifwanikiso kakunyina kuchincha, inga kachili chintu chibotu kuti uchileke eechi.
Tachikwe nchochichita kumilongo yomwe (Langa fillSingleRow ).
fillSingleRow
kuzwa mubbuku lya 2.1.0
trueKUZWA kuzwa muchibaka 2.4.0 (KAKAZWA kuzwa mubbuku lya 2.3.0 )
Kuti kakuli buyo mulongo omwe, ulabamba zifwanikiso kuchitila kuti mulongo kauzwide. Kuti kachili chikonzya kuchitika kuti ube achifanikisyo chomwe naa zyobile mubbokesi lyazifwanikiso, inga caba chintu chibotu kuti uzileke.

Waterfall Nzila zyakusala

Muulo uubikkidweBupanduluzi
autoFontSizefalseChilachincha bupati bwamabala aabbokesi lyomwe lyomwe kweendelanya abwaanda bwabbokesi lyakusaanguna. Mbuli mbukweelede, bupati bwamabala tabubikkidwe antangalala pe.
desiredWidth250Kupandulula bupati bwamilongo njoyanda. Bulamfu bwini buyoobalilwa kweendelanya abwaamba buliko amweelwe wamilongo.
hideOnMissingImagetrueKusisa mabbokesi ajisi zifwanikiso zitakonzyi kubikwa.
horizontalOrderfalseKupandulula kuti zintu zibikkidwe buyo chintu chomwe mumulongo umwi awumwi kuzwa kulumwensyi kuya kululyo, mpawo kutalika alimwi mumulongo wakulumwensyi kapati kakutalangwi kuti mulongo nzi uujisi busena bupati. Mbubwenya mbuli mbozibede zintu ziyoobikkwa mumulongo uulaa bulamfu buniini.
spaceBetween4Kupandulula musinzo akati kazintu muma pixels.
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.

Zimwi Zisumpukide

Kuti ujane zimwi nzila zisumpukide, langa API .

HTML ya Semantic

Bupange bwa HTML buubauba bwa Gridzy mbuboobu:

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

Nokuba boobo, Gridzy ilakonzya kuchincha loko mpawo ulakonzya kubelesya kufumbwa nzila ya HTML. Kuli buyo twaambo tusyoonto twakulanga-langa:

  • Mwana umwi awumwi wachintu chili mukati wiiminina chintu chomwe mumulongo.
  • Zyoonse zyobile, chibikkilo antoomwe abana bacho balakonzya kuba musyobo uuli woonse wa tag, mbuli ul a li (koyeeya biyo kujokezya zyintu zyakachitika mubrowser).
  • Ikuti naa cibeela img tacili mwana wini, ciyandika cibeela ca gridzyImage .

Aboobo eeyi ninzila ibeleka ya HTML:

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

Ikapati kuti koyanda kuyungizya mabala, weelede kuba abubambe bwa HTML busumpukide. Kuti uyiiye zyiingi aatala anzizyo, langa aa Captions & Skins .

Malembe amutwe wamakani azikumba

Kuti koyanda kuyungizya mabala aalembedwe mubbuku lyako lyazifwanikiso, weelede kupandulula mboliboneka. Aboobo, zimwi zikumba zyakabambilwa kale zilajanika. Chikumba chimwi achimwi chili a fayela lya CSS. Weelede kuyungizya fayela eeli mukuyungizya kuma fayela mapati aa Gridzy (kanjikanji muchibeela chamutwe):

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

Kuya kunembo uyandika bupange bwa HTML busumpukide:

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

Kuti koli mukubuzya aatala abupange bwa HTML, langa Semantic HTML .

Aawo mutwe wamakani ulakonzya kubelesya kufumbwa musyobo wa tag, kosinizya kuti ilijisi chiiyo cha gridzyCaption . Cibeela img chiyanda chiiyo cha gridzyImage .

Chikozyano chili atala aawa chikutondezya chikumba gridzySkinClassic . Kuti ubelesye limbi, kobikka buyo zina lyachikkumba limwi akati kazeezi:

Zikumba zibikkilizyidwe

Makkilasi aaliwo
gridzySkinBlank
ntalisyo mbotu yakupanga chikumba chako
kulangisisya kumonya mulomo
gridzySkinBlank
gridzySkinClassic
kulangisisya kumonya mulomo
gridzySkinClassic
gridzySkinClassicLight(KAKAZWA kuzwa mubbuku lya 2.6.0)
gridzySkinFullOverlay
kulangisisya kumonya mulomo
gridzySkinFullOverlay
gridzySkinFullOverlayLight(KAKAZWA kuzwa mubbuku lya 2.6.0)
gridzySkinLift
kulangisisya kumonya mulomo
gridzySkinLift
gridzySkinLiftLight(KAKAZWA kuzwa mubbuku lya 2.6.0)
gridzySkinMagnifier
mulimo wakuyungizya taubikkilizyidwe pe
kulangisisya kumonya mulomo
gridzySkinMagnifier
gridzySkinMagnifierLight(KAKAZWA kuzwa mubbuku lya 2.6.0)

Zyoonse zikumba zili atala aawa ziyandika buyo fayela lya CSS, pesi kuli zikumba zimbi ziyandika fayela lya JavaScript:

<link rel="stylesheet" href="gridzy/skins/gridzySkinBlur/style.min.css" />
<script src="gridzy/skins/gridzySkinBlur/script.min.js"></script>
Makkilasi aaliwo
gridzySkinBlur
tachibeleki mu IE
kulangisisya kumonya mulomo
gridzySkinBlur
gridzySkinBlurLight(KAKAZWA kuzwa mubbuku lya 2.6.0)
gridzySkinCard
kulangisisya kumonya mulomo
gridzySkinCard
gridzySkinCardLight(KAKAZWA kuzwa mubbuku lya 2.6.0)

Nzila zyakusala chikumba

Kuzwa mumusyobo wa 2.6.0 kuli nzila zyakubamba zikumba zyakayakwa mukati. Kweelana achikumba chilichose ulakonzya kubikka mubala wakusyule, mubala wamalembe amweenzule wamalembe. Weelede buyo kubelesya zintu zya CSS mbuli mbokonzya kubona aawa:

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

Langa zintu zigwasyilizyigwa azyeelelo zyachikumba chimwi achimwi aawa:

gridzySkinClassic
KuchinchaMuulo uubikkidweMajwi
--backgroundrgba(0, 0, 0, .7)ilazumizya kufumbwa mpindu ya CSS
--colorrgb(255, 255, 255)ilazumizya kufumbwa mubala wa CSS
--text-shadownoneilazumizya kufumbwa CSS text-shadow value
gridzySkinFullOverlay
KuchinchaMuulo uubikkidweMajwi
--backgroundrgba(0, 0, 0, .7)ilazumizya kufumbwa mpindu ya CSS
--colorrgb(255, 255, 255)ilazumizya kufumbwa mubala wa CSS
--text-shadownoneilazumizya kufumbwa CSS text-shadow value
gridzySkinLift
KuchinchaMuulo uubikkidweMajwi
--backgroundrgba(0, 0, 0, .7)ilazumizya kufumbwa mpindu ya CSS
--colorrgb(255, 255, 255)ilazumizya kufumbwa mubala wa CSS
--text-shadow0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0)ilazumizya kufumbwa CSS text-shadow value
gridzySkinMagnifier
KuchinchaMuulo uubikkidweMajwi
--backgroundrgba(0, 0, 0, .7)ilazumizya kufumbwa mpindu ya CSS
--colorrgb(255, 255, 255)ilazumizya kufumbwa mubala wa CSS

Chikumba eechi tachigwasyilizyi --text-shadow

gridzySkinBlur
KuchinchaMuulo uubikkidweMajwi
--backgroundrgba(0, 0, 0, .7)ilazumizya kufumbwa mpindu ya CSS
--colorrgb(255, 255, 255)ilazumizya kufumbwa mubala wa CSS
--text-shadow0 0 10px rgb(0, 0, 0)ilazumizya kufumbwa CSS text-shadow value
gridzySkinCard
KuchinchaMuulo uubikkidweMajwi
--backgroundrgba(0, 0, 0, 1)ilazumizya kufumbwa mpindu ya CSS
--colorrgb(255, 255, 255)ilazumizya kufumbwa mubala wa CSS
--text-shadownoneilazumizya kufumbwa CSS text-shadow value

Zikumba zyoonse zyakabambilwa kale zigwasyilizya buyo malembe maubauba. Ulakonzya kupanga zikumba zyako omwini alimwi zikatazya kumvwisisisya. Kolanga a Style Gridzy .

Chiimo cha Gridzy

Kuti kakunyina chikumba chibikkidwe kale chikonzya kweendelana azintu nzyoyanda, ulakonzya kulibamba omwini.

Nzila nguba njakusaanguna kukkopa chikumba chiliwo mpawo uchichinche kuti chikonzye kweendelana azintu nzyoyanda. Chikumba chakabikkwa kale gridzySkinBlank kanjikanji chilakonzya kupa ntalisyo mbotu antoomwe amalembe mabotu mufailo lya CSS:

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

Mufailo lya CSS ulajana makkilasi aa gridzySkinBlank , gridzyImage antoomwe a gridzyCaption . Gridzy lwakwe mwini tayandi makkilasi aaya. Zibelesegwa biyo mukubamba zintu aboobo ulakonzya kuzigwisya naakuti kuzipa zina limbi kuti koyanda.

Kuyungizya waawo ulajana chiiyo cha CSS gridzyItem . Gridzy ilabikka chiiyo eechi kubana boonse bazwa kuchintu chipati. Aboobo, ulakonzya kubelesya chiiyo eechi kubamba zintu zili muchibaka chako.

Mizeezo Zintu Ziyandikana

  1. Zili mukati kachintu zyeelede kuti kazili kabotu. Yeeya kuti bupati bwachintu buyoochincha. Belesya mweelwe wamapesenti muciindi chamweelwe wama pixel. Mpawo langa aGridzy layout option autoFontSize , eeyo iiswaanganya bupati bwamabala kubupati bwabbokesi lyachintu.
  2. Chintu chimwi achimwi cheelede kuba achiimo chili kabotu. Bupati bwachintu tabukonzyi kuchincha pe mpawo bulayandika kuti kube kubala kwa gridi. aboobo kuti chintu kachitakwe bbazu lisalazyidwe kabotu, kochisalazya omwini (nkokuti kwiinda mu css).

Chimwi chiindi, chilakonzya kuuba kubamba zili mukati kazintu Gridzy katanatalika. Gwisya biyo chiiyo cha gridzy naakuti fayela lya javascript lya Gridzy kwakaindi kaniini.

Mbombubo! Nzizyo zyoonse nzyoyelede kuchita kuti uyake chikumba chako. Bunji bwazikumba zyakabambilwa kale tazibelesyi zinji kwiinda eezi.

Asi inga kwaba zyiingi kuti koyanda...

Zikumba Zisumpukide

Gridzy ibelesya makkilasi manji aa CSS kwiinda buyo gridzyItem . Bunji bwazyo ziyoobikkwa zyokwazyo mpawo ulakonzya kuzibelesya mukubamba.

Makkilasi Mapati

Izina lyachiiyoBupanduluzi
gridzy
kubikka amaanza
Gridzy ulajana zintu zili muchiiyo eechi mpawo ulazitalisya.
gridzyAnimatedZiyoobikkwa zilikke ikuti naa nzila ya animate ili true . Kuti chiiyo eechi chabikkwa amaanza, nzila ya animate ilakonzya kuba true (kunze kwakuti yabikkwa kuti false ).

Makkilasi aazintu

Izina lyachiiyoBupanduluzi
gridzyItemZiyoobikkwa mpawo chintu nichitalika biyo nzila yakutalisya. Tachikonzyi kugwisigwa pe.
gridzyItemInitializingZiyoobikkwa mpawo chintu nichitalika biyo nzila yakutalisya. Ziyoonjililwa busena a gridzyItemReady mpawo chintu nichatalisyigwa. Tazyambi kuti zifwanikiso zilizwide (langa gridzyItemLoading ), pesi chintu chilibambilide kulibonya.
gridzyItemReadyUyoonjila mubusena bwa gridzyItemInitializing mbuli chintu nichatalisyigwa biyo. Tachikonzyi kugwisigwa pe. Tazyambi kuti zifwanikiso zilizwide (langa gridzyItemComplete ), pesi chintu chilibambilide kulibonya.
gridzyItemLoadingZiyoobikkwa mpawo chintu nichitalika biyo nzila yakutalisya. Ziyoonjililwa busena a gridzyItemComplete mpawo zifwanikiso zili mukati (kanjikanji zyomwe luzutu) zyazula.
gridzyItemCompleteUyoonjila mubusena bwa gridzyItemLoading mpawo zifwanikiso zili mukati (kanjikanji zyomwe luzutu) zyazula. Tachikonzyi kugwisigwa pe.
gridzyItemInitialToVisibleZiyoobikkwa biyo chintu nichitalika kulibonya chiindi chakusanguna. Chiyoogwisigwa mpawo chintu nichilibonya biyo.
gridzyItemVisibleZiyoobikkwa mpawo chintu nichilibonya biyo. Ziyoogwisigwa mpawo chintu nichitalika kuzimaana.
gridzyItemVisibleToHiddenZiyoobikkwa mpawo chintu nichitalika kuzimaana. Ziyoogwisigwa mpawo chintu nichisisidwe.
gridzyItemHiddenZiyoobikkwa mpawo biyo chintu nichisisidwe. Chiyoogwisigwa mpawo chintu nichitalika kulibonya.
gridzyItemHiddenToVisibleZiyoobikkwa mpawo chintu nichitalika kulibonya (kunze lyakuboneka chiindi chakusanguna – langa chiiyo cha gridzyItemInitialToVisible ). Chiyoogwisigwa mpawo chintu nichilibonya biyo.
gridzyItemVisibleToVisibleZiyoobikkwa mpawo biyo chimwi chintu muchikozyano nichisanduka, pesi eecho chintu chakali mpawo chizumanana kulibonya. Ziyoogwisigwa mpawo biyo kusanduka kwamana.

Mbuli mbukweelede, chitondeezyo chakuchita zintu antoomwe azifwanikiso zilibonya anzyozimana zyakabambwa kale aGridzy main CSS file.

Aaya makkilasi aa CSS aambwa atala aawa ulakonzya kulibambila nzila yako yakuchita zintu azifwanikiso zipona. Kolanga mu Gridzy main CSS file, kuti umvwisisisye nchoyelede kuchincha. Utayoowi pe, zyoonse zililembedwe kabotu aawo.

Kubamba kabotu

Kuti kobelesya zifwanikiso zyiingi, inga waba muzeezo mubotu kugwasya Gridzy kuyaka nzila yakufwambaana.

Kokasya zifwanikiso zitazungaani

Gridzy uyandika ncobeni mweelwe wazifwanikiso zyoonse kuti abale gridi. Twaambo ootu tupa kuti zimwi zifwanikiso kazilibambilide mpawo zimwi tazilibambilide pe. Ikuti naa kuli zifwanikiso zinji, nkokuti eeci cilakonzya kunyemya kapati.

Kuchitila kutabilila eechi chintu, bikka buyo width height bwazibeela zyoonse img . Nchintu chipati kubikka zyeelelo ziluzi zyachifanikisyo chimwi achimwi, ikuti tiikwaba boobo zifwanikiso zilakonzya kunyongana. Impindu ziluzi mbubwamba bwakusaanguna abulamfu bwechifanikisyo:

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

Kuzwa waawo Gridzy ulakonzya kubala gridi mpawo-mpawo kakunyina kuziba bupati bwazifwanikiso.

Kubbila kwakubula nguzu

Kuti ubweze buyo zifwanikiso zili mubusena bwakulanga, tobela buyo ntaamu eezyi:

  1. Bika bupati width height mbuli mbokwaambidwe atala aawa (bona kuti wabelesya zyeelelo ziluzi)
  2. Bikka zyoonse src a data-gridzylazysrc mbuli mbokutondezyedwe munsi (ikuti koli a srcset , bikka data-gridzylazysrcset ).
<div class="gridzy">
  <img data-gridzylazysrc="https://loremflickr.com/640/480?random=1" width="640" height="480" alt="a random image" />
  <img data-gridzylazysrc="https://loremflickr.com/480/640?random=2" width="480" height="640" alt="another random image" />
  <img data-gridzylazysrc="https://loremflickr.com/640/640?random=3" width="640" height="640" alt="yet another random image" />
  <img data-gridzylazysrc="https://loremflickr.com/640/480?random=4" width="640" height="480" alt="a random image again" />
  <img data-gridzylazysrc="https://loremflickr.com/640/480?random=5" width="640" height="480" alt="one last random image" />
</div>

Nikwakainda ntaamu eezyi zifwanikiso zilajaluka mbuli mbozisika afwaafwi naa mukati kachibaka chakubonena.

Chitondeezyo chaNchito

Chitondezyo chakuchita nchikozyano chiniini chiboneka aawo mufanikisyo noulikubikkwa. Kuti kobelesya malembe aamabala , chitondezyo chakuchita chiyootondezyegwa biyo. Kuti kakutali boobo weelede kuchincha:

  1. Bika chimwi achimwi chibeela img muchibeela cha div
    (naa muchintu chilichose – langa HTML ya semantic kuti ujane zyiingi)
  2. Bikka chiiyo cha gridzyImage kuli chimwi achimwi chintu img
<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>

Kuzwa waawo weelede kubona zitondezyo zyakuchita kuti zifwanikiso zitola chiindi kuti zijanike.

Zisefa

Zisefa muGridzy nziubauba pesi zilaanguzu. Nikuba kuti uyanda nsefa iili buti, zilalangilwa kuti zilakonzya kuchitwa. Nchoyanda biyo, CSS mbichaani antoomwe azintu zya HTML...

Aawa mpaali zikozyanyo zibeleka:

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

Atuchiyake ntaamu a ntaamu

1. Chakusanguna tuyanda bupange bwa HTML bwa Gridzy mpawo tubike mazina aamakkilasi aazintu zyoonse zyamu gallery kuchitila kuti tukonzye kuzisefa twamana

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

Muchikozyano eechi tubelesya buyo kilasi yomwe kuli chimwi achimwi chintu. Asi ulakonzya kubikka makkilasi miingi kuchintu chomwe, ikuti eecho chintu chikonzya kujanwa kwiinda mukubelesya zisefa zyiingi.

2. Mpawo twayungizya mabbatani amwi ngotukonzya kuchincha zisefa mpawo

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

Mucibaka chamabbatani, ulakonzya kubelesya zimwi zintu zilimbuli mabbokesi, mabbatani aa radio, zibeela zyakusala azimwi.

Mbuli mbomukonzya kubona, mpindu zyamabbatani nzizyo zisala zya CSS. Mbotwakamanizya biyo, kutyola bbatani liliboobu kuyootondezya zifwanikiso zyeendelana a CSS selector. Munzila yakuchita zintu, chibikka biyo nzila filter kuti ibe aamuulo ooyu.

Ulakonzya kubelesya zyakusala zikatazya kumvwisisisya. Mbuli chitondeezyo :not(.animals) inga babeleka abalo, mbuli .animals.people a .animals, .people .

3. Chamamanino, twabikka mabbatani muchibbeeke cha div mpawo twaaanga ku Gridzy gallery, kwiinda mukubikka nzila ya filterControls :

<div id="myFilterControls">
  <button value="*">All</button>
  <button value=".animals">Animals</button>
  <button value=".architecture">Architecture</button>
  <button value=".people">People</button>
</div>

<div class="gridzy" data-gridzy-filterControls="#myFilterControls button">
  <img class="animals" src="https://loremflickr.com/640/480/animals?random=1" alt="a random animal image" />
  <img class="architecture" src="https://loremflickr.com/640/480/arch?random=1" alt="a random architecture image" />
  <img class="people" src="https://loremflickr.com/640/480/people?random=1" alt="a random people image" />
  <img class="animals" src="https://loremflickr.com/640/480/animals?random=2" alt="another random animal image" />
  <img class="architecture" src="https://loremflickr.com/640/480/arch?random=2" alt="another random architecture image" />
  <img class="people" src="https://loremflickr.com/640/480/people?random=2" alt="another random people image" />
  <img class="animals" src="https://loremflickr.com/640/480/animals?random=3" alt="yet another random animal image" />
</div>

Mbuli mbomukonzya kubona, tulabelesya CSS selector ku filterControls option. Ciyobwedo ca div cijisi bube id cibeleka buyo kupa kuti mabbatani kaauba-uba kusala kwiinda mukubelesya CSS selector eeyo.

Mbombubo!

Kuti koyanda nzila ya JavaScript, langa API .

API

Nikuba kuti Gridzy ilijisi API yayo, zintu zyiingi zilakonzya kuchitwa kakwiina, kwiinda mukubelesya buyo DOM. Gridzy ulabona mpawo ulabambulula nzila. Pesi kuli API iilaanguzu loko...

Kubelesya DOM

Kuzintu zyoonse zya Document Object Model (DOM) tusaanguna kuyandika chintu chakubikkila:

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

Koyungizya zifwanikiso

Nchintu chipati kuyaka akuzuzya chintu chipya chamwana kotaninga chibikka kuchintu chakubikkila. Kuti kakutali boobo Gridzy takonzyi kubona bupati buli kabotu.

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

Gwisya zifwanikiso

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

Sandula nzila

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

Zyiingi aatala akweendelezya DOM ulakonzya kujana a MDN web docs . Alimwi kuli Ntalisyo ya DOM iiliwo.

API yabuleya

Kuti tubelesye API, tusaanguna kuyandika Gridzy instance, eeyo iijatikizyidwe ku Gridzy container element:

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

jana nzila

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

jana nzila zyoonse

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

Bikka zyakusala

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

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

Bikka Sefa

Kubelesya nsefa nkubikka buyo filter yakusala iikonzya kuba kufumbwa CSS selector iili kabotu:

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

Bikka milimu yakujokezya

KAKANYIKWA kuzwa mubbuku lya 2.4.0
Belesya zintu zyamazubaano alimwi zikonzya kuchincha. Langa chibeela chiza kuti ujane makani woonse.

Gridzy.js 2 ilagwasyilizya zimwi nzila zyakufoona. Zilakonzya kubikkwa biyo kwiinda mukubelesya API, pesi mbweenya mbuli zimwi nzila:

// 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.
  }
});
Bupanduluzi
onBeforeOptionsChangedMulimo wakujokezya uubelesyegwa kakutanabikkwa nzila zyakusala.
onOptionsChangedMulimo wakujokezya uuchitwa mpawo-mpawo musule aakubikka nzila zyakusala.
onBeforeRenderMulimo wakujokezya uubelesyegwa kakutanaba kuchitwa.
onRenderMulimo wakujokezya uubelesyegwa mpawo-mpawo musule aakusanduka.

Belesya Zichitika

kuzwa mubbuku lya 2.4.0

Ulakonzya kubelesya zintu zya Gridzy mbweenya mbuli zintu zya JavaScript:

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

Zimwi zintu zichitwa aGridzy container element mpawo zimwi zichitwa aacontainer element.

Zintu zyakachitika a Gridzy container element:

Bupanduluzi
gridzyBeforeInitImulilo kakutanatalika ŋanda yakutondezya zintu.
gridzyInitIyaka mulilo musule lyakutalisya ŋanda yakutondezya zintu.
gridzyBeforeOptionsChangedIyaka mulilo katana bikka zyakusala.
gridzyOptionsChangedKupya nikwakamana kubikka zyakusala.
gridzyBeforeRenderMulilo katana tondezya.
gridzyRenderMulilo musule lyakusanduka.
Kuti naa wasweekelwa zintu zili zyoonse aawa, twalomba kuti utume lugwalo lwakulomba lugwasyo .

event.target ilapa chintu cha Gridzy.
event.detail.instance ipa Gridzy instance.

Zintu zyakachitika kuzintu:

Bupanduluzi
gridzyItemBeforeInitIyaka mulilo kakutanatalika chintu.
gridzyItemInitIyaka mulilo musule lyakutalisya chintu.
gridzyItemLoadingIlapya aawo chintu nichitalika kujanika.
gridzyItemReadyIlapya aawo chintu nichilibambilide kubalwa. Aboobo mweelwe wazyintu ulizibinkene, asi mufanikisyo ulakonzya kachili mukujalwa.
gridzyItemCompleteIlapya aawo mufanikisyo wachintu nuuzwide.
Kuti naa wasweekelwa zintu zili zyoonse aawa, twalomba kuti utume lugwalo lwakulomba lugwasyo .

event.target ilapa chintu eecho.
event.detail.instance ipa Gridzy instance.

API – Nyika yoonse

Kuli milimo imwi iitakweendelani a Gridzy instances. Aboobo tatuyandiki kujana chikozyano chiindi.

jana nzila iitabikkidwe

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

Amujane Zyoonse Zyakusaanguna

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

Bika nzila zyakusala

Eezi tazibikki nzila zyakusala zya Gridzy zyoonse zyakatalisyigwa kale, pesi zipandulula ntalisyo yazibeela zipya. Nokuba boobo, ikuti naa kusala kwachintu chiliwo kale kwabikkwa lubo kwiinda mukubelesya mweelwe null , inga kwabelesya mweelwe mupya.

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

Ulakonzya kubelesya eechi kubikka nzila zyakusala munyika yoonse, kuti wayiita kakutanaba DOM. Aboobo toyelede kubikka zintu mbuli zitondezyo limbi.

Zintu zilikke

Kufumbwa buyo kuti zyoonse zyeendelezya zya Gridzy.js 2 kazibeleka, takuyandiki kubelesya nzila zili ansi aawa. Pesi zibelesyo zikonzya kuzima kuti zibelesyegwe Gridzy munzila yachiindi:

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

Zimwi zyazyeezyi nzila tazikonzyi kubikkwa kwiinda mukubelesya data-gridzy- attributes naa kwiinda mukubelesya setOptions() , nkaambo katwaambo tumvwika:

Muulo uubikkidweBupanduluzi
autoInitOnDomReadytrueUlabona zintu zili a kilasi gridzy aawo mapeeji naatalika kubelesegwa mpawo ulazitalisya.

Zilakonzya kubikkwa kwiinda mu Gridzy.setDefaultOptions()
autoInitOnDomMutation
MutationObserver
trueUlabona zintu zipya a class gridzy mbuli mboziboneka mu DOM mpawo ulazitalisya. (nkokuti kubelesya mapeeji aakucinca)

Zilakonzya kubikkwa kwiinda mu Gridzy.setDefaultOptions()
autoSyncChildListMutation
MutationObserver
trueIlabona naa zintu zyabana (zifwanikiso) zyayungizyigwa naa kugwisigwa, mpawo zilabambulula bbazu lyamagesi.

Zilakonzya kubikkwa kwiinda mu data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
useOptionAttributestrueChipandulula kuti naa data-gridzy- ilabelesyegwa naa pe. Kuti eezi nzyakubeja false zyakusala zilakonzya kubikkwa biyo kwiinda mukubelesya API.

Zilakonzya kubikkwa kwiinda mukubelesya new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncAttributesMutation
MutationObserver
trueUlabona kucinca kwabube bwa data-gridzy- , mpawo ulabambulula grid alikke. Alimwi ulabona kuti naa bbazu lya gridzyAnimated lyayungizyigwa naa kugwisigwa alimwi akuti naa kwacinca bube style . Kuti useOptionAttributes kauli false , ulajana buyo kuchincha style .

Zilakonzya kubikkwa kwiinda mu data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncChildClassMutation
MutationObserver
trueUlabona kuchincha kwazibeela class chazibeela zyoonse zyabana (zifwanikiso). Zyelede kujatikizya zisefa.

Zilakonzya kubikkwa kwiinda mu data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncImageMutation
MutationObserver

kuzwa kumusyobo wa 2.5.0
trueIlabona kuchincha kwabube bwa src bwazifwanikiso zyoonse. Zilagwasya aawo nozibelesyegwa a React naakuti malaibbulali aakozyenye.

Zilakonzya kubikkwa kwiinda mu data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoRenderOnResize
Kuchincha bupati bwaSikulangisisya

kuzwa mubbuku lya 2.6.0
trueUlabona kuchincha kwabwamba bwachintu. Zyelede kujatikizya kubamba kabotu. (Kakutanaba musyobo wa 2.6.0 kwakali kubelesegwa siswiilizi wakucinca bupati bwawindo)

Zilakonzya kubikkwa kwiinda mu data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()

Talisya amaanza

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

Nyonyoona Chikozyano

Mukwaamba biyo, nchintu chiimpene akutalisya Gridzy.

gridzyInstance.destroy();
gridzyInstance = null;

Kweendelana Mulongo Wabana Amaanza

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

Kweendelana amwana omwe amaanza

Kanjikanji taziyandiki pe, kunze lyaziindi zitavwuli pe.

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

Kweendelana aBube Amaanza

Kozyiba kuti useOptionAttributes yeelede kuba true kuli eci.

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

Kusinikizya

Kanjikanji taziyandiki pe, nikuba kuti zyoonse zyeenzyo zyazima

gridzyInstance.render();