კარუსელი
სლაიდშოუს კომპონენტი ელემენტების - სურათების ან ტექსტის სლაიდების ველოსიპედით გადასაადგილებლად, კარუსელის მსგავსად.
კარუსელი არის სლაიდშოუ ველოსიპედით გადასაადგილებლად კონტენტის სერიის მეშვეობით, აგებულია CSS 3D ტრანსფორმაციებით და ცოტა JavaScript-ით. ის მუშაობს სურათების, ტექსტის ან მორგებული მარკირების სერიით. იგი ასევე მოიცავს წინა/შემდეგი კონტროლისა და ინდიკატორების მხარდაჭერას.
ბრაუზერებში, სადაც გვერდის ხილვადობის API არის მხარდაჭერილი, კარუსელი თავიდან აიცილებს სრიალს, როდესაც ვებგვერდი მომხმარებლისთვის არ ჩანს (მაგალითად, როდესაც ბრაუზერის ჩანართი არააქტიურია, ბრაუზერის ფანჯარა მინიმუმამდეა დაყვანილი და ა.შ.).
გთხოვთ, გაითვალისწინოთ, რომ ჩასმული კარუსელები არ არის მხარდაჭერილი და კარუსელები, როგორც წესი, არ შეესაბამება ხელმისაწვდომობის სტანდარტებს.
და ბოლოს, თუ თქვენ აშენებთ ჩვენს JavaScript-ს წყაროდან, ის მოითხოვსutil.js
.
კარუსელები ავტომატურად არ ახდენს სლაიდების ზომების ნორმალიზებას. როგორც ასეთი, შეიძლება დაგჭირდეთ დამატებითი უტილიტების ან მორგებული სტილის გამოყენება შინაარსის შესაბამისი ზომისთვის. მიუხედავად იმისა, რომ კარუსელები მხარს უჭერენ წინა/შემდეგ კონტროლს და ინდიკატორებს, ისინი აშკარად არ არის საჭირო. დაამატეთ და შეცვალეთ თქვენი შეხედულებისამებრ.
.active
კლასი უნდა დაემატოს ერთ-ერთ სლაიდს, წინააღმდეგ შემთხვევაში კარუსელი არ გამოჩნდება. ასევე, დარწმუნდით, რომ დააყენეთ უნიკალური id-ზე .carousel
არჩევითი კონტროლისთვის, განსაკუთრებით თუ იყენებთ რამდენიმე კარუსელს ერთ გვერდზე. საკონტროლო და ინდიკატორი ელემენტებს უნდა ჰქონდეს data-target
ატრიბუტი (ან href
ბმულებისთვის), რომელიც ემთხვევა .carousel
ელემენტის id-ს.
აქ არის კარუსელი მხოლოდ სლაიდებით. გაითვალისწინეთ კარუსელის სურათების არსებობა .d-block
და .w-100
ბრაუზერის ნაგულისხმევი სურათების გასწორების თავიდან ასაცილებლად.
წინა და შემდეგი კონტროლის დამატება:
თქვენ ასევე შეგიძლიათ დაამატოთ ინდიკატორები კარუსელში, კონტროლერებთან ერთად.
დაამატეთ სუბტიტრები თქვენს სლაიდებს მარტივად .carousel-caption
ნებისმიერი ელემენტის ფარგლებში .carousel-item
. მათი ადვილად დამალვა შესაძლებელია მცირე ხედის პორტებზე, როგორც ეს ნაჩვენებია ქვემოთ, არჩევითი დისპლეის კომუნალური საშუალებებით . ჩვენ მათ თავდაპირველად ვმალავთ .d-none
და ვაბრუნებთ საშუალო ზომის მოწყობილობებზე .d-md-block
.
დაამატეთ .carousel-fade
თქვენს კარუსელში სლაიდების ანიმაციისთვის სლაიდის ნაცვლად გაცვეთილი გადასვლით.
გამოიყენეთ მონაცემთა ატრიბუტები კარუსელის პოზიციის მარტივად გასაკონტროლებლად. data-slide
იღებს საკვანძო სიტყვებს prev
ან next
, რომელიც ცვლის სლაიდის პოზიციას მის ამჟამინდელ პოზიციასთან შედარებით. ალტერნატიულად, გამოიყენეთ data-slide-to
ნედლი სლაიდის ინდექსის კარუსელში გადასაცემად data-slide-to="2"
, რომელიც ცვლის სლაიდის პოზიციას კონკრეტულ ინდექსზე დაწყებული 0
.
ატრიბუტი გამოიყენება კარუსელის აღსანიშნავად data-ride="carousel"
, როგორც ანიმაციური გვერდის ჩატვირთვისას. მისი გამოყენება შეუძლებელია იმავე კარუსელის (ზედმეტად და არასაჭირო) აშკარა JavaScript ინიციალიზაციასთან ერთად.
კარუსელის ხელით გამოძახება:
ოფციების გადაცემა შესაძლებელია მონაცემთა ატრიბუტების ან JavaScript-ის საშუალებით. მონაცემთა ატრიბუტებისთვის, დაამატეთ ვარიანტის სახელი data-
, როგორც data-interval=""
.
სახელი | ტიპი | ნაგულისხმევი | აღწერა |
---|---|---|---|
ინტერვალი | ნომერი | 5000 | დრო, რომელიც დაგვიანებულია ნივთის ავტომატურ ველოსიპედს შორის. თუ არასწორია, კარუსელი ავტომატურად არ დატრიალდება. |
კლავიატურა | ლოგიკური | მართალია | უნდა რეაგირებდეს თუ არა კარუსელი კლავიატურის მოვლენებზე. |
პაუზა | სიმებიანი | ლოგიკური | "ჰოვერ" | თუ დაყენებულია შეხებით ჩართულ მოწყობილობებზე, როდესაც დაყენებულია ველზე |
გასეირნება | სიმებიანი | ყალბი | ავტომატურად უკრავს კარუსელს მას შემდეგ, რაც მომხმარებელი ხელით გადააბრუნებს პირველ ელემენტს. თუ "კარუსელი", ავტომატურად უკრავს კარუსელს ჩატვირთვისას. |
გადახვევა | ლოგიკური | მართალია | უნდა მოძრაობდეს თუ არა კარუსელი განუწყვეტლივ თუ რთული გაჩერებები. |
ასინქრონული მეთოდები და გადასვლები
ყველა API მეთოდი ასინქრონულია და იწყებს გადასვლას . ისინი უბრუნდებიან აბონენტს გადასვლის დაწყებისთანავე, მაგრამ მის დასრულებამდე . გარდა ამისა, მეთოდის გამოძახება გარდამავალ კომპონენტზე იგნორირებული იქნება .
დამატებითი ინფორმაციისთვის იხილეთ ჩვენი JavaScript დოკუმენტაცია.
ახორციელებს კარუსელის ინიციალიზაციას არჩევითი ოფციებით object
და იწყებს ველოსიპედით სვლას ნივთებზე.
მოძრაობს კარუსელის ელემენტებში მარცხნიდან მარჯვნივ.
აჩერებს კარუსელს ნივთების ველოსიპედით გადაადგილებას.
აბრუნებს კარუსელს კონკრეტულ ჩარჩოზე (0-ზე დაფუძნებული, მასივის მსგავსი). უბრუნდება აბონენტს სამიზნე ნივთის ჩვენებამდე (ანუ slid.bs.carousel
მოვლენის დადგომამდე).
ციკლები წინა პუნქტამდე. უბრუნდება აბონენტს წინა ელემენტის ჩვენებამდე (ანუ slid.bs.carousel
მოვლენის დადგომამდე).
ციკლები შემდეგ პუნქტზე. უბრუნდება აბონენტს შემდეგი ელემენტის ჩვენებამდე (ანუ slid.bs.carousel
მოვლენის დადგომამდე).
ანადგურებს ელემენტის კარუსელს.
Bootstrap-ის კარუსელის კლასი ავლენს ორ მოვლენას კარუსელის ფუნქციონალებში ჩასართავად. ორივე მოვლენას აქვს შემდეგი დამატებითი თვისებები:
direction
: მიმართულება, რომლითაც სრიალებს კარუსელი (ან"left"
ან"right"
).relatedTarget
: DOM ელემენტი, რომელიც სრიალდება ადგილზე, როგორც აქტიური ელემენტი.from
: მიმდინარე ელემენტის ინდექსიto
: შემდეგი ელემენტის ინდექსი
კარუსელის ყველა ღონისძიება ისროლება თავად კარუსელზე (ანუ ზე <div class="carousel">
).
ღონისძიების ტიპი | აღწერა |
---|---|
სლაიდი.ბს.კარუსელი | ეს მოვლენა მაშინვე ირთვება, როდესაც slide ინსტანციის მეთოდი გამოიძახება. |
სრიალი.ბს.კარუსელი | ეს ღონისძიება გააქტიურებულია, როდესაც კარუსელი დაასრულებს სლაიდზე გადასვლას. |
გადასვლის ხანგრძლივობა .carousel-item
შეიძლება შეიცვალოს $carousel-transition
Sass ცვლადით კომპილაციამდე ან მორგებული სტილები, თუ თქვენ იყენებთ შედგენილ CSS-ს. თუ გამოყენებულია მრავალი გადასვლები, დარწმუნდით, რომ ტრანსფორმაციის გარდამავალი პირველია განსაზღვრული (მაგ. transition: transform 2s ease, opacity .5s ease-out
).