BoxLang 🚀 A New JVM Dynamic Language Learn More...

PresideCMS Extension: SwiperJs Carousel/Slider Widget

v1.2.0 Preside Extensions

Preside Extension for a Swiper based Slider

This extension allows you to place a slider element as a widget. We use the awesome Swiper library.

Swiper version: 12.1.2

Features

  • support for all swiper effects: slide, fade, cube, coverflow, flip, creative, cards

  • configurable animation speed

  • support for horizontal and vertical sliders

  • support for looping and rewind (loop alternative without jump)

  • support for multiple slides per view with configurable space between slides

  • center active slide option

  • grab cursor on hover

  • support for autoplay and autoplay delay

  • optional navigation arrows (show/hide, custom color)

  • optional progress bar (show/hide, custom color)

  • vertical slider: configurable bullet size

  • image fit option per widget: crop to fill or proportional

  • support for separate mobile image folder

  • support for title/description above the slider widget

  • grab cursor support

Widget Options

Option Description
Swiper TitleTitle displayed above the slider
Swiper DescriptionDescription text displayed above the slider
Image folderAsset folder with slider images
Mobile image folderOptional separate asset folder for mobile images
Show titleToggle title visibility
Show descriptionToggle description visibility
Transition effectslide, fade, cube, coverflow, flip, creative, cards
Effect speedTransition duration in ms
Endless scrollingEnable loop mode
Directionhorizontal or vertical
Slides per view1, 2, 3, 4 or auto
Space between slides0, 10, 20, 30, 40, 50 px
Center active slideCenters the active slide in the viewport
Grab cursorShows grab cursor on hover
RewindRewind to start without loop jump
AutoplayEnable automatic slide advancement
Autoplay delayInterval between slides in ms
Bullet sizeSize of pagination bullets (vertical only)
Image fitCrop to fill or proportional (no crop)
Show navigation arrowsToggle prev/next buttons
Navigation colorColor of navigation arrows
Show progress barToggle progress bar (horizontal only)
Progress bar colorColor of the progress bar

Image Derivatives

Derivative Dimensions Mode
swiperFullCrop1280 × 480 pxcrop to fill, maintains aspect ratio
swiperFullFit1280 × 480 pxfits proportionally, maintains aspect ratio
swiperMobile360 px widthproportional
swiperThumb300 × 225 pxcrop to fill

Changelog

1.2.0

  • updated Swiper library to version 12.1.2
  • fixed image distortion: replaced swiperFull derivative with swiperFullCrop and swiperFullFit
  • added image fit option (crop to fill / proportional) per widget instance
  • navigation color and progress bar color are now independently configurable
  • added show/hide toggle for navigation arrows
  • added show/hide toggle for progress bar
  • added slides per view option (1, 2, 3, 4, auto)
  • added space between slides option
  • added center active slide option
  • added grab cursor option
  • added rewind option
  • removed autoheight option (replaced by server-side image derivatives)
  • updated navigation CSS to use Swiper CSS custom properties (--swiper-navigation-color, --swiper-pagination-color)
  • default color for navigation and progress bar changed to #fff

1.0.4

  • initial release with Swiper 8.3.2

$ box install ext-preside-swiper-slider

No collaborators yet.
   
  • {{ getFullDate("2022-08-17T13:31:52Z") }}
  • {{ getFullDate("2026-03-03T09:00:24Z") }}
  • 1,914
  • 1,218