Multi Carousel

Category: Widgets
Subcategory: Display widgets

Overview

Multi Carousel widget is a web widget for building dynamic content rotators. And Support action for the slides.

Documentation

The documentation below has been duplicated from the GitHub repository Multi Carousel

=================================================================================

MultiCarousel

Multi Carousel widget is a web widget for building dynamic content rotators.

Features

  • dynamic content.

  • Support action for the slides.

  • Auto Height, and Auto Width.

  • Responsive design.

    For Normal and Active on click types

    • Auto Play, and Infinite loop.
    • Swipe to slide, Touch and Drag support.

Usage

This widget works as list view to display the dynamic data as a carousel. contains 3 types:

  • Normal carousel: content rotators without a built-in action support. However, you can add actions to the slides in the content.

     

  • Active on click carousel: content rotators with active slide. you can set the active slide and fire it's action on click the slide.

    Note: adding an action to the slides content in this type will override the method that handles setting the active slide.

     

  • Active on slide carousel: content rotators with active slide. switching the active slide happens automatically when clicking next/prev buttons.

     

Issues, suggestions

  1. This widget is built only to handle dynamic data only.

  2. Adding an action to the slide content in active on click type will override the method that handles setting the active slide. if you wish to do that, use the Normal type.

  3. Every carousel has an auto-generated unique class name starting with "-a". You can use it if you have multiple carousels on the same page.

  4. For active on click/slide carousel, the carousel will automatically slide to the first item, activate it, and fire its action.

Development and contribution

$ cd [cloned widget folder]

$ npm install

$ npm run build

 

UI (CSS classes)

1- Normal carousel:

.normal-carousel__container

.normal-carousel__item

.alice-carousel__prev-btn

.alice-carousel__prev-btn-item

.alice-carousel__next-btn

.alice-carousel__next-btn-item

2- Active on click carousel:

.active-click-carousel__container

.active-click-carousel__item

.alice-carousel__prev-btn

.alice-carousel__prev-btn-item

.alice-carousel__next-btn

.alice-carousel__next-btn-item

3- Active on slide carousel:

.active-slide-carousel__container

.active-slide-carousel__wrapper

.active-slide-carousel__prev-btn

.active-slide-carousel__next-btn

4- Dots:

.alice-carousel__dots

.alice-carousel__dots-item

5- Autoplay buttons:

.alice-carousel__play-btn

.alice-carousel__play-btn-item

6- Error:

.multi-carousel__error

7- Loading:

.multi-carousel__loading

 

LinkedIn Aseel Dweedar

Releases

Version: 1.1.0
Framework Version: 9.12.0
Release Notes: - Add dynamic responsive object, so the user can control the number of items depending on screen size.
Version: 1.0.1
Framework Version: 9.12.0
Release Notes: - Active the first item and fire its action when resizing the active click carousel. - Active the first item and fire its action by default when initializing the active click/slide carousel. - Add class "multi-carousel__error" to manage Error messages. - Rearrange XML properties' order.
Version: 1.0.0
Framework Version: 9.12.0
Release Notes: v.1.0.0