Situs wéb puniki sampun katerjemahang otomatis. Yening wenten sane durung tatas, durusang cingakin ring dokumentasi basa Inggris.
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
Justified Tata Letak
Waterfall Tata Letak
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
ullanli(wantah nimbangin antuk ngatur malih default browser). - Yéning elemen
imgnénten ja anak langsung, punika ngamerluang kelasgridzyImage.
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(SAMPUN KAANGGEN saking versi 2.6.0) |
| gridzySkinFullOverlay pratinjo langsung | gridzySkinFullOverlay(SAMPUN KAANGGEN saking versi 2.6.0) |
| gridzySkinLift pratinjo langsung | gridzySkinLift(SAMPUN KAANGGEN saking versi 2.6.0) |
| gridzySkinMagnifier fungsi zoom nénten karanjingang pratinjo langsung | gridzySkinMagnifier(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(SAMPUN KAANGGEN saking versi 2.6.0) |
| gridzySkinCard pratinjo langsung | gridzySkinCard(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
| Variabel | Nilai Bawaan | Inpormasi |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ngijinin nilai latar belakang CSS napi manten |
--color | rgb(255, 255, 255) | ngijinin nilai warna CSS napi manten |
--text-shadow | none | ngijinin nilai bayangan teks CSS napi manten |
gridzySkinFullOverlay
| Variabel | Nilai Bawaan | Inpormasi |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ngijinin nilai latar belakang CSS napi manten |
--color | rgb(255, 255, 255) | ngijinin nilai warna CSS napi manten |
--text-shadow | none | ngijinin nilai bayangan teks CSS napi manten |
gridzySkinLift
| Variabel | Nilai Bawaan | Inpormasi |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ngijinin nilai latar belakang CSS napi manten |
--color | rgb(255, 255, 255) | ngijinin nilai warna CSS napi manten |
--text-shadow | 0 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
| Variabel | Nilai Bawaan | Inpormasi |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ngijinin nilai latar belakang CSS napi manten |
--color | rgb(255, 255, 255) | ngijinin nilai warna CSS napi manten |
Kulit puniki nénten nyokong --text-shadow
gridzySkinBlur
| Variabel | Nilai Bawaan | Inpormasi |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ngijinin nilai latar belakang CSS napi manten |
--color | rgb(255, 255, 255) | ngijinin nilai warna CSS napi manten |
--text-shadow | 0 0 10px rgb(0, 0, 0) | ngijinin nilai bayangan teks CSS napi manten |
gridzySkinCard
| Variabel | Nilai Bawaan | Inpormasi |
|---|---|---|
--background | rgba(0, 0, 0, 1) | ngijinin nilai latar belakang CSS napi manten |
--color | rgb(255, 255, 255) | ngijinin nilai warna CSS napi manten |
--text-shadow | none | ngijinin 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
- 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. - 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 Kelas | Panjelasan |
|---|---|
gridzyanggén nyetél manual | Gridzy otomatis ngerereh elemen sareng kelas puniki lan ngawitin. |
gridzyAnimated | Pacang 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 Kelas | Panjelasan |
|---|---|
gridzyItem | Pacang kaatur digelis ritatkala barang punika ngawitin proses inisialisasi. Tan pacang naenin kaicalang. |
gridzyItemInitializing | Pacang 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. |
gridzyItemReady | Pacang 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. |
gridzyItemLoading | Pacang kaatur digelis ritatkala barang punika ngawitin proses inisialisasi. Pacang kagentosin antuk gridzyItemComplete digelis gambar sane madaging (ketahnyane wantah asiki) sampun jangkep kamuat. |
gridzyItemComplete | Pacang ngentosin gridzyItemLoading digelis gambar sane madaging (ketahnyane wantah asiki) sampun jangkep kamuat. Tan pacang naenin kaicalang. |
gridzyItemInitialToVisible | Pacang kaatur digelis ritatkala barang punika ngawit medal kapertama. Pacang kaicalang digelis barang punika sampun jangkep kacingak. |
gridzyItemVisible | Pacang kagenahang digelis barang punika sampun jangkep kacingak. Pacang kaicalang digelis barang punika ngawit ical. |
gridzyItemVisibleToHidden | Pacang kaatur digelis barang punika ngawit ical. Pacang kaicalang digelis barang punika sampun jangkep kaengkebang. |
gridzyItemHidden | Pacang kagenahang digelis barang punika sampun jangkep kaengkebang. Pacang kaicalang digelis barang punika ngawit medal. |
gridzyItemHiddenToVisible | Pacang kaatur digelis ritatkala barang punika ngawit medal (sajabaning medal kapertama – cingak kelas gridzyItemInitialToVisible ). Pacang kaicalang digelis barang punika sampun jangkep kacingak. |
gridzyItemVisibleToVisible | Pacang 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:
- Sisipang atribut
widthlanheightsakadi sané sampun katlatarang ring ajeng (pastikayang nganggén nilai sané patut) - Gentosin samian atribut
srcantukdata-gridzylazysrcsakadi sane kacihnayang ring sor puniki (yening semeton madue atributsrcsettaler, ganti antukdata-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:
- Masang soang-soang elemen
imgdados elemendiv.
(utawi ka elemen tiosan – cingak HTML semantik antuk sejangkepnyané) - Wewehin kelas
gridzyImagering soang-soang elemenimg
<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.
}
});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:
event.target ngicenin elemen wadah Gridzy.
event.detail.instance ngicénin conto Gridzy.
Acara sané kamedalang ring elemen barang:
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:
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();