# Image slide (Hero slider)

{% hint style="info" %}
**Note**: This article is work in progress.
{% endhint %}

Das ThemeWare® CMS-Element "**Image slide (Hero slider)**" ist explizit für die Verwendung im CMS-Block "**Hero slider (...)**" vorgesehen. Das CMS-Element ist nicht für die Nutzung in anderen CMS-Blöcken ausgelegt und funktioniert nicht in anderen CMS-Blöcken.

<figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FICKLge0WZRknETGMsJbE%2Fcms-element--image-slide.png?alt=media&#x26;token=367d54e7-9eb9-4137-aa47-d4ded0019470" alt=""><figcaption><p>ThemeWare® "Image slide (Hero slider)"</p></figcaption></figure>

{% hint style="info" %}
**Note**: The element is explicitly intended for use in its own CMS block. It is not designed for use in other CMS blocks and therefore cannot be exchanged or placed in other blocks.
{% endhint %}

{% hint style="warning" %}
**Important**: This element is only available in the ThemeWare® Pro Edition.
{% endhint %}

***

## Configure element

You can configure the ThemeWare® CMS element "Text slide (Hero slider)" as follows:

1. Click on the corresponding CMS block (1) to activate the "edit mode"
2. Navigate to the desired CMS element using the arrow navigation (2)
3. Click on the ![](https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2F2PucLINZ7mAqvu1W2yKk%2Ficon-cog.png?alt=media\&token=56e34152-66e8-4707-8c19-3621b8f2448e) "gear" icon (3) to configure the CMS element
4. The "Element settings" pop-up will open
5. Make the desired changes
6. Save your changes

You have now configured the CMS element.

<figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FOOMztPnsqa3acFmukRQj%2Fcms-image-slide--configure-2.png?alt=media&#x26;token=818da7ac-2ed8-4150-8a4e-ea9b73cbc7c7" alt=""><figcaption><p>ThemeWare® "Image slide" konfigurieren</p></figcaption></figure>

***

## Configuration

The configuration of the "Image slide" is quite self-explanatory. The **image** is a mandatory field. That's all you need to configure.

### General

In the tab "General" you configure the content of the element.

> **Image**
>
> In the section "Image" you define the **background image** (1) of the slide. This is a mandatory field.
>
> **Link**
>
> In the section "Link" you define the target of the teaser when it is clicked.

### Layout

In the tab "Layout" you can configure general settings and a **coloured overlay**.

> **General**
>
> In the section "General" you can configure the **border radius** (border-radius).
>
> **Colour overlay**
>
> In the section "Colour overlay" a **colour overlay** can be activated and configured.

<figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FlHNjzNNYG6XkbPXX4Rxw%2Fimage.png?alt=media&#x26;token=365213f6-3648-4ec0-a717-18785750a0bf" alt=""><figcaption><p>Elements of the "Image slide"</p></figcaption></figure>

### Responsive

In the tab "Responsive" you can optimise the representation for mobile viewports. Here you can configure the **breakpoint** for the image display mode.

> **Image**
>
> In the section "Image" you can configure the **display mode** of the image. With the **breakpoint** you can define when the display mode of the image should change (e.g. from 'cover' to 'contain'). In this way you can, for example, guarantee a **minimum height** in mobile viewports.

### Slide

In the tab "Slide" you can configure the **slide interval** (display duration in milliseconds). Additionally, in the section "Scheduling" you can optionally set a **start date** and **end date** to display the slide only within a specific time period.

{% hint style="warning" %}
**Important**: The "automatic transition" (autoplay) is disabled (from version 3.7 or 4.0) due to accessibility concerns. You can finde more information: [#autoplay-and-accessibility](https://docs.themeware.design/additional-features/cms-blocks/hero-slider#autoplay-and-accessibility "mention")
{% endhint %}

### SEO & Pagespeed

In the tab "SEO & Pagespeed" you can configure the "Lazy loading" of the image.

### Advanced

You can select each HTML element of our slides using the appropriate CSS classes. If you want to use your own CSS classes, you can insert them in the "Advanced" tab.

***

## Breakpoint

### Image

The image of the Hero slides is usually displayed in display mode '**contain**' (1). It scales, while maintaining the aspect ratio, to the full width of the slide.

Since ThemeWare® 2.1 you have the option of defining yourself whether the display mode should change to '**cover**' (2) and if so, from which viewport. In the display mode 'cover' you must also configure the **minimum height** (3) of the slide. This determines the height of the slide and the image fills the slide while maintaining its aspect ratio. If necessary, the image is cropped (4) to fit.

<div><figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FjbErtoLT57FwB6AXQhYE%2Fcms-element--hero-slide-image-contain.png?alt=media&#x26;token=35b525c0-5e9b-42bd-8a08-a5396c24ee38" alt=""><figcaption><p>Disply mode 'contain'</p></figcaption></figure> <figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FBVuRnsq9GE3tlIGwMoBD%2Fcms-element--hero-slide-image-cover.png?alt=media&#x26;token=f01c1be8-211f-4b80-9d81-819a0e0ac3b2" alt=""><figcaption><p>Disply mode 'cover'</p></figcaption></figure> <figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FVpNiAMgpAGegX1Sl9k2l%2Fcms-element--hero-slide-image-cover-2.png?alt=media&#x26;token=96ff7358-ce78-45d7-8446-82b65f059fb1" alt=""><figcaption><p>Disply mode 'cover' in detail</p></figcaption></figure></div>

***

## Demo

You can find some examples of use in our demo shops:

{% embed url="<https://demo.themeware.design/modern/en/Features/ThemeWare-CMS-elements/Hero-slider/>" %}
ThemeWare® Demoshop => Hero slider
{% endembed %}