רכיב מצגת לרכיבה על אופניים בין אלמנטים - תמונות או שקופיות של טקסט - כמו קרוסלה.
איך זה עובד
הקרוסלה היא מצגת לרכיבה על אופניים דרך סדרת תוכן, הבנויה עם טרנספורמציות תלת-ממדיות של CSS ומעט JavaScript. זה עובד עם סדרה של תמונות, טקסט או סימון מותאם אישית. זה כולל גם תמיכה בפקדים ומחוונים קודמים/הבאים.
בדפדפנים שבהם נתמך ה-Page Visibility API , הקרוסלה תמנע החלקה כאשר דף האינטרנט אינו גלוי למשתמש (כגון כאשר לשונית הדפדפן אינה פעילה, חלון הדפדפן ממוזער וכו').
לידיעתך, קרוסלות מקוננות אינן נתמכות, וקרוסלות בדרך כלל אינן תואמות לתקני נגישות.
לבסוף, אם אתה בונה את JavaScript שלנו מהמקור, זה דורשutil.js .
דוגמא
קרוסלות אינן מנרמלות אוטומטית את מידות השקופיות. ככזה, ייתכן שתצטרך להשתמש בכלי עזר נוספים או בסגנונות מותאמים אישית כדי להתאים את גודל התוכן. אמנם קרוסלות תומכות בפקדים ובאינדיקטורים קודמים/הבאים, אך הם אינם נדרשים במפורש. הוסף והתאם אישית כראות עיניך.
.activeיש להוסיף את הכיתה לאחת השקופיות אחרת הקרוסלה לא תהיה גלויה. הקפד גם להגדיר מזהה ייחודי .carouselעבור פקדים אופציונליים, במיוחד אם אתה משתמש במספר קרוסלות בעמוד בודד. רכיבי בקרה ומחוון חייבים להיות בעלי data-targetתכונה (או hrefעבור קישורים) התואמת את המזהה של .carouselהאלמנט.
שקופיות בלבד
הנה קרוסלה עם שקופיות בלבד. שימו לב לנוכחות של תמונות קרוסלה .d-blockובעל .w-100כדי למנוע יישור תמונות ברירת המחדל של הדפדפן.
הוסף כיתובים לשקופיות שלך בקלות עם .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.
השתמש בתכונות נתונים כדי לשלוט בקלות במיקום הקרוסלה. data-slideמקבל את מילות המפתח prevאו next, אשר משנה את מיקום השקף ביחס למיקומו הנוכחי. לחלופין, השתמש data-slide-toכדי להעביר אינדקס שקופיות גולמי לקרוסלה data-slide-to="2", מה שמעביר את מיקום השקופית לאינדקס מסוים שמתחיל ב- 0.
התכונה data-ride="carousel"משמשת לסימון קרוסלה כהנפשה החל מטעינת העמוד. אם אינך משתמש data-ride="carousel"באתחול הקרוסלה שלך, עליך לאתחל אותה בעצמך. לא ניתן להשתמש בו בשילוב עם אתחול JavaScript מפורש (מיותר ומיותר) של אותה קרוסלה.
דרך JavaScript
התקשר לקרוסלה באופן ידני עם:
אפשרויות
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-interval="".
שֵׁם
סוּג
בְּרִירַת מֶחדָל
תיאור
הַפסָקָה
מספר
5000
משך הזמן שיש לעכב בין רכיבה אוטומטית של פריט. אם לא נכון, הקרוסלה לא תעבור אוטומטית.
מקלדת
בוליאני
נָכוֹן
האם הקרוסלה צריכה להגיב לאירועי מקלדת.
הַפסָקָה
מחרוזת | בוליאני
"לְרַחֵף"
אם מוגדר ל- "hover", משהה את רכיבת הקרוסלה פועלת mouseenterומחדש את הרכיבה על הקרוסלה mouseleave. אם מוגדר ל- false, ריחוף מעל הקרוסלה לא ישהה אותה.
במכשירים התומכים במגע, כאשר מוגדר ל- "hover", הרכיבה על אופניים תושהה touchend(ברגע שהמשתמש יסיים את האינטראקציה עם הקרוסלה) למשך שני מרווחים, לפני שתתחדש אוטומטית. שימו לב שזה בנוסף להתנהגות העכבר לעיל.
נסיעה
חוּט
שֶׁקֶר
הפעלה אוטומטית של הקרוסלה לאחר שהמשתמש עובר ידנית על הפריט הראשון. אם "קרוסלה", מפעיל אוטומטית את הקרוסלה בטעינה.
לַעֲטוֹף
בוליאני
נָכוֹן
האם הקרוסלה צריכה להסתובב ברציפות או שתהיה לה עצירות קשות.
לגעת
בוליאני
נָכוֹן
האם הקרוסלה צריכה לתמוך באינטראקציות החלקה שמאלה/ימינה במכשירי מסך מגע.
שיטות
שיטות ומעברים אסינכרוניים
כל שיטות ה-API הן אסינכרוניות ומתחילות מעבר . הם חוזרים למתקשר ברגע שהמעבר מתחיל אבל לפני שהוא מסתיים . בנוסף, תתעלם מקריאת שיטה על רכיב מעבר .
כל אירועי הקרוסלה נורים לעבר הקרוסלה עצמה (כלומר לעבר ה- <div class="carousel">).
סוג אירוע
תיאור
מגלשת.bs.קרוסלה
אירוע זה מופעל מיד כאשר slideשיטת המופע מופעלת.
slid.bs.carousel
אירוע זה מופעל כאשר הקרוסלה השלימה את מעבר השקופיות שלה.
שנה את משך המעבר
.carousel-itemניתן לשנות את משך המעבר של עם $carousel-transitionהמשתנה Sass לפני הידור או סגנונות מותאמים אישית אם אתה משתמש ב-CSS המהודר. אם מוחלים מעברים מרובים, ודא שמעבר ההמרה מוגדר תחילה (למשל transition: transform 2s ease, opacity .5s ease-out).