Carousel

عناصر کے ذریعے سائیکل چلانے کے لیے سلائیڈ شو کا جزو—تصاویر یا متن کی سلائیڈ—جیسے ایک carousel۔

یہ کیسے کام کرتا ہے

carousel مواد کی ایک سیریز کے ذریعے سائیکل چلانے کے لیے ایک سلائیڈ شو ہے، جسے CSS 3D ٹرانسفارمز اور تھوڑا سا JavaScript کے ساتھ بنایا گیا ہے۔ یہ تصاویر، متن، یا حسب ضرورت مارک اپ کی ایک سیریز کے ساتھ کام کرتا ہے۔ اس میں پچھلے/اگلے کنٹرولز اور اشارے کے لیے سپورٹ بھی شامل ہے۔

براؤزرز میں جہاں Page Visibility API کو سپورٹ کیا جاتا ہے، carousel اس وقت سلائیڈنگ سے گریز کرے گا جب ویب صفحہ صارف کو نظر نہیں آتا ہے (جیسے جب براؤزر ٹیب غیر فعال ہو، براؤزر ونڈو کو چھوٹا کر دیا جائے، وغیرہ)۔

prefers-reduced-motionاس جزو کا اینیمیشن اثر میڈیا کے استفسار پر منحصر ہے ۔ ہماری ایکسیسبیلٹی دستاویزات کا کم موشن سیکشن دیکھیں ۔

براہ کرم آگاہ رہیں کہ نیسٹڈ carousels تعاون یافتہ نہیں ہیں، اور carousels عام طور پر رسائی کے معیارات کے مطابق نہیں ہیں۔

آخر میں، اگر آپ ہمارا جاوا اسکرپٹ ماخذ سے بنا رہے ہیں، تو اس کی ضرورت ہےutil.js ۔

مثال

Carousels خود بخود سلائیڈ کے طول و عرض کو معمول پر نہیں لاتے ہیں۔ اس طرح، آپ کو مواد کو مناسب سائز دینے کے لیے اضافی یوٹیلیٹیز یا حسب ضرورت اسٹائل استعمال کرنے کی ضرورت پڑ سکتی ہے۔ جبکہ carousels پچھلے/اگلے کنٹرولز اور اشارے کو سپورٹ کرتے ہیں، لیکن ان کی واضح طور پر ضرورت نہیں ہے۔ شامل کریں اور اپنی مرضی کے مطابق بنائیں جیسا کہ آپ مناسب دیکھیں۔

.activeکلاس کو کسی ایک سلائیڈ میں شامل کرنے کی ضرورت ہے بصورت دیگر carousel نظر نہیں آئے گا۔ اختیاری کنٹرولز کے لیے پر ایک منفرد آئی ڈی سیٹ کرنا بھی یقینی بنائیں .carousel، خاص طور پر اگر آپ ایک صفحے پر متعدد carousels استعمال کر رہے ہیں۔ کنٹرول اور اشارے کے عناصر میں ایک data-targetخاصیت (یا hrefلنکس کے لیے) ہونی چاہیے جو .carouselعنصر کی شناخت سے مماثل ہو۔

صرف سلائیڈز

یہاں صرف سلائیڈز کے ساتھ ایک carousel ہے۔ براؤزر کی ڈیفالٹ امیج الائنمنٹ کو روکنے کے لیے 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۔

پہلا سلائیڈ لیبل

Nulla vitae elit libero، a pharetra augue mollis interdum.

دوسری سلائیڈ لیبل

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

تیسری سلائیڈ لیبل

Praesent commodo cursus magna, vel scelerisque nisl consectetur.

<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>Nulla vitae elit libero, a pharetra augue mollis interdum.</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>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</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>Praesent commodo cursus magna, vel scelerisque nisl consectetur.</p>
      </div>
    </div>
  </div>
  <a class="carousel-control-prev" href="#carouselExampleCaptions" 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="#carouselExampleCaptions" role="button" data-slide="next">
    <span class="carousel-control-next-icon" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</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>

انفرادی `.carousel-item`وقفہ

اگلی آئٹم تک خود بخود سائیکل چلانے کے درمیان تاخیر کے لیے وقت کی مقدار کو تبدیل کرنے کے لیے 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>

استعمال

ڈیٹا اوصاف کے ذریعے

carousel کی پوزیشن کو آسانی سے کنٹرول کرنے کے لیے ڈیٹا کی خصوصیات کا استعمال کریں۔ data-slideمطلوبہ الفاظ کو قبول کرتا ہے prevیا next، جو سلائیڈ کی پوزیشن کو اس کی موجودہ پوزیشن کے نسبت تبدیل کرتا ہے۔ متبادل طور پر، data-slide-toایک خام سلائیڈ انڈیکس کو carousel میں منتقل کرنے کے لیے استعمال کریں data-slide-to="2"، جو سلائیڈ کی پوزیشن کو ایک خاص انڈیکس میں منتقل کرتا ہے جس سے شروع ہوتا ہے 0۔

انتساب کا data-ride="carousel"استعمال ایک carousel کو صفحہ لوڈ سے شروع ہونے والے متحرک کے بطور نشان زد کرنے کے لیے کیا جاتا ہے۔ اگر آپ اپنے carousel کو شروع کرنے کے لیے استعمال نہیں کرتے ہیں data-ride="carousel"، تو آپ کو اسے خود شروع کرنا ہوگا۔ اسے ایک ہی carousel کے (فالتو اور غیر ضروری) واضح JavaScript ابتدا کے ساتھ استعمال نہیں کیا جا سکتا۔

جاوا اسکرپٹ کے ذریعے

carousel کو دستی طور پر اس کے ساتھ کال کریں:

$('.carousel').carousel()

اختیارات

اختیارات کو ڈیٹا انتساب یا JavaScript کے ذریعے منتقل کیا جا سکتا ہے۔ ڈیٹا کی خصوصیات کے لیے، آپشن کا نام شامل کریں data-، جیسا کہ میں data-interval=""۔

نام	قسم	طے شدہ	تفصیل
وقفہ	نمبر	5000	کسی آئٹم کو خودکار طور پر سائیکل کرنے کے درمیان تاخیر کا وقت۔ غلط ہونے پر، carousel خود بخود سائیکل نہیں آئے گا۔
کی بورڈ	بولین	سچ ہے	آیا کیروسل کو کی بورڈ ایونٹس پر رد عمل ظاہر کرنا چاہیے۔
توقف	تار \| بولین	"ہوور"	پر سیٹ ہونے پر `"hover"`، کیروسل کی سائیکلنگ کو موقوف کرتا ہے اور آن `mouseenter`کیروسل کی سائیکلنگ کو دوبارہ شروع کرتا ہے `mouseleave`۔ پر سیٹ ہونے پر `false`، کیروسل پر منڈلانے سے یہ موقوف نہیں ہوگا۔ ٹچ سے چلنے والے آلات پر، پر سیٹ ہونے پر `"hover"`، سائیکلنگ `touchend`خود بخود دوبارہ شروع ہونے سے پہلے، دو وقفوں کے لیے (ایک بار جب صارف کیروسل کے ساتھ تعامل مکمل کر لیتا ہے) پر رک جائے گی۔ نوٹ کریں کہ یہ اوپر والے ماؤس کے رویے کے علاوہ ہے۔
سواری	تار	جھوٹا	صارف کی طرف سے پہلے آئٹم کو دستی طور پر سائیکل کرنے کے بعد carousel کو آٹو پلے کرتا ہے۔ اگر "کیروسل"، لوڈ ہونے پر carousel کو آٹو پلے کرتا ہے۔
لپیٹ	بولین	سچ ہے	آیا کیروسل کو مسلسل سائیکل چلانا چاہیے یا سخت رک جانا چاہیے۔
چھو	بولین	سچ ہے	آیا کیروسل کو ٹچ اسکرین آلات پر بائیں/دائیں سوائپ کے تعاملات کو سپورٹ کرنا چاہیے۔

طریقے

غیر مطابقت پذیر طریقے اور ٹرانزیشن

تمام API طریقے غیر مطابقت پذیر ہیں اور ایک منتقلی شروع کرتے ہیں ۔ منتقلی شروع ہوتے ہی وہ کال کرنے والے کے پاس واپس آ جاتے ہیں لیکن اس کے ختم ہونے سے پہلے ۔ اس کے علاوہ، منتقلی کے جزو پر میتھڈ کال کو نظر انداز کر دیا جائے گا ۔

مزید معلومات کے لیے ہماری جاوا اسکرپٹ دستاویزات دیکھیں ۔

`.carousel(options)`

ایک اختیاری اختیارات کے ساتھ carousel objectکو شروع کرتا ہے اور آئٹمز کے ذریعے سائیکل چلانا شروع کرتا ہے۔

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

`.carousel('cycle')`

بائیں سے دائیں تک carousel آئٹمز کے ذریعے سائیکل۔

`.carousel('pause')`

carousel کو آئٹمز کے ذریعے سائیکل چلانے سے روکتا ہے۔

`.carousel(number)`

carousel کو کسی خاص فریم پر چکر لگاتا ہے (0 پر مبنی، ایک صف کی طرح)۔ ٹارگٹ آئٹم کے دکھائے جانے سے پہلے کال کرنے والے کے پاس واپس آجاتا ہے (یعنی slid.bs.carouselواقعہ پیش آنے سے پہلے)۔

`.carousel('prev')`

پچھلی آئٹم پر سائیکل۔ پچھلی آئٹم کے دکھائے جانے سے پہلے کال کرنے والے کے پاس واپس آجاتا ہے (یعنی slid.bs.carouselواقعہ پیش آنے سے پہلے)۔

`.carousel('next')`

اگلی آئٹم پر سائیکل۔ اگلی آئٹم کے دکھائے جانے سے پہلے کال کرنے والے کے پاس واپس آجاتا ہے (یعنی slid.bs.carouselواقعہ پیش آنے سے پہلے)۔

`.carousel('dispose')`

ایک عنصر کے carousel کو تباہ کرتا ہے۔

تقریبات

بوٹسٹریپ کی carousel کلاس carousel کی فعالیت میں جڑنے کے لیے دو واقعات کو بے نقاب کرتی ہے۔ دونوں واقعات میں درج ذیل اضافی خصوصیات ہیں:

direction: وہ سمت جس میں carousel پھسل رہا ہے (یا تو "left"یا "right")۔
relatedTarget: DOM عنصر جس کو ایکٹو آئٹم کے طور پر جگہ پر سلائیڈ کیا جا رہا ہے۔
from: موجودہ آئٹم کا اشاریہ
to: اگلی آئٹم کا اشاریہ

تمام carousel واقعات carousel پر ہی فائر کیے جاتے ہیں (یعنی at the <div class="carousel">).

واقعہ کی قسم	تفصیل
slide.bs.carousel	یہ واقعہ فوری طور پر فائر ہو جاتا ہے جب `slide`مثال کا طریقہ استعمال کیا جاتا ہے۔
slid.bs.carousel	یہ ایونٹ اس وقت شروع ہوتا ہے جب carousel اپنی سلائیڈ کی منتقلی مکمل کر لیتا ہے۔

$('#myCarousel').on('slide.bs.carousel', function () {
  // do something...
})

منتقلی کا دورانیہ تبدیل کریں۔

اگر آپ مرتب کردہ سی ایس ایس استعمال کر رہے ہیں تو مرتب کرنے سے پہلے یا اپنی مرضی کے انداز کے ساتھ منتقلی کا دورانیہ ساس متغیر .carousel-itemکے ساتھ تبدیل کیا جا سکتا ہے ۔ $carousel-transitionاگر متعدد ٹرانزیشن لاگو ہوتے ہیں، تو یقینی بنائیں کہ ٹرانسفارم ٹرانزیشن پہلے بیان کی گئی ہے (مثال کے طور پر transition: transform 2s ease, opacity .5s ease-out)۔