The all purpose, lightweight and highly customisable slider.

How to use SuperSlider on your website

A

Connect to a CDN

B

GitHub

C

Download Folder

Getting started

1

CSS


<link rel="stylesheet" type="text/css" href="super/super.css"/>

<!-- Add the new super-theme.css if you want the default styling -->
<link rel="stylesheet" type="text/css" href="super/super-theme-v1.css"/>
<link rel="stylesheet" type="text/css" href="super/super-theme-v1.css"/>
<link rel="stylesheet" type="text/css" href="super/super-theme-v1.css"/>

2

HTML


<div class="your-class-here" id="your-id-here"  >
	<div>slide content</div>
	<div>slide content</div>
	<div>slide content</div>
</div>
<!-- If you have more than one slide it's advisable to give each it's own unique id also -->

3

Javascript


<link rel="stylesheet" type="text/css" href="super/super-theme-v1.css"/>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>
<script src="dist/scripts/superSlider.min.js" type="text/javascript" charset="utf-8"></script>

4

Initialise


$(document).ready(function () {
	$('.your-class-here').super({
		// Any custom settings go here
	});
	
});	

// Note that if you have multiple sliders that will have the same settings you can simply initialise using the shared class

A simple and lightweight slider.

Lightweight

One of the smallest and efficient slider packages out there, at < 32kb in total size. Ensuring your project isn't weighed down with bloated code.

Customisable

With over 30 customisable features you have the power to build the slider you need with just a few lines of code.

Responsive

You can customise your slider to look and function however you need it to depending on the breakpoints that you add.

Examples of the key features

Default settings


$('.your-class-here').super();

// If you don't need to customise anything you can simply create your slider like this
1
2
3
4
5
6

Autoplay


$('.your-class-here').super({
	autoplay: true,
});

// As default autoplay is set to false

1
2
3
4
5
6

Multiple slides


$('.your-class-here').super({
	slidesToShow: 2,
});

// Control how many slides you want to show
1
2
3
4
5
6

Responsive


$('.your-class-here').super({
	slidesToShow: 1,
	slidesToScroll: 1,
	responsive: [
		{
			breakpoint: 600,
			settings: {
				slidesToShow: 2,
				slidesToScroll: 2
			}
		},
		{
			breakpoint: 1200,
			settings: {
			slidesToShow: 3,
			slidesToScroll: 3,
			}
		}
	]
});

// You can customise how your SuperSlider looks at different screen sizes. Note: SuperSlider is mobile-first
1
2
3
4
5
6

Infinite scroll


$('.your-class-here').super({
	infiniteScroll: false,
});

// As default infinite scroll is set to true
1
2
3
4
5
6

Fade effect


$('.your-class-here').super({
	fadeEffect: true,
});

// Use any fade effect you want instead of transform. As default fade effect is set to false.
1
2
3
4
5
6

Navigation


$('.your-class-here').super({
	arrows: false,
});

// You can remove navigation buttons. As default navigation is set to true.
1
2
3
4
5
6

Slide Indicator


$('.your-class-here').super({
	indicator: false,
});

// You can remove indicator buttons. As default indicator is set to true.

1
2
3
4
5
6

Touch sensitivity


$('.your-class-here').super({
	touchSensitivity: 'high',
});

// Control how sensitive you want the dragging to be to trigger changing the slide. 
1
2
3
4
5
6

List of features

Feature Type Default Information
accessibility boolean TRUE Enable the use of keys (left & right) to navigate through the slides of the selected slider.
arrowAppend element
$(element) The DOM element where the arrows will be appended to. As default this is set to the slider.
arrowClass string ' ' Enables for any custom classes to be added to both arrow containers.
arrowDirections array ['left', 'right'] Array of the directions of the slider. Used as content if the arrowLeft/Right are empty.
arrowElement element
'<button></button>' The type of element the arrow content is wrapped in.
arrowLeft string '<svg width="15" height="24"><path d="M13 2L3 12L13 22" /></svg>' The content for the left navigation button.
arrowRight string '<svg width="15" height="24" viewBox="0 0 15 24" fill="none" <path d="M2 2L12 12L2 22"/></svg>' The content for the right navigation button.
arrows boolean TRUE Enable navigation elements to be added to the slider.
autoPlay boolean false
Enable the slides to automatically scroll.
autoPlayDelay integer 3000 The delay to triggering autoplay.
customClass string ' '
Enables for any custom classes to be added to the slider.
indicator boolean TRUE Enable indicator elements to be added to the slider.
indicatorClass string ' '
Enables for any custom classes to be added to the indicator container.
indicatorElement element $(element) The DOM element where the indicator container will be appended to. As default this is set to the slider.
infiniteScroll boolean TRUE Enables continous scrolling - creates cloned slides to create the allusion of infinite scrolling.
initialSlide integer 1 The starting slide.
mobileFirst boolean TRUE All breakpoints defined in responsive are mobile first.
pauseOnHover
boolean true
Pause the autoplay animation on hover.
removeSuper boolean FALSE Completely removes the slider from the DOM.
respondTo string window'
Control whether the breakpoints respond tothe window or the slider width.
responsive object
null An array of objects with any custom settings applied at each breakpoint.
slidesToScroll integer 1 The number of slides to scroll.
slidesToShow integer 1 The number of slides that are visible.
touchSensitivity integer 'default' Control how sensitive the slider drag is. Accepts any of the following: 'low', 'normal, 'default', and 'high'.
transitionDelay integer 0 The delay applied to the transitions of changing slides.
transitionProperty string 'ease' The transition property type, accepts any valid css transition type.
transitions boolean TRUE Enables the css transitions on all change slide types.
transitionSpeed integer 800 The speed that the transitions are carried out.
transitionUnit string 'ms' The unit for the speed/delay.
z-index integer 100 Controls the z-index of the slider.