Source

હિંડોળા

તત્વો દ્વારા સાયકલ ચલાવવા માટેનો સ્લાઇડશો ઘટક—ચિત્રો અથવા ટેક્સ્ટની સ્લાઇડ્સ—જેમ કે કેરોયુઝલ.

તે કેવી રીતે કામ કરે છે

કેરોયુઝલ એ સામગ્રીની શ્રેણી દ્વારા સાયકલ ચલાવવા માટેનો સ્લાઇડશો છે, જે CSS 3D ટ્રાન્સફોર્મ્સ અને થોડી JavaScript સાથે બનેલ છે. તે છબીઓ, ટેક્સ્ટ અથવા કસ્ટમ માર્કઅપની શ્રેણી સાથે કામ કરે છે. તેમાં પાછલા/આગલા નિયંત્રણો અને સૂચકાંકો માટે સપોર્ટ પણ સામેલ છે.

બ્રાઉઝર્સમાં જ્યાં પેજ વિઝિબિલિટી API સપોર્ટેડ છે, જ્યારે વેબપેજ વપરાશકર્તાને દેખાતું ન હોય ત્યારે કેરોયુઝલ સ્લાઇડ કરવાનું ટાળશે (જેમ કે જ્યારે બ્રાઉઝર ટેબ નિષ્ક્રિય હોય, બ્રાઉઝર વિન્ડો નાની હોય, વગેરે).

આ ઘટકની એનિમેશન અસર prefers-reduced-motionમીડિયા ક્વેરી પર આધારિત છે. અમારા ઍક્સેસિબિલિટી દસ્તાવેજીકરણનો ઘટાડો ગતિ વિભાગ જુઓ .

કૃપા કરીને ધ્યાન રાખો કે નેસ્ટેડ કેરોયુસેલ્સ સમર્થિત નથી અને કેરોયુસેલ્સ સામાન્ય રીતે સુલભતા ધોરણોનું પાલન કરતા નથી.

છેલ્લે, જો તમે સ્ત્રોતમાંથી અમારી JavaScript બનાવી રહ્યાં છો, તો તેની જરૂરutil.js છે .

ઉદાહરણ

કેરોયુસેલ્સ સ્લાઇડના પરિમાણોને આપમેળે સામાન્ય બનાવતા નથી. જેમ કે, તમારે સામગ્રીને યોગ્ય રીતે માપવા માટે વધારાની ઉપયોગિતાઓ અથવા કસ્ટમ શૈલીઓનો ઉપયોગ કરવાની જરૂર પડી શકે છે. જ્યારે કેરોયુસેલ્સ અગાઉના/આગલા નિયંત્રણો અને સૂચકાંકોને સમર્થન આપે છે, ત્યારે તે સ્પષ્ટપણે જરૂરી નથી. તમને યોગ્ય લાગે તેમ ઉમેરો અને કસ્ટમાઇઝ કરો.

વર્ગને એક .activeસ્લાઇડ્સમાં ઉમેરવાની જરૂર છે અન્યથા કેરોયુઝલ દેખાશે નહીં. વૈકલ્પિક નિયંત્રણો માટે પર એક અનન્ય આઈડી સેટ કરવાનું પણ સુનિશ્ચિત કરો .carousel, ખાસ કરીને જો તમે એક પૃષ્ઠ પર બહુવિધ કેરોયુઝલનો ઉપયોગ કરી રહ્યાં હોવ. નિયંત્રણ અને સૂચક ઘટકોમાં એક data-targetવિશેષતા (અથવા hrefલિંક્સ માટે) હોવી આવશ્યક છે જે એલિમેન્ટના id સાથે મેળ ખાતી .carouselહોય.

માત્ર સ્લાઇડ્સ

અહીં માત્ર સ્લાઇડ્સ સાથેનું કેરોયુઝલ છે. બ્રાઉઝર ડિફોલ્ટ ઇમેજ ગોઠવણીને રોકવા માટે કેરોયુઝલ ઇમેજ પર .d-blockઅને તેની હાજરીની નોંધ લો ..w-100

<div id="carouselExampleSlidesOnly" class="carousel slide" data-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
        <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
</div>

નિયંત્રણો સાથે

પાછલા અને આગલા નિયંત્રણોમાં ઉમેરવું:

<div id="carouselExampleControls" class="carousel slide" data-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleControls" role="button" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="carousel-control-next" href="#carouselExampleControls" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

સૂચકાંકો સાથે

તમે નિયંત્રણોની સાથે, કેરોયુઝલમાં સૂચકાંકો પણ ઉમેરી શકો છો.

<div id="carouselExampleIndicators" class="carousel slide" data-ride="carousel">
  <ol class="carousel-indicators">
    <li data-target="#carouselExampleIndicators" data-slide-to="0" class="active"></li>
    <li data-target="#carouselExampleIndicators" data-slide-to="1"></li>
    <li data-target="#carouselExampleIndicators" data-slide-to="2"></li>
  </ol>
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleIndicators" role="button" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="carousel-control-next" href="#carouselExampleIndicators" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

કૅપ્શન્સ સાથે

.carousel-captionકોઈપણ ની અંદર તત્વ સાથે સરળતાથી તમારી સ્લાઇડ્સમાં કૅપ્શન્સ ઉમેરો .carousel-item. તેઓ વૈકલ્પિક પ્રદર્શન ઉપયોગિતાઓ સાથે, નીચે બતાવ્યા પ્રમાણે, નાના વ્યુપોર્ટ્સ પર સરળતાથી છુપાવી શકાય છે . અમે તેમને શરૂઆતમાં છુપાવીએ છીએ .d-noneઅને સાથે મધ્યમ કદના ઉપકરણો પર પાછા લાવીએ છીએ .d-md-block.

<div class="carousel-item">
  <img src="..." alt="...">
  <div class="carousel-caption d-none d-md-block">
    <h5>...</h5>
    <p>...</p>
  </div>
</div>

ક્રોસફેડ

.carousel-fadeસ્લાઇડને બદલે ફેડ ટ્રાન્ઝિશન સાથે સ્લાઇડ્સને એનિમેટ કરવા માટે તમારા કેરોયુઝલમાં ઉમેરો .

<div id="carouselExampleFade" class="carousel slide carousel-fade" data-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleFade" role="button" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="carousel-control-next" href="#carouselExampleFade" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

આગલી આઇટમ પર આપમેળે સાયકલ ચલાવવાની વચ્ચે વિલંબ થવાનો સમય બદલવા data-interval=""માટે a માં ઉમેરો ..carousel-item

<div id="carouselExampleInterval" class="carousel slide" data-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active" data-interval="10000">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item" data-interval="2000">
      <img src="..." class="d-block w-100" alt="...">
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleInterval" role="button" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="carousel-control-next" href="#carouselExampleInterval" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

ઉપયોગ

ડેટા લક્ષણો દ્વારા

કેરોયુઝલની સ્થિતિને સરળતાથી નિયંત્રિત કરવા માટે ડેટા વિશેષતાઓનો ઉપયોગ કરો. data-slideકીવર્ડ્સ સ્વીકારે છે prevઅથવા next, જે સ્લાઇડની સ્થિતિને તેની વર્તમાન સ્થિતિની તુલનામાં બદલે છે. વૈકલ્પિક રીતે, data-slide-toકાચી સ્લાઇડ અનુક્રમણિકાને કેરોયુઝલમાં પસાર કરવા માટે ઉપયોગ કરો data-slide-to="2", જે સ્લાઇડની સ્થિતિને ની સાથે શરૂ થતા ચોક્કસ અનુક્રમણિકામાં શિફ્ટ કરે છે 0.

data-ride="carousel"એટ્રિબ્યુટનો ઉપયોગ કેરોયુઝલને પૃષ્ઠ લોડથી શરૂ કરીને એનિમેટિંગ તરીકે ચિહ્નિત કરવા માટે થાય છે . તેનો ઉપયોગ સમાન કેરોયુઝલના (અનર્થક અને બિનજરૂરી) સ્પષ્ટ JavaScript આરંભ સાથે સંયોજનમાં કરી શકાતો નથી.

જાવાસ્ક્રિપ્ટ દ્વારા

કેરોયુઝલને મેન્યુઅલી આની સાથે કૉલ કરો:

$('.carousel').carousel()

વિકલ્પો

વિકલ્પો ડેટા વિશેષતાઓ અથવા JavaScript દ્વારા પસાર કરી શકાય છે. ડેટા એટ્રિબ્યુટ્સ માટે, વિકલ્પ નામને data-, જેમ કે માં ઉમેરો data-interval="".

નામ પ્રકાર ડિફૉલ્ટ વર્ણન
અંતરાલ સંખ્યા 5000 આઇટમને આપમેળે સાયકલ ચલાવવામાં વિલંબ થવાનો સમય. જો ખોટુ હોય, તો કેરોયુઝલ આપમેળે ચક્રમાં આવશે નહીં.
કીબોર્ડ બુલિયન સાચું કેરોયુઝલ કીબોર્ડ ઇવેન્ટ્સ પર પ્રતિક્રિયા આપવી જોઈએ કે કેમ.
વિરામ શબ્દમાળા | બુલિયન "હોવર"

જો પર સેટ કરેલ હોય "hover", તો કેરોયુઝલની સાયકલિંગ ચાલુને થોભાવે છે અને કેરોયુઝલની mouseenterસાયકલ ચાલુ કરવાનું ફરી શરૂ કરે છે mouseleave. જો પર સેટ કરેલ હોય false, તો કેરોયુઝલ પર હોવર કરવાથી તે થોભાવશે નહીં.

ટચ-સક્ષમ ઉપકરણો પર, જ્યારે પર સેટ કરેલ હોય, ત્યારે "hover"સાયકલિંગ touchendઆપમેળે ફરી શરૂ થતાં પહેલાં બે અંતરાલ માટે (એકવાર વપરાશકર્તા કેરોયુઝલ સાથે ક્રિયાપ્રતિક્રિયા કરવાનું સમાપ્ત કરી લે) થોભાવશે. નોંધ કરો કે આ ઉપરોક્ત માઉસ વર્તન ઉપરાંત છે.

રાઇડ તાર ખોટું વપરાશકર્તા પ્રથમ આઇટમને મેન્યુઅલી સાયકલ કરે તે પછી કેરોયુઝલ ઑટોપ્લે કરે છે. જો "કેરોયુઝલ", લોડ પર કેરોયુઝલ ઑટોપ્લે કરે છે.
લપેટી બુલિયન સાચું કેરોયુઝલ સતત સાયકલ ચલાવવું જોઈએ કે સખત સ્ટોપ હોવું જોઈએ.
સ્પર્શ બુલિયન સાચું કેરોયુઝલને ટચસ્ક્રીન ઉપકરણો પર ડાબે/જમણે સ્વાઇપ ક્રિયાપ્રતિક્રિયાઓને સમર્થન આપવું જોઈએ કે કેમ.

પદ્ધતિઓ

અસુમેળ પદ્ધતિઓ અને સંક્રમણો

બધી API પદ્ધતિઓ અસુમેળ છે અને સંક્રમણ શરૂ કરે છે . સંક્રમણ શરૂ થતાંની સાથે જ તેઓ કૉલર પાસે પાછા ફરે છે પરંતુ તે સમાપ્ત થાય તે પહેલાં . વધુમાં, સંક્રમણ ઘટક પર પદ્ધતિ કૉલ અવગણવામાં આવશે .

વધુ માહિતી માટે અમારા JavaScript દસ્તાવેજીકરણ જુઓ .

.carousel(options)

વૈકલ્પિક વિકલ્પો સાથે કેરોયુઝલની શરૂઆત કરે છે objectઅને વસ્તુઓ દ્વારા સાયકલ ચલાવવાનું શરૂ કરે છે.

$('.carousel').carousel({
  interval: 2000
})

.carousel('cycle')

કેરોયુઝલ આઇટમ દ્વારા ડાબેથી જમણે સાયકલ કરો.

.carousel('pause')

કેરોયુઝલને વસ્તુઓ દ્વારા સાયકલ ચલાવવાથી રોકે છે.

.carousel(number)

કેરોયુઝલને ચોક્કસ ફ્રેમ પર સાયકલ કરે છે (0 આધારિત, એરેની જેમ). લક્ષ્ય આઇટમ બતાવવામાં આવે તે પહેલાં (એટલે ​​કે slid.bs.carouselઘટના બને તે પહેલાં) કૉલર પર પાછા ફરે છે.

.carousel('prev')

પાછલી આઇટમ પર ચક્ર. પાછલી આઇટમ બતાવવામાં આવે તે પહેલાં કૉલર પર પાછા ફરે છે (એટલે ​​કે slid.bs.carouselઇવેન્ટ થાય તે પહેલાં).

.carousel('next')

આગલી આઇટમ પર સાયકલ. આગલી આઇટમ બતાવવામાં આવે તે પહેલાં (એટલે ​​કે slid.bs.carouselઘટના બને તે પહેલાં) કૉલર પર પાછા ફરે છે.

.carousel('dispose')

તત્વના કેરોયુઝલનો નાશ કરે છે.

ઘટનાઓ

બુટસ્ટ્રેપનો કેરોયુઝલ વર્ગ કેરોયુઝલ કાર્યક્ષમતામાં હૂક કરવા માટે બે ઘટનાઓને ઉજાગર કરે છે. બંને ઇવેન્ટ્સમાં નીચેના વધારાના ગુણધર્મો છે:

  • direction: કેરોયુઝલ જે દિશામાં સરકતું હોય તે દિશામાં (ક્યાં તો "left"અથવા "right").
  • relatedTarget: DOM ઘટક કે જે સક્રિય આઇટમ તરીકે સ્થાને સરકવામાં આવી રહ્યું છે.
  • from: વર્તમાન આઇટમની અનુક્રમણિકા
  • to: આગલી આઇટમની અનુક્રમણિકા

તમામ કેરોયુઝલ ઇવેન્ટ્સ કેરોયુઝલ પર જ ફાયર કરવામાં આવે છે (એટલે ​​​​કે <div class="carousel">).

ઇવેન્ટનો પ્રકાર વર્ણન
slide.bs.carousel slideજ્યારે ઇન્સ્ટન્સ પદ્ધતિનો ઉપયોગ કરવામાં આવે ત્યારે આ ઇવેન્ટ તરત જ ફાયર થાય છે.
slid.bs.carousel જ્યારે કેરોયુઝલ તેનું સ્લાઇડ સંક્રમણ પૂર્ણ કરે છે ત્યારે આ ઇવેન્ટને ફાયર કરવામાં આવે છે.
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

સંક્રમણ અવધિ બદલો

જો તમે સંકલિત CSS નો ઉપયોગ કરી રહ્યાં હોવ તો સંકલન કરતા પહેલા અથવા કસ્ટમ શૈલીઓ સાથે સંક્રમણ અવધિને Sass વેરીએબલ .carousel-itemસાથે બદલી શકાય છે. $carousel-transitionજો બહુવિધ સંક્રમણો લાગુ કરવામાં આવ્યા હોય, તો ખાતરી કરો કે રૂપાંતરણ સંક્રમણ પહેલા વ્યાખ્યાયિત થયેલ છે (દા.ત. transition: transform 2s ease, opacity .5s ease-out).