Helu 2.x


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

Waiwai Paʻamauwehewehe
animatetrueE hoʻoholo inā pono e hoʻohana ʻia nā animation i ka wā e hoʻololi ai ka mānoanoa (no ka laʻana, i ka hoʻololi ʻana i ka puka aniani a i ʻole ke kau ʻana i kahi kānana).
layoutjustifiedE wehewehe i ka hoʻolālā i hoʻohana ʻia. Kākoʻo ʻo Gridzy.js 2 i nā hoʻolālā ʻokoʻa ʻelua justified a me waterfall . Loaʻa i kēlā me kēia o lākou nā koho koho ʻē aʻe, hiki iā ʻoe ke loaʻa ma lalo o kēia papa.
filter*Hoʻoholo i nā kiʻi e hōʻike ʻia. Hiki ke hoʻohana ʻia kekahi CSS-koho ma ke ʻano he waiwai ma aneʻi. Hoʻonohonoho maʻamau ma filterControls (e ʻike i ke koho aʻe).
E nānā i nā kānana
filterControlsE hoʻoholo i nā ʻano mea hiki ke hoʻohana ʻia e kānana i nā kiʻi. Hiki ke hoʻohana ʻia kekahi mea koho CSS, e koho ana i nā ʻano HTML, ma ke ʻano he waiwai ma aneʻi.
E nānā i nā kānana
autoConsiderScrollBarstrueNo ka wānana i ka laula i loaʻa inā ʻike ʻia a nalowale paha nā ʻōwili pahu. Paipai mau ʻia e waiho i ka true ke ʻole kēia automatism i pilikia.

Justified Nā koho koho

Waiwai Paʻamauwehewehe
autoFontSizefalseHoʻohou 'akomi i ka waiwai momona o kēlā me kēia pahu ma muli o ka nui pahu kumu. Ma ka paʻamau, ʻaʻole i hoʻonohonoho pono ʻia ka waiwai momona.
desiredHeight190Wehewehe i ke kiʻekiʻe i makemake ʻia o nā lālani mea. E helu ʻia ke kiʻekiʻe maoli ma muli o ka laula i loaʻa a me nā mea o ka lālani.
hideOnMissingImagetrueHūnā nā pahu i loaʻa nā kiʻi hiki ʻole ke hoʻouka ʻia.
spaceBetween4Wehewehe i ka mamao ma waena o nā mea ma nā pika.
lastRowAlign
mai ka mana 2.3.0
justifiedWehewehe i ke ano o ka lalani hope. left nā waiwai i ʻae ʻia , center , right a me justified .
singleRowAlign
mai ka mana 2.3.0
justifiedWehewehe i ka hana inā hoʻokahi wale nō lālani. left nā waiwai i ʻae ʻia , center , right a me justified .
fillLastRow
mai ka mana 2.1.0
trueREMOVED mai ka mana 2.4.0 (DEPRECATED mai ka mana 2.3.0 )
Hoʻonohonoho i nā kiʻi i hoʻopiha piha ʻia ka lālani hope. Inā hoʻolālā ʻoe e hoʻohui i nā kiʻi me ka ikaika, he manaʻo maikaʻi paha ia e hoʻopau i kēia.
ʻAʻohe hopena i nā lālani hoʻokahi (e nānā fillSingleRow ).
fillSingleRow
mai ka mana 2.1.0
trueREMOVED mai ka mana 2.4.0 (DEPRECATED mai ka mana 2.3.0 )
Inā hoʻokahi lālani, hoʻonohonoho ia i nā kiʻi i hoʻopiha piha ʻia ka lālani. Inā hiki ke loaʻa iā ʻoe hoʻokahi a ʻelua mau kiʻi i loko o ka hale kiʻi, he mea maikaʻi paha e hoʻopau i kēia.

Waterfall Koho Layout

Waiwai Paʻamauwehewehe
autoFontSizefalseHoʻohou 'akomi i ka waiwai momona o kēlā me kēia pahu ma muli o ka nui pahu kumu. Ma ka paʻamau, ʻaʻole i hoʻonohonoho pono ʻia ka waiwai momona.
desiredWidth250E wehewehe i ka laula o nā kolamu i makemake ʻia. E helu ʻia ka laulā maoli ma muli o ka laula i loaʻa a me ka helu o nā kolamu.
hideOnMissingImagetrueHūnā nā pahu i loaʻa nā kiʻi hiki ʻole ke hoʻouka ʻia.
horizontalOrderfalseWehewehe ʻia ka hoʻokomo ʻia ʻana o nā mea i hoʻokahi mea i kēlā me kēia kolamu mai ka hema a i ka ʻākau, a laila hoʻomaka hou i ka kolamu hema loa kūʻokoʻa kahi i ʻoi aku ka nui o ke kolamu. E hoʻokomo mau ʻia nā mea i ke kolamu me ke kiʻekiʻe liʻiliʻi loa.
spaceBetween4Wehewehe i ka mamao ma waena o nā mea ma nā pika.
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.

ʻ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 ul a me li (e noʻonoʻo wale e hoʻihoʻi i nā paʻamau polokalamu kele pūnaewele).
  • Inā ʻaʻole kahi keiki img ponoʻī, pono ia i ka papa gridzyImage .

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
gridzySkinClassicLight(DEPRECATED mai ka mana 2.6.0)
gridzySkinFullOverlay
namua ola
gridzySkinFullOverlay
gridzySkinFullOverlayLight(DEPRECATED mai ka mana 2.6.0)
gridzySkinLift
namua ola
gridzySkinLift
gridzySkinLiftLight(DEPRECATED mai ka mana 2.6.0)
gridzySkinMagnifier
ʻAʻole i hoʻokomo ʻia ka hana zoom
namua ola
gridzySkinMagnifier
gridzySkinMagnifierLight(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
gridzySkinBlurLight(DEPRECATED mai ka mana 2.6.0)
gridzySkinCard
namua ola
gridzySkinCard
gridzySkinCardLight(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ʻololiWaiwai PaʻamauʻIkepili
--backgroundrgba(0, 0, 0, .7)ʻae i kekahi waiwai kāʻei CSS
--colorrgb(255, 255, 255)hiki i kekahi waiwai kala CSS
--text-shadownonehiki i kekahi CSS kikokikona-aka waiwai
gridzySkinFullOverlay
HoʻololiWaiwai PaʻamauʻIkepili
--backgroundrgba(0, 0, 0, .7)ʻae i kekahi waiwai kāʻei CSS
--colorrgb(255, 255, 255)hiki i kekahi waiwai kala CSS
--text-shadownonehiki i kekahi CSS kikokikona-aka waiwai
gridzySkinLift
HoʻololiWaiwai PaʻamauʻIkepili
--backgroundrgba(0, 0, 0, .7)ʻae i kekahi waiwai kāʻei CSS
--colorrgb(255, 255, 255)hiki i kekahi waiwai kala CSS
--text-shadow0 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ʻololiWaiwai PaʻamauʻIkepili
--backgroundrgba(0, 0, 0, .7)ʻae i kekahi waiwai kāʻei CSS
--colorrgb(255, 255, 255)hiki i kekahi waiwai kala CSS

ʻAʻole kākoʻo kēia ʻili --text-shadow

gridzySkinBlur
HoʻololiWaiwai PaʻamauʻIkepili
--backgroundrgba(0, 0, 0, .7)ʻae i kekahi waiwai kāʻei CSS
--colorrgb(255, 255, 255)hiki i kekahi waiwai kala CSS
--text-shadow0 0 10px rgb(0, 0, 0)hiki i kekahi CSS kikokikona-aka waiwai
gridzySkinCard
HoʻololiWaiwai PaʻamauʻIkepili
--backgroundrgba(0, 0, 0, 1)ʻae i kekahi waiwai kāʻei CSS
--colorrgb(255, 255, 255)hiki i kekahi waiwai kala CSS
--text-shadownonehiki 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

  1. 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.
  2. 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 Papawehewehe
gridzy
e hoʻonohonoho lima
Loaʻa iā Gridzy nā mea me kēia papa a hoʻomaka iā lākou.
gridzyAnimatedE 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 Papawehewehe
gridzyItemE hoʻonoho ʻia i ka wā e hoʻomaka ai ke kaʻina hana hoʻomaka. ʻAʻole loa e wehe ʻia.
gridzyItemInitializingE 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.
gridzyItemReadyE 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.
gridzyItemLoadingE 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ō).
gridzyItemCompleteE 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.
gridzyItemInitialToVisibleE 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.
gridzyItemVisibleE 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.
gridzyItemVisibleToHiddenE 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.
gridzyItemHiddenE hoʻonoho koke ʻia ke huna ʻia ka mea. E wehe koke ʻia ke hoʻomaka ʻana o ka mea.
gridzyItemHiddenToVisibleE 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.
gridzyItemVisibleToVisibleE 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:

  1. E hoʻokomo i nā hiʻohiʻona width a me height e like me ka mea i wehewehe ʻia ma luna (e hoʻohana i nā waiwai kūpono)
  2. E hoʻololi i nā ʻano src āpau me data-gridzylazysrc e like me ka mea i hōʻike ʻia ma lalo nei (inā loaʻa iā ʻoe nā ʻano srcset pū kekahi, e hoʻololi iā lākou me 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>

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:

  1. E hoʻokomo i kēlā me kēia mea img i kahi mea div
    (a i ʻole i kekahi mea ʻē aʻe - e ʻike i ka HTML semantic no nā mea hou aku)
  2. E hoʻohui i ka papa gridzyImage i kēlā me kēia mea 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>

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.
  }
});
wehewehe
onBeforeOptionsChangedʻO ka hana callback i kāhea pololei ʻia ma mua o ka hoʻonohonoho ʻana i nā koho.
onOptionsChangedʻO ka hana callback i kāhea pololei ʻia ma hope o ka hoʻonohonoho ʻana i nā koho.
onBeforeRenderHana ʻia ke kāhea ʻana ma mua o ka hāʻawi ʻana.
onRenderHana ʻia ke kāhea ʻana ma hope o ka hāʻawi ʻana.

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:

wehewehe
gridzyBeforeInitKe ahi ma mua o ka hoʻomaka ʻana o ka hale kiʻi.
gridzyInitKe ahi ma hope o ka hoʻomaka ʻana o ka hale kiʻi.
gridzyBeforeOptionsChangedKe ahi ma mua o ka hoʻonohonoho ʻana i nā koho.
gridzyOptionsChangedKe ahi ma hope o ka hoʻonohonoho ʻana i nā koho.
gridzyBeforeRenderʻO ke ahi ma mua o ka hana ʻana.
gridzyRenderʻO ke ahi ma hope o ka hana ʻana.
Inā haʻalele ʻoe i kekahi hanana ma aneʻi, e ʻoluʻolu e hoʻouna i kahi noi kākoʻo .

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:

wehewehe
gridzyItemBeforeInitKe ahi ma mua o ka hoʻomaka ʻana o ka mea.
gridzyItemInitKe ahi ma hope o ka hoʻomaka ʻana o ka mea.
gridzyItemLoadingKe ahi ke hoʻomaka ka ukana.
gridzyItemReadyKe ahi i ka wā e mākaukau ai ka mea no ka helu ʻana. No laila, ʻike ʻia ka lākiō hiʻohiʻona, akā ke hoʻouka nei paha ke kiʻi.
gridzyItemCompleteKe ahi ke hoʻouka piha ʻia ke kiʻi mea.
Inā haʻalele ʻoe i kekahi hanana ma aneʻi, e ʻoluʻolu e hoʻouna i kahi noi kākoʻo .

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:

Waiwai Paʻamauwehewehe
autoInitOnDomReadytrueʻIke i nā mea me ka papa gridzy ma ka hoʻouka ʻana i ka ʻaoʻao a hoʻomaka iā lākou.

Hoʻonohonoho ʻia ma Gridzy.setDefaultOptions()
autoInitOnDomMutation
MutationObserver
trueʻIke i nā mea hou me gridzy papa i ka wā e ʻike ʻia ai lākou i ka DOM a hoʻomaka iā lākou. (e laʻa me ka hoʻohana ʻana i nā hoʻololi ʻaoʻao)

Hoʻonohonoho ʻia ma Gridzy.setDefaultOptions()
autoSyncChildListMutation
MutationObserver
trueE ʻike inā hoʻohui ʻia a wehe ʻia paha nā mea keiki (nā kiʻi), a hoʻohou i ka pā.

Hoʻonohonoho ʻia ma data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
useOptionAttributestrueE wehewehe inā hoʻohana mau ʻia nā ʻano data-gridzy- a i ʻole. Inā he false kēia, hiki ke hoʻonohonoho wale ʻia ma o ka API proprietary.

Hoʻonohonoho ʻia ma new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncAttributesMutation
MutationObserver
trueʻIke i nā hoʻololi o nā ʻano data-gridzy- , a hoʻohou i ka pā. ʻIke pū inā hoʻohui ʻia a wehe ʻia paha ka papa gridzyAnimated a inā hoʻololi ke ʻano style . Inā he false useOptionAttributes , ʻike ia i nā hoʻololi ʻano style wale nō.

Hoʻonohonoho ʻia ma data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncChildClassMutation
MutationObserver
trueʻIke i nā loli o nā ʻano class o nā mea keiki a pau (kiʻi). Pili e pili ana i nā kānana.

Hoʻonohonoho ʻia ma data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoSyncImageMutation
MutationObserver

mai ka mana 2.5.0
trueʻIke i nā loli o nā ʻano src o nā kiʻi āpau. Pili ke hoʻohana ʻia me React a i ʻole nā waihona like.

Hoʻonohonoho ʻia ma data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()
autoRenderOnResize
Hoʻololi i ka mea nānā

mai ka mana 2.6.0
trueʻIke i nā hoʻololi o ka laulā element. Pili e pili ana i ka hoʻolālā pane. (Ma mua o ka mana 2.6.0 ua hoʻohana ʻia kahi mea hoʻolohe hanana hanana pukaaniani)

Hoʻonohonoho ʻia ma data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions()

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