Adds an image item to a carousel. Each item is a clickable slide with an image.

Syntax

Result = MaterialSB::CarouselAddItem(Carousel, ImageSource.s, Link.s)

Parameters

Carousel	The carousel element returned by Carousel().
ImageSource.s	The image URL or path for this slide.
Link.s	The URL to navigate to when the slide is clicked.

Return Value

Returns the carousel-item anchor element.

Remarks

Add all items before calling Init() on the carousel. The carousel requires at least a few items to display properly with the 3D effect.

Example

Procedure Main(Success)
  If Success
    MaterialSB::Row(MaterialSB::#Grid_Container)
      MaterialSB::Col(12)
        MaterialSB::Append(MaterialSB::Header("Image Gallery", 3))
        
        ; Create carousel
        myCarousel = MaterialSB::Carousel()
        
        ; Add multiple items
        MaterialSB::CarouselAddItem(myCarousel, "https://picsum.photos/400/300?1", "#slide1")
        MaterialSB::CarouselAddItem(myCarousel, "https://picsum.photos/400/300?2", "#slide2")
        MaterialSB::CarouselAddItem(myCarousel, "https://picsum.photos/400/300?3", "#slide3")
        MaterialSB::CarouselAddItem(myCarousel, "https://picsum.photos/400/300?4", "#slide4")
        MaterialSB::CarouselAddItem(myCarousel, "https://picsum.photos/400/300?5", "#slide5")
        
        ; Initialize after adding all items
        MaterialSB::Init(myCarousel, #Null)
        
      MaterialSB::CloseCurrentParent()
    MaterialSB::CloseCurrentParent()
    
    ; Slider variant
    MaterialSB::Row(MaterialSB::#Grid_Container)
      MaterialSB::Col(12)
        MaterialSB::Append(MaterialSB::Header("Full-width Slider", 3))
        
        sliderCarousel = MaterialSB::Carousel(MaterialSB::#Carousel_Slider)
        MaterialSB::CarouselAddItem(sliderCarousel, "https://picsum.photos/800/400?6", "#")
        MaterialSB::CarouselAddItem(sliderCarousel, "https://picsum.photos/800/400?7", "#")
        MaterialSB::CarouselAddItem(sliderCarousel, "https://picsum.photos/800/400?8", "#")
        MaterialSB::Init(sliderCarousel, #Null)
        
      MaterialSB::CloseCurrentParent()
    MaterialSB::CloseCurrentParent()
  EndIf
EndProcedure

MaterialSB::Download(@Main())

See Also

Carousel(), Init()