Slideshow

is an HTML custom element for the purpose of displaying a sequence of slides, which can automatically advance through the content or be manually controlled by the user.

The element is a wrapper element. All slides are slotted content and must be direct children of the element. Slides must have assigned width and height properties to display properly.

is a fully customizable element and does not come with any features turned on by default. The features of are turned on by including the proper attributes on the element.

Note: If all the slides can fit on the screen at once, the slideshow will not activate.

$3

autoplay and autoScroll are mutually exclusive properties and should not be used together on the same component instance.

Both navigation and pagination can be used together, but at least one must be used to give users a clear way to control the slides manually.

$3

On mobile devices, autoScroll and navigation controls are automatically disabled. Users can navigate the slideshow by swiping left or right.

Use Cases

The element should be used in situations where:

* A series of images or content needs to be displayed in a space-saving way
* Autoplaying or autoscrolling functionality is needed
* A current slide indicator is required

Install

!ESM supported

``shell
$ npm i @aurodesignsystem/auro-slideshow
`

$3


Defining the dependency within each project that is using the component.




`js
import "@aurodesignsystem/auro-slideshow";
`

$3


In cases where the project is not able to process JS assets, there are pre-processed assets available for use. Legacy browsers such as IE11 are no longer supported.

`html

`

Basic Example




`html







When you install the component as described on the Install page, the class is imported automatically, and the component is registered globally for you.

However, if you need to load multiple versions of the same component on a single page (for example, when two projects depend on different versions), you can manually register the class under a custom element name to avoid conflicts.

You can do this by importing only the component class and using the register(name) method with a unique name:




`js
// Import the class only
import { AuroSlideshow } from '@aurodesignsystem/auro-slideshow/class';

// Register with a custom name if desired
AuroSlideshow.register('custom-slideshow');
`

This will create a new custom element that behaves exactly like , allowing both to coexist on the same page without interfering with each other.