Development
API: Options - Jssor Slider
Jssor Slider Initialization Options
Option Required Default Description
$AutoPlay optional 0 0: no auto play
1: continuously
2: stop at last slide
4: stop on click
8: stop on user navigation (click on arrow/bullet/thumbnail, swipe slide, press keyboard left, right arrow key)
12: stop on click or user navigation
Slideshow will be disabled if this value is 0.
$AutoPlaySteps optional 1 Steps to go for each auto play request. Possible value can be 1, 2, -1, -2 ...
$Idle optional 3000 Interval (in milliseconds) to go for next slide since the previous stopped if the slider is auto playing
$SlideDuration optional 500 Specifies duration (in milliseconds) for right to left swipe animation
$SlideEasing optional $Jease$.$OutQuad Specifies easing for right to left swipe animation
$PauseOnHover optional 1 Whether to pause when mouse over if a slider is auto playing
0: no pause
1: pause for desktop
2: pause for touch device
3: pause for desktop and touch device
4: freeze for desktop
8: freeze for touch device
12: freeze for desktop and touch device
$FillMode optional 0 The way to fill the main image in a slide
0: stretch
1: contain (keep aspect ratio and put all inside slide)
2: cover (keep aspect ratio and cover whole slide)
4: actual size
5: contain for large image and actual size for small image
$LazyLoading optional 1 For image with data-src attribute (<img data-src="url" />), it will lead to lazy loading.
If this value is 0, it will load current slide only. If this value is 1, it will load current slide and 1 adjacent slide.
$SlideWidth optional (auto) Width of every slide in pixels
By default, the $SlideWidth is Slides Container width.
$SlideHeight optional (auto) Height of every slide in pixels
By default, the $SlideHeight is Slides Container height.
$SlideSpacing optional 0 Space between each slide in pixels
$Align optional (auto) Offset position (in pixels) to align current slide in Slides Container.
Slideshow will be disabled if this value is not 0.
$Cols optional (auto) [Obsolete] Number of slides to display is up to size of the Slides Container
$PlayOrientation optional 1 Orientation to play slide (for auto play, navigation)
1: horizental
2: vertical
$DragOrientation optional 1 Orientation to drag slide
0: no drag
1: horizental
2: vertical
3: either
The $DragOrientation should be the same as $PlayOrientation when $Align is not 0.
$DragRatio optional 1 drag ratio to move slide while dragging
$MinDragOffsetToSlide optional 20 Minimum drag offset (in pixels) to be traited as successful drag to swipe to next or previous slide
$StartIndex optional 0 Index of slide to display when initialize
$Loop optional 1 Enable loop(circular) of carousel or not
0: stop
1: loop
2: rewind
$ArrowKeyNavigation optional 1 Steps to go for each navigation request by pressing arrow key
$UISearchMode optional 1 The way (0 parellel, 1 recursive) to search UI components (slides container, loading screen, bullet navigator, arrow navigator, thumbnail navigator).
{$SlideshowOptions} optional null Options to specify and enable slideshow
{$BulletNavigatorOptions} optional null Options to specify and enable navigator
{$ArrowNavigatorOptions} optional null Options to specify and enable arrow navigator
{$ThumbnailNavigatorOptions} optional null Options to specify and enable thumbnail navigator
Ad
Option Required Default Description
$Class required $JssorBulletNavigator$ Class to create navigator instance
$ChanceToShow optional 2 Show bullet navigator
0: Never
1: Mouse Over
2: Always
$ActionMode optional 1 Action to trigger navigation
1: click
2: mouse hover
$Steps optional 1 Steps to go for each navigation request
$Rows optional 1 Rows to arrange bullets
$SpacingX optional 10 Horizontal space (in pixels) between each item in pixel
$SpacingY optional 10 Vertical space (in pixels) between each item
$Orientation optional 1 The layout orientation
1: horizontal
2: vertical
$Scale optional true [Obsolete] use data-scale attribute instead.
$AutoCenter optional 0 [Obsolete] use data-autocenter attribute instead.
{$ArrowNavigatorOptions}
Option Required Default Description
$Class required $JssorArrowNavigator$ Class to create arrow navigator instance
$ChanceToShow optional 2 Show arrow navigator
0: Never
1: Mouse Over
2: Always
$Steps optional 1 Steps to go for each navigation request
$Scale optional true [Obsolete] use data-scale attribute instead.
$AutoCenter optional 0 [Obsolete] use data-autocenter attribute instead.
{$ThumbnailNavigatorOptions}
Option Required Default Description
$Class required $JssorThumbnailNavigator$ Class to create thumbnail navigator instance
$ChanceToShow optional 2 Show thumbnail navigator
0: Never
1: Mouse Over
2: Always
$Loop optional 1 Enable loop(circular) of carousel or not
0: stop
1: loop
$ActionMode optional 1 Action to trigger navigation
1: act by click
2: act by mouse hover
$Cols optional (auto) [Obsolete] Number of items to display is up to the thumbnail navigator container size
$Rows optional 1 Specify rows to arrange thumbnails
$SpacingX optional 0 Horizontal space (in pixels) between each thumbnail
$SpacingY optional 0 Vertical space (in pixels) between each thumbnail
$Align optional (auto) The offset position (in pixels) to align active thumbnail
$Orientation optional 1 Orientation to arrange thumbnails
1: horizental
2: vertical
$NoDrag optional false Disable drag or not
$DisableDrag optional false [Obsolete] Use $NoDrag instead
$AutoCenter optional 0 [Obsolete] use data-autocenter attribute instead.
{$SlideshowOptions}
Option Required Default Description
$Class required $JssorSlideshowRunner$ Class to create instance of slideshow
$Transitions requried An array of slideshow transitions to play slideshow
$TransitionsOrder optional 0 The way to choose transition to play slideshow
0: Random
1: In Order