in English

હિંડોળા

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

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

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

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

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

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

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

ઉદાહરણ

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

વર્ગને એક .activeસ્લાઇડ્સમાં ઉમેરવાની જરૂર છે અન્યથા કેરોયુઝલ દેખાશે નહીં. idવૈકલ્પિક નિયંત્રણો માટે પર એક અનન્ય સેટ કરવાનું પણ સુનિશ્ચિત કરો .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>

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

પાછલા અને આગલા નિયંત્રણોમાં ઉમેરી રહ્યા છીએ. અમે તત્વોનો ઉપયોગ કરવાની ભલામણ કરીએ છીએ <button>, પરંતુ તમે <a>સાથે તત્વોનો ઉપયોગ પણ કરી શકો છો role="button".

<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>
 <button class="carousel-control-prev" type="button" data-target="#carouselExampleControls" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-target="#carouselExampleControls" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </button>
</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>
  <button class="carousel-control-prev" type="button" data-target="#carouselExampleIndicators" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-target="#carouselExampleIndicators" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </button>
</div>

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

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

<div id="carouselExampleCaptions" class="carousel slide" data-ride="carousel">
  <ol class="carousel-indicators">
    <li data-target="#carouselExampleCaptions" data-slide-to="0" class="active"></li>
    <li data-target="#carouselExampleCaptions" data-slide-to="1"></li>
    <li data-target="#carouselExampleCaptions" data-slide-to="2"></li>
  </ol>
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>First slide label</h5>
        <p>Some representative placeholder content for the first slide.</p>
      </div>
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>Second slide label</h5>
        <p>Some representative placeholder content for the second slide.</p>
      </div>
    </div>
    <div class="carousel-item">
      <img src="..." class="d-block w-100" alt="...">
      <div class="carousel-caption d-none d-md-block">
        <h5>Third slide label</h5>
        <p>Some representative placeholder content for the third slide.</p>
      </div>
    </div>
  </div>
  <button class="carousel-control-prev" type="button" data-target="#carouselExampleCaptions" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-target="#carouselExampleCaptions" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </button>
</div>

ક્રોસફેડ

.carousel-fadeસ્લાઇડને બદલે ફેડ ટ્રાન્ઝિશન સાથે સ્લાઇડ્સ એનિમેટ કરવા માટે તમારા કેરોયુઝલમાં ઉમેરો . તમારી કેરોયુઝલ સામગ્રી (દા.ત., ફક્ત ટેક્સ્ટ સ્લાઇડ્સ) પર આધાર રાખીને, તમે યોગ્ય ક્રોસફેડિંગ માટે s માં ઉમેરવા .bg-bodyઅથવા કેટલાક કસ્ટમ CSS કરવા માંગો છો..carousel-item

<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>
  <button class="carousel-control-prev" type="button" data-target="#carouselExampleFade" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-target="#carouselExampleFade" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </button>
</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>
  <button class="carousel-control-prev" type="button" data-target="#carouselExampleInterval" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-target="#carouselExampleInterval" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </button>
</div>

ટચ સ્વાઇપિંગને અક્ષમ કરો

કેરોસેલ્સ સ્લાઇડ્સ વચ્ચે ખસેડવા માટે ટચસ્ક્રીન ઉપકરણો પર ડાબે/જમણે સ્વાઇપ કરવાનું સમર્થન કરે છે. આ લક્ષણનો ઉપયોગ કરીને અક્ષમ કરી શકાય data-touchછે. નીચેના ઉદાહરણમાં પણ data-rideવિશેષતા શામેલ નથી અને data-interval="false"તેથી તે ઑટોપ્લે થતું નથી.

<div id="carouselExampleControlsNoTouching" class="carousel slide" data-touch="false" data-interval="false">
  <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>
  <button class="carousel-control-prev" type="button" data-target="#carouselExampleControlsNoTouching" data-slide="prev">
    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </button>
  <button class="carousel-control-next" type="button" data-target="#carouselExampleControlsNoTouching" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </button>
</div>

ઉપયોગ

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

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

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

JavaScript દ્વારા

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

$('.carousel').carousel()

વિકલ્પો

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

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

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

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

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

પદ્ધતિઓ

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

બધી 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')

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

.carousel('nextWhenVisible')

જ્યારે પૃષ્ઠ દૃશ્યમાન ન હોય અથવા કેરોયુઝલ અથવા તેના માતાપિતા દૃશ્યમાન ન હોય ત્યારે કેરોયુઝલને આગળ સાયકલ કરશો નહીં. આગલી આઇટમ બતાવવામાં આવે તે પહેલાં (એટલે ​​કે slid.bs.carouselઘટના બને તે પહેલાં) કૉલર પર પાછા ફરે છે.

.carousel('to')

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

ઘટનાઓ

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

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

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

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

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

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