Vérsi 2.x


Kawigunan Dasar

Unggahang berkas Gridzy ka server Sametoné lan tambahang ring situs wéb Sametoné (ketahnyané ring bagian sirah):

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

Wewehin kode HTML (ring dija ja ring bagian awak):

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

Inggih wantah asapunika! Punika conto sane jangkep fungsinyane. Nénten perlu inisialisasi ekstra.

Konfigurasi

Cara sane pinih dangan antuk ngatur Gridzy inggih punika, mangda wantah nganggen atribut HTML. Sameton wantah perlu ngawitin wastan opsi antuk data-gridzy- . Dadosnyané, anggén ngatur opsi spaceBetween , tambahin manten atribut data-gridzy-spaceBetween .

<div class="gridzy" data-gridzy-spaceBetween="20" data-gridzy-desiredHeight="400">
  <img src="https://loremflickr.com/640/480?random=1" alt="a random image" />
  <img src="https://loremflickr.com/480/640?random=2" alt="another random image" />
  <img src="https://loremflickr.com/640/640?random=3" alt="yet another random image" />
  <img src="https://loremflickr.com/640/480?random=4" alt="a random image again" />
  <img src="https://loremflickr.com/640/480?random=5" alt="one last random image" />
</div>

Pilihan Utama

Nilai BawaanPanjelasan
animatetrueNentuang napiké animasi patut kaanggén ritatkala grid mauwah (contonyané, ritatkala nguwah ukuran jendela panylahjah utawi ritatkala nyetél filter).
layoutjustifiedNentuang tata letak sané kaanggén. Gridzy.js 2 ngadukung kalih tata letak sane matiosan justified lan waterfall . Soang-soang punika madue parameter opsi tambahan soang-soang, sane prasida kapanggihin ring sor tabel puniki.
filter*Nentuang gambar sané patut kasinahang. Saluiring CSS-selector prasida kaanggen nilai iriki. Lumrahnyané kaatur otomatis saking filterControls (cingak opsi selanturnyané).
Cingakin Saringan
filterControlsNentuang elemen wangun napi sane prasida kaanggen nyaring gambar. Saluiring pemilih CSS, sane milih elemen wangun HTML, prasida kaanggen nilai iriki.
Cingakin Saringan
autoConsiderScrollBarstrueAnggén narka linggah sané wénten yéning bilah gulir medal utawi ical. Setata kasaratang mangda katinggalin ring true sajabaning otomatisme puniki ngawinang pikobet.

Justified Tata Letak

Nilai BawaanPanjelasan
autoFontSizefalseOtomatis ngapdet properti ukuran font ring soang-soang kotak manut ukuran kotak asli. Manut default, properti ukuran font nénten kaatur manut eksplisit.
desiredHeight190Nentuang tegeh baris elemen sane kaaptiang. Tegeh sane sujati pacang kaitung manut ring linggah sane wenten lan elemen ring baris.
hideOnMissingImagetrueNgidepang kotak sané madaging gambar sané nénten prasida kamuat.
spaceBetween4Nentuang jarak pantaraning elemen ring piksel.
lastRowAlign
ngawit saking versi 2.3.0
justifiedNentuang parilaksana ring baris sané kaping untat. Nilai sané kadadosang inggih punika left , center , right miwah justified .
singleRowAlign
ngawit saking versi 2.3.0
justifiedNentuang parilaksana yening wantah wenten asiki baris tunggal. Nilai sané kadadosang inggih punika left , center , right miwah justified .
fillLastRow
ngawit saking versi 2.1.0
trueKAICALANG saking versi 2.4.0 (SAMPUN KAANGGEN saking versi 2.3.0 )
Ngatur gambar mangda baris sane kaping untat setata jangkep kadagingin. Yéning Sameton ngarencanayang jagi nambahin gambar manut dinamis, becik yéning Sameton nénten ngaktifang gambar puniki.
Nénten mapangaruh ring baris tunggal (cingak fillSingleRow ).
fillSingleRow
ngawit saking versi 2.1.0
trueKAICALANG saking versi 2.4.0 (SAMPUN KAANGGEN saking versi 2.3.0 )
Yening wantah asiki baris, punika ngatur gambar-gambar punika mangda baris punika setata jangkep kadagingin. Yening prasida kejadian semeton wantah madue asiki utawi kalih gambar ring galeri, minab ide sane becik yening non-aktifkan puniki.

Waterfall Tata Letak

Nilai BawaanPanjelasan
autoFontSizefalseOtomatis ngapdet properti ukuran font ring soang-soang kotak manut ukuran kotak asli. Manut default, properti ukuran font nénten kaatur manut eksplisit.
desiredWidth250Nentuang linggah kolom sané kakayunin. Lebar sane sujati pacang kaitung manut ring lebar sane wenten lan akeh kolom.
hideOnMissingImagetrueNgidepang kotak sané madaging gambar sané nénten prasida kamuat.
horizontalOrderfalseNelatarang indik elemen-elemen punika kagenahang ketat siki elemen ring soang-soang kolom saking kiwa ka tengen, salanturnyane kakawitin malih ring kolom sane pinih kiwa independen ring dija kolom punika lebih genah. Manut default elemen-elemen punika pacang setata kagenahang ring kolom sane tegehnyane pinih alit.
spaceBetween4Nentuang jarak pantaraning elemen ring piksel.
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.

Pilihan Lanturan Sané Lianan

Anggén opsi sané sayan nglimbak, cingakin API .

HTML teges

Struktur HTML sane pinih sederana saking Gridzy inggih punika:

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

Nanging, Gridzy puniki fleksibel pisan lan semeton prasida nganggen struktur HTML sane lianan sane meh-mehan. Wantah makudang-kudang poin sane patut kauratiang:

  • Soang-soang anak saking elemen wadah punika ngangganin siki item ring grid.
  • Kakalih elemen wadah lan pianaknyane prasida jenis tag napi kemanten, sakadi ul lan li (wantah nimbangin antuk ngatur malih default browser).
  • Yéning elemen img nénten ja anak langsung, punika ngamerluang kelas gridzyImage .

Dadosnyane puniki taler struktur HTML sane makarya:

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

Napi malih yening jagi nambahin caption, semeton perlu struktur HTML sane canggih. Mangda uning malih indiké punika, cingakin ring Teks & Kulit .

Keterangan & Kulit

Yéning Sameton jagi ngawewehin keterangan ring galeri, Sameton patut nentuang penampilannyané. Punika mawinan, makudang-kudang kulit sane sampun katentuang sampun wenten. Soang-soang kulit sane kawangun antuk file CSS. Sameton patut ngawewehin berkas puniki tiosan ring berkas Gridzy utama (ketahnyane ring bagian sirah):

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

Selanturnyané Sameton merluang struktur HTML sané canggih:

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

Yening semeton wenten sane metaken indik struktur HTML, cingakin ring Semantic HTML .

Antuk keterangan Sameton dados nganggén soroh tag napi manten, pastiang manten madué kelas gridzyCaption . Elemen img punika ngamerluang kelas gridzyImage .

Conto ring ajeng nyihnayang semeton kulit gridzySkinClassic . Mangda nganggén sané tiosan, ganti manten wastan kulit antuk silih tunggil saking puniki:

Kulit sané ngranjing

Kelas sané katadongang
Kulit GridzyKosong
titik awal sane becik anggen ngaryanin kulit soang-soang
pratinjo langsung
gridzySkinBlank
gridzySkinClassic
pratinjo langsung
gridzySkinClassic
gridzySkinClassicLight(SAMPUN KAANGGEN saking versi 2.6.0)
gridzySkinFullOverlay
pratinjo langsung
gridzySkinFullOverlay
gridzySkinFullOverlayLight(SAMPUN KAANGGEN saking versi 2.6.0)
gridzySkinLift
pratinjo langsung
gridzySkinLift
gridzySkinLiftLight(SAMPUN KAANGGEN saking versi 2.6.0)
gridzySkinMagnifier
fungsi zoom nénten karanjingang
pratinjo langsung
gridzySkinMagnifier
gridzySkinMagnifierLight(SAMPUN KAANGGEN saking versi 2.6.0)

Makasami kulit ring ajeng wantah ngamerluang file CSS, nanging wenten kulit tambahan sane taler ngamerluang file JavaScript:

<link rel="stylesheet" href="gridzy/skins/gridzySkinBlur/style.min.css" />
<script src="gridzy/skins/gridzySkinBlur/script.min.js"></script>
Kelas sané katadongang
gridzySkinBlur
nénten mamargi ring IE
pratinjo langsung
gridzySkinBlur
gridzySkinBlurLight(SAMPUN KAANGGEN saking versi 2.6.0)
gridzySkinCard
pratinjo langsung
gridzySkinCard
gridzySkinCardLight(SAMPUN KAANGGEN saking versi 2.6.0)

Pilihan Kulit

Sasukat versi 2.6.0 wenten Opsi anggen ngonfigurasi kulit sane sampun kapasang. Manut ring kulit tertentu semeton prasida ngatur warna latar belakang, warna teks lan bayangan teks. Sameton wantah patut nganggén properti uwahan CSS sakadi sané prasida kacingak iriki:

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

Cingakin variabel sané kasokong lan nilai default anggén soang-soang kulit iriki:

gridzySkinClassic
VariabelNilai BawaanInpormasi
--backgroundrgba(0, 0, 0, .7)ngijinin nilai latar belakang CSS napi manten
--colorrgb(255, 255, 255)ngijinin nilai warna CSS napi manten
--text-shadownonengijinin nilai bayangan teks CSS napi manten
gridzySkinFullOverlay
VariabelNilai BawaanInpormasi
--backgroundrgba(0, 0, 0, .7)ngijinin nilai latar belakang CSS napi manten
--colorrgb(255, 255, 255)ngijinin nilai warna CSS napi manten
--text-shadownonengijinin nilai bayangan teks CSS napi manten
gridzySkinLift
VariabelNilai BawaanInpormasi
--backgroundrgba(0, 0, 0, .7)ngijinin nilai latar belakang CSS napi manten
--colorrgb(255, 255, 255)ngijinin nilai warna CSS napi manten
--text-shadow0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0)ngijinin nilai bayangan teks CSS napi manten
gridzySkinMagnifier
VariabelNilai BawaanInpormasi
--backgroundrgba(0, 0, 0, .7)ngijinin nilai latar belakang CSS napi manten
--colorrgb(255, 255, 255)ngijinin nilai warna CSS napi manten

Kulit puniki nénten nyokong --text-shadow

gridzySkinBlur
VariabelNilai BawaanInpormasi
--backgroundrgba(0, 0, 0, .7)ngijinin nilai latar belakang CSS napi manten
--colorrgb(255, 255, 255)ngijinin nilai warna CSS napi manten
--text-shadow0 0 10px rgb(0, 0, 0)ngijinin nilai bayangan teks CSS napi manten
gridzySkinCard
VariabelNilai BawaanInpormasi
--backgroundrgba(0, 0, 0, 1)ngijinin nilai latar belakang CSS napi manten
--colorrgb(255, 255, 255)ngijinin nilai warna CSS napi manten
--text-shadownonengijinin nilai bayangan teks CSS napi manten

Makasami kulit sané sampun katentuang wantah nyokong keterangan teks saderana. Sameton prasida ngaryanin kulit semetone sane pinih soang-soang lan lebih kompleks. Ngiring cingakin ring Gaya Gridzy .

Gaya Kisi

Yening nenten wenten kulit sane sampun katentuang sane cocok sareng kebutuhan ragane, ragane dados ngagayain ragane padidi.

Cara sane pinih dangan inggih punika kapertama nyalin kulit sane sampun wenten lan nganutin kebutuhan ragane padidi. Kulit gridzySkinBlank sane sampun katentuang biasane pacang ngicenin dasar sane becik taler dokumentasi sane becik ring file 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;
}

Ring berkas CSS Sameton pacang manggihin kelas gridzySkinBlank , gridzyImage lan gridzyCaption . Gridzy ngraga nenten perlu ring kelas-kelas punika. Ipun wantah kaanggen antuk gaya lan dadosnyane semeton prasida ngicalang utawi ngalih wastannyane yening semeton seneng.

Tiosan punika, Sameton pacang ngamolihang kelas CSS gridzyItem . Gridzy ngatur kelas puniki otomatis majeng ring makasami anak langsung saking elemen wadah utama. Dadosnyane, semeton dados nganggen kelas puniki anggen gaya barang-barang galeri semetone.

Pikayunan Sane Penting

  1. Daging barang punika mangda jangkep responsif. Anggapja yening ukuran elemen punika pastika pacang mauwah. Anggén nilai persentase gumanti nilai piksel. Lan cingakin opsi tata letak Gridzy autoFontSize , sane ngiket ukuran-font ring ukuran kotak item.
  2. Soang-soang barang punika patut madue rasio aspek sane sampun katentuang becik. Rasio aspek barang punika nenten pacang naenin mauwah lan kabuatang anggen ngitung kisi. Dadosnyane yening item nenten otomatis madue rasio aspek sane sampun katentuang becik, pradefinisiang manual (contonyane lewat css).

Ring makudang-kudang kasus, minab dangan antuk ngagayain daging item sadurung Gridzy punika ngawitin. Cukup ngilangang kelas gridzy utawi file javascript Gridzy sementara antuk puniki.

Inggih wantah asapunika! Ento dogen ane perluang cening anggon ngawangun kulit ceninge padidi. Akeh kulit sane sampun katentuang nenten nganggen lebih saking puniki.

Nanging minab wenten malih yening semeton seneng ...

Kulit Lanturan

Gridzy nganggén kelas CSS sané akéh yéning saihang sareng gridzyItem kémanten. Akehnyane pacang kaatur otomatis lan semeton prasida nganggen antuk gaya taler.

Kelas Wadah Utama

Wastan KelasPanjelasan
gridzy
anggén nyetél manual
Gridzy otomatis ngerereh elemen sareng kelas puniki lan ngawitin.
gridzyAnimatedPacang kaatur otomatis yéning opsi animate punika true . Yéning kelas puniki kaatur manual, opsi animate otomatis pacang ngamolihang true taler (sajabaning yéning sampun kaatur secara eksplisit dados false ).

Kelas Barang

Wastan KelasPanjelasan
gridzyItemPacang kaatur digelis ritatkala barang punika ngawitin proses inisialisasi. Tan pacang naenin kaicalang.
gridzyItemInitializingPacang kaatur digelis ritatkala barang punika ngawitin proses inisialisasi. Pacang kagentosin antuk gridzyItemReady digelis barang punika sampun jangkep ka-inisialisasi. Tegesnyane nenten ja gambar sane sampun jangkep kamuat (cingak gridzyItemLoading ), nanging barang sampun sayaga mangda prasida kacingak.
gridzyItemReadyPacang ngentosin gridzyItemInitializing digelis barang punika sampun jangkep ka-inisialisasi. Tan pacang naenin kaicalang. Tegesnyane nenten ja gambar sane sampun jangkep (cingak gridzyItemComplete ), nanging item sampun sayaga mangda prasida kacingak.
gridzyItemLoadingPacang kaatur digelis ritatkala barang punika ngawitin proses inisialisasi. Pacang kagentosin antuk gridzyItemComplete digelis gambar sane madaging (ketahnyane wantah asiki) sampun jangkep kamuat.
gridzyItemCompletePacang ngentosin gridzyItemLoading digelis gambar sane madaging (ketahnyane wantah asiki) sampun jangkep kamuat. Tan pacang naenin kaicalang.
gridzyItemInitialToVisiblePacang kaatur digelis ritatkala barang punika ngawit medal kapertama. Pacang kaicalang digelis barang punika sampun jangkep kacingak.
gridzyItemVisiblePacang kagenahang digelis barang punika sampun jangkep kacingak. Pacang kaicalang digelis barang punika ngawit ical.
gridzyItemVisibleToHiddenPacang kaatur digelis barang punika ngawit ical. Pacang kaicalang digelis barang punika sampun jangkep kaengkebang.
gridzyItemHiddenPacang kagenahang digelis barang punika sampun jangkep kaengkebang. Pacang kaicalang digelis barang punika ngawit medal.
gridzyItemHiddenToVisiblePacang kaatur digelis ritatkala barang punika ngawit medal (sajabaning medal kapertama – cingak kelas gridzyItemInitialToVisible ). Pacang kaicalang digelis barang punika sampun jangkep kacingak.
gridzyItemVisibleToVisiblePacang kaatur digelis wenten ring grid sane kauwah, nanging barang punika lan tetep kacingak. Pacang kaicalang digelis yening animasi perubahan sampun puput.

Manut default indikator proses lan animasi antuk gambar sane medal lan ical sampun katentuang olih file CSS utama Gridzy.

Antuk kelas CSS sane sampun kabaosang ring ajeng puniki semeton prasida ngayahin indikator proses lan animasi semetone soang-soang. Dare cingakin ring file CSS utama Gridzy, mangda ngresepang napi sane pacang patut katimpalin. Tan jejeh, samian sampun kadokumentasiang becik irika.

Optimalkan Pamuatan

Yening nganggen akeh gambar, minab dados ide sane becik anggen ngwantu Gridzy ngawangun grid mangda gelisan.

Cegah gambar sané makecog

Gridzy mutlak ngamerluang rasio aspek saking makasami gambar anggen ngitung grid. Kasujatian punika ngasilang unsur-unsur meloncat yening wenten gambar sane sampun sayaga lan sane lianan durung. Sayan akeh gambar sane wenten, sayan ngresepang prasida efek puniki.

Mangda nenten wenten parilaksana puniki, wantah atur atribut width lan height antuk makasami elemen img . Penting pisan mangda ngatur nilai sane patut antuk soang-soang gambar individu, yening nenten gambar punika pacang terdistorsi. Nilai sané patut inggih punika linggah lan tegeh asli gambar soang-soang:

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

Sesampune punika Gridzy prasida ngitung grid langsung tanpa perlu uning ukuran gambar sane sujati.

Males Muat

Anggén ngunggahang gambar sané wénten ring viewport sané sinah, anut manten pamargi puniki:

  1. Sisipang atribut width lan height sakadi sané sampun katlatarang ring ajeng (pastikayang nganggén nilai sané patut)
  2. Gentosin samian atribut src antuk data-gridzylazysrc sakadi sane kacihnayang ring sor puniki (yening semeton madue atribut srcset taler, ganti antuk 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>

Sesampuné langkah-langkah puniki gambar pacang kamuat digelis yéning sampun nampek utawi ring tengahing viewport.

Indikator Proses

Indikator proses inggih punika ikon animasi alit sane medal ritatkala gambar punika sedek kamuat. Yéning Sameton nganggén keterangan & kulit , indikator proses pacang kasinahang otomatis. Yéning nénten, Sameton merluang makudang-kudang penyesuaian:

  1. Masang soang-soang elemen img dados elemen div .
    (utawi ka elemen tiosan – cingak HTML semantik antuk sejangkepnyané)
  2. Wewehin kelas gridzyImage ring soang-soang elemen 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>

Sesampune punika semeton patut nyingakin indikator proses yening gambar punika ngamerluang galah anggen muat.

Saringan

Filter ring Gridzy puniki cukup sederhana nanging kuat. Nenten lali ring saringan napi sane kabuatang, minab pisan punika prasida karealisasiang. Sane kabuatang wantah, akidik CSS lan makudang-kudang elemen wangun HTML ...

Puniki conto fungsional:

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

Ngiring Wangun Langkah-langkah

1. Kapertama iraga perlu struktur HTML biasa saking Gridzy lan ngatur wastan kelas antuk makasami item galeri mangda iraga prasida nyaring sesampunne .

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

Ring conto puniki iraga wantah nganggen siki kelas antuk soang-soang elemen. Nanging Sameton taler prasida ngatur makudang-kudang kelas antuk siki elemen, yéning elemen punika patut prasida kapanggihin saking makudang-kudang filter.

2. Raris iraga nambahin makudang-kudang tombol sane malarapan antuk punika iraga prasida ngubah filter lantas .

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

Pangentos tombol, Sameton taler prasida nganggén elemen formulir tiosan sakadi kotak centang, tombol radio, pilih widang miwah sané tiosan.

Sakadi sane sampun kacingak, nilai-nilai tombol punika biasane pemilih CSS. Sasampune iraga puput, klik ring tombol sakadi punika pacang nyinahang gambar sane cocok sareng CSS selector punika. Secara teknis punika wantah ngatur opsi filter ring nilai puniki.

Sameton taler prasida nganggen selektor sane joh lebih kompleks. Minakadi :not(.animals) taler pacang makarya, taler .animals.people miwah .animals, .people .

3. Pamuput, iraga ngrangkum tombol-tombol punika ring wadah div lan ngiket ring galeri Gridzy, antuk nyetel opsi 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>

Sakadi sane sampun kacingak, iraga taler nganggen pemilih CSS antuk opsi filterControls . Wadah div antuk atribut id wantah mawiguna mangda tombol-tombol punika dangan kapilih malarapan antuk pemilih CSS punika.

Inggih wantah asapunika!

Yéning Sameton seneng ring solusi JavaScript, cingakin API .

API

Yadiastun Gridzy madue API nyane, akehan sane prasida kalaksanayang tanpa punika, wantah antuk manipulasi DOM. Gridzy pacang nguratiang indike punika lan nyesuaiang kisi-kisi. Nanging wenten taler API sane dahat sakti ...

Nguwah DOM

Antuk samian manipulasi Model Objek Dokumen (DOM) iraga kapertama merluang elemen wadah:

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

Wewehin gambar

Penting pisan mangda jangkep ngwangun lan nagingin elemen anak anyar sadurung semeton nambahin ring elemen wadah. Yening nenten, Gridzy nenten prasida mendeteksi dimensi sane patut.

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

Icalang gambar

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

Uwah opsi

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

Sejangkepnyané indik manipulasi DOM prasida kapanggih ring dokumen web MDN . Wenten taler Purwakaning DOM sane wenten.

API sané kadruwénang

Mangda prasida nganggen API, kapertama iraga merluang instansi Gridzy, sane ngiket ring elemen wadah Gridzy:

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

Polihang Pilihan

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

Polihang Pilihan Makasami

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

Atur opsi

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

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

Terapang Saringan

Nerapang saringan wantah nyetél filter opsi sané prasida dados pamilih CSS sané sah:

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

Wewehin Fungsi Panggilan Mawali

NENTEN KAANGGEN saking versi 2.4.0
Anggen Acara sane modern lan lebih fleksibel pinaka pangentosnyane. Cingak bagian selanturnyané anggén rinciannyané.

Gridzy.js 2 ngadukung makudang-kudang opsi antuk fungsi panggilan balik. Ipun wantah prasida kaatur saking API proprietari, nanging pateh sakadi opsi tiosan:

// 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.
  }
});
Panjelasan
onBeforeOptionsChangedFungsi callback sane kaanggen langsung sadurung nyetel opsi.
onOptionsChangedFungsi callback sane kaanggen langsung sesampun nyetel opsi.
onBeforeRenderFungsi callback sane kaanggen langsung sadurung rendering.
onRenderFungsi callback sane kaanggen langsung sesampun rendering.

Anggén Acara

ngawit saking versi 2.4.0

Sameton dados nganggén acara Gridzy pateh sakadi acara JavaScript biasa:

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

Makudang-kudang acara katembakang ring elemen wadah Gridzy lan acara sane lianan katembakang ring elemen item individu ring elemen wadah.

Acara sané kamedalang ring elemen wadah Gridzy:

Panjelasan
gridzyBeforeInitApi sadurung inisialisasi galeri.
gridzyInitApi sesampun inisialisasi galeri.
gridzyBeforeOptionsChangedApi sadurung nyetél opsi.
gridzyOptionsChangedApi risampuné nyetél opsi.
gridzyBeforeRenderApi sadurung ngarender.
gridzyRenderApi risampuné ngarender.
Yéning Sameton kantun acara iriki, durusang kirim pinunas dukungan .

event.target ngicenin elemen wadah Gridzy.
event.detail.instance ngicénin conto Gridzy.

Acara sané kamedalang ring elemen barang:

Panjelasan
gridzyItemBeforeInitApi sadurung inisialisasi barang.
gridzyItemInitApi sesampun inisialisasi barang.
gridzyItemLoadingApi ritatkala barang punika ngawit kamuat.
gridzyItemReadyApi ritatkala barang punika sampun sayaga antuk itungan grid. Dadosnyane rasio aspek sampun kauningin, nanging gambar minab kantun muat.
gridzyItemCompleteMenyala ritatkala gambar barang sampun jangkep kamuat.
Yéning Sameton kantun acara iriki, durusang kirim pinunas dukungan .

event.target ngicenin elemen item soang-soang.
event.detail.instance ngicénin conto Gridzy.

API – Global

Wenten makudang-kudang fungsi sane independen saking instansi Gridzy. Dadosne iraga nenten perlu ngamolihang instansi sadurungnyane.

Polihang Opsi Default

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

Polihang Opsi Default Makasami

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

Atur Opsi Bawaan

Puniki nenten ngatur opsi saking makasami instansi Gridzy sane sampun kainisialisasi, nanging nentuang dasar antuk instansi anyar. Nanging, yéning opsi saking instansi sané sampun wénten pacang ka-reset saking nilai null , punika pacang nganggén nilai default anyar.

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

Sameton dados nganggén puniki anggén ngatur opsi ring global, yéning Sameton nyambat sadurung DOM sayaga. Dadosné Sameton nénten perlu malih ngatur opsi pinaka atribut.

Otomatisme

Salami makasami otomatisme Gridzy.js 2 aktif, nenten perlu metode ring sor puniki. Nanging otomatisme prasida kapademang mangda nganggen Gridzy antuk cara sane lebih tradisional:

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

Makudang-kudang opsi puniki nénten prasida kaatur saking atribut data-gridzy- utawi saking setOptions() , santukan alasan logis:

Nilai BawaanPanjelasan
autoInitOnDomReadytrueMendeteksi elemen sareng kelas gridzy ring pamuatan halaman lan ngawitin.

Dados kaatur saking Gridzy.setDefaultOptions()
autoInitOnDomMutation
Pangamat Mutasi
trueMendeteksi elemen anyar antuk kelas gridzy digelis ipun medal ring DOM lan inisialisasi ipun. (contonyané nganggén transisi laman)

Dados kaatur saking Gridzy.setDefaultOptions()
autoSyncChildListMutation
Pangamat Mutasi
trueMendeteksi napiké elemen anak (gambar) kawewehin utawi kaicalang, lan ngapdet grid otomatis.

Dados kaatur saking data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
useOptionAttributestrueNelatarang napike atribut data-gridzy- umumnyane kaanggen utawi nenten. Yéning puniki false opsi prasida kaatur wantah saking API proprietari.

Dados kaatur saking new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncAttributesMutation
Pangamat Mutasi
trueMendeteksi pauwahan atribut data-gridzy- , lan ngapdet grid otomatis. Taler mendeteksi yening kelas gridzyAnimated kawewehin utawi kaicalang lan yening wenten perubahan atribut style . Yéning useOptionAttributes punika false , punika wantah mendeteksi pauwahan atribut style .

Dados kaatur saking data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncChildClassMutation
Pangamat Mutasi
trueNgadeteksi pauwahan atribut class saking samian elemen anak (gambar). Relevan ngeninin indik saringan.

Dados kaatur saking data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncImageMutation
Pangamat Mutasi

ngawit saking versi 2.5.0
trueMendeteksi perubahan atribut src saking gambar makasami. Relevan yéning kaanggén sareng React utawi perpustakaan sané pateh.

Dados kaatur saking data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoRenderOnResize
Uwah ukuranPangamat

ngawit saking versi 2.6.0
trueMendeteksi pauwahan linggah elemen. Relevan ngenenin indik desain sane responsif. (Sadurung versi 2.6.0 pamiarsa acara sané nguwah ukuran jendela sampun kaanggén)

Dados kaatur saking data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()

Inisialisasi manual

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

Usak Instansi

Kasarnyane kabaosang, sane matungkalikan sareng inisialisasi Gridzy.

gridzyInstance.destroy();
gridzyInstance = null;

Sinkronisasi Daftar Anak Manual

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

Sinkronisasi Elemen Anak Tunggal Manual

Biasane nenten kabuatang, sajabaning ring kasus sane arang pisan.

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

Sinkronisasiang Atribut Manual

Nyatet indik opsi useOptionAttributes mangda true antuk puniki.

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

Paksa Rendering

Biasane nenten kabuatang, yadiastun samian otomatis sampun kapademang

gridzyInstance.render();