Ityough ki sha 2.x – Gridzy.Gallery .

I gema ijiir i sha Intanet ne sha tseeneke u i. Aluer kwagh ngu u a lu wang ga yô, nenge ken ityakerada i ken zwa Buter la.

U eren tom a mi

Upload u Gridzy files la sha server wou shi seer ve sha ijiir you i sha Intanet ne (ka i lu ken vegher u sha ityou la):

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

Seer HTML code (hanma ijiir cii ken vegher u iyol la):

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

Ka nahan je la! Ka ikyav i tesen ér kwagh ngu eren vough vough je la. I gba u a seer eren kwagh u hiihii ga.

Mzough u akaa

Gbenda u hemban lun ican ga u eren tom a Gridzy yô, ka u eren tom a akaa a HTML tseegh. Ka u nger ati a akaa a u tsough la sha data-gridzy- tseegh. Nahan, u veren kwagh u a lu spaceBetween yô, seer kwagh u i yer ér 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>

Akaa a vesen a tsuan

	Mlu u sha inja	Mpase
`animate`	`true`	Ka i tese aluer gba u a er tom a akaa a tesen akaa a a lu zan hemen la shighe u grid a gema yô (u tesen ikyav yô, shighe u i lu geman mze u windou u browser shin shighe u i lu veren filter yô).
`layout`	`justified`	Ka a pase kwagh u i er tom a mi la. Ior mbagenev mba ve lu a `justified` u kpeegh sha kwagh u mlu u ken hemen la, ka ve nenge ér mlu u ken hemen la una lu inja er ka kwagh u i yer ér Gridzy.js 2 `waterfall` nahan. Hanma ve yô, nan ngu a akaa a nan a seer sha mi, a u zua a mi shin inya hen tebul ne yô.
`filter`	`*`	Ka a tese ufoto mba i gbe u a tese la. Hanma kwagh u CSS-selector cii una lu a inja heen. Ka i ver kwagh ne sha ikyev i `filterControls` (nenge kwagh u a dondo ne). Nenge ase akaa a i yer ér Filters la .
`filterControls`		Ka i tese akaa a i gbe u a er tom a mi u sôron ufoto mbara yô. Hanma kwagh u CSS selector, u a tsough akaa a ken HTML la cii, a er tom a mi er ka inja heen nahan. Nenge ase akaa a i yer ér Filters la .
`autoConsiderScrollBars`	`true`	U tsengan fan mze u a lu la aluer ikyav mbi ngeren kwagh mbi due shin mbi kera lu ga yô. Hanma shighe yô, ka i doo u se de ér i lu sha `true` saa di aluer kwagh u a lu eren sha tseeneke na ne va a mbamzeyol yô.

Justified Akaa a u tsough u eren yô

	Mlu u sha inja	Mpase
`autoFontSize`	`false`	Ka i hide i sôr mlu u font-size u hanma akwati la sha mlu u akwati u hiihii la. Sha mlu u ken ijime yô, i ver kwagh u font-size la wang ga.
`desiredHeight`	`190`	Ka i pase mlu u i soo ér ior ve lu a mi la. I ôr mzehemen u mimi la sha mzehemen u a lu la man akaa a a lu ken ikyav la.
`hideOnMissingImage`	`true`	Hide mbaakwati mba ve lu a ufoto mba yange ve lu a ian i eren tom a mi ga la.
`spaceBetween`	`4`	Ka i pase mlu u akaa a a lu hen atô u akaa la ken pixels.
`lastRowAlign` hii ken mgem u 2.3.0 la je.	`justified`	Ka a pase ieren i mlu u ken ijime la. Ior mba ve lu a ian i eren tom ne yô, ka ve lu `left` , `center` , `right` man `justified` .
`singleRowAlign` hii ken mgem u 2.3.0 la je.	`justified`	Ka a pase ieren la aluer ka ikyav i môm tseegh i lu yô. Ior mba ve lu a ian i eren tom ne yô, ka ve lu `left` , `center` , `right` man `justified` .
~~`fillLastRow`~~ ~~hii ken mgem u 2.1.0 la je.~~	~~`true`~~	I dugh un ken takerada u 2.4.0 la kera. (I DE u eren tom a mi hii ken mgem u 2.3.0 la je ) Ka i sôr ufoto mbara sha er hanma shighe yô, ikyav i masetyô la ia iv a ior cii yô. Aluer u soo u seer ufoto sha mi sha gbenda u eren tom yô, alaghga a doo u ú de kwagh ne. Ka i lu a inja sha kwagh u mlu u môm môm ga (nenge `fillSingleRow` ).
`fillSingleRow` hii ken mgem u 2.1.0 la je.	~~`true`~~	I dugh un ken takerada u 2.4.0 la kera. (I DE u eren tom a mi hii ken mgem u 2.3.0 la je ) Aluer ka ikyav i môm tseegh yô, i sôr ufoto mbara sha er hanma shighe yô, ikyav la ia iv a ior cii yô. Aluer kwagh er nahan yô, u ngu a foto môm shin uhar tseegh ken iyou i tesen akaa la yô, a doo u ú de kwagh ne.

Waterfall Akaa a u tsough u eren la

	Mlu u sha inja	Mpase
`autoFontSize`	`false`	Ka i hide i sôr mlu u font-size u hanma akwati la sha mlu u akwati u hiihii la. Sha mlu u ken ijime yô, i ver kwagh u font-size la wang ga.
`desiredWidth`	`250`	Ka i pase kwagh u i soo ér i er la. A ôr mzehemen u mimi la sha mzehemen u a lu la man iyenge i ikyav mbi i gber la.
`hideOnMissingImage`	`true`	Hide mbaakwati mba ve lu a ufoto mba yange ve lu a ian i eren tom a mi ga la.
`horizontalOrder`	`false`	I pase ér i ver akaa la vough vough ken hanma ityough hii ken imese zan zan ken iyan, maa i hide i hii ken ityough ki ki hembe lun ken imese la, i lu sha ityough ki ityough ki ki hembe lun a ijiir la ga. Sha mlu u ken hemen yô, hanma shighe yô, a ver akaa la ken ikyônough ki torough ki ki hembe lun a mzehemen ga la.
`spaceBetween`	`4`	Ka i pase mlu u akaa a a lu hen atô u akaa la ken pixels.
`singleRowAlign` since version 2.7.0	`justified`	Defines the behavior when not all columns can be filled due to too few images. Allowed values are `left`, `center`, `right` and `justified`.

Akaa agen a i gbe u se tsua yô

Aluer u soo u fan akaa agen yô, nenge sha API .

HTML u tesen injakwagh

Ikyav i HTML i Gridzy i hembe lun ican ga yô, ka i ne:

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

Kpa Gridzy ngu a mshi kpishi shi u ngu a ian i eren tom a hanma mlu u HTML ugen cii. Ka akaa kpuaa tseegh a i gbe u se hen sha mi ye:

Hanma wan u ken kwagh u a lu ken ikyav la cii tile sha ityough ki kwagh môm ken ikyav la.
Ior mba ve lu a mnenge u vough sha kwagh u mlu u ken hemen la cii, vea lu hanma inja i tag cii, er ul man li nahan (nenge ase sha kwagh u hiden veren akaa a i yer ér browser la).
Aluer kwagh u img la ka wan u nan iyol i nan ga yô, gba u nana lu a klase gridzyImage .

Nahan kwagh ne kpa ka mzough u HTML u a lu eren tom yô:

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

Hemban je yô, aluer u soo u seer akaaôron yô, gba u u lu a ikyav i HTML i i ze hemen yô. U fan kwagh u ú yô, nenge sha takerada u i yer ér Captions & Skins la .

Akaa a ngeren sha mi man ikyav mbi tomov

Aluer u soo u seer akaa a i nger sha mi la sha ikyav you yô, gba u u pase mluashe u i. Nahan yô, ikyav mbigenev mbi i vande pasen mbi la mbi. Hanma ikyav yô, ka i lu a faile u CSS. Ka u seer faile ne sha faile u Gridzy u vesen la (ka i lu ken vegher u ityough la):

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

Heela tseegh ga, gba u u lu a ikyav i HTML i i ze hemen yô:

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

Aluer u ngu henen sha kwagh u mlu u HTML yô, nenge sha Semantic HTML .

Sha kwagh u ngeren u u soo u eren tom a mi la yô, nenge wer ngu a klase gridzyCaption . Ior mba img gba u vea lu a klase gridzyImage .

Ikyav i tesen i i lu sha heen ne tese u ikyav i gridzySkinClassic . U eren tom a ugen kposo yô, gema iti i ikyav la sha môm ken akaa ne:

I wa Skins ker

	Uklase mba ve lu her la
ikyav mbi tswamev mbi lun gbilin ka kwagh u dedoo u hiin u eren kwagh u u soo la . mtese u ken igbar	`gridzySkinBlank`
gridzySkinClassic mtese u ken igbar	`gridzySkinClassic` `gridzySkinClassicLight`(I DE u eren tom a mi hii ken mgem u 2.6.0 la je)
gridzySkinFullOverlay mtese u ken igbar	`gridzySkinFullOverlay` `gridzySkinFullOverlayLight`(I DE u eren tom a mi hii ken mgem u 2.6.0 la je)
gridzySkinLift mtese u ken igbar	`gridzySkinLift` `gridzySkinLiftLight`(I DE u eren tom a mi hii ken mgem u 2.6.0 la je)
gridzySkinMagnifier zoom u eren tom la ngu ker ga mtese u ken igbar	`gridzySkinMagnifier` `gridzySkinMagnifierLight`(I DE u eren tom a mi hii ken mgem u 2.6.0 la je)

Ikyav mbi i ter sha heen ne cii gba u a lu a CSS file tseegh, kpa ikyav mbigenev mbigenev mbi i gbe u a lu a JavaScript file yô:

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

	Uklase mba ve lu her la
gridzySkinBlur ka a er tom ken IE . mtese u ken igbar	`gridzySkinBlur` `gridzySkinBlurLight`(I DE u eren tom a mi hii ken mgem u 2.6.0 la je)
gridzySkinCard mtese u ken igbar	`gridzySkinCard` `gridzySkinCardLight`(I DE u eren tom a mi hii ken mgem u 2.6.0 la je)

Akaa a tsuan sha iyol

Hii ken mgem u 2.6.0 la je, akaa nga a i gbe u se er ve se sôr akaa a i we ken takerada la yô. Ka sha mlu u ikyav mbi tomov mbi u lu a mi la ve u ver ikyav mbi ken ijime, ikyav mbi ngeren man ikyav mbi ngeren ye. Ka u eren tom a akaa a CSS a i yer ér custom properties la tseegh er u nenge heen nahan:

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

Nenge ase akaa a i suen la man akaa a i ver sha ci u hanma ikyav heen:

gridzySkinClassic

Kwagh u geman	Mlu u sha inja	Ibaver
`--background`	`rgba(0, 0, 0, .7)`	ka a na hanma kwagh u a lu ken ijime i CSS cii ian
`--color`	`rgb(255, 255, 255)`	Na ian ér hanma kwagh u CSS cii a lu a inja.
`--text-shadow`	`none`	ka a na hanma kwagh u i nger ken CSS cii ian

gridzySkinFullOverlay

Kwagh u geman	Mlu u sha inja	Ibaver
`--background`	`rgba(0, 0, 0, .7)`	ka a na hanma kwagh u a lu ken ijime i CSS cii ian
`--color`	`rgb(255, 255, 255)`	Na ian ér hanma kwagh u CSS cii a lu a inja.
`--text-shadow`	`none`	ka a na hanma kwagh u i nger ken CSS cii ian

gridzySkinLift

Kwagh u geman	Mlu u sha inja	Ibaver
`--background`	`rgba(0, 0, 0, .7)`	ka a na hanma kwagh u a lu ken ijime i CSS cii ian
`--color`	`rgb(255, 255, 255)`	Na ian ér hanma kwagh u CSS cii a lu a inja.
`--text-shadow`	`0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0)`	ka a na hanma kwagh u i nger ken CSS cii ian

gridzySkinMagnifier

Kwagh u geman	Mlu u sha inja	Ibaver
`--background`	`rgba(0, 0, 0, .7)`	ka a na hanma kwagh u a lu ken ijime i CSS cii ian
`--color`	`rgb(255, 255, 255)`	Na ian ér hanma kwagh u CSS cii a lu a inja.

Ikyav ne ngi suen --text-shadow ga .

gridzySkinBlur

Kwagh u geman	Mlu u sha inja	Ibaver
`--background`	`rgba(0, 0, 0, .7)`	ka a na hanma kwagh u a lu ken ijime i CSS cii ian
`--color`	`rgb(255, 255, 255)`	Na ian ér hanma kwagh u CSS cii a lu a inja.
`--text-shadow`	`0 0 10px rgb(0, 0, 0)`	ka a na hanma kwagh u i nger ken CSS cii ian

gridzySkinCard

Kwagh u geman	Mlu u sha inja	Ibaver
`--background`	`rgba(0, 0, 0, 1)`	ka a na hanma kwagh u a lu ken ijime i CSS cii ian
`--color`	`rgb(255, 255, 255)`	Na ian ér hanma kwagh u CSS cii a lu a inja.
`--text-shadow`	`none`	ka a na hanma kwagh u i nger ken CSS cii ian

Ikyav mbi i vande pasen mbi cii mbi suen akaangeren a a lu ican ga la tseegh. U ngu a er ikyav you iyol you man mbi mbi hembe lun a inja yô. Ka m nenge a Style Gridzy .

Ieren i Gridzy

Aluer ikyav i i vande veren ér i er la ngi i i zough sha mbamgbe ou ga yô, u er style u iyol you.

Gbenda u hemban lun ican ga yô, ka u hii kôron ikyav i i vande lun la, nahan geman i sha er ia zua sha mbamgbe ou yô. Ior gridzySkinBlank ve lu a mnenge u vough sha kwagh u mlu u ken hemen la, ka ve nenge ér mlu u ken hemen la una lu inja er ka kwagh u dedoo nahan.

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

Ken faile u CSS la u zua a ikyav mbi tswamev mbi gridzySkinBlank , man ikyav mbi tswamev mbi i yer ér gridzyImage gridzyCaption . Gridzy iyol na kpa yange gba u una er klase ne ga. Ka i er tom a mi sha u sôron akaa tseegh nahan u ngu a dugh a mi kera shin u gema iti a mi aluer u soo yô.

U seer yô, u zua a klase u CSS gridzyItem la. Gridzy ver klase ne sha tseeneke na sha ci u mbayev mba ve lu ken kwagh u vesen u i yer ér container element la cii. Nahan, u ngu a er tom a klase ne u eren akaa a ken gallery wou style.

Mind Akaa a Hange Hange .

Doo u akaa a a lu ken kwagh shon la aa lu a inja vough vough. Nenge ase er mlu u element la una gema kpôô kpôô yô. U er tom a mlu u percentage sha ityough ki mlu u pixel. Shi nenge ase kwagh u i yer ér autoFontSize la, u a kange mlu u font la sha mlu u akwati u kwagh la.
Hanma kwagh yô, a lu a mlu u i pase un tsembelee yô. Kwagh u a lu ken mlu u kwagh la una gema mayange ga, nahan gba u a ôr kwagh u grid la. Nahan aluer kwagh ugen ngu a aspect ratio u i pase un tsembelee ga yô, vande pasen un sha ave (er sha css nahan).

Ashighe agen yô, alaghga a hemba lun ican ga u eren style u akaa a a lu ker la cii ve Gridzy una hii u eren tom ye. Ka u dughun klase gridzy shin faile u javascript u Gridzy la kera sha anshighe kpuaa sha ci u kwagh ne.

Ka nahan je la! Ka kwagh u i gbe u ú er ve u maa iyol you tseegh je la. Ior kpishi mba ve lu a ikyav mbi tswamev mbi i yer ér predefined la mba eren tom a kwagh u hemban nahan ga.

Kpa akaa agen kpa aa lu aluer u soo yô ...

Ikyav mbi tomov mbi vesen

Gridzy ka a er tom a ikyav mbi CSS kpishi hemba gridzyItem tseegh. Ior kpishi vea lu a ian i eren kwagh sha tseeneke ve shi u er tom a mi sha u eren styling kpaa.

Klase u Konteina u vesen

Iti i klase	Mpase
`gridzy` u veren sha ave	Gridzy ka a zua a akaa a a lu ken klase ne la iyol na, maa a hii u eren tom a mi.
`gridzyAnimated`	Ka i ver un iyol na aluer kwagh u i yer `animate` ka `true` yô. Aluer i ver klase ne sha ave yô, kwagh u i yer ér `animate` la kpa una hingir `true` iyol na (saa di aluer i ver un wang ér `false` ).

Item klase

Iti i klase	Mpase
`gridzyItem`	Ka i lu inja er kwagh la hii u eren tom u hiin kwagh la nahan. Mayange a dugh un kera ga.
`gridzyItemInitializing`	Ka i lu inja er kwagh la hii u eren tom u hiin kwagh la nahan. Ka i gema i ver `gridzyItemReady` sha ityough ki kwagh shon shighe u i hii u eren tom a mi vough vough la. Inja na yô, ka ufoto mba iv a mi cii ga (nenge `gridzyItemLoading` ), kpa kwagh la wa iyol u duen ken igbar.
`gridzyItemReady`	Ka sea ôron kwagh u `gridzyItemInitializing` yô, se nenge a kwagh u se soo u eren la. Mayange a dugh un kera ga. Inja na yô, ka ufoto mba iv a mi cii ga (nenge `gridzyItemComplete` ), kpa kwagh la wa iyol u duen ken igbar.
`gridzyItemLoading`	Ka i lu inja er kwagh la hii u eren tom u hiin kwagh la nahan. Ka i gema i ver `gridzyItemComplete` sha ityough ki ufoto mba ve lu ker la (ka ve lu môm tseegh) ve iv ye.
`gridzyItemComplete`	Ka a gema a ver `gridzyItemLoading` sha ityough ki ufoto mba ve lu ker la (ka ve lu môm tseegh) ve iv a mi ye. Mayange a dugh un kera ga.
`gridzyItemInitialToVisible`	Ka i ver un shighe u kwagh la a hii u duen sha kwa u hiihii la je. Ka i dugh kwagh la kera shighe u i nenge a mi vindi vindi la.
`gridzyItemVisible`	Ka i ver kwagh la shighe u i nenge a mi vindi vindi la je. A dugh kwagh la kera shighe u kwagh la a hii u been kera la je.
`gridzyItemVisibleToHidden`	Ka i ver un shighe u kwagh la a hii u been kera la je. A dugh kwagh la kera shighe u i yer kwagh shon vindi vindi la.
`gridzyItemHidden`	Ka i ver kwagh la shighe u i yer kwagh shon vindi vindi la je. A dugh kwagh shon kera shighe u kwagh la a hii u duen la je.
`gridzyItemHiddenToVisible`	Ka i ver kwagh u a hii u duen la je (saa di u duen sha kwa u hiihii la tseegh – nenge klase u `gridzyItemInitialToVisible` ). Ka i dugh kwagh la kera shighe u i nenge a mi vindi vindi la.
`gridzyItemVisibleToVisible`	Ka i ver un fese er kwagh ugen ken ikyav la a gema nahan, kpa kwagh shon iyol na lu shi una lu her. Ka i dugh un kera shighe u i lu geman kwagh u i yer ér animation la been kera yô.

Ka i vande veren ikyav i tesen ér kwagh ngu zan hemen la man akaa a tesen ufoto mba ve lu duen man mba ve lu been la cii ken faile u Gridzy main CSS la.

Ka sea ôron kwagh u mlu u ken hemen yô, se nenge ser se mba a ian i eren kwagh u se soo la. Dare nenge ken Gridzy main CSS file, sha er u kav kwagh u u soo u eren yô. Mciem ma cian ga, i nger hanma kwagh cii ker tsembelee.

U eren tom a mi tsembelee

Aluer u er tom a ufoto kpishi yô, a lu kwagh u dedoo u wasen Gridzy u maan grid la fese.

Yangen ufoto mba eren tom

Gridzy gba u una lu a aspect ratio u ufoto cii sha er una ôr kwagh u grid la yô. Akaa ne ka a na yô, ior ve gba eren akaa a a lu a inja kpishi la, aluer ufoto mbagenev wa iyol, mbagenev di wa iyol ga yô. Er ufoto ve lu kpishi yô, kwagh ne una hemba vihin or ishima.

U yangen ieren ne yô, ver ikyav i width man height sha akaa a img cii. Ka hange hange u veren akaa a vough sha hanma foto môm môm, aluer ka nahan ga yô, ufoto mbara vea vihi. Akaa a vough ka mzehemen man mze u foto la:

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

Nahan Gridzy una ôr kwagh u grid la fese je, a kera gba u una fa mze u ufoto mbara jighilii ga.

U eren tom sha inja ga

U eren tom a ufoto mba ve lu ken ikyav i tesen la tseegh yô, dondo akaa ne tseegh:

Nyôr width man height er i pase sha heen nahan (nenge wer u er tom a inja i vough)
I nger akaa a src cii sha ityough ki data-gridzylazysrc er i tese shin heen nahan (aluer u ngu a akaa srcset kpaa yô, gema sha 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>

Ka wea er akaa ne cii yô, ufoto mbara ve gba eren tom shighe u ve lu ikyua shin ken atô u ijiir i nengen a mi la je.

Kwagh u tesen gbenda u eren kwagh

Kwagh u tesen ér kwagh ngu zan hemen la ka ikyav i kiriki i i tese shighe u i lu eren tom a foto la. Aluer u er tom a captions & skins , ikyav i tesen er kwagh a lu zan hemen la ia tese u iyol i i. Aluer ka nahan ga yô, gba u u gema akaa agen:

Ver hanma kwagh img ken kwagh u div .
(shin ken hanma kwagh ugen cii – nenge semantic HTML sha u fan kwagh ugen)
Seer klase gridzyImage sha hanma kwagh img cii .

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

Ka a been yô, u nenge a akav a tesen ér kwagh ngu zan hemen la aluer ufoto mbara mba tôôn shighe u eren tom yô.

Akaa a sôron akaa

Filter mba ken Gridzy ka ve lu kwagh u kiriki kpa ve lu a tahav. Aluer ka nyi inja filter u soo cii kpa, alaghga kwagh la una wase u u fan kwagh u a lu zan hemen la. Kwagh u u soo cii ka, CSS kpuaa man akaa a HTML kpuaa ...

Ikyav i tesen yô, ka heen:

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

Se Maa Nen Kwagh sha Ikyev sha Ikyev .

1. Hiihii yô, gba u se lu a mlu u HTML u Gridzy la, shi se ver ati a klase sha akaa a ken gallery la cii sha er se filter a ken masejime yô.

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

Ken ikyav ne se mba eren tom a klase môm tseegh sha hanma kwagh. Kpa u ngu a ver klase kpishi sha kwagh u môm, aluer kwagh shon gba u a zua a mi sha u eren tom a ikyav mbi sôron akaa kpishi yô.

2. Nahan se seer akaa agen a se er tom a mi u geman akaa a se lu eren tom a mi la yô.

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

Sha ityough ki ikyav mbi eren tom a mi la yô, u ngu a er tom a akaa agen a i yer ér checkboxes la, ikyav mbi eren tom a mi sha redio, ikyav mbi eren tom a mi mbi i yer ér select fields la man akaa agen kpaa.

Er u nenge nahan, akaa a a lu ken ikyav la ka akaa a i yer ér CSS selectors la. Se mba been yô, aluer se kende sha imba ikyav la yô, a tese ufoto mba ve zough sha kwagh u i yer ér CSS selector la. Sha kwaghfan yô, ka i ver kwagh u filter la sha inja ne tseegh.

Shi u ngu a er tom a akaa a tsuan kwagh u a hembe lun a inja kpishi yô. Ikyav i tesen yô :not(.animals) kpa una er tom, kua .animals.people man .animals, .people .

3. Kwagh u masetyô yô, se wa akaa a i yer ér buttons la ken ikyagh ki div , se kange a sha ikyav i Gridzy, sha u veren kwagh u i yer filterControls la:

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

Er u nenge nahan, se mba eren tom a kwagh u CSS u tsuan kwagh u filterControls la kpaa. Ityough ki div ki ki lu a id attribute la ka ki wase u eren ér i lu ican ga u tsuan akaa a i gber la sha ikyev i CSS selector la tseegh.

Ka nahan je la!

Aluer u soo u eren tom a JavaScript yô, nenge sha API .

API

Shin er Gridzy a lu a API na nahan kpa, akaa kpishi aa er a mi shio, ka sha u eren tom a DOM la tseegh. Gridzy una nenge a mi shi una sôr mlu u grid la. Kpa API ugen kpa ngu u a lu a tahav kpishi yô ...

U eren tom a DOM la

Sha ci u akaa a i eren ken takerada u i yer ér Document Object Model (DOM) la cii, gba u se vande lun a kwagh u a lu ken ikyav la:

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

Seer ufoto

Ka hange hange u ú maa shi ú iv kwagh u wanye u he la cii ve ú mase seer un sha kwagh u a lu ken ikyav la ye. Aluer ka nahan ga yô, Gridzy una kera fa kwagh u a lu vough ga.

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

Dugh ufoto kera

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

Gema akaa a u tsough la

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

U zua a akaa agen sha kwagh u eren tom a DOM hen MDN web docs . Shi takerada u Introduction u DOM la kpa ngu.

API u or

U eren tom a API yô, gba u se vande lun a ikyav i Gridzy, i i zough a kwagh u a lu ken ikyav i Gridzy la:

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

Zua a kwagh u tsuan

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

Zua a akaa a u tsough cii .

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

Set akaa a tsuan

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

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

Er tom a Filter

U eren tom a filter la ka di u veren filter u tsuan u una lu hanma kwagh u CSS u vough cii:

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

Seer akaa a eren sha u yilan or

I DE u eren tom a mi hii ken mgem u 2.4.0 la je.
U er tom a Events mba ainge mba ve hembe lun a inja la sha ityough ki Events. Nenge vegher u a dondo ne sha er u fa kwagh u a lu ker la vighe vighe yô.

~~Gridzy.js 2 ngu suen akaa agen a i gbe u se er sha u yilan or yô. Ka sha ikyev i API u i yer ér proprietary API la tseegh i lu u a ver ve ye, kpa ka vough er akaa agen nahan:~~

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

	~~Mpase~~
~~`onBeforeOptionsChanged`~~	~~Callback function u ka i yila un jighilii cii ve i mase veren akaa a u tsough la ye.~~
~~`onOptionsChanged`~~	~~Callback function u ka i yila un jighilii shighe u i ver akaa a u tsough la kera yô.~~
~~`onBeforeRender`~~	~~Callback function u ka i yila un jighilii cii ve i mase geman kwagh la.~~
~~`onRender`~~	~~Callback function u ka i yila un jighilii shighe u i er tom u pasen kwagh kera yô.~~

U er tom a akaa a a er la

hii ken mgem u 2.4.0 la je.

U ngu a er tom a akaa a Gridzy vough er akaa a JavaScript a eren nahan:

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

Ior mbagenev ka ve er kwagh sha kwagh u Gridzy container element la, mbagenev di ka ve er kwagh sha kwagh u i yer ér item elements la asange asange ken kwagh u i yer ér container element la.

Akaa a yange er sha kwagh u ikyav i Gridzy la:

	Mpase
`gridzyBeforeInit`	Fires cii man i hii u eren tom a gallery ye.
`gridzyInit`	Fires mba been yô, i hii u eren tom a gallery.
`gridzyBeforeOptionsChanged`	Fires cii ve u mase veren akaa a u soo la ye.
`gridzyOptionsChanged`	Fires ka se ver akaa a se tsough la.
`gridzyBeforeRender`	Fires cii ve mase eren tom ye.
`gridzyRender`	Fires mba been yô.

Aluer u ngu a zua a kwagh u a lu zan hemen heen ga yô, tindi a msen u suen we .

event.target ka a na se kwagh u a lu ken ikyav i Gridzy la.
event.detail.instance ka a na ikyav i Gridzy la.

Akaa a yange er sha akaa a item la:

	Mpase
`gridzyItemBeforeInit`	Fires cii man kwagh u hiihii la.
`gridzyItemInit`	Fires ka kwagh u i hii u eren la.
`gridzyItemLoading`	Fires shighe u kwagh a hii u eren tom la.
`gridzyItemReady`	Fires shighe u kwagh la a lu vough u ôron kwagh u grid la. Nahan i fa aspect ratio la, kpa alaghga foto la una lu eren tom her.
`gridzyItemComplete`	Fires shighe u foto u kwagh la a lu a mshi ga yô.

Aluer u ngu a zua a kwagh u a lu zan hemen heen ga yô, tindi a msen u suen we .

event.target ka a na se kwagh u se soo la.
event.detail.instance ka a na ikyav i Gridzy la.

API – Tar cii

Ior mbagenev mba ve lu a ityom i eren sha tseeneke ve ga yô, ka Gridzy instances. Nahan gba u se vande zuan a instance cii ve se mase eren nahan ga.

Zua a kwagh u u tsough la

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

Zua a akaa a u tsough la cii .

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

Set akaa a u tsough la

Kwagh ne ka a ver akaa a ior ve tsough u eren sha u eren akaa a Gridzy a i vande hiin la cii ga, kpa a pase kwagh u a lu ityôkyaa i a er akaa a he yô. Kpa aluer i hide i ver kwagh u i tsough u eren ken ikyav i i vande lun la sha ikyev i mlu u null yô, una er tom a mlu u he u i ver la.

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

U ngu a er tom a kwagh ne u veren akaa a u tsough la sha tar cii, aluer u yila un cii man DOM a mase wan yô. Nahan a kera gba u u ver akaa a u tsough la ér a lu attributes ga.

Akaa a eren tom sha tseeneke u a

Aluer akaa a a lu ken Gridzy.js 2 la cii nga eren tom yô, kwagh gba sha igbenda i i lu shin heen ne ga. Kpa a fatyo u wuan akaa a a lu eren tom sha tseeneke na la sha u eren tom a Gridzy sha gbenda u tse:

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

Ior mbagenev mba ve lu a mnenge u vough sha kwagh u data-gridzy- una lu inja er ka setOptions() nahan.

	Mlu u sha inja	Mpase
`autoInitOnDomReady`	`true`	Ka i nenge a akaa a a lu a class `gridzy` sha peeji u i lu eren tom a mi la, nahan i hii u eren tom a mi. I ver sha ikyev i `Gridzy.setDefaultOptions()`
`autoInitOnDomMutation` Or u nengen sha mgem u akaa	`true`	Ka a nenge a akaa a he a a lu a class `gridzy` fese er a dugh ken DOM la, maa a hii u eren tom a mi. (er sha u yaren tom a mgem u peeji nahan) I ver sha ikyev i Gridzy. ver `Gridzy.setDefaultOptions()`
`autoSyncChildListMutation` Or u nengen sha mgem u akaa	`true`	Ka a nenge aluer i seer akaa a kiriki (ufoto) shin i dugh a kera yô, maa a hide a sôr ikyav mbi eren tom la iyol na. I ver sha ikyev i `data-grizy-` , `new Gridzy()` , `setOptions()` , `Gridzy.setDefaultOptions()`
`useOptionAttributes`	`true`	Ka i pase aluer ior kpishi mba eren tom a akaa a `data-gridzy-` la shin mba eren tom a mi ga yô. Aluer kwagh ne ka `false` a fatyo u veren akaa a i tsough la sha ikyev i API u i lu a mi la tseegh. I ver sha ikyev i `new Gridzy()` , `setOptions()` , `Gridzy.setDefaultOptions()`
`autoSyncAttributesMutation` Or u nengen sha mgem u akaa	`true`	Ka a nenge a akaa a a lu geman ken `data-gridzy-` , shi a hide a sôr akaa a a lu ken grid la iyol na. Shi ka a nenge aluer i seer shin i dugh klase `gridzyAnimated` la kera yô, shi aluer akaa gema ken mlu `style` la yô. Aluer `useOptionAttributes` ka `false` , ka a nenge a mgem u `style` tseegh. I ver sha ikyev i `data-grizy-` , `new Gridzy()` , `setOptions()` , `Gridzy.setDefaultOptions()`
`autoSyncChildClassMutation` Or u nengen sha mgem u akaa	`true`	Ka a nenge a mbamgem mba `class` u akaa a mbayev cii (ufoto). Ka kwagh u hange hange sha kwagh u filter. I ver sha ikyev i `data-grizy-` , `new Gridzy()` , `setOptions()` , `Gridzy.setDefaultOptions()`
`autoSyncImageMutation` Or u nengen sha mgem u akaa hii ken mgem u sha 2.5.0 la je.	`true`	Ka i nenge a mbamgem mba ken mlu `src` u ufoto cii. Ka i lu kwagh u injaa shighe u i lu eren tom a React shin ityakerada i i lu kwagh môm a mi yô. I ver sha ikyev i `data-grizy-` , `new Gridzy()` , `setOptions()` , `Gridzy.setDefaultOptions()`
`autoRenderOnResize` Gema mze u kwagh u nengen hii ken mgem u 2.6.0 la je.	`true`	Ka i nenge a mbamgem mba ken mlu u element la. Relevant sha kwagh u mzough u eren kwagh sha inja. (Cii man i va a mgem u i yer ér 2.6.0 la yô, i er tom a kwagh u ungwan kwagh u a lu zan hemen la sha u geman mze u windoo) I ver sha ikyev i `data-grizy-` , `new Gridzy()` , `setOptions()` , `Gridzy.setDefaultOptions()`

Hii sha ave

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

Vihi Instance la .

Roughly kaa ér, kwagh u a lu kposo a u hiin Gridzy la.

gridzyInstance.destroy();
gridzyInstance = null;

Sync List u Mbayev sha ave

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

Sync kwagh u wanye môm sha ave

Ashighe kpishi ka i gba u a er nahan ga, saa di sha ashighe a a lu kpuaa tseegh yô.

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

Sync Aeren a sha ave

Fa wer, gba u kwagh u i yer useOptionAttributes la una lu true sha ci u kwagh ne.

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

Mgem u sha agee

Ashighe kpishi ka i gba u a er nahan ga, shin er i cir akaa a a lu eren tom sha tseeneke u a la cii nahan kpaa .

gridzyInstance.render();

Mlu u sha 2.x