Glide.js is a dependency-free JavaScript ES6 slider and carousel. It’s lightweight, flexible and fast. Designed to slide. No less, no more
What can convince you:
- Dependency-free. Everything included, ready for action.
- Lightweight. Only ~23kb (~7kb gzipped) with every functionality on board.
- Modular. Remove unused modules and drop script weight even more.
- Extendable. Plug-in your own modules with additional functionalities.
- Bundlers ready. Using Rollup or Webpack? We have your back.
Visit glidejs.com for documentation.
Looking for old documentation? Wiki contains archived documentation of Glide.js in version
^2.0.0.
Glide.js is an open source project licensed under the MIT license. It's completely free to use. However, it would be great if you buy me a cup of coffee once in a while to keep me awake :)
Pull-in a latest version with NPM ...
npm install @glidejs/glide... provide <link> to the required core stylesheet. You can also optionally add an included theme stylesheet ...
<!-- Required Core stylesheet -->
<link rel="stylesheet" href="node_modules/@glidejs/glide/dist/css/glide.core.min.css">
<!-- Optional Theme stylesheet -->
<link rel="stylesheet" href="node_modules/@glidejs/glide/dist/css/glide.theme.min.css">... then, prepare a little bit of necessary markup ...
<div class="glide">
<div data-glide-el="track" class="glide-track">
<ul class="glide-slides">
<li class="glide-slide"></li>
<li class="glide-slide"></li>
<li class="glide-slide"></li>
</ul>
</div>
</div>... and finally, initialize and mount a Glide.
import Glide from '@glidejs/glide'
new Glide('.glide').mount()Need a few selected modules? Import and mount only what you need.
import Glide, { Controls, Breakpoints } from '@glidejs/glide/dist/glide.modular.esm'
new Glide('.glide').mount({ Controls, Breakpoints })The issue channel is especially for improvement proposals and bug reporting. If you have implementing problems, please write on StackOverflow with glidejs tag.
The optional theme stylesheet (glide.theme.css) reads its colors from custom properties. Set them on any ancestor of the slider, or on :root:
.glide {
--glide-control-color: #222; /* arrow text and hover border, active bullet (default: white) */
--glide-control-muted-color: #2228; /* arrow border, bullets (default: white at 50%) */
--glide-control-shadow-color: transparent; /* arrow and bullet shadows (default: black at 10%) */
}The theme places each .glide-arrow by its data-glide-dir: a direction ending in < on the left, one ending in > on the right.
Glide marks state with attributes rather than classes, so style them with attribute selectors:
| Attribute | Element | Meaning |
|---|---|---|
data-type="slider|carousel" |
root | The type option |
data-direction="ltr|rtl" |
root | The direction option |
data-swipeable |
root | The Swipe component is mounted |
data-dragging |
root | A swipe or drag is in progress |
data-active |
slide | The current slide |
data-clone |
slide | A copy added by the carousel type |
aria-current="true" |
bullet | The bullet of the current slide |
aria-disabled="true" |
arrow | The arrow cannot move further (rewind: false) |
.glide-slide[data-active] { outline: 2px solid; }
.glide-arrow[aria-disabled="true"] { visibility: hidden; }Glide targets Baseline Widely Available browsers, the same default as Vite 8:
- Chrome 111+
- Edge 111+
- Firefox 114+
- Safari 16.4+
- Safari iOS 16.4+
Build using NPM scripts. The following scripts are available:
build:css- Outputs prefixed and minified CSS files from the stylesheets insrc/assets/css.build:js- Outputs all destination variants of the script, plus TypeScript declarations for the ES module builds.build- Comprehensively builds the entire library.test- Runs complete test suite.typecheck- Type-checks the TypeScript sources and tests.lint- Lints library TypeScript and CSS files.
- Jędrzej Chałubek - Creator
- Contributors
Copyright (c) 2014-present, Jędrzej Chałubek. Licensed under the terms of the MIT License.
