---
url: /reference/items/Slider.md
---
# Slider
## Usage
Use the `Slider` component to display items on the X axis and enable indexed navigation between them.
::: code-group
```js twoslash [app.js]
import { registerComponent } from '@studiometa/js-toolkit';
import { Slider } from '@studiometa/ui';
registerComponent(Slider);
```
```twig [slider.twig]
{% for item in 1..4 %}
#{{ item }}
{% endfor %}
```
:::
By default, the `SliderItem` and `SliderDrag` components are included in the `Slider`. You can add more controls with the following components:
* `SliderBtn` to add previous and next buttons
* `SliderCount` to display the current index of the slider
* `SliderDots` to have a secondary navigation
* `SliderProgress` to add a progress bar
These components need to be added as child components of the `Slider` component, so a `Slider` class must be reimplemented in your project:
::: code-group
```js twoslash [Slider.js]
import { Base, createApp } from '@studiometa/js-toolkit';
import {
Slider as SliderCore,
SliderBtn,
SliderCount,
SliderDots,
SliderDrag,
SliderItem,
SliderProgress,
} from '@studiometa/ui';
export class Slider extends SliderCore {
static config = {
components: {
SliderBtn,
SliderCount,
SliderDots,
SliderDrag,
SliderItem,
SliderProgress,
},
};
}
```
```js twoslash [app.js]
import { Base, createApp } from '@studiometa/js-toolkit';
import { Slider } from './Slider.js';
class App extends Base {
static config = {
name: 'App',
components: {
Slider,
},
};
}
export default createApp(App);
```