අනුවාදය 2.x


මූලික භාවිතය

Gridzy ගොනු ඔබගේ සේවාදායකයට උඩුගත කර ඒවා ඔබගේ වෙබ් අඩවියට එක් කරන්න (සාමාන්‍යයෙන් ප්‍රධාන කොටසේ):

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

HTML කේතය එක් කරන්න (ශරීර කොටසේ ඕනෑම තැනක):

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

ඒක තමයි! එය සම්පූර්ණ ක්‍රියාකාරී උදාහරණයකි. අමතර ආරම්භ කිරීම අවශ්ය නොවේ.

මානකරනය

Gridzy වින්‍යාස කිරීමට ඇති පහසුම ක්‍රමය නම්, HTML attributes භාවිතා කිරීමයි. ඔබට අවශ්‍ය වන්නේ data-gridzy- සමඟ විකල්ප නාම උපසර්ගය පමණි. එබැවින්, spaceBetween විකල්පය සැකසීමට, 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>

ප්රධාන විකල්ප

පෙරනිමි අගයවිස්තරය
animatetrueජාලකය වෙනස් වන විට සජීවිකරණ භාවිතා කළ යුතුද යන්න තීරණය කරයි (උදාහරණයක් ලෙස, බ්‍රවුසර කවුළුව ප්‍රමාණය වෙනස් කිරීමේදී හෝ පෙරහනක් සැකසීමේදී).
layoutjustifiedභාවිතා කළ පිරිසැලසුම නිර්වචනය කරයි. Gridzy.js 2 විවිධ පිරිසැලසුම් justified සහ waterfall සඳහා සහය දක්වයි. ඒ සෑම එකක්ම තමන්ගේම අතිරේක විකල්ප පරාමිතීන් ඇත, ඔබට මෙම වගුවේ පහළින් සොයාගත හැකිය.
filter*කුමන රූප පෙන්විය යුතුද යන්න තීරණය කරයි. ඕනෑම CSS-තේරීමක් මෙහි අගය ලෙස භාවිතා කළ හැක. සාමාන්‍යයෙන් filterControls හරහා ස්වයංක්‍රීයව සකසන්න (ඊළඟ විකල්පය බලන්න).
පෙරහන් පරීක්ෂා කරන්න
filterControlsරූප පෙරීමට භාවිතා කළ හැක්කේ කුමන ආකෘති මූලද්‍රව්‍යද යන්න තීරණය කරයි. HTML ආකෘති මූලද්‍රව්‍ය තෝරන ඕනෑම CSS තේරීමක් මෙහි අගය ලෙස භාවිතා කළ හැක.
පෙරහන් පරීක්ෂා කරන්න
autoConsiderScrollBarstrueඅනුචලන තීරු දිස් වුවහොත් හෝ අතුරුදහන් වුවහොත් පවතින පළල පුරෝකථනය කිරීමට. මෙම ස්වයංක්‍රීයකරණය ගැටළු ඇති කරන්නේ නම් මිස එය true ලෙස තැබීම සැමවිටම නිර්දේශ කෙරේ.

Justified පිරිසැලසුම් විකල්ප

පෙරනිමි අගයවිස්තරය
autoFontSizefalseමුල් කොටු ප්‍රමාණය මත පදනම්ව එක් එක් කොටුවේ අකුරු ප්‍රමාණයේ ගුණය ස්වයංක්‍රීයව යාවත්කාලීන කරයි. පෙරනිමියෙන් අකුරු ප්‍රමාණයේ ගුණය පැහැදිලිව සකසා නොමැත.
desiredHeight190මූලද්රව්ය පේළිවල අපේක්ෂිත උස නිර්වචනය කරයි. පවතින පළල සහ පේළියේ ඇති මූලද්‍රව්‍ය මත පදනම්ව සැබෑ උස ගණනය කෙරේ.
hideOnMissingImagetrueපූරණය කළ නොහැකි පින්තූර අඩංගු කොටු සඟවයි.
spaceBetween4පික්සලවල මූලද්‍රව්‍ය අතර දුර නිර්වචනය කරයි.
lastRowAlign
2.3.0 අනුවාදයේ සිට
justifiedඅවසාන පේළියේ හැසිරීම නිර්වචනය කරයි. අවසර ලත් අගයන් left , center , right සහ justified වේ.
singleRowAlign
2.3.0 අනුවාදයේ සිට
justifiedතනි පේළියක් පමණක් තිබේ නම් හැසිරීම නිර්වචනය කරයි. අවසර ලත් අගයන් left , center , right සහ justified වේ.
fillLastRow
2.1.0 අනුවාදයේ සිට
true2.4.0 අනුවාදයේ සිට ඉවත් කර ඇත ( 2.3.0 අනුවාදයේ සිට අත්හරින ලදී)
අවසාන පේළිය සෑම විටම සම්පූර්ණයෙන්ම පිරී ඇති පරිදි පින්තූර සකසයි. ඔබ රූප ගතිකව එකතු කිරීමට අදහස් කරන්නේ නම්, මෙය අක්‍රිය කිරීම හොඳ අදහසක් විය හැකිය.
තනි පේළි මත බලපෑමක් නැත ( fillSingleRow බලන්න).
fillSingleRow
2.1.0 අනුවාදයේ සිට
true2.4.0 අනුවාදයේ සිට ඉවත් කර ඇත ( 2.3.0 අනුවාදයේ සිට අත්හරින ලදී)
එක් පේළියක් පමණක් තිබේ නම්, එය පේළිය සෑම විටම සම්පූර්ණයෙන්ම පිරී ඇති පරිදි පින්තූර සකස් කරයි. ඔබට ගැලරියේ පින්තූර එකක් හෝ දෙකක් පමණක් තිබීම සිදුවිය හැකි නම්, මෙය අක්‍රිය කිරීම හොඳ අදහසක් විය හැකිය.

Waterfall පිරිසැලසුම් විකල්ප

පෙරනිමි අගයවිස්තරය
autoFontSizefalseමුල් කොටු ප්‍රමාණය මත පදනම්ව එක් එක් කොටුවේ අකුරු ප්‍රමාණයේ ගුණය ස්වයංක්‍රීයව යාවත්කාලීන කරයි. පෙරනිමියෙන් අකුරු ප්‍රමාණයේ ගුණය පැහැදිලිව සකසා නොමැත.
desiredWidth250තීරු වල අපේක්ෂිත පළල නිර්වචනය කරයි. පවතින පළල සහ තීරු ගණන අනුව සැබෑ පළල ගණනය කෙරේ.
hideOnMissingImagetrueපූරණය කළ නොහැකි පින්තූර අඩංගු කොටු සඟවයි.
horizontalOrderfalseමූලද්‍රව්‍ය වමේ සිට දකුණට එක් එක් තීරුවේ එක් මූලද්‍රව්‍යයක් බැගින් තබා ඇති බව නිර්වචනය කරයි, ඉන්පසු තීරුව වැඩි ස්ථානයක් ඇති ස්වාධීනව වම් තීරුවෙන් නැවත ආරම්භ වේ. පෙරනිමියෙන් මූලද්රව්ය සෑම විටම කුඩාම උස සහිත තීරුවේ තබා ඇත.
spaceBetween4පික්සලවල මූලද්‍රව්‍ය අතර දුර නිර්වචනය කරයි.
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.

තවත් උසස් විකල්ප

වඩාත් උසස් විකල්ප සඳහා, API පරීක්ෂා කරන්න.

අර්ථකථන HTML

Gridzy හි සරලම HTML ව්‍යුහය මෙයයි:

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

කෙසේ වෙතත්, Gridzy ඉතා නම්‍යශීලී වන අතර ඔබට වෙනත් ඕනෑම HTML ව්‍යුහයක් භාවිතා කළ හැකිය. සලකා බැලිය යුතු කරුණු කිහිපයක් පමණි:

  • බහාලුම් මූලද්රව්යයේ සෑම දරුවෙකුම ජාලයේ එක් අයිතමයක් නියෝජනය කරයි.
  • බහාලුම් මූලද්‍රව්‍යය සහ එහි දරුවන් යන දෙකම ul සහ li වැනි ඕනෑම ටැග් වර්ගයක් විය හැකිය (බ්‍රවුසර පෙරනිමි යළි පිහිටුවීමට සලකා බලන්න).
  • img මූලද්‍රව්‍ය සෘජු දරුවෙකු නොවේ නම්, එයට පන්තිය gridzyImage අවශ්‍ය වේ.

එබැවින් මෙය වැඩ කරන HTML ව්‍යුහයක් ද වේ:

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

විශේෂයෙන්ම ඔබට සිරස්තල එකතු කිරීමට අවශ්‍ය නම්, ඔබට උසස් HTML ව්‍යුහයක් අවශ්‍ය වේ. ඒ ගැන තව දැන ගැනීමට, සිරස්තල සහ සම බලන්න.

සිරස්තල සහ සම

ඔබට ඔබේ ගැලරියට සිරස්තල එක් කිරීමට අවශ්‍ය නම්, ඔබ පෙනුම නිර්වචනය කළ යුතුය. එබැවින්, සමහර පූර්ව නිශ්චිත හම් තිබේ. සෑම සමක්ම CSS ගොනුවකින් සමන්විත වේ. ඔබට මෙම ගොනුව ප්‍රධාන Gridzy ගොනු වලට අමතරව එක් කිරීමට අවශ්‍ය වේ (සාමාන්‍යයෙන් ප්‍රධාන කොටසේ):

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

තවද ඔබට උසස් HTML ව්‍යුහයක් අවශ්‍ය වේ:

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

ඔබ HTML ව්‍යුහය ගැන පුදුම වන්නේ නම්, Semantic HTML දෙස බලන්න.

සිරස්තලය සඳහා ඔබට ඕනෑම වර්ගයක ටැගයක් භාවිතා කළ හැක, එයට class gridzyCaption ඇති බව සහතික කර ගන්න. img මූලද්‍රව්‍යයට gridzyImage පන්තිය අවශ්‍ය වේ.

ඉහත උදාහරණය ඔබට සම gridzySkinClassic පෙන්වයි. වෙනත් එකක් භාවිතා කිරීමට, සමේ නම මේවායින් එකක් සමඟ ප්‍රතිස්ථාපනය කරන්න:

ඇතුළත් සම

ලබා ගත හැකි පන්ති
gridzySkinBlank
තමන්ගේම සමක් නිර්මාණය කිරීම සඳහා හොඳ ආරම්භක ලක්ෂ්‍යයක්
සජීවී පෙරදසුන
gridzySkinBlank
gridzySkinClassic
සජීවී පෙරදසුන
gridzySkinClassic
gridzySkinClassicLight(2.6.0 අනුවාදයේ සිට අත්හරින ලදී)
gridzySkinFullOverlay
සජීවී පෙරදසුන
gridzySkinFullOverlay
gridzySkinFullOverlayLight(2.6.0 අනුවාදයේ සිට අත්හරින ලදී)
gridzySkinLift
සජීවී පෙරදසුන
gridzySkinLift
gridzySkinLiftLight(2.6.0 අනුවාදයේ සිට අත්හරින ලදී)
gridzySkinMagnifier
විශාලන ක්‍රියාකාරිත්වය ඇතුළත් නොවේ
සජීවී පෙරදසුන
gridzySkinMagnifier
gridzySkinMagnifierLight(2.6.0 අනුවාදයේ සිට අත්හරින ලදී)

ඉහත සියලුම හම් වලට අවශ්‍ය වන්නේ CSS ගොනුවක් පමණි, නමුත් JavaScript ගොනුවක් අවශ්‍ය වන අමතර සම් තිබේ:

<link rel="stylesheet" href="gridzy/skins/gridzySkinBlur/style.min.css" />
<script src="gridzy/skins/gridzySkinBlur/script.min.js"></script>
ලබා ගත හැකි පන්ති
gridzySkinBlur
IE වල වැඩ කරන්නේ නැහැ
සජීවී පෙරදසුන
gridzySkinBlur
gridzySkinBlurLight(2.6.0 අනුවාදයේ සිට අත්හරින ලදී)
gridzySkinCard
සජීවී පෙරදසුන
gridzySkinCard
gridzySkinCardLight(2.6.0 අනුවාදයේ සිට අත්හරින ලදී)

සම විකල්ප

2.6.0 අනුවාදයේ සිට බිල්ට් හම් වින්‍යාස කිරීමට විකල්ප ඇත. විශේෂිත සම මත පදනම්ව, ඔබට පසුබිම් වර්ණය, පෙළ වර්ණය සහ පෙළ සෙවනැල්ල සැකසිය හැක. ඔබට මෙහි දැකිය හැකි පරිදි CSS අභිරුචි ගුණාංග භාවිතා කිරීමට සිදුවේ:

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

මෙහි එක් එක් සම සඳහා සහය දක්වන විචල්‍යයන් සහ පෙරනිමි අගයන් පරීක්ෂා කරන්න:

gridzySkinClassic
විචල්යපෙරනිමි අගයතොරතුරු
--backgroundrgba(0, 0, 0, .7)ඕනෑම CSS පසුබිම් අගයකට ඉඩ දෙයි
--colorrgb(255, 255, 255)ඕනෑම CSS වර්ණ අගයකට ඉඩ දෙයි
--text-shadownoneඕනෑම CSS text-shadow අගයකට ඉඩ දෙයි
gridzySkinFullOverlay
විචල්යපෙරනිමි අගයතොරතුරු
--backgroundrgba(0, 0, 0, .7)ඕනෑම CSS පසුබිම් අගයකට ඉඩ දෙයි
--colorrgb(255, 255, 255)ඕනෑම CSS වර්ණ අගයකට ඉඩ දෙයි
--text-shadownoneඕනෑම CSS text-shadow අගයකට ඉඩ දෙයි
gridzySkinLift
විචල්යපෙරනිමි අගයතොරතුරු
--backgroundrgba(0, 0, 0, .7)ඕනෑම CSS පසුබිම් අගයකට ඉඩ දෙයි
--colorrgb(255, 255, 255)ඕනෑම CSS වර්ණ අගයකට ඉඩ දෙයි
--text-shadow0 0 10px rgb(0, 0, 0), 0 0 20px rgb(0, 0, 0), 0 0 30px rgb(0, 0, 0)ඕනෑම CSS text-shadow අගයකට ඉඩ දෙයි
gridzySkinMagnifier
විචල්යපෙරනිමි අගයතොරතුරු
--backgroundrgba(0, 0, 0, .7)ඕනෑම CSS පසුබිම් අගයකට ඉඩ දෙයි
--colorrgb(255, 255, 255)ඕනෑම CSS වර්ණ අගයකට ඉඩ දෙයි

මෙම සම --text-shadow සහය නොදක්වයි

gridzySkinBlur
විචල්යපෙරනිමි අගයතොරතුරු
--backgroundrgba(0, 0, 0, .7)ඕනෑම CSS පසුබිම් අගයකට ඉඩ දෙයි
--colorrgb(255, 255, 255)ඕනෑම CSS වර්ණ අගයකට ඉඩ දෙයි
--text-shadow0 0 10px rgb(0, 0, 0)ඕනෑම CSS text-shadow අගයකට ඉඩ දෙයි
gridzySkinCard
විචල්යපෙරනිමි අගයතොරතුරු
--backgroundrgba(0, 0, 0, 1)ඕනෑම CSS පසුබිම් අගයකට ඉඩ දෙයි
--colorrgb(255, 255, 255)ඕනෑම CSS වර්ණ අගයකට ඉඩ දෙයි
--text-shadownoneඕනෑම CSS text-shadow අගයකට ඉඩ දෙයි

සියලුම පෙර නිර්වචනය කළ සම සරල පෙළ සිරස්තලවලට පමණක් සහය දක්වයි. ඔබට ඔබේම සහ වඩාත් සංකීර්ණ සමක් නිර්මාණය කළ හැකිය. කරුණාකර Style Gridzy දෙස බලන්න.

ශෛලිය Gridzy

පූර්ව නිශ්චිත සමක් ඔබේ අවශ්‍යතාවලට නොගැලපේ නම්, ඔබට ඔබේම එකක් මෝස්තර කළ හැකිය.

පහසුම ක්‍රමය නම් පවතින සමක් පළමුව පිටපත් කර ඔබේ අවශ්‍යතාවයට අනුවර්තනය කිරීමයි. පූර්ව නිශ්චිත සම gridzySkinBlank සාමාන්‍යයෙන් 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;
}

CSS ගොනුව තුළ ඔබට පන්ති gridzySkinBlank , gridzyImage සහ gridzyCaption සොයා ගත හැක. ග්‍රිඩ්සිට මේ පන්ති අවශ්‍ය නැත. ඒවා භාවිතා කරන්නේ හැඩගැන්වීම සඳහා පමණක් වන අතර, ඔබ කැමති නම් ඒවා ඉවත් කිරීමට හෝ නැවත නම් කිරීමට හැකිය.

මීට අමතරව ඔබට CSS පන්තියේ gridzyItem සොයා ගත හැක. Gridzy මෙම පන්තිය ස්වයංක්‍රීයව ප්‍රධාන බහාලුම් මූලද්‍රව්‍යයේ සියලුම සෘජු දරුවන්ට සකසයි. එබැවින්, ඔබේ ගැලරියේ අයිතම හැඩගැන්වීමට ඔබට මෙම පන්තිය භාවිතා කළ හැකිය.

වැදගත් දේවල් හිතට ගන්න

  1. අයිතමයේ අන්තර්ගතය සම්පූර්ණයෙන්ම ප්රතිචාර දැක්විය යුතුය. මූලද්රව්ය ප්රමාණය අනිවාර්යයෙන්ම වෙනස් වන බව සලකන්න. පික්සල් අගයන් වෙනුවට ප්‍රතිශත අගයන් භාවිතා කරන්න. සහ ග්‍රිඩ්සි පිරිසැලසුම් විකල්පය දෙස බලන්න autoFontSize , එය අකුරු ප්‍රමාණය අයිතම පෙට්ටියේ ප්‍රමාණයට සම්බන්ධ කරයි.
  2. සෑම අයිතමයකටම හොඳින් අර්ථ දක්වා ඇති දර්ශන අනුපාතයක් තිබිය යුතුය. අයිතමයේ දර්ශන අනුපාතය කිසි විටෙකත් වෙනස් නොවන අතර ජාලකය ගණනය කිරීමට අවශ්‍ය වේ. එබැවින් අයිතමයකට ස්වයංක්‍රීයව මනාව නිර්වචනය කළ දර්ශන අනුපාතයක් නොමැති නම්, එය අතින් පූර්ව නිර්වචනය කරන්න (උදා: css හරහා).

සමහර අවස්ථාවලදී, Gridzy ආරම්භ කිරීමට පෙර අයිතමවල අන්තර්ගතය හැඩගැන්වීම පහසු විය හැකිය. මේ සඳහා class gridzy හෝ Gridzy javascript ගොනුව තාවකාලිකව ඉවත් කරන්න.

ඒක තමයි! ඔබේම සමක් ගොඩනගා ගැනීමට ඔබට අවශ්‍ය වන්නේ එපමණයි. බොහෝ කලින් නිර්වචනය කළ හම් මෙයට වඩා භාවිතා නොකරයි.

නමුත් ඔබ කැමති නම් තවත් තිබිය හැකිය ...

උසස් සම

Gridzy පමණක් gridzyItem වලට වඩා CSS පන්ති භාවිතා කරයි. ඒවායින් බොහොමයක් ස්වයංක්‍රීයව සැකසෙනු ඇති අතර ඔබට ඒවා හැඩගැන්වීම සඳහාද භාවිතා කළ හැක.

ප්රධාන බහාලුම් පන්ති

පන්තියේ නමවිස්තරය
gridzy
අතින් සැකසීමට
Gridzy ස්වයංක්‍රීයව මෙම පන්තිය සමඟ මූලද්‍රව්‍ය සොයාගෙන ඒවා ආරම්භ කරයි.
gridzyAnimatedanimate විකල්පය true නම් ස්වයංක්‍රීයව සකසනු ඇත. මෙම පන්තිය අතින් සකසා ඇත්නම්, animate විකල්පය ස්වයංක්‍රීයව true වේ (එය පැහැදිලිවම false ලෙස සකසා ඇත්නම් හැර).

අයිතම පන්ති

පන්තියේ නමවිස්තරය
gridzyItemඅයිතමය ආරම්භක ක්‍රියාවලිය ආරම්භ කළ වහාම සකසනු ඇත. කවදාවත් ඉවත් කරන්නේ නැහැ.
gridzyItemInitializingඅයිතමය ආරම්භක ක්‍රියාවලිය ආරම්භ කළ වහාම සකසනු ඇත. අයිතමය සම්පූර්ණයෙන්ම ආරම්භ කළ වහාම gridzyItemReady මගින් ප්‍රතිස්ථාපනය වනු ඇත. එයින් අදහස් වන්නේ පින්තූර සම්පූර්ණයෙන්ම පූරණය වී ඇති බව නොවේ (බලන්න gridzyItemLoading ), නමුත් අයිතමය දෘශ්‍යමාන වීමට සූදානම්ය.
gridzyItemReadyඅයිතමය සම්පූර්ණයෙන්ම ආරම්භ කළ වහාම gridzyItemInitializing ප්‍රතිස්ථාපනය කරනු ඇත. කවදාවත් ඉවත් කරන්නේ නැහැ. එයින් අදහස් වන්නේ පින්තූර සම්පූර්ණයෙන්ම පූරණය වී ඇති බවක් නොවේ (බලන්න gridzyItemComplete ), නමුත් අයිතමය දෘශ්‍යමාන වීමට සූදානම්ය.
gridzyItemLoadingඅයිතමය ආරම්භක ක්‍රියාවලිය ආරම්භ කළ වහාම සකසනු ඇත. අඩංගු රූප (සාමාන්‍යයෙන් එකක් පමණක්) සම්පුර්ණයෙන්ම පූරණය වූ වහාම gridzyItemComplete මගින් ප්‍රතිස්ථාපනය වනු ඇත.
gridzyItemCompleteඅඩංගු රූප (සාමාන්‍යයෙන් එකක් පමණක්) සම්පුර්ණයෙන්ම පූරණය වූ වහාම gridzyItemLoading ප්‍රතිස්ථාපනය කරයි. කවදාවත් ඉවත් කරන්නේ නැහැ.
gridzyItemInitialToVisibleඅයිතමය පළමු වරට දර්ශනය වීමට පටන් ගත් වහාම සකසනු ඇත. අයිතමය සම්පූර්ණයෙන්ම දෘශ්යමාන වූ වහාම ඉවත් කරනු ලැබේ.
gridzyItemVisibleඅයිතමය සම්පූර්ණයෙන්ම දෘශ්‍යමාන වූ වහාම සකසනු ඇත. අයිතමය අතුරුදහන් වීමට පටන් ගත් වහාම ඉවත් කරනු ලැබේ.
gridzyItemVisibleToHiddenඅයිතමය අතුරුදහන් වීමට පටන් ගත් වහාම සැකසෙනු ඇත. අයිතමය සම්පූර්ණයෙන්ම සැඟවුණු වහාම ඉවත් කරනු ලැබේ.
gridzyItemHiddenඅයිතමය සම්පූර්ණයෙන්ම සැඟවුණු වහාම සැකසෙනු ඇත. අයිතමය දර්ශනය වීමට පටන් ගත් වහාම ඉවත් කරනු ලැබේ.
gridzyItemHiddenToVisibleඅයිතමය දිස් වීමට පටන් ගත් වහාම සකසනු ඇත (පළමු වරට දිස් වීම හැර - පන්තිය gridzyItemInitialToVisible බලන්න). අයිතමය සම්පූර්ණයෙන්ම දෘශ්යමාන වූ වහාම ඉවත් කරනු ලැබේ.
gridzyItemVisibleToVisibleජාලකයේ යමක් වෙනස් වූ විගස සකසනු ඇත, නමුත් අයිතමයම තිබූ අතර දෘශ්‍යමානව පවතී. වෙනස් කිරීමේ සජීවිකරණය අවසන් වූ වහාම ඉවත් කරනු ලැබේ.

පෙරනිමියෙන් ක්‍රියාවලි දර්ශකය සහ රූප දිස්වන සහ අතුරුදහන් වීම සඳහා වන සජීවිකරණ Gridzy ප්‍රධාන CSS ගොනුව මගින් පූර්ව නිර්වචනය කර ඇත.

ඉහත සඳහන් කළ මෙම CSS පන්ති සමඟ ඔබට ඔබේම ක්‍රියාවලි දර්ශකයක් සහ සජීවිකරණ මෝස්තර කළ හැකිය. ඔබට අභිබවා යා යුතු දේ තේරුම් ගැනීමට Gridzy ප්‍රධාන CSS ගොනුව දෙස බලන්න. බිය නොවන්න, සෑම දෙයක්ම එහි හොඳින් ලේඛනගත කර ඇත.

පූරණය ප්‍රශස්ත කරන්න

ඔබ බොහෝ පින්තූර භාවිතා කරන්නේ නම්, Gridzy වේගයෙන් ජාලකය ගොඩනැගීමට උදවු කිරීම හොඳ අදහසක් විය හැකිය.

පින්තූර පැනීම වළක්වන්න

ජාලකය ගණනය කිරීම සඳහා Gridzy හට සියලුම රූපවල දර්ශන අනුපාතය අවශ්‍ය වේ. සමහර රූප සූදානම් නම් සහ අනෙක් ඒවා එසේ නොවේ නම් මෙම කරුණු පැනීමේ මූලද්‍රව්‍ය ඇති කරයි. රූප වැඩි වන තරමට මෙම බලපෑම වඩාත් කරදරකාරී විය හැකිය.

මෙම හැසිරීම වැළැක්වීම සඳහා, සියලු img මූලද්‍රව්‍ය සඳහා width සහ height ගුණාංග සකසන්න. එක් එක් රූපය සඳහා නිවැරදි අගයන් සැකසීම වැදගත් වේ, එසේ නොවුවහොත් පින්තූර විකෘති වනු ඇත. නිවැරදි අගයන් වන්නේ අදාළ රූපයේ මුල් පළල සහ උසයි:

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

ඉන් පසුව Gridzy හට රූපවල සත්‍ය ප්‍රමාණයන් දැන ගැනීමට අවශ්‍ය නොවී වහාම ජාලකය ගණනය කළ හැක.

කම්මැලි පැටවීම

දෘශ්‍ය දර්ශන තොටේ ඇති පින්තූර පමණක් පූරණය කිරීමට, මෙම පියවර අනුගමනය කරන්න:

  1. ඉහත විස්තර කර ඇති පරිදි width සහ height ගුණාංග ඇතුළත් කරන්න (නිවැරදි අගයන් භාවිතා කිරීමට වග බලා ගන්න)
  2. පහත පෙන්වා ඇති පරිදි සියලුම src attributes data-gridzylazysrc සමඟ ප්‍රතිස්ථාපනය කරන්න (ඔබට srcset ගුණාංගද තිබේ නම්, ඒවා 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>

මෙම පියවරෙන් පසු, රූප දර්ශන තොට අසල හෝ ඇතුළත ඇති විගස පූරණය වේ.

ක්රියාවලි දර්ශකය

ක්‍රියාවලි දර්ශකය යනු රූපය පූරණය වන විට දිස්වන කුඩා සජීවිකරණ නිරූපකයයි. ඔබ සිරස්තල සහ සම් භාවිතා කරන්නේ නම්, ක්‍රියාවලි දර්ශකය ස්වයංක්‍රීයව පෙන්වනු ඇත. එසේ නොමැතිනම් ඔබට යම් ගැලපීම් අවශ්ය වේ:

  1. සෑම img මූලද්‍රව්‍යයක්ම div මූලද්‍රව්‍යයකට දමන්න
    (හෝ වෙනත් ඕනෑම මූලද්‍රව්‍යයකට - වැඩි විස්තර සඳහා අර්ථකථන HTML බලන්න)
  2. එක් එක් img මූලද්‍රව්‍යයට class gridzyImage එක් කරන්න
<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>

ඊට පසු, පින්තූර පූරණය වීමට කාලය ගතවේ නම්, ඔබට ක්‍රියාවලි දර්ශක දැකිය යුතුය.

පෙරහන්

Gridzy හි පෙරහන් ඉතා සරල නමුත් බලවත් වේ. ඔබට කුමන ආකාරයේ පෙරහනක් අවශ්‍ය වුවද, එය සාක්ෂාත් කර ගැනීමට බොහෝ දුරට ඉඩ ඇත. ඔබට අවශ්‍ය වන්නේ, CSS ටිකක් සහ HTML ආකෘති මූලද්‍රව්‍ය කිහිපයක් පමණි ...

මෙන්න ක්රියාකාරී උදාහරණයක්:

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

අපි එය පියවරෙන් පියවර ගොඩනඟමු

1. පළමුව අපට Gridzy හි සාමාන්‍ය HTML ව්‍යුහය අවශ්‍ය වන අතර සියලුම ගැලරි අයිතම සඳහා පන්ති නම් සකසන්න එවිට අපට ඒවා පෙරීමට හැකිය

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

මෙම උදාහරණයේදී අපි එක් එක් මූලද්‍රව්‍ය සඳහා එක් පන්තියක් පමණක් භාවිතා කරමු. නමුත් ඔබට එක් මූලද්‍රව්‍යයක් සඳහා බහු පන්ති සැකසිය හැක, එම මූලද්‍රව්‍යය බහු පෙරහන් හරහා සොයා ගත හැකි නම්.

2. ඉන්පසුව අපි ෆිල්ටර් වෙනස් කළ හැකි බොත්තම් කිහිපයක් එකතු කරමු

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

බොත්තම් වෙනුවට, ඔබට පිරික්සුම් කොටු, රේඩියෝ බොත්තම්, තෝරාගත් ක්ෂේත්‍ර සහ යනාදිය වැනි වෙනත් පෝරම මූලද්‍රව්‍ය ද භාවිතා කළ හැකිය.

ඔබට පෙනෙන පරිදි, බොත්තම් වල අගයන් සාමාන්ය CSS තේරීම් වේ. අපි අවසන් වූ වහාම, එවැනි බොත්තමක් මත ක්ලික් කිරීමෙන් එම CSS තේරීමට ගැලපෙන පින්තූර පෙන්වනු ඇත. තාක්ෂණික වශයෙන් එය filter විකල්පය මෙම අගයට සකසයි.

ඔබට වඩාත් සංකීර්ණ තේරීම් භාවිතා කළ හැකිය. උදාහරණයක් ලෙස :not(.animals) ද වැඩ කරනු ඇත, මෙන්ම .animals.people සහ .animals, .people .

3. අවසාන වශයෙන්, අපි බොත්තම් div කන්ටේනරයක කොටු කර Gridzy ගැලරියට බඳිමු, 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>

ඔබට පෙනෙන පරිදි, අපි filterControls විකල්පය සඳහා CSS තේරීමක් ද භාවිතා කරමු. id ගුණාංගය සහිත div කන්ටේනරය එම CSS තේරීම්කාරකය හරහා බොත්තම් තේරීම පහසු කිරීමට පමණක් සේවය කරයි.

ඒක තමයි!

ඔබ JavaScript විසඳුමකට කැමති නම්, API පරීක්ෂා කරන්න.

API

Gridzy සතුව තමන්ගේම API ඇතත්, එය නොමැතිව බොහෝ දේ කළ හැක්කේ, DOM හැසිරවීමෙන්. Gridzy එය දැක ජාලකය සකසනු ඇත. නමුත් ඉතා බලවත් API එකක් ද තිබේ ...

DOM හැසිරවීම

සියලුම Document Object Model (DOM) හැසිරවීම් සඳහා අපට මුලින්ම අවශ්‍ය වන්නේ බහාලුම් මූලද්‍රව්‍යය:

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

පින්තූර එකතු කරන්න

ඔබ එය බහාලුම් මූලද්‍රව්‍යයට එක් කිරීමට පෙර නව ළමා මූලද්‍රව්‍යය සම්පූර්ණයෙන්ම ගොඩනඟා පිරවීම වැදගත් වේ. එසේ නොමැතිනම් Gridzy හට නිවැරදි මානයන් හඳුනාගත නොහැක.

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

පින්තූර ඉවත් කරන්න

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

විකල්ප වෙනස් කරන්න

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

DOM හැසිරවීම පිළිබඳ වැඩි විස්තර ඔබට MDN වෙබ් ලේඛනයෙන් සොයාගත හැකිය. DOM සඳහා හැඳින්වීමක් ද ඇත.

හිමිකාර API

API භාවිතා කිරීමට, අපට ප්‍රථමයෙන් Gridzy බහාලුම් මූලද්‍රව්‍යයට බැඳී ඇති Gridzy අවස්ථාව අවශ්‍ය වේ:

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

විකල්පය ලබා ගන්න

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

සියලුම විකල්ප ලබා ගන්න

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

විකල්ප සකසන්න

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

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

පෙරහන යොදන්න

පෙරහනක් යෙදීම යනු ඕනෑම වලංගු CSS තේරීමක් විය හැකි විකල්ප filter සැකසීමයි:

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

ආපසු ඇමතුම් කාර්යයන් එක් කරන්න

2.4.0 අනුවාදයේ සිට අත්හරින ලදී
ඒ වෙනුවට නවීන සහ වඩාත් නම්‍යශීලී සිදුවීම් භාවිතා කරන්න. විස්තර සඳහා ඊළඟ කොටස බලන්න.

Gridzy.js 2 ආපසු ඇමතුම් කාර්යයන් සඳහා සමහර විකල්ප සඳහා සහය දක්වයි. ඒවා සැකසිය හැක්කේ හිමිකාර API හරහා පමණි, නමුත් වෙනත් විකල්ප මෙන්:

// 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.
  }
});
විස්තරය
onBeforeOptionsChangedවිකල්ප සැකසීමට පෙර කෙලින්ම ඉල්ලා සිටින ආපසු ඇමතුම් ශ්‍රිතය.
onOptionsChangedවිකල්ප සැකසීමෙන් පසු සෘජුවම ඉල්ලා සිටින ආපසු කැඳවීමේ කාර්යය.
onBeforeRenderවිදැහුම්කරණයට පෙර සෘජුවම ඉල්ලා සිටින ආපසු ඇමතුම් ශ්‍රිතය.
onRenderවිදැහුම්කරණයෙන් පසු සෘජුවම ඉල්ලා සිටින ආපසු ඇමතුම් ශ්‍රිතය.

සිදුවීම් භාවිතා කරන්න

2.4.0 අනුවාදයේ සිට

ඔබට සාමාන්‍ය JavaScript සිදුවීම් මෙන් Gridzy සිදුවීම් භාවිතා කළ හැක:

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

සමහර සිදුවීම් ග්‍රිඩ්සි බහාලුම් මූලද්‍රව්‍ය මත වෙඩි තබන අතර අනෙකුත් සිදුවීම් බහාලුම් මූලද්‍රව්‍යය තුළ ඇති තනි අයිතම මූලද්‍රව්‍ය මත වෙඩි තබා ඇත.

Gridzy බහාලුම් මූලද්‍රව්‍ය මත සිදු වූ සිදුවීම්:

විස්තරය
gridzyBeforeInitගැලරිය ආරම්භ කිරීමට පෙර ගිනි ගැනීම්.
gridzyInitගැලරිය ආරම්භ කිරීමෙන් පසු ගිනි ගැනීම්.
gridzyBeforeOptionsChangedවිකල්ප සැකසීමට පෙර ගිනි.
gridzyOptionsChangedවිකල්ප සැකසීමෙන් පසු ගිනි.
gridzyBeforeRenderවිදැහුම්කරණයට පෙර ගිනි.
gridzyRenderවිදැහුම්කරණයෙන් පසු ගිනි.
ඔබට මෙහි කිසියම් සිදුවීමක් මග හැරී ඇත්නම්, කරුණාකර සහාය ඉල්ලීමක් එවන්න.

event.target Gridzy බහාලුම් මූලද්‍රව්‍යය සපයයි.
event.detail.instance Gridzy අවස්ථාව සපයයි.

අයිතම මූලද්රව්ය මත වෙඩි තැබූ සිදුවීම්:

විස්තරය
gridzyItemBeforeInitඅයිතමය ආරම්භ කිරීමට පෙර ගිනි.
gridzyItemInitඅයිතමය ආරම්භ කිරීමෙන් පසු ගිනි ගැනීම්.
gridzyItemLoadingඅයිතමය පූරණය වීමට පටන් ගත් විට ගිනි ගනී.
gridzyItemReadyඅයිතමය ජාල ගණනය කිරීම සඳහා සූදානම් වන විට ගිනි ගනී. එබැවින් දර්ශන අනුපාතය දන්නා නමුත් රූපය තවමත් පූරණය විය හැක.
gridzyItemCompleteඅයිතම රූපය සම්පූර්ණයෙන්ම පූරණය වූ විට ගිනි ගනී.
ඔබට මෙහි කිසියම් සිදුවීමක් මග හැරී ඇත්නම්, කරුණාකර සහාය ඉල්ලීමක් එවන්න.

event.target අදාළ අයිතම මූලාංගය සපයයි.
event.detail.instance Gridzy අවස්ථාව සපයයි.

API - ගෝලීය

Gridzy අවස්ථාවන්ගෙන් ස්වාධීන වන සමහර කාර්යයන් ඇත. ඒ නිසා අපි කලින් උදාහරණයක් ලබා ගැනීමට අවශ්ය නැහැ.

පෙරනිමි විකල්පය ලබා ගන්න

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

සියලුම පෙරනිමි විකල්ප ලබා ගන්න

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

පෙරනිමි විකල්ප සකසන්න

මෙය දැනටමත් ආරම්භ කර ඇති සියලුම Gridzy අවස්ථා වල විකල්ප සකසන්නේ නැත, නමුත් නව අවස්ථා සඳහා පදනම නිර්වචනය කරයි. කෙසේ වෙතත්, පවතින අවස්ථාවක විකල්පයක් අගය null හරහා නැවත සකසන්නේ නම්, එය නව පෙරනිමි අගය භාවිතා කරයි.

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

DOM සූදානම් වීමට පෙර ඔබ එය ඇමතුවහොත් ගෝලීය වශයෙන් විකල්ප සැකසීමට ඔබට මෙය භාවිතා කළ හැක. එබැවින් ඔබට තවදුරටත් විකල්ප ගුණාංග ලෙස සැකසීමට අවශ්‍ය නොවනු ඇත.

ස්වයංක්රීයකරණයන්

Gridzy.js 2 හි සියලුම ස්වයංක්‍රීයකරණයන් ක්‍රියාත්මක වන තාක්, පහත ක්‍රම අවශ්‍ය නොවේ. නමුත් වඩාත් සාම්ප්‍රදායික ආකාරයෙන් Gridzy භාවිතා කිරීමට ස්වයංක්‍රීයකරණය ක්‍රියා විරහිත කළ හැක:

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

මෙම විකල්ප වලින් සමහරක් තාර්කික හේතු නිසා data-gridzy- උපකරණ හරහා හෝ setOptions() හරහා සැකසිය නොහැක:

පෙරනිමි අගයවිස්තරය
autoInitOnDomReadytrueපිටු පැටවීමේදී පන්ති gridzy සහිත මූලද්‍රව්‍ය හඳුනාගෙන ඒවා ආරම්භ කරයි.

Gridzy.setDefaultOptions() හරහා සැකසිය හැක
autoInitOnDomMutation
MutationObserver
trueDOM හි දිස් වූ විගස class gridzy සහිත නව මූලද්‍රව්‍ය හඳුනාගෙන ඒවා ආරම්භ කරයි. (උදා: පිටු සංක්‍රාන්ති භාවිතා කිරීමේදී)

Gridzy.setDefaultOptions() හරහා සැකසිය හැක
autoSyncChildListMutation
MutationObserver
trueළමා මූලද්‍රව්‍ය (පින්තූර) එකතු කර හෝ ඉවත් කර ඇත්ද යන්න හඳුනාගෙන, ජාලකය ස්වයංක්‍රීයව යාවත්කාලීන කරයි.

data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() හරහා සැකසිය හැක
useOptionAttributestruedata-gridzy- attributes සාමාන්‍යයෙන් භාවිතා කරන්නේද නැද්ද යන්න නිර්වචනය කරයි. මෙය false නම් විකල්ප සැකසිය හැක්කේ හිමිකාර API හරහා පමණි.

new Gridzy() , setOptions() , Gridzy.setDefaultOptions() හරහා සැකසිය හැක
autoSyncAttributesMutation
MutationObserver
truedata-gridzy- ගුණාංගවල වෙනස්කම් හඳුනාගෙන, ජාලකය ස්වයංක්‍රීයව යාවත්කාලීන කරයි. gridzyAnimated පන්තිය එක් කර හෝ ඉවත් කර තිබේද සහ style ගුණාංග වෙනස් වන්නේද යන්න ද අනාවරණය කරයි. useOptionAttributes false නම්, එය style ගුණාංග වෙනස් කිරීම් පමණක් හඳුනා ගනී.

data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() හරහා සැකසිය හැක
autoSyncChildClassMutation
MutationObserver
trueසියලුම ළමා මූලද්‍රව්‍යවල (රූප) class ගුණාංගවල වෙනස්කම් හඳුනා ගනී. පෙරහන් සම්බන්ධයෙන් අදාළ වේ.

data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() හරහා සැකසිය හැක
autoSyncImageMutation
MutationObserver

2.5.0 අනුවාදයේ සිට
trueසියලුම පින්තූරවල src ගුණාංගවල වෙනස්කම් හඳුනා ගනී. ප්‍රතික්‍රියා හෝ සමාන පුස්තකාල සමඟ භාවිතා කරන විට අදාළ වේ.

data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() හරහා සැකසිය හැක
autoRenderOnResize
ResizeObserver

2.6.0 අනුවාදයේ සිට
trueමූලද්රව්යයේ පළලෙහි වෙනස්කම් හඳුනා ගනී. ප්‍රතිචාරාත්මක නිර්මාණය සම්බන්ධයෙන් අදාළ වේ. (2.6.0 අනුවාදයට පෙර කවුළු ප්‍රමාණය වෙනස් කිරීමේ සිදුවීම් සවන්දෙන්නෙකු භාවිතා කරන ලදී)

data-grizy- , new Gridzy() , setOptions() , Gridzy.setDefaultOptions() හරහා සැකසිය හැක

අතින් ආරම්භ කරන්න

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

උදාහරණය විනාශ කරන්න

දළ වශයෙන් කිවහොත්, Gridzy ආරම්භ කිරීමේ ප්‍රතිවිරුද්ධයයි.

gridzyInstance.destroy();
gridzyInstance = null;

ළමා ලැයිස්තුව හස්තීයව සමමුහුර්ත කරන්න

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

තනි ළමා අංගයක් අතින් සමමුහුර්ත කරන්න

ඉතා දුර්ලභ අවස්ථාවන් හැර, සාමාන්යයෙන් අවශ්ය නොවේ.

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

ගුණාංග අතින් සමමුහුර්ත කරන්න

මේ සඳහා useOptionAttributes විකල්පය true විය යුතු බව සලකන්න.

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

බල විදැහුම්කරණය

සාමාන්‍යයෙන් අවශ්‍ය නොවේ, සියලුම ස්වයංක්‍රීයකරණය අක්‍රිය වුවද

gridzyInstance.render();