Source

Carousel

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

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

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

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

براہ کرم آگاہ رہیں کہ نیسٹڈ 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 class="d-block w-100" src=".../800x400?auto=yes&bg=777&fg=555&text=First slide" alt="First slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=666&fg=444&text=Second slide" alt="Second slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=555&fg=333&text=Third slide" alt="Third slide">
    </div>
  </div>
</div>

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

پچھلے اور اگلے کنٹرولز میں شامل کرنا:

<div id="carouselExampleControls" class="carousel slide" data-ride="carousel">
  <div class="carousel-inner">
    <div class="carousel-item active">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=777&fg=555&text=First slide" alt="First slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=666&fg=444&text=Second slide" alt="Second slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=555&fg=333&text=Third slide" alt="Third slide">
    </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 class="d-block w-100" src=".../800x400?auto=yes&bg=777&fg=555&text=First slide" alt="First slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=666&fg=444&text=Second slide" alt="Second slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=555&fg=333&text=Third slide" alt="Third slide">
    </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 class="d-block w-100" src=".../800x400?auto=yes&bg=777&fg=555&text=First slide" alt="First slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=666&fg=444&text=Second slide" alt="Second slide">
    </div>
    <div class="carousel-item">
      <img class="d-block w-100" src=".../800x400?auto=yes&bg=555&fg=333&text=Third slide" alt="Third slide">
    </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 کی پوزیشن کو آسانی سے کنٹرول کرنے کے لیے ڈیٹا کی خصوصیات کا استعمال کریں۔ data-slideمطلوبہ الفاظ کو قبول کرتا ہے prevیا next، جو سلائیڈ کی پوزیشن کو اس کی موجودہ پوزیشن کے نسبت تبدیل کرتا ہے۔ متبادل طور پر، data-slide-toایک خام سلائیڈ انڈیکس کو carousel میں منتقل کرنے کے لیے استعمال کریں data-slide-to="2"، جو سلائیڈ کی پوزیشن کو ایک خاص انڈیکس میں منتقل کرتا ہے جس سے شروع ہوتا ہے 0۔

انتساب کا data-ride="carousel"استعمال ایک 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