@smartimpact-it/modern-slick

v2.0.2

Published

24 days ago

Modern, jQuery-free TypeScript port of slick-carousel — the last carousel you'll ever need.

0High
0Medium
0Low

smartimpact

bogdanbeniaminb

imarinescu

carousel slick responsive js slider typescript

modern-slick

A modern, jQuery-free TypeScript port of the original slick-carousel by Ken Wheeler — the last carousel you'll ever need.

This fork is a drop-in upgrade: the same options, methods and events are kept so existing integrations migrate with little or no code changes, but the runtime no longer depends on jQuery, ships first-class TypeScript types, and now publishes ESM-only entrypoints.

Installation

npm install @smartimpact-it/modern-slick

Usage — core (ESM / TypeScript)

import Slick from "@smartimpact-it/modern-slick";
import "@smartimpact-it/modern-slick/slick.css";
import "@smartimpact-it/modern-slick/slick-theme.css";

const carousel = new Slick(document.querySelector(".your-class")!, {
  slidesToShow: 3,
  slidesToScroll: 1,
  autoplay: true,
  autoplaySpeed: 2000,
});

// Same events as the original, also exposed on the instance.
carousel.on("afterChange", (event, slick, currentSlide) => {
  console.log("now on slide", currentSlide);
});

carousel.slickGoTo(2);
carousel.slickPause();
carousel.destroy();

The default @smartimpact-it/modern-slick entry is the lean core build. It keeps autoplay and swipe, but lazy-loading now lives in the full entry:

import Slick from "@smartimpact-it/modern-slick/full";

The bundle also dispatches native CustomEvents on the carousel element (init, beforeChange, afterChange, breakpoint, setPosition, swipe, edge, lazyLoaded, lazyLoadError, allImagesLoaded, destroy, unslick, reInit) so framework-agnostic code can listen via element.addEventListener('afterChange', …) as well.

Usage — optional jQuery bridge

The jQuery plugin surface still exists, but it is no longer auto-registered by the default bundle. Import the optional bridge explicitly when you still need $.fn.slick:

import $ from "jquery";
import "@smartimpact-it/modern-slick/jquery";

$(".your-class").slick({ slidesToShow: 3, slidesToScroll: 1 });

Browser support

Modern evergreen browsers (ES2020+). For older targets, transpile through your own bundler.

Migration from slick 1.8.x

jQuery users now need one explicit import: import '@smartimpact-it/modern-slick/jquery'.
If you'd like to drop jQuery: import Slick from '@smartimpact-it/modern-slick' and call new Slick(el, opts) instead of $(el).slick(opts).
If you rely on lazyLoad, import @smartimpact-it/modern-slick/full instead of the core entry.
Method aliases (next/slickNext, goTo/slickGoTo, …) are all kept.
The same CSS files (slick.css, slick-theme.css, plus .scss / .less source) ship in this package; their class names are unchanged.

Building from source

npm install
npm run build       # produces dist/{modern-slick,full,jquery}.js + .d.ts
npm test            # smoke tests running the built bundle in jsdom
npm run typecheck   # strict TypeScript check

Live demo

Two playgrounds ship with the source:

index.html — a root-level ESM playground that reuses the shared demo module.
demo/index.html — the modern, jQuery-free playground that loads dist/full.js through demo/app.mjs. It also subscribes to native CustomEvents and prints them in a live log so you can verify the event surface.

After running npm run build, serve the project root with any static server (for example npx serve .) and open /demo/.

Below is the original slick-carousel documentation, which still describes the options and events accurately, but the old <script>/CDN packaging examples do not match this ESM-only fork anymore.

slick

the last carousel you'll ever need

Demo

http://kenwheeler.github.io/slick

CDN

To start working with Slick right away, there's a couple of CDN choices available to serve the files as close, and fast as possible to your users:

https://cdnjs.com/libraries/slick-carousel
https://cdn.jsdelivr.net/gh/kenwheeler/slick/

Example using jsDelivr

Just add a link to the css file in your <head>:

<link
  rel="stylesheet"
  type="text/css"
  href="https://cdn.jsdelivr.net/gh/kenwheeler/[email protected]/slick/slick.css"
/>
<!-- Add the slick-theme.css if you want default styling -->
<link
  rel="stylesheet"
  type="text/css"
  href="https://cdn.jsdelivr.net/gh/kenwheeler/[email protected]/slick/slick-theme.css"
/>

Then, before your closing <body> tag add:

<script
  type="text/javascript"
  src="https://cdn.jsdelivr.net/gh/kenwheeler/[email protected]/slick/slick.min.js"
></script>

Package Managers

# Bower
bower install --save slick-carousel

# NPM
npm install slick-carousel

Contributing

PLEASE review CONTRIBUTING.markdown prior to requesting a feature, filing a pull request or filing an issue.

Data Attribute Settings

In slick 1.5 you can now add settings using the data-slick attribute. You still need to call $(element).slick() to initialize slick on the element.

Example:

<div data-slick='{"slidesToShow": 4, "slidesToScroll": 4}'>
  <div><h3>1</h3></div>
  <div><h3>2</h3></div>
  <div><h3>3</h3></div>
  <div><h3>4</h3></div>
  <div><h3>5</h3></div>
  <div><h3>6</h3></div>
</div>

Settings

| Option | Type | ---------------- | accessibility | boolean | adaptiveHeight | boolean | appendArrows | string | appendDots | string | arrows | boolean | asNavFor | string | autoplay | boolean | autoplaySpeed | int | centerMode | boolean | centerPadding | string | cssEase | string | customPaging | function | dots | boolean | dotsClass | string | draggable | boolean | easing | string | edgeFriction | integer | fade | boolean | focusOnSelect | boolean | focusOnChange | boolean | infinite | boolean | initialSlide | integer | lazyLoad | string | mobileFirst | boolean | nextArrow | pauseOnDotsHover | boolean | pauseOnFocus | boolean | pauseOnHover | boolean | prevArrow | respondTo | string | responsive | array | rows | int | rtl | boolean | slide | string | slidesPerRow | int | slidesToScroll | int | slidesToShow | int | speed | int | swipe | boolean | swipeToSlide | boolean | touchMove | boolean | touchThreshold | int | useCSS | boolean | useTransform | boolean | variableWidth | boolean | vertical | boolean | verticalSwiping | boolean | waitForAnimate | boolean | zIndex | number | Default | Description | | ---------------------------------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | true | Enables tabbing and arrow key navigation. Unless autoplay: true, sets browser focus to current slide (or first of current slide set, if multiple slidesToShow) after slide change. For full a11y compliance enable focusOnChange in addition to this. | | false | Adapts slider height to the current slide | | $(element) | Change where the navigation arrows are attached (Selector, htmlString, Array, Element, jQuery object) | | $(element) | Change where the navigation dots are attached (Selector, htmlString, Array, Element, jQuery object) | | true | Enable Next/Prev arrows | | $(element) | Enables syncing of multiple sliders | | false | Enables auto play of slides | | 3000 | Auto play change interval | | false | Enables centered view with partial prev/next slides. Use with odd numbered slidesToShow counts. | | '50px' | Side padding when in center mode. (px or %) | | 'ease' | CSS3 easing | | n/a | Custom paging templates. See source for use example. | | false | Current slide indicator dots | | 'slick-dots' | Class for slide indicator dots container | | true | Enables desktop dragging | | 'linear' | animate() fallback easing | | 0.15 | Resistance when swiping edges of non-infinite carousels | | false | Enables fade | | false | Enable focus on selected element (click) | | false | Puts focus on slide after change | | true | Infinite looping | | 0 | Slide to start on | | 'ondemand' | Accepts 'ondemand' or 'progressive' for lazy load technique. 'ondemand' will load the image as soon as you slide to it, 'progressive' loads one image after the other when the page loads. | | false | Responsive settings use mobile first calculation | | string (html | jQuery selector) | object (DOM node | jQuery object) | <button type="button" class="slick-next">Next</button> | Allows you to select a node or customize the HTML for the "Next" arrow. | | false | Pauses autoplay when a dot is hovered | | true | Pauses autoplay when slider is focussed | | true | Pauses autoplay on hover | | string (html | jQuery selector) | object (DOM node | jQuery object) | <button type="button" class="slick-prev">Previous</button> | Allows you to select a node or customize the HTML for the "Previous" arrow. | | 'window' | Width that responsive object responds to. Can be 'window', 'slider' or 'min' (the smaller of the two). | | null | Array of objects containing breakpoints and settings objects (see example). Enables settings at given breakpoint. Set settings to "unslick" instead of an object to disable slick at a given breakpoint. | | 1 | Setting this to more than 1 initializes grid mode. Use slidesPerRow to set how many slides should be in each row. | | false | Change the slider's direction to become right-to-left | | '' | Slide element query | | 1 | With grid mode initialized via the rows option, this sets how many slides are in each grid row. | | 1 | # of slides to scroll at a time | | 1 | # of slides to show at a time | | 300 | Transition speed | | true | Enables touch swipe | | false | Swipe to slide irrespective of slidesToScroll | | true | Enables slide moving with touch | | 5 | To advance slides, the user must swipe a length of (1/touchThreshold) * the width of the slider. | | true | Enable/Disable CSS Transitions | | true | Enable/Disable CSS Transforms | | false | Disables automatic slide width calculation | | false | Vertical slide direction | | false | Changes swipe direction to vertical | | true | Ignores requests to advance the slide while animating | | 1000 | Set the zIndex values for slides, useful for IE9 and lower |

Responsive Option Example

The responsive option, and value, is quite unique and powerful. You can use it like so:

$(".slider").slick({
  // normal options...
  infinite: false,

  // the magic
  responsive: [
    {
      breakpoint: 1024,
      settings: {
        slidesToShow: 3,
        infinite: true,
      },
    },
    {
      breakpoint: 600,
      settings: {
        slidesToShow: 2,
        dots: true,
      },
    },
    {
      breakpoint: 300,
      settings: "unslick", // destroys slick
    },
  ],
});

Events

In slick 1.4, callback methods were deprecated and replaced with events. Use them before the initialization of slick as shown below:

// On swipe event
$(".your-element").on("swipe", function (event, slick, direction) {
  console.log(direction);
  // left
});

// On edge hit
$(".your-element").on("edge", function (event, slick, direction) {
  console.log("edge was hit");
});

// On before slide change
$(".your-element").on(
  "beforeChange",
  function (event, slick, currentSlide, nextSlide) {
    console.log(nextSlide);
  },
);

| Event | Params | Description | | ------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | afterChange | event, slick, currentSlide | After slide change callback | | beforeChange | event, slick, currentSlide, nextSlide | Before slide change callback | | breakpoint | event, slick, breakpoint | Fires after a breakpoint is hit | | destroy | event, slick | When slider is destroyed, or unslicked. | | edge | event, slick, direction | Fires when an edge is overscrolled in non-infinite mode. | | init | event, slick | When Slick initializes for the first time callback. Note that this event should be defined before initializing the slider. | | reInit | event, slick | Every time Slick (re-)initializes callback | | setPosition | event, slick | Every time Slick recalculates position | | swipe | event, slick, direction | Fires after swipe/drag | | lazyLoaded | event, slick, image, imageSource | Fires after image loads lazily | | lazyLoadError | event, slick, image, imageSource | Fires after image fails to load |

Methods

Methods are called on slick instances through the slick method itself in version 1.4, see below:

// Add a slide
$(".your-element").slick("slickAdd", "<div></div>");

// Get the current slide
var currentSlide = $(".your-element").slick("slickCurrentSlide");

This new syntax allows you to call any internal slick method as well:

// Manually refresh positioning of slick
$(".your-element").slick("setPosition");

| Method | Argument | Description | | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | | slick | options : object | Initializes Slick | | unslick | | Destroys Slick | | slickNext | | Triggers next slide | | slickPrev | | Triggers previous slide | | slickPause | | Pause Autoplay | | slickPlay | | Start Autoplay (will also set autoplay option to true) | | slickGoTo | index : int, dontAnimate : bool | Goes to slide by index, skipping animation if second parameter is set to true | | slickCurrentSlide | | Returns the current slide index | | slickAdd | element : html or DOM object, index: int, addBefore: bool | Add a slide. If an index is provided, will add at that index, or before if addBefore is set. If no index is provided, add to the end or to the beginning if addBefore is set. Accepts HTML String | | Object | | slickRemove | index: int, removeBefore: bool | Remove slide by index. If removeBefore is set true, remove slide preceding index, or the first slide if no index is specified. If removeBefore is set to false, remove the slide following index, or the last slide if no index is set. | | slickFilter | filter : selector or function | Filters slides using jQuery .filter syntax | | slickUnfilter | | Removes applied filter | | slickGetOption | option : string(option name) | Gets an option value. | | slickSetOption | change an option, refresh is always boolean and will update UI changes... | | option, value, refresh | change a single option to given value; refresh is optional. | | "responsive", [{ breakpoint: n, settings: {} }, ... ], refresh | change or add whole sets of responsive options | | { option: value, option: value, ... }, refresh | change multiple options to corresponding values. |

Example

Initialize with:

$(element).slick({
  dots: true,
  speed: 500,
});

Change the speed with:

$(element).slick("slickSetOption", "speed", 5000, true);

Destroy with:

$(element).slick("unslick");

Sass Variables

| Variable | Type | Default | Description | | ----------------------- | ------ | ---------------- | -------------------------------------------------- | | $slick-font-path | string | "./fonts/" | Directory path for the slick icon font | | $slick-font-family | string | "slick" | Font-family for slick icon font | | $slick-loader-path | string | "./" | Directory path for the loader image | | $slick-arrow-color | color | white | Color of the left/right arrow icons | | $slick-dot-color | color | black | Color of the navigation dots | | $slick-dot-color-active | color | $slick-dot-color | Color of the active navigation dot | | $slick-prev-character | string | '\2190' | Unicode character code for the previous arrow icon | | $slick-next-character | string | '\2192' | Unicode character code for the next arrow icon | | $slick-dot-character | string | '\2022' | Unicode character code for the navigation dot icon | | $slick-dot-size | pixels | 6px | Size of the navigation dots |

Browser support

Slick works on IE8+ in addition to other modern browsers such as Chrome, Firefox, and Safari.

Dependencies

jQuery 1.7

License

Licensed under the MIT license.

Free as in Bacon.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

modern-slick

Installation

Usage — core (ESM / TypeScript)

Usage — optional jQuery bridge

Browser support

Migration from slick 1.8.x

Building from source

Live demo

slick

Demo

CDN

Example using jsDelivr

Package Managers

Contributing

Data Attribute Settings

Settings

Responsive Option Example

Events

Methods

Example

Sass Variables

Browser support

Dependencies

License