Carousel

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

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

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

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

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

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

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

مثال

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

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

کنٹرولز کے ساتھ

پچھلے اور اگلے کنٹرولز میں شامل کرنا۔ ہم عناصر کے استعمال کی تجویز کرتے <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سلائیڈ کے بجائے فیڈ ٹرانزیشن کے ساتھ سلائیڈوں کو متحرک کرنے کے لیے اپنے کیروسل میں شامل کریں ۔ آپ کے carousel کے مواد پر منحصر ہے (مثال کے طور پر، صرف ٹیکسٹ سلائیڈز)، آپ مناسب کراس فیڈنگ کے لیے 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>

انفرادی `.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>
  <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>

ٹچ سوائپنگ کو غیر فعال کریں۔

Carousels سلائیڈوں کے درمیان منتقل کرنے کے لیے ٹچ اسکرین آلات پر بائیں/دائیں سوائپ کرنے کی حمایت کرتے ہیں۔ 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>

استعمال

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

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

اختیارات

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

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

طریقے

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

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

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

`.carousel(options)`

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

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

`.carousel('cycle')`

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

`.carousel('pause')`

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

`.carousel(number)`

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

`.carousel('prev')`

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

`.carousel('next')`

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

`.carousel('dispose')`

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

`.carousel('nextWhenVisible')`

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

`.carousel('to')`

carousel کو کسی خاص فریم پر چکر لگاتا ہے (0 پر مبنی، ایک صف کی طرح)۔ اگلی آئٹم کے دکھائے جانے سے پہلے کال کرنے والے کے پاس واپس آجاتا ہے (یعنی slid.bs.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)۔