Carousel

Category: Widgets
Subcategory: Display widgets

Overview

This widget displays images in a carousel with support for swiping

Documentation

Carousel

Displays images in a carousel.

Features

  • Supports different data sources:
    • Set static images in the Modeler
    • Retrieve images from the database via XPath
    • Retrieve images via a microflow
  • Image from mendix System.Images or from a URL
  • Navigate to the next or the previous image
  • Execute a microflow or open a page when an image is clicked
  • Swipe through the images on mobile devices

Dependencies

Mendix 7.1

Demo project

http://carouselwidget.mxapps.io

Usage

The widget requires a context.

Data source: Static

  • On the Data source option of the Data source tab, select the static option if its not already selected by default.
  • On the Static images option of the same tab, click new to add static images from the modeller and also configure an onclick action.
  • For the on click options, configure only one of the two (either calling a microflow or a page).
  • Configuring both options will only trigger the microflow.

Data source: XPath

  • On the Data source option of the Data source tab, select the XPath option.
  • Specify the image entity and the XPath constraint (if any).
  • In the behavior tab, you can configure on click behavior i.e Do nothing, call microflow or show page.
  • For options call microflow and show page, a microflow or page must be specified respectively.

Data source: Microflow

  • On the Data source option of the Data source tab, select the Microflow option.
  • Specify the image entity and the microflow to retrieve the carousel images from (both required).
  • Refer to the XPath section for configuring click behavior.

For the microflow and XPath data source options, specifying a URL attribute will make the value of the URL attribute the priority.

Issues, suggestions and feature requests

We are actively maintaining this widget, please report any issues or suggestion for improvement at https://github.com/mendixlabs/carousel/issues.

Releases

Version: 2.0.0
Framework Version: 9.6.0
Release Notes: ### Added - We added new properties such as *autoplay*, *animation*, *pagination*, *navigation*, *infinite loop*, *delay*. ### Changed - We changed the widget to a pluggable widget. - We changed the library for Carousel widget to use Swiper. - We changed the data source selection, now you can put your preferred widget inside carousel content.
Version: 1.4.1
Framework Version: 7.13.1
Release Notes: Web modeler configuration for static images are working again (Fixing GitHub issue #22)