Ua unuhi 'akomi 'ia ka punaewele. Inā maopopo ʻole kekahi mea, e ʻoluʻolu e nānā i ka palapala Pelekane.
Hoohana Kumu
Hoʻouka i nā faila Gridzy i kāu kikowaena a hoʻohui iā lākou i kāu pūnaewele (maʻamau ma ka ʻāpana poʻo):
<link rel="stylesheet" href="gridzy/gridzy.min.css" />
<script src="gridzy/gridzy.min.js"></script>Hoʻohui i ka code HTML (ma nā wahi a pau o ka ʻāpana kino):
<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>ʻo ia wale nō! He laʻana hana piha kēlā. ʻAʻole pono ka hoʻomaka ʻana.
Hoʻonohonoho
ʻO ke ala maʻalahi e hoʻonohonoho iā Gridzy, e hoʻohana wale i nā ʻano HTML. Pono ʻoe e kau mua i nā inoa koho me data-gridzy- . No laila, e hoʻonohonoho i ka koho spaceBetween , e hoʻohui wale i ke ʻano 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>Nā Koho Nui
Justified Nā koho koho
Waterfall Koho Layout
ʻOi aku nā koho kiʻekiʻe
No nā koho hou aku, e nānā i ka API .
HTML Semantic
ʻO ke ʻano HTML maʻalahi loa o Gridzy ʻo kēia:
<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>Eia nō naʻe, maʻalahi loa ʻo Gridzy a hiki iā ʻoe ke hoʻohana i kahi ʻano HTML ʻē aʻe. He mau mea wale no e noonoo ai:
- Hōʻike kēlā me kēia keiki o ka mea ipu i hoʻokahi mea ma ka mānoanoa.
- Hiki ke ʻano o ka pahu pahu a me kāna mau keiki i kēlā me kēia ʻano hōʻailona, e like me
ula meli(e noʻonoʻo wale e hoʻihoʻi i nā paʻamau polokalamu kele pūnaewele). - Inā ʻaʻole kahi keiki
imgponoʻī, pono ia i ka papagridzyImage.
No laila he hana HTML hana kēia:
<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>ʻOi loa inā makemake ʻoe e hoʻohui i nā captions, pono ʻoe i kahi hoʻolālā HTML holomua. No ka ʻike hou aku e pili ana iā ia, e nānā iā Captions & Skins .
Nā Manaʻo a me nā ʻili
Inā makemake ʻoe e hoʻohui i nā captions i kāu hale kiʻi, pono ʻoe e wehewehe i ke ʻano. No laila, loaʻa kekahi mau ʻili i koho mua ʻia. Aia kēlā me kēia ʻili i kahi faila CSS. Pono ʻoe e hoʻohui i kēia faila me nā faila Gridzy nui (maʻamau ma ka ʻāpana poʻo):
<link rel="stylesheet" href="gridzy/skins/gridzySkinClassic/style.min.css" />Eia kekahi, pono ʻoe i kahi hoʻolālā HTML kiʻekiʻe:
<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>Inā ʻoe e noʻonoʻo e pili ana i ka hoʻolālā HTML, e nānā iā Semantic HTML .
No ka caption hiki iā ʻoe ke hoʻohana i kēlā me kēia ʻano o ka hōʻailona, e hōʻoia wale iā ia ka papa gridzyCaption . Pono ka mea img i ka papa gridzyImage .
Hōʻike ka laʻana i luna iā ʻoe i ka ʻili gridzySkinClassic . No ka hoʻohana ʻana i kahi mea ʻē aʻe, e hoʻololi wale i ka inoa ʻili me kekahi o kēia:
Nā ʻili i komo
| Nā Papa Loaʻa | |
|---|---|
| gridzySkinBlank kahi hoʻomaka maikaʻi no ka hana ʻana i kahi ʻili ponoʻī namua ola | gridzySkinBlank |
| gridzySkinClassic namua ola | gridzySkinClassic(DEPRECATED mai ka mana 2.6.0) |
| gridzySkinFullOverlay namua ola | gridzySkinFullOverlay(DEPRECATED mai ka mana 2.6.0) |
| gridzySkinLift namua ola | gridzySkinLift(DEPRECATED mai ka mana 2.6.0) |
| gridzySkinMagnifier ʻAʻole i hoʻokomo ʻia ka hana zoom namua ola | gridzySkinMagnifier(DEPRECATED mai ka mana 2.6.0) |
Pono nā ʻili āpau i luna i kahi faila CSS, akā aia kekahi mau ʻili hou e pono ai i kahi faila JavaScript:
<link rel="stylesheet" href="gridzy/skins/gridzySkinBlur/style.min.css" />
<script src="gridzy/skins/gridzySkinBlur/script.min.js"></script>| Nā Papa Loaʻa | |
|---|---|
| gridzySkinBlur ʻaʻole hana ma IE namua ola | gridzySkinBlur(DEPRECATED mai ka mana 2.6.0) |
| gridzySkinCard namua ola | gridzySkinCard(DEPRECATED mai ka mana 2.6.0) |
Koho Ili
Mai ka mana 2.6.0 aia nā koho e hoʻonohonoho i nā ʻili i kūkulu ʻia. Ma muli o ka ʻili kikoʻī hiki iā ʻoe ke hoʻonohonoho i ke kala hope, kala kikokikona a me ke aka kikokikona. Pono ʻoe e hoʻohana i nā waiwai maʻamau CSS e like me kāu e ʻike ai ma aneʻi:
<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>E nānā i nā mea hoʻololi i kākoʻo ʻia a me nā waiwai paʻamau no kēlā me kēia ʻili ma aneʻi:
gridzySkinClassic
| Hoʻololi | Waiwai Paʻamau | ʻIkepili |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ʻae i kekahi waiwai kāʻei CSS |
--color | rgb(255, 255, 255) | hiki i kekahi waiwai kala CSS |
--text-shadow | none | hiki i kekahi CSS kikokikona-aka waiwai |
gridzySkinFullOverlay
| Hoʻololi | Waiwai Paʻamau | ʻIkepili |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ʻae i kekahi waiwai kāʻei CSS |
--color | rgb(255, 255, 255) | hiki i kekahi waiwai kala CSS |
--text-shadow | none | hiki i kekahi CSS kikokikona-aka waiwai |
gridzySkinLift
| Hoʻololi | Waiwai Paʻamau | ʻIkepili |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ʻae i kekahi waiwai kāʻei CSS |
--color | rgb(255, 255, 255) | hiki i kekahi waiwai kala CSS |
--text-shadow | 0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0) | hiki i kekahi CSS kikokikona-aka waiwai |
gridzySkinMagnifier
| Hoʻololi | Waiwai Paʻamau | ʻIkepili |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ʻae i kekahi waiwai kāʻei CSS |
--color | rgb(255, 255, 255) | hiki i kekahi waiwai kala CSS |
ʻAʻole kākoʻo kēia ʻili --text-shadow
gridzySkinBlur
| Hoʻololi | Waiwai Paʻamau | ʻIkepili |
|---|---|---|
--background | rgba(0, 0, 0, .7) | ʻae i kekahi waiwai kāʻei CSS |
--color | rgb(255, 255, 255) | hiki i kekahi waiwai kala CSS |
--text-shadow | 0 0 10px rgb(0, 0, 0) | hiki i kekahi CSS kikokikona-aka waiwai |
gridzySkinCard
| Hoʻololi | Waiwai Paʻamau | ʻIkepili |
|---|---|---|
--background | rgba(0, 0, 0, 1) | ʻae i kekahi waiwai kāʻei CSS |
--color | rgb(255, 255, 255) | hiki i kekahi waiwai kala CSS |
--text-shadow | none | hiki i kekahi CSS kikokikona-aka waiwai |
Kākoʻo nā ʻili āpau i koho mua ʻia i nā huaʻōlelo maʻalahi. Hiki iā ʻoe ke hana i kāu mau ʻili ponoʻī a paʻakikī. E ʻoluʻolu e nānā iā Style Gridzy .
Kāhua Gridzy
Inā ʻaʻohe ʻili i koho mua ʻia i kūpono i kāu mau pono, hiki iā ʻoe ke kāhiko i kāu ʻili ponoʻī.
ʻO ke ala maʻalahi ke kope mua i kahi ʻili i loaʻa a hoʻololi iā ia i kāu pono ponoʻī. Hāʻawi maʻamau ka ʻili gridzySkinBlank i kahi kumu maikaʻi a me kahi palapala maikaʻi ma ka faila 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;
}Ma ka waihona CSS e ʻike ʻoe i nā papa gridzySkinBlank , gridzyImage a gridzyCaption . ʻAʻole pono ʻo Gridzy i kēia mau papa. Hoʻohana wale ʻia lākou no ke kālai ʻana a no laila hiki iā ʻoe ke wehe a inoa hou paha inā makemake ʻoe.
Eia hou, e ʻike ʻoe i ka CSS class gridzyItem . Hoʻonohonoho ʻo Gridzy i kēia papa i nā keiki pololei a pau o ka mea ipu nui. No laila, hiki iā ʻoe ke hoʻohana i kēia papa e kāhiko i nā mea o kāu hale kiʻi.
Noʻonoʻo i nā mea nui
- Pono e pane piha nā mea i loko. E noʻonoʻo e loli maoli ka nui o ka element. E hoʻohana i nā helu pākēneka ma kahi o nā waiwai pika. A e nānā i ke koho hoʻonohonoho Gridzy
autoFontSize, kahi e hoʻopaʻa ai i ka nui font ma ka nui o ka pahu mea. - Pono e loaʻa i kēlā me kēia mea kahi lākiō i wehewehe maikaʻi ʻia. ʻAʻole e loli ka lākiō hiʻohiʻona o ka mea a pono e helu i ka mānoanoa. No laila, inā ʻaʻole i loaʻa i kahi mea i kahi lākiō hiʻohiʻona i wehewehe maikaʻi ʻia, e wehewehe mua iā ia me ka lima (e laʻa me css).
I kekahi mau hihia, ʻoi aku ka maʻalahi o ka hana ʻana i ke ʻano o nā mea ma mua o ka hoʻomaka ʻana o Gridzy. E wehe wale i ka papa gridzy a i ʻole ka faila javascript Gridzy no kēia.
ʻo ia wale nō! ʻO ia wale nō ka mea e pono ai ke kūkulu i kou ʻili ponoʻī. ʻAʻole hoʻohana ka hapa nui o nā ʻili i koho ʻia ma mua o kēia.
Akā hiki ke loaʻa nā mea hou aku inā makemake ʻoe…
Nā ʻili Kiʻekiʻe
Hoʻohana ʻo Gridzy i nā papa CSS ʻoi aku ma mua o gridzyItem wale nō. E hoʻonohonoho aunoa ʻia ka hapa nui o lākou a hiki iā ʻoe ke hoʻohana iā lākou no ka hana ʻana.
Na Papa Ioko Nui
| Inoa Papa | wehewehe |
|---|---|
gridzye hoʻonohonoho lima | Loaʻa iā Gridzy nā mea me kēia papa a hoʻomaka iā lākou. |
gridzyAnimated | E hoʻonohonoho aunoa inā true ke koho animate . Inā hoʻonohonoho lima ʻia kēia papa, e true nō ke koho animate (koe naʻe inā hoʻonohonoho pono ʻia i false ). |
Nā Papa Mea
| Inoa Papa | wehewehe |
|---|---|
gridzyItem | E hoʻonoho ʻia i ka wā e hoʻomaka ai ke kaʻina hana hoʻomaka. ʻAʻole loa e wehe ʻia. |
gridzyItemInitializing | E hoʻonoho ʻia i ka wā e hoʻomaka ai ke kaʻina hana hoʻomaka. E hoʻololi ʻia e gridzyItemReady ke hoʻomaka piha ka mea. ʻAʻole ia i hoʻopiha piha ʻia nā kiʻi (e ʻike i gridzyItemLoading ), akā ua mākaukau ka mea e ʻike ʻia. |
gridzyItemReady | E hoʻololi i gridzyItemInitializing ke hoʻomaka piha ka mea. ʻAʻole loa e wehe ʻia. 'A'ole i ho'opiha piha 'ia nā ki'i (e 'ike i gridzyItemComplete ), akā ua mākaukau ka mea e 'ike 'ia. |
gridzyItemLoading | E hoʻonoho ʻia i ka wā e hoʻomaka ai ke kaʻina hana hoʻomaka. E pani ʻia e gridzyItemComplete i ka wā e hoʻopiha piha ʻia ai nā kiʻi i loaʻa (maʻamau hoʻokahi wale nō). |
gridzyItemComplete | E hoʻololi i gridzyItemLoading i ka wā e hoʻopiha piha ʻia ai nā kiʻi i loko (maʻamau hoʻokahi wale nō). ʻAʻole loa e wehe ʻia. |
gridzyItemInitialToVisible | E hoʻopaʻa ʻia i ka wā e hoʻomaka ai ka mea i ka manawa mua. E wehe ʻia ke ʻike ʻia ka mea. |
gridzyItemVisible | E hoʻonoho koke ʻia ke ʻike piha ʻia ka mea. E wehe ʻia i ka wā e hoʻomaka ai ka nalo ʻana o ka mea. |
gridzyItemVisibleToHidden | E hoʻonoho ʻia i ka wā e hoʻomaka ai ka nalo ʻana o ka mea. E wehe koke ʻia ke huna ʻia ka mea. |
gridzyItemHidden | E hoʻonoho koke ʻia ke huna ʻia ka mea. E wehe koke ʻia ke hoʻomaka ʻana o ka mea. |
gridzyItemHiddenToVisible | E hoʻonohonoho ʻia i ka wā e hoʻomaka ai ka mea (koe wale ka ʻike ʻana i ka manawa mua - e ʻike i ka papa gridzyItemInitialToVisible ). E wehe koke ʻia ke ʻike ʻia ka mea. |
gridzyItemVisibleToVisible | E hoʻonohonoho koke ʻia i ka wā i hoʻololi ʻia ai kekahi mea i loko o ka pā, akā ʻo ka mea ponoʻī a ʻike ʻia. E wehe koke ʻia i ka pau ʻana o ka animation hoʻololi. |
ʻO ka mea maʻamau, ʻo ka hōʻailona kaʻina hana a me nā animation no ka ʻike ʻana a me ka nalo ʻana o nā kiʻi i koho mua ʻia e ka faila CSS nui Gridzy.
Me kēia mau papa CSS i ʻōlelo ʻia ma luna nei hiki iā ʻoe ke kāhiko i kāu hōʻailona kaʻina hana a me nā animations. E ʻaʻa e nānā i ka faila CSS nui Gridzy, e hoʻomaopopo i kāu mea e hoʻopau ai. ʻAʻohe makaʻu, ua kākau maikaʻi ʻia nā mea a pau ma laila.
Hoʻonui i ka hoʻouka ʻana
Inā hoʻohana ʻoe i nā kiʻi he nui, he manaʻo maikaʻi paha ia e kōkua iā Gridzy e kūkulu wikiwiki i ka pā.
Kāohi i ka lele ʻana i nā kiʻi
Pono pono ʻo Gridzy i ka ratio hiʻohiʻona o nā kiʻi āpau e helu ai i ka pā. ʻO kēia ka hopena i ka lele ʻana i nā mea inā mākaukau kekahi mau kiʻi a ʻaʻole i mākaukau nā kiʻi ʻē aʻe. ʻOi aku ka nui o nā kiʻi, ʻoi aku ka huhū o kēia hopena.
No ka pale ʻana i kēia ʻano, hoʻonohonoho wale i nā ʻano width a me height no nā mea img āpau. He mea nui e hoʻonoho i nā waiwai kūpono no kēlā me kēia kiʻi, inā ʻaʻole e hoʻololi ʻia nā kiʻi. ʻO nā waiwai kūpono ka laula a me ke kiʻekiʻe o ke kiʻi.
<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>A laila hiki iā Gridzy ke helu koke i ka mānoanoa me ka ʻole e ʻike i ka nui maoli o nā kiʻi.
Lazy Loading
No ka hoʻouka ʻana i nā kiʻi wale nō i loko o ka ʻike maka, e hahai wale i kēia mau ʻanuʻu:
- E hoʻokomo i nā hiʻohiʻona
widtha meheighte like me ka mea i wehewehe ʻia ma luna (e hoʻohana i nā waiwai kūpono) - E hoʻololi i nā ʻano
srcāpau medata-gridzylazysrce like me ka mea i hōʻike ʻia ma lalo nei (inā loaʻa iā ʻoe nā ʻanosrcsetpū kekahi, e hoʻololi iā lākou medata-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>Ma hope o kēia mau ʻanuʻu, e hoʻouka ʻia nā kiʻi i ko lākou kokoke ʻana a i ʻole i loko o ke awa ʻike.
Hōʻike Kaʻina Hana
ʻO ka hōʻailona kaʻina hana ʻo ia ka ikona animated liʻiliʻi e ʻike ʻia i ka wā e hoʻouka ana ke kiʻi. Inā hoʻohana ʻoe i nā captions & skins , e hōʻike ʻia ka hōʻailona kaʻina hana. A i ʻole, pono ʻoe i kekahi mau hoʻoponopono:
- E hoʻokomo i kēlā me kēia mea
imgi kahi meadiv
(a i ʻole i kekahi mea ʻē aʻe - e ʻike i ka HTML semantic no nā mea hou aku) - E hoʻohui i ka papa
gridzyImagei kēlā me kēia meaimg
<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>Ma hope o kēlā, pono ʻoe e ʻike i nā hōʻailona kaʻina inā lawe nā kiʻi i ka manawa e hoʻouka ai.
Nā kānana
He maʻalahi nā kānana ma Gridzy akā ikaika. ʻAʻohe ʻano kānana āu e pono ai, hiki ke ʻike ʻia. ʻO nā mea a pau āu e makemake ai, he CSS liʻiliʻi a me kekahi mau mea HTML HTML ...
Eia kekahi laʻana hana:
<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>E kūkulu kākou i kēlā me kēia ʻanuʻu
1. Pono mua mākou i ke ʻano HTML maʻamau o Gridzy a hoʻonoho i nā inoa papa no nā mea hale kiʻi āpau i hiki iā mākou ke kānana iā lākou ma hope.
<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>Ma kēia laʻana, hoʻohana wale mākou i hoʻokahi papa no kēlā me kēia mea. Akā hiki iā ʻoe ke hoʻonohonoho i nā papa he nui no ka mea hoʻokahi, inā e ʻike ʻia kēlā mea ma o nā kānana he nui.
2. A laila hoʻohui mākou i kekahi mau pihi e hiki ai iā mākou ke hoʻololi i nā kānana a laila
<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>Ma kahi o nā pihi, hiki iā ʻoe ke hoʻohana i nā ʻano mea like ʻole e like me nā pahu pahu, nā pihi lekiō, koho i nā kahua a pēlā aku.
E like me kāu e ʻike ai, ʻo nā waiwai o nā pihi he mau mea koho CSS maʻamau. I ka pau ʻana o kā mākou kaomi ʻana ma ia pihi e hōʻike i nā kiʻi e pili ana i kēlā koho CSS. Hoʻonohonoho ʻenehana i ke koho filter i kēia waiwai.
Hiki iā ʻoe ke hoʻohana i nā mea koho paʻakikī. No ka laʻana :not(.animals) e hana pū kekahi, a me .animals.people a me .animals, .people .
3. ʻO ka hope, hoʻopili mākou i nā pihi i loko o kahi pahu div a hoʻopaʻa iā lākou i ka hale kiʻi Gridzy, ma ka hoʻonohonoho ʻana i ke koho 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>E like me kāu e ʻike ai, hoʻohana pū mākou i kahi mea koho CSS no ke koho filterControls . ʻO ka pahu div me ka ʻano id wale nō ka mea e maʻalahi ai ke koho ʻana i nā pihi ma o kēlā koho CSS.
ʻo ia wale nō!
Inā makemake ʻoe i kahi hoʻonā JavaScript, e nānā i ka API .
API
ʻOiai aia ʻo Gridzy i kāna API ponoʻī, hiki ke hana ʻia ka hapa nui o nā mea me ka ʻole, ma ka hoʻopunipuni wale ʻana i ka DOM. E ʻike ʻo Gridzy iā ia a hoʻoponopono i ka pā. Akā aia kekahi API ikaika loa ...
Hoʻoponopono i ka DOM
No nā manipulations Document Object Model (DOM) pono mākou i ka mea pahu:
// get the container element
var gridzyElement = document.querySelector('.gridzy');Hoʻohui i nā kiʻi
He mea nui e kūkulu pono a hoʻopiha i ka mea keiki hou ma mua o kou hoʻohui ʻana i ka mea ipu. A i ʻole, ʻaʻole hiki iā Gridzy ke ʻike i nā ana kūpono.
// 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);Wehe i nā kiʻi
// remove the first image
gridzyElement.removeChild(gridzyElement.firstElementChild);Hoʻololi i nā koho
// 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');ʻOi aku e pili ana i ka hoʻopunipuni ʻana i ka DOM hiki iā ʻoe ke loaʻa ma MDN web docs . Aia kekahi Introduction i ka DOM i loaʻa.
API no ka pono
No ka hoʻohana ʻana i ka API, pono mua mākou i ka hiʻohiʻona Gridzy, kahi i hoʻopaʻa ʻia i ka mea pahu Gridzy:
// get the Gridzy instance
var gridzyInstance = document.querySelector('.gridzy').gridzy;Loaʻa i ke koho
// get the value of a single option
var currentLayout = gridzyInstance.getOption('layout');Loaʻa i nā koho a pau
// get all option values as an object
var currentOptions = gridzyInstance.getOptions();Hoʻonoho i nā koho
// set specific option values
gridzyInstance.setOptions({
spaceBetween: 10,
layout: 'waterfall'
});
// or reset options to their default values
gridzyInstance.setOptions({
spaceBetween: null,
layout: null
});Hoʻopili i kāna kānana
ʻO ka hoʻohana ʻana i kahi kānana ke hoʻonohonoho wale nei i ka filter koho i hiki ke koho i kekahi mea koho CSS kūpono:
// 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'
});Hoʻohui i nā hana Callback
DEPRECATED mai ka mana 2.4.0
E hoʻohana i nā hanana hou a maʻalahi hoʻi. E ʻike i ka ʻāpana aʻe no nā kikoʻī.
Kākoʻo ʻo Gridzy.js 2 i kekahi mau koho no nā hana callback. Hiki ke hoʻonohonoho ʻia ma o ka API proprietary, akā e like me nā koho ʻē aʻe:
// 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.
}
});E hoʻohana i nā hanana
mai ka mana 2.4.0
Hiki iā ʻoe ke hoʻohana i nā hanana Gridzy e like me nā hanana JavaScript maʻamau:
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.
});Hoʻopau ʻia kekahi mau hanana ma ka mea pahu Gridzy a hoʻopau ʻia nā hanana ʻē aʻe ma luna o kēlā me kēia mea i loko o ka mea ipu.
Nā hanana i kī ʻia ma ka mea pahu Gridzy:
Hāʻawi event.target i ka mea pahu Gridzy.
Hāʻawi event.detail.instance i ka hiʻohiʻona Gridzy.
Nā hanana i kī ʻia ma nā ʻano mea:
Hāʻawi ka event.target i kēlā me kēia mea.
Hāʻawi event.detail.instance i ka hiʻohiʻona Gridzy.
API - Ka honua
Aia kekahi mau hana kūʻokoʻa i nā hiʻohiʻona Gridzy. No laila ʻaʻole pono mākou e kiʻi i kahi laʻana ma mua.
E kiʻi i ke koho Default
// get the default value of a single option
var defaultLayout = Gridzy.getDefaultOption('layout');E kiʻi i nā koho paʻamau a pau
// 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');E hoʻonoho i nā koho paʻamau
ʻAʻole kēia i hoʻonohonoho i nā koho o nā manawa Gridzy i hoʻomaka mua ʻia, akā wehewehe i ke kumu no nā manawa hou. Eia naʻe, inā e hoʻihoʻi hou ʻia kahi koho o kahi mea i loaʻa ma o ka waiwai null , e hoʻohana ia i ka waiwai paʻamau hou.
// set default option values
Gridzy.setDefaultOptions({
spaceBetween: 10,
layout: 'waterfall'
});Hiki iā ʻoe ke hoʻohana i kēia e hoʻonohonoho i nā koho ma ke ao holoʻokoʻa, inā ʻoe e kāhea iā ia ma mua o ka mākaukau ʻana o DOM. No laila ʻaʻole pono ʻoe e hoʻonohonoho hou i nā koho ma ke ʻano he ʻano.
ʻO nā automatism
I ka wā e paʻa ana nā automatisms a pau o Gridzy.js 2, ʻaʻohe pono o nā ʻano ma lalo nei. Akā hiki ke hoʻopau ʻia nā automatisms e hoʻohana iā Gridzy ma ke ʻano kuʻuna.
// 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
});ʻAʻole hiki ke hoʻonohonoho ʻia kekahi o kēia mau koho ma o data-gridzy- attributes a i ʻole setOptions() , no nā kumu kūpono:
E hoʻomaka me ka lima
// initialize a new Gridzy instance
var gridzyInstance = new Gridzy(document.querySelector('.gridzy'), {
spaceBetween: 10,
layout: 'waterfall'
});E luku i ka Instance
I ʻōlelo ʻia, ʻo ka ʻokoʻa o ka hoʻomaka ʻana iā Gridzy.
gridzyInstance.destroy();
gridzyInstance = null;Hoʻopili lima i ka papa inoa keiki
// after child elements (images) are added to or removed from the DOM.
gridzyInstance.syncChildList();E hoʻopaʻa lima i kahi mea keiki hoʻokahi
ʻAʻole pono ka maʻamau, koe wale nō i nā hihia kakaʻikahi.
// after child elements (images) are added to the DOM and only one of them should be synced to Gridzy.
gridzyInstance.syncChild(childElement);Hoʻopili lima i nā ʻano
E hoʻomaopopo he pono true ke koho useOptionAttributes no kēia.
// after data-gridzy- attributes have changed
gridzyInstance.syncAttributes();Ka hoʻolilo ikaika
ʻAʻole pono maʻamau, ʻoiai inā ua pio nā automatism a pau
gridzyInstance.render();