# Text-Slide (Hero-Slider)

{% hint style="info" %}
**Info**: Dieser Artikel ist in Arbeit...
{% endhint %}

Das ThemeWare® CMS-Element "**Text-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://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2F67PrT1ko3molxrQrA9Ga%2Fcms-element--text-image-slide.png?alt=media&#x26;token=af701111-7c24-4e53-a23d-3ee93c2e8d9c" alt=""><figcaption><p>ThemeWare® "Text-Slide (Hero-Slider)"</p></figcaption></figure>

{% hint style="info" %}
**Hinweis**: Das Element ist explizit für die Verwendung in seinem eigenen CMS-Block vorgesehen. Es ist nicht für die Nutzung in anderen CMS-Blöcken ausgelegt und lässt sich daher nicht austauschen bzw. in anderen Blöcken platzieren.
{% endhint %}

{% hint style="warning" %}
**Wichtig**: Dieses Element ist nur in der ThemeWare® Pro Edition verfügbar.
{% endhint %}

***

## Element konfigurieren

Das ThemeWare® Hero-Slider CMS-Element "Text (Hero-Slider)" kannst du wie folgt konfigurieren:

1. Klicke auf den entsprechenden CMS-Block (1) um den Bearbeitungsmodus zu aktivieren
2. Navigiere mit der Pfeil-Navigation (2) zum gewünschten CMS-Element
3. Klicke auf das ![](https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2FIZM6GLQF0MWHOXpClvGX%2Ficon-cog.png?alt=media\&token=b20c0af0-cbac-4884-89df-58b77f274c9d) "Zahnrad"-Icon (3) um das CMS-Element zu konfigurieren
4. Es öffnet sich das Pop-up "Element-Einstellungen"
5. Nehme die gewünschten Änderungen vor
6. Speichere deine Änderungen

Du hast das CMS-Element nun konfiguriert.

<figure><img src="https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2FROcl2bT0cEqCUgzHIO7g%2Fcms-text-slide--configure-2.png?alt=media&#x26;token=5c29aeeb-aea7-46d0-a281-4c379b7ccecb" alt=""><figcaption><p>ThemeWare® "Text-Slide" konfigurieren</p></figcaption></figure>

{% hint style="info" %}
**Hinweis**: Das Textfeld ist **HTML**-fähig. Links `<a>` sollten allerdings nicht verwendet werden wenn das "Gesamte Element anklickbar" ist, da dies die eigentliche Verlinkung des Slides stört.
{% endhint %}

***

## Konfiguration

Die Konfiguration vom "Text-Slide" ist recht selbsterklärend. Das **Bild** und der **Text** sind Pflichtfelder. Mehr brauchst du genau genommen nicht konfigurieren.

### Allgemein

Im Tab "Allgemein" konfigurierst du den Content des Elementes.

> **Bild**
>
> Im Abschnitt "Bild" definierst du das **Hintergrundbild** (1) des Slides. Dies ist ein Pflichtfeld.
>
> **Content (Inhalt)**
>
> Im Abschnitt "Content" kannst du den **Teaser**-Text, die **Überschrift** (3) und den **Text** (4) für den Slide eingeben. Der Text ist ein Pflichtfeld.
>
> **Link**
>
> Im Abschnitt "Link" definierst du das Ziel des Teasers wenn dieser angeklickt wird.

{% hint style="info" %}
**Hinweis**: Das Textfeld ist **HTML**-fähig. Links `<a>` sollten allerdings nicht verwendet werden wenn das "Gesamte Element anklickbar" ist, da dies die eigentliche Verlinkung des Slides stört.
{% endhint %}

### Layout

Im Tab "Layout" kannst du allgemeine Einstellungen, das **Overlay** (2), den **Text** (3, 4, 5) im Overlay und ein **Farb-Overlay** konfigurieren.

> **Allgemein**
>
> Im Abschnitt "Allgemein" kannst du das **Padding** (Innenabstand) und den **Eckenradius** (border-radius) konfigurieren.
>
> **Content (Inhalt)**
>
> Im Abschnitt "Content" können Sie die **Textausrichtung** und den **Textschatten** konfigurieren.
>
> **Teaser**
>
> Im Abschnitt "Teaser" kannst du die **Schriftart** und **Textfarbe** vom Teaser (3) konfigurieren.
>
> **Überschrift**
>
> Im Abschnitt "Überschrift" kannst du die **Schriftart** und **Textfarbe** der Überschrift (4) konfigurieren.
>
> **Text**
>
> Im Abschnitt "Text" kannst du die **Schriftart** und **Textfarbe** vom Text (5) konfigurieren.
>
> **Content-Overlay**
>
> Im Abschnitt "Content-Overlay" konfigurierst du das Overlay (2). Hier kannst du die **horizontale Ausrichtung** und die **vertikale Ausrichtung** vom Overlay konfigurieren. Zudem kannst du eine Einblend-**Animation** auswählen und die **Breite** (z.B. 100%) sowie die **maximale Breite** (z.B. 50%) für das Overlay festlegen. Außerdem kannst du die **Overlay-Größe** konfigurieren und einen **Hintergrund-Effekt** (z.B. Blur) auswählen.
>
> Mit der Konfiguration "**Overlay-Styling anwenden**" kannst du Konfigurationsfelder zum gestalten des Overlays aktivieren. Hier kannst du die **Hintergrundfarbe** festlegen, einen **Schlagschatten** und **abgerundete Ecken** auswählen.
>
> **Farb-Overlay**
>
> Im Abschnitt "Farb-Overlay" kann ein **Farb-Overlay** aktiviert und konfiguriert werden.

<figure><img src="https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2FOiHm05N06VAUMhSTPhyW%2Fimage.png?alt=media&#x26;token=dc888d95-bf06-47d2-b7a7-14520f6073c6" alt=""><figcaption><p>Elemente vom "Text-Slide"</p></figcaption></figure>

### Responsive

Im Tab "Responsive" kannst du die Darstellung für mobile Viewports optimieren. Hier kannst du **Breakpoints** für den Bild-Anzeigemodus und das Text-Overlay konfigurieren.

> **Bild**
>
> Im Abschnitt "Bild" kann der **Anzeigemodus** des Bildes konfiguriert werden. Mit dem **Breakpoint** kannst du definieren, ab wann der Anzeigemodus des Bildes wechseln soll (z.B. von 'cover' auf 'contain'). So kannst du beispielsweise eine **minimale Höhe** in mobilen Viewports gewährleisten.
>
> **Text**
>
> Im Abschnitt "Text" kann der **Breakpoint** für den Text konfiguriert werden. Ab diesem Breakpoint überlagert der Text das Bild. Außerdem kannst du eine **Hintergrundfarbe** für den Textbereich konfigurieren, die angezeigt wird wenn der Text unterhalb des Bildes dargestellt wird.

### Slide

Im Tab "Slide" kannst du das **Slide-Intervall** (Anzeigedauer in Millisekunden) konfigurieren. Außerdem kannst du im Abschnitt "Zeitsteuerung" optional ein **Startdatum** und **Enddatum** festlegen um den Slide nur in einem bestimmten Zeitraum anzuzeigen.

{% hint style="warning" %}
**Wichtig**: Das "automatische Abspielen" (autoplay) ist aufgrund von Bedenken hinsichtlich der Barrierefreiheit (ab Version 3.7 bzw. 4.0) deaktiviert. Mehr Informationen dazu findest du hier: [#autoplay-und-barrierefreiheit](https://doku.themeware.design/zusatzfunktionen/cms-bloecke/hero-slider#autoplay-und-barrierefreiheit "mention")
{% endhint %}

### SEO & Pagespeed

Im Tab "SEO & Pagespeed" kannst du den HTML-Tag für die Überschrift sowie das "Lazy Loading" vom Bild konfigurieren.

### Erweitert

Du kannst zwar jedes HTML-Element unserer Slides über passende CSS-Klassen selektieren, falls du eigene CSS-Klassen nutzen möchtest, kannst du diese im Tab "Erweitert" einfügen.

***

## Breakpoint

### Bild

Das Bild der Hero-Slides wird üblicherweise im Anzeigemodus '**contain**' (1) dargestellt. Es skaliert, unter Beibehaltung des Seitenverhältnisses, auf die volle Breite des Slides.

Ab ThemeWare® 2.1 hast du die Möglichkeit selber zu definieren ob und wenn ja ab welchem Viewport der Anzeigemodus zu '**cover**' (2) wechseln soll. Im Anzeigemodus 'cover' musst du ergänzend die **minimale Höhe** (3) des Slides konfigurieren. Diese gibt dann die Höhe des Slides vor und das Bild füllt, unter Beibehaltung des Seitenverhältnisses, die angegebene Größe aus. Das Bild wird ggf. beschnitten (4) damit es passt.

<div><figure><img src="https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2F5E45ZCK7bGsOedStXWom%2Fcms-element--hero-slide-image-contain.png?alt=media&#x26;token=50a95b73-7008-4129-8ddf-ae2993ee48bd" alt=""><figcaption><p>Anzeigemodus 'contain'</p></figcaption></figure> <figure><img src="https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2FVtJAfeyuBihlS5kjBDOv%2Fcms-element--hero-slide-image-cover.png?alt=media&#x26;token=4fbaecfc-bd6a-449e-b403-119b2a32407f" alt=""><figcaption><p>Anzeigemodus 'cover'</p></figcaption></figure> <figure><img src="https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2FV7R0NZabkaGLrtepMvbq%2Fcms-element--hero-slide-image-cover-2.png?alt=media&#x26;token=ab9e3822-1747-49b8-9396-96ed84de51f0" alt=""><figcaption><p>Anzeigemodus 'cover' im Detail</p></figcaption></figure></div>

### Text

Der Text in den Hero-Slides überlagert üblicherweise das Bild. In kleineren Viewports kann dies, insbesondere bei langen Texten, nicht mehr perfekt passen, daher wird der Text auf mobilen Geräten unterhalb des Bildes dargestellt.

Ab ThemeWare® 2.1 hast du die Möglichkeit selber zu definieren ob und wenn ja ab welchem Viewport der Text das Bild überlagern soll.

<div><figure><img src="https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2F8T3ZqAde9RIVSUpPsYPJ%2Fimage.png?alt=media&#x26;token=a9c53390-6c42-4e87-9c25-71891b25d025" alt=""><figcaption><p>Text unter dem Bild</p></figcaption></figure> <figure><img src="https://2276716575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ42X804kUeKKTtIEUr2%2Fuploads%2FJNzCGRe8H59LNv6TYl2b%2Fimage.png?alt=media&#x26;token=5f03fbe6-2fcb-4484-9e17-99b8f256caba" alt=""><figcaption><p>Text überlagert das Bild</p></figcaption></figure></div>

***

## Demo

Anwendungsbeispiele findest du in den ThemeWare® Demoshops:

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