From 73126fec0c6602c6ff8961bc9cc9a3bdef011d91 Mon Sep 17 00:00:00 2001 From: Lars Date: Sun, 22 Nov 2026 07:24:03 +0100 Subject: [PATCH] =?UTF-8?q?Spiele=20im=20Einstieg=20ein=20freigegebenes=20?= =?UTF-8?q?Video=20stumm=20auf=20der=20Fl=C3=A4che=20des=20Fotos=20ab?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Neue optionale Auswahl refs.video am Hero (Variante Foto mit Textfläche). Gespielt wird der für die Website freigegebene Clip nach der Regel der Karte (Trailer, Vorschauclip, Website-Datei des Films); nie der vollständige Film. Start nach dem Laden, Schaltfläche zum Anhalten, Foto als Rückfall, kein Selbststart bei reduzierter Bewegung, Datensparmodus und 2G. Keine Migration. Co-Authored-By: Claude Sonnet 5.5 --- app/Domain/Cms/Widgets/Support/HeroVideo.php | 137 +++++++++ app/Domain/Cms/Widgets/Types/HeroWidget.php | 31 +- .../12_Entscheidungsprotokoll_ADR.md | 3 +- docs/architektur/cms-widget-registry.md | 4 +- .../medienzugriff-fuer-komponenten.md | 2 + .../Release-Vorbereitung_2026-11-21.md | 2 + resources/css/components/lf-hero.css | 48 +++ resources/js/app.js | 1 + resources/js/hero-video.js | 203 +++++++++++++ resources/views/widgets/hero.blade.php | 19 +- tests/Feature/CmsHeroVideoTest.php | 286 ++++++++++++++++++ 11 files changed, 731 insertions(+), 5 deletions(-) create mode 100644 app/Domain/Cms/Widgets/Support/HeroVideo.php create mode 100644 resources/js/hero-video.js create mode 100644 tests/Feature/CmsHeroVideoTest.php diff --git a/app/Domain/Cms/Widgets/Support/HeroVideo.php b/app/Domain/Cms/Widgets/Support/HeroVideo.php new file mode 100644 index 0000000..dcdf85a --- /dev/null +++ b/app/Domain/Cms/Widgets/Support/HeroVideo.php @@ -0,0 +1,137 @@ + + */ + public function options(?string $term, int $limit = 25): array + { + $term = trim((string) $term); + + $candidates = ContentElement::query() + ->with('editorialContentKind') + ->where('output_class', 'film') + ->whereNull('archived_at') + ->when($term !== '', function ($query) use ($term): void { + $like = '%'.mb_strtolower($term).'%'; + $query->where(fn ($inner) => $inner + ->whereRaw('LOWER(working_title) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like])); + }) + ->orderBy('working_title') + ->limit($limit * 2) + ->get(); + + $options = []; + + foreach ($candidates as $element) { + if (! $this->allowed($element)) { + continue; + } + + $options[$element->id] = $this->label($element); + + if (count($options) >= $limit) { + break; + } + } + + return $options; + } + + public function labelFor(mixed $id): ?string + { + $element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null; + + return $element instanceof ContentElement ? $this->label($element) : null; + } + + /** + * Prüft die gewählte Kennung. Gibt die Kennung zurück oder null, wenn keine gewählt ist oder die Wahl ungültig ist. + */ + public function clean(mixed $value, WidgetErrors $errors, string $key = 'refs.video'): ?int + { + if ($value === null || $value === '' || $value === false) { + return null; + } + + $element = is_numeric($value) ? ContentElement::query()->with('editorialContentKind')->find((int) $value) : null; + + if (! $element instanceof ContentElement || ! $this->allowed($element)) { + $errors->add($key, 'Bitte einen Film aus dem Medienmanager wählen (nicht archiviert, nicht gesperrt, keine Traineranleitung).'); + + return null; + } + + return $element->id; + } + + /** + * @return array{url: string|null, title: string, notice: string|null} + */ + public function resolve(mixed $id, bool $preview): array + { + $element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null; + + if (! $element instanceof ContentElement) { + return ['url' => null, 'title' => '', 'notice' => null]; + } + + $title = (string) ($element->display_title ?: $element->working_title); + + if (! $this->allowed($element)) { + return ['url' => null, 'title' => $title, 'notice' => $preview ? 'Das gewählte Medium „'.$title.'“ ist archiviert oder gesperrt; es erscheint kein Video.' : null]; + } + + $clip = $this->clips->for($element, $preview); + + if ($clip['url'] !== null) { + return ['url' => $clip['url'], 'title' => $clip['title'] !== '' ? $clip['title'] : $title, 'notice' => null]; + } + + return [ + 'url' => null, + 'title' => $title, + 'notice' => $preview + ? 'Für „'.$title.'“ gibt es kein für die Website freigegebenes Video (Trailer, Vorschauclip oder freigegebene Website-Datei des Mediums); öffentlich bleibt es beim Foto. Freigabe: Medium öffnen → Reiter „Website“.' + : null, + ]; + } + + /** Ein Film, der nicht archiviert, nicht gesperrt und keine Traineranleitung ist. */ + private function allowed(ContentElement $element): bool + { + return $element->output_class === 'film' + && $this->materials->isSelectable($element) + && ! in_array($element->editorialContentKind?->slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true); + } + + private function label(ContentElement $element): string + { + $state = $this->clips->for($element, false)['url'] !== null ? 'Video freigegeben' : 'noch kein freigegebenes Video'; + + return (string) ($element->display_title ?: $element->working_title).' · '.$state; + } +} diff --git a/app/Domain/Cms/Widgets/Types/HeroWidget.php b/app/Domain/Cms/Widgets/Types/HeroWidget.php index ad02d15..5f0427d 100644 --- a/app/Domain/Cms/Widgets/Types/HeroWidget.php +++ b/app/Domain/Cms/Widgets/Types/HeroWidget.php @@ -3,12 +3,14 @@ namespace App\Domain\Cms\Widgets\Types; use App\Domain\Cms\Widgets\RenderContext; +use App\Domain\Cms\Widgets\Support\HeroVideo; use App\Domain\Cms\Widgets\Support\ImageRefFields; use App\Domain\Cms\Widgets\Support\PremiumFields; use App\Domain\Cms\Widgets\Support\PublicMedia; use App\Domain\Cms\Widgets\Support\WebsiteImage; use App\Domain\Cms\Widgets\WidgetErrors; use App\Domain\Cms\Widgets\WidgetType; +use Filament\Forms\Components\Select; use Filament\Forms\Components\Textarea; use Filament\Forms\Components\TextInput; use Filament\Schemas\Components\Group; @@ -20,6 +22,10 @@ * Containerbreite), Label, Überschriftenebene, Bildfokus in Prozent, Akzent, zwei Schaltflächen. * Die data-Schlüssel der Version 1 (heading, text, cta_*, alt) bleiben unverändert, damit ältere Revisionen und ein * Code-Rollback darstellbar bleiben. + * + * Optional ein Video (refs.video, ein Film aus dem Medienmanager): In der Variante „Foto mit Textfläche“ läuft ein + * stummer, für die Website freigegebener Clip auf der Fläche des Fotos (HeroVideo, resources/js/hero-video.js). Neuer + * Schlüssel ohne Versionssprung; ältere Revisionen ohne `video` bleiben unverändert darstellbar. */ class HeroWidget extends WidgetType { @@ -152,7 +158,7 @@ public function dataRules(): array public function refRules(): array { - return ImageRefFields::rules(); + return ImageRefFields::rules() + ['video' => ['nullable']]; } public function dataFields(): array @@ -169,7 +175,19 @@ public function dataFields(): array public function refFields(): array { - return ImageRefFields::fields(live: true); + return [...ImageRefFields::fields(live: true), $this->videoField()]; + } + + private function videoField(): Select + { + return Select::make('video') + ->label('Video (optional)') + ->helperText('Ein Film aus dem Medienmanager. Läuft stumm auf der Fläche des Fotos, nur in der Variante „Foto mit Textfläche“ und nur, wenn ein Trailer, Vorschauclip oder die Website-Datei des Films für die Website freigegeben ist. Das Foto bleibt als Rückfall, bei „reduzierte Bewegung“ und im Datensparmodus startet das Video nur auf Wunsch. Die Auswahl gibt nichts frei.') + ->live() + ->searchable() + ->getSearchResultsUsing(fn (?string $search): array => app(HeroVideo::class)->options($search)) + ->getOptionLabelUsing(fn (mixed $value): ?string => app(HeroVideo::class)->labelFor($value)) + ->options(fn (): array => app(HeroVideo::class)->options(null)); } public function editorSchema(): array @@ -192,6 +210,8 @@ public function mediaSchema(): array public function clean(array $data, array $refs, WidgetErrors $errors): array { $refs = ImageRefFields::clean($refs, $errors); + $video = app(HeroVideo::class)->clean($refs['video'] ?? null, $errors); + $video === null ? $refs = array_diff_key($refs, ['video' => true]) : $refs['video'] = $video; $data['heading'] = trim((string) ($data['heading'] ?? '')); $data['text'] = filled($data['text'] ?? null) ? trim((string) $data['text']) : null; $data = PremiumFields::clean($data, $errors, $refs['image'] !== null); @@ -205,8 +225,15 @@ public function resolve(array $widget, RenderContext $context): array $images = app(WebsiteImage::class); $image = $widget['refs']['image'] ?? null; + $video = app(HeroVideo::class)->resolve($widget['refs']['video'] ?? null, $context->preview); + $photoSplit = ($widget['variant'] ?? 'photo_split') !== 'editorial_solid'; + + if (! $photoSplit && $video['title'] !== '') { + $video = ['url' => null, 'title' => $video['title'], 'notice' => $context->preview ? 'Das Video erscheint nur in der Variante „Foto mit Textfläche“; die Markenfläche zeigt kein Video.' : null]; + } return [ + 'video' => $video, 'imageUrl' => $images->url($image, $context->preview), 'imageAlt' => $images->alt($image, $widget['data']['alt'] ?? null), 'imageNotice' => $context->preview ? $images->previewNotice($image) : null, diff --git a/docs/architektur/12_Entscheidungsprotokoll_ADR.md b/docs/architektur/12_Entscheidungsprotokoll_ADR.md index 8e287be..ed7a775 100644 --- a/docs/architektur/12_Entscheidungsprotokoll_ADR.md +++ b/docs/architektur/12_Entscheidungsprotokoll_ADR.md @@ -576,6 +576,7 @@ ## ADR-43 – Trailer auf Karten - **Rechte:** Es spielt nur ein für die Website freigegebener Clip. Der vollständige Film, die Originaldatei und nicht freigegebene Clips kommen nie über eine Karte, auch nicht in der Redaktionsvorschau; diese nennt stattdessen, dass der Trailer nicht freigegeben ist. Die Karte gibt nichts frei und bietet keinen Download. Die Karte einer Traineranleitung erscheint weiter öffentlich nie. - **Auslieferung:** Die Route `website.media` beantwortet Bereichsabrufe (`Range`, Antwort 206/416) für Filme und Hörstücke. Safari und iOS spielen sonst nicht ab. **Alternativen.** Clip je Karte frei wählen (verworfen: mehrere Wege, doppelte Pflege); Autoplay mit Ton oder ohne Bedienung (verworfen: Barrierefreiheit, Datenvolumen); Clip aus dem vollständigen Film erzeugen (verworfen: Rechte, kein freigegebener Clip). -**Folgen.** Neue Einstellung `clip` an der Medien-, Programm- und Modulkarte, Klasse `CardClip`, Skript `resources/js/card-clip.js`; keine Migration. Bereits gespeicherte Karten ohne Wahl spielen einen freigegebenen Trailer ab (Vorgabe Abspielen). Offen: Trailer im Hero-Widget als Hintergrund (nicht entschieden); Hinweis „Mit Ton starten“ nicht vorgesehen. +**Folgen.** Neue Einstellung `clip` an der Medien-, Programm- und Modulkarte, Klasse `CardClip`, Skript `resources/js/card-clip.js`; keine Migration. Bereits gespeicherte Karten ohne Wahl spielen einen freigegebenen Trailer ab (Vorgabe Abspielen). Hinweis „Mit Ton starten“ nicht vorgesehen. +**Nachtrag Hero (22.11.2026).** Das Hero-Widget (Variante „Foto mit Textfläche“) kann ein Video zeigen: optionale Auswahl `refs.video` (ein Film aus dem Medienmanager, Klasse `HeroVideo`, Skript `resources/js/hero-video.js`). Der Clip folgt derselben Regel wie auf der Karte (Trailer, sonst Vorschauclip, sonst die freigegebene Website-Datei des Films; nie der vollständige Film, nie ein nicht freigegebener Clip). Er läuft stumm auf der Fläche des Fotos und startet nach dem Laden der Seite von selbst, sobald der Einstieg im Bild ist; das Foto bleibt darunter, bis das erste Videobild da ist, und ist der Rückfall bei Fehlern. Eine Schaltfläche „Video“ hält an und spielt ab (WCAG 2.2.2). Bei „reduzierte Bewegung“, im Datensparmodus und bei 2G startet nichts von selbst, nur auf Bedienung und ohne Schleife. Er hält an, wenn der Einstieg aus dem Bild scrollt, und läuft nur weiter, wenn er von selbst lief und nicht angehalten wurde. In der Markenfläche (`editorial_solid`) gibt es kein Video. Neuer Schlüssel ohne Versionssprung, keine Migration. Hinweis „Mit Ton starten“ und Video als Seitenhintergrund bleiben ausgeschlossen. **Quelle.** `docs/ux/verwaltung/04-fachliche-anforderungen.md` FACH-46; `medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md`; ADR-39, ADR-40, ADR-41. diff --git a/docs/architektur/cms-widget-registry.md b/docs/architektur/cms-widget-registry.md index 291d671..cceac60 100644 --- a/docs/architektur/cms-widget-registry.md +++ b/docs/architektur/cms-widget-registry.md @@ -70,7 +70,7 @@ ## 4. Registrierte Widget-Arten | Kennung | Name | Version | Varianten | Breiten (Einheiten) | Höhen | Verweise | |---|---|---|---|---|---|---| -| `hero` | Einstieg (Hero), Premium nach Kit v1.6 | 2 | `photo_split` (Foto mit Textfläche), `editorial_solid` (Navy-Markenfläche) | 3, 4 | `compact` (mind. 400 px), `normal` (512 px, Vorgabe), `large` (640 px) | `refs.image` | +| `hero` | Einstieg (Hero), Premium nach Kit v1.6 | 2 | `photo_split` (Foto mit Textfläche), `editorial_solid` (Navy-Markenfläche) | 3, 4 | `compact` (mind. 400 px), `normal` (512 px, Vorgabe), `large` (640 px) | `refs.image`, `refs.video` (optional) | | `heading` | Überschrift und Einleitung | 1 | `standard` | 1–4 | – | – | | `prose` | Fließtext | 1 | `standard` | 1–4 | – | – | | `image_text` | Bild und Text, Premium nach Kit v1.6 | 3 | `image_left`, `image_right` (Bildseite) | 1–4 | `compact`, `normal` (Vorgabe), `spacious` | `refs.image` | @@ -312,6 +312,8 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39) **Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px). +**Video im Einstieg (Hero, Variante `photo_split`).** Optional `refs.video`: ein Film aus dem Medienmanager (Auswahl über `HeroVideo`, geprüft: Film, nicht archiviert, nicht gesperrt, keine Traineranleitung). Gespielt wird der freigegebene Clip nach der Regel der Karte (`CardClip`: Trailer, Vorschauclip, sonst die freigegebene Website-Datei des Films). Das Video liegt stumm auf der Fläche des Fotos, startet nach dem Laden von selbst (nicht bei „reduzierte Bewegung“, Datensparmodus, 2G), hat eine Schaltfläche zum Anhalten und fällt bei Fehlern auf das Foto zurück; `resources/js/hero-video.js`. Die Markenfläche zeigt kein Video. Entscheidung: ADR-43 (Nachtrag). + **Trailer auf der Karte (Medien-, Programm- und Modulkarte).** Einstellung `settings.clip` (`yes` Vorgabe, `no`). Der Clip ist der Trailer des Objekts (Präsentationsrolle „Trailer“, sonst „Vorschauclip“, bei einem Film ersatzweise sein freigegebener Teaser), nur wenn er für die Website freigegeben ist (`CardClip`). Er liegt stumm über dem Kartenbild und startet beim Überfahren mit der Maus, am Handy mit Tippen, per Tastatur über die Schaltfläche am Bild; `resources/js/card-clip.js`. Ohne Freigabe bleibt das Bild; die Redaktionsvorschau nennt den Grund. Entscheidung: ADR-43. **Text der Karte.** Einstellung `settings.text_source` (`auto` Vorgabe, `teaser`, `summary`, `description`; an der Programm- und Modulkarte zusätzlich `goal`, das Lernziel der Fassung). `auto` entspricht dem bisherigen Verhalten je Karte (Medien: Kurzbeschreibung, sonst Teaser; Programm und Modul: Teaser, sonst Kurzbeschreibung, sonst Lernziel); die Themenkarte hat nur einen Text und keine Wahl. Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Die ausführliche Beschreibung erscheint nur auf diese Wahl (öffentlich, sofern die Karte öffentlich ist). Der eigene Text der Karte (`data.summary`) hat Vorrang. diff --git a/docs/architektur/medienzugriff-fuer-komponenten.md b/docs/architektur/medienzugriff-fuer-komponenten.md index de121c5..c991cf8 100644 --- a/docs/architektur/medienzugriff-fuer-komponenten.md +++ b/docs/architektur/medienzugriff-fuer-komponenten.md @@ -186,3 +186,5 @@ ### Trailer auf Medien-, Programm- und Modulkarten Ein Trailer ist ein eigenes Medium (Film ohne Fassung, Ableitung unter `teaser/`), das im Medienmanager einem Medium, Programm oder Modul in der Präsentation mit der Rolle „Trailer“ oder „Vorschauclip“ zugeordnet wird. Die Karte spielt ihn ab, wenn er für die Website freigegeben ist (Reiter „Website“ am Trailer). Lesende Klasse: `CardClip` (Trailer, sonst Vorschauclip, bei einem Film ersatzweise sein eigener freigegebener Teaser). Ausgeliefert wird über `website.media`, die Bereichsabrufe (`Range`) beantwortet. Nicht freigegebene Clips, der vollständige Film und Originale kommen nie über die Karte. Die Redaktionsvorschau spielt ebenfalls nur freigegebene Clips und nennt sonst den Grund. Verhalten (Maus, Tipp, Tastatur, reduzierte Bewegung, Datensparmodus): ADR-43. +Ein Film, der nur aus einer Website-Datei besteht (Medium ohne Fassung, zum Beispiel ein Teaser), ist auf der Medienkarte wählbar (`PublicMaterialReader::isWebsiteOnlyFilm`). Öffentlich erscheint die Karte, sobald diese Datei für die Website freigegeben ist, ohne Verweis auf eine Programmseite und damit ohne Aktion; ohne Freigabe nur in der Redaktionsvorschau. Dasselbe freigegebene Video nutzt der Einstieg (Hero, `HeroVideo`). + diff --git a/docs/betrieb/Release-Vorbereitung_2026-11-21.md b/docs/betrieb/Release-Vorbereitung_2026-11-21.md index a939993..4e70b1a 100644 --- a/docs/betrieb/Release-Vorbereitung_2026-11-21.md +++ b/docs/betrieb/Release-Vorbereitung_2026-11-21.md @@ -11,6 +11,8 @@ ## 1. Inhalt (Stand 21.11.2026 abends: 22 Commits seit `main`) | Medien- und Materialkarte | Text der Karte wählen (Teaser, Kurzbeschreibung, Ausführliche Beschreibung); Bild aus dem Film (Regler mit Live-Bild, Vorschaubild übernehmen) | Claude | | Programm- und Modulkarte | Text der Karte wählen (zusätzlich Lernziel); Vorschaubild als Website-Bild übernehmen | Claude | | Trailer auf Karten | Medien-, Programm- und Modulkarte spielen den für die Website freigegebenen Trailer (Rolle Trailer, sonst Vorschauclip, bei Filmen ersatzweise der eigene Teaser) stumm beim Überfahren mit der Maus oder per Tipp ab; je Karte abschaltbar; die Medienroute beantwortet Bereichsabrufe (ADR-43). Auf luf-test mit einem echten Clip geprüft. Keine Migration | Claude | +| Medienkarte: Film nur mit Website-Datei | Ein Medium ohne Fassung (z. B. Teaser) ist auf der Medienkarte wählbar und erscheint öffentlich, sobald die Datei für die Website freigegeben ist (ohne Programmseite, ohne Aktion). Keine Migration | Claude | +| Hero mit Video | Der Einstieg (Variante Foto mit Textfläche) spielt auf Wunsch ein freigegebenes Video stumm auf der Fläche des Fotos ab, mit Schaltfläche zum Anhalten; Foto als Rückfall (ADR-43 Nachtrag). Keine Migration | Claude | | Website-Datei eines Films | Ablage der Datei eines eigenständigen Präsentationsmediums über die Warteschlange, nachträgliches Hochladen am Medium (Behebung: der Web-Prozess darf `derived/` nicht schreiben) | Lars (anderer Rechner) | | Medienmanager | „Medium löschen“ erreicht Standbilder und übernommene CMS-Bilder (Fremdschlüssel gelockert) | Claude | | Fachliche Säulen | Vereinheitlichung auf die zentrale Säulenverwaltung | Lars (anderer Rechner) | diff --git a/resources/css/components/lf-hero.css b/resources/css/components/lf-hero.css index 60ee795..babd297 100644 --- a/resources/css/components/lf-hero.css +++ b/resources/css/components/lf-hero.css @@ -48,6 +48,52 @@ .lf-hero__photo { border-radius: inherit; } +/* + * Video auf der Fläche des Fotos (nur photo_split, resources/js/hero-video.js). Das Foto bleibt darunter sichtbar, bis + * das erste Videobild da ist; ohne JavaScript, bei Fehlern und ohne freigegebenen Clip bleibt es beim Foto. + */ +.lf-hero__video { + position: absolute; + inset: 0; + z-index: -2; + inline-size: 100%; + block-size: 100%; + max-inline-size: none; + object-fit: cover; + object-position: var(--lf-hero-focus-x) var(--lf-hero-focus-y); + border-radius: inherit; + opacity: 0; + transition: opacity 0.4s ease; + pointer-events: none; +} + +.lf-hero.is-hero-started .lf-hero__video { opacity: 1; } + +.lf-hero__video-toggle { + position: absolute; + inset: 12px 12px auto auto; + z-index: 2; + display: inline-flex; + align-items: center; + gap: 6px; + min-block-size: 44px; + padding: 8px 14px 8px 10px; + border: 0; + border-radius: 999px; + color: #fff; + background: rgb(3 37 81 / 86%); + font: 600 0.8125rem/1.2 var(--lf-font-ui, system-ui, sans-serif); + cursor: pointer; +} + +.lf-hero__video-toggle[hidden] { display: none; } +.lf-hero__video-toggle:hover { background: var(--lf-navy-deep, var(--lf-hero-navy)); } +.lf-hero__video-toggle:focus-visible { outline: 3px solid var(--lf-hero-yellow); outline-offset: 3px; } +.lf-hero__video-icon { inline-size: 20px; block-size: 20px; } +.lf-hero__video-pause, +.lf-hero__video-toggle[aria-pressed="true"] .lf-hero__video-play { display: none; } +.lf-hero__video-toggle[aria-pressed="true"] .lf-hero__video-pause { display: inline; } + .lf-hero--photo-split::before { content: ''; position: absolute; @@ -189,6 +235,7 @@ @container lf-hero (max-width: 859.99px) { .lf-hero--height-normal, .lf-hero--height-large { min-block-size: 0; } .lf-hero__photo { position: relative; display: block; block-size: auto; aspect-ratio: 16 / 9; } + .lf-hero__video { inset: 0 0 auto 0; block-size: auto; aspect-ratio: 16 / 9; border-radius: inherit; } .lf-hero--photo-split::before { display: none; } .lf-hero__inner { padding: clamp(1.2rem, 3.5cqi, 2rem); padding-block-end: 2.4rem; } .lf-hero__copy { max-inline-size: 100%; } @@ -204,6 +251,7 @@ @container lf-hero (max-width: 440px) { } @media (prefers-reduced-motion: reduce) { + .lf-hero__video { transition: none; } .lf-hero__button { transition: none; } .lf-hero__button:hover { transform: none; } } diff --git a/resources/js/app.js b/resources/js/app.js index 25a2608..5033362 100644 --- a/resources/js/app.js +++ b/resources/js/app.js @@ -1,6 +1,7 @@ import Hls from 'hls.js'; import './site-nav.js'; import './card-clip.js'; +import './hero-video.js'; function attachPlayback(video) { if (!(video instanceof HTMLVideoElement) || video.dataset.playbackReady === '1') { diff --git a/resources/js/hero-video.js b/resources/js/hero-video.js new file mode 100644 index 0000000..ebba1ea --- /dev/null +++ b/resources/js/hero-video.js @@ -0,0 +1,203 @@ +/* + * Video im Einstieg (Hero, Variante „Foto mit Textfläche“). + * + * Ein Einstieg mit [data-hero-video] trägt einen für die Website freigegebenen Clip (data-clip-src). Der Clip + * - startet stumm von selbst, sobald die Seite geladen ist (die Quelle wird erst dann gesetzt, preload="none"), + * - lässt das Foto stehen, bis das erste Videobild da ist (Klasse is-hero-started), und fällt bei Fehlern auf das Foto zurück, + * - startet bei „reduzierte Bewegung“, im Datensparmodus und bei sehr langsamer Verbindung nie von selbst, sondern nur + * auf ausdrückliche Bedienung, dann ohne Schleife, + * - hat immer eine Schaltfläche zum Anhalten und Abspielen (WCAG 2.2.2), + * - hält an, sobald der Einstieg aus dem Bild scrollt oder der Tab verborgen ist, und läuft danach nur weiter, wenn + * er von selbst lief und nicht angehalten wurde. + * Ohne JavaScript bleibt es beim Foto; die Schaltfläche erscheint erst, wenn dieses Skript sie freigibt. + */ +const REDUCED = window.matchMedia ? window.matchMedia('(prefers-reduced-motion: reduce)') : { matches: false }; + +function connection() { + return navigator.connection || null; +} + +function mayAutoplay() { + const link = connection(); + + if (REDUCED.matches) { + return false; + } + + if (link && (link.saveData || /(^|-)2g$/.test(String(link.effectiveType || '')))) { + return false; + } + + return true; +} + +function whenLoaded(callback) { + const run = () => { + if ('requestIdleCallback' in window) { + window.requestIdleCallback(callback, { timeout: 2500 }); + } else { + window.setTimeout(callback, 200); + } + }; + + if (document.readyState === 'complete') { + run(); + } else { + window.addEventListener('load', run, { once: true }); + } +} + +function setup(hero) { + if (hero.dataset.heroVideoReady === '1') { + return; + } + + const video = hero.querySelector('video.lf-hero__video'); + const toggle = hero.querySelector('[data-hero-toggle]'); + const source = hero.dataset.clipSrc; + + if (!(video instanceof HTMLVideoElement) || !toggle || !source) { + return; + } + + hero.dataset.heroVideoReady = '1'; + + const title = hero.dataset.clipTitle || ''; + let playing = false; + let wantsPlay = false; // läuft (oder lief) nach Absicht der Besucherin oder des Besuchers bzw. von selbst + let failed = false; + let armed = mayAutoplay(); // darf noch von selbst starten (einmal, sobald geladen und im Bild) + let loaded = false; + + function inView() { + const box = hero.getBoundingClientRect(); + + return box.bottom > 0 && box.top < window.innerHeight; + } + + function label() { + toggle.setAttribute('aria-pressed', playing ? 'true' : 'false'); + toggle.setAttribute('aria-label', (playing ? 'Video anhalten: ' : 'Video abspielen: ') + title); + } + + function play(auto) { + if (failed) { + return; + } + + if (!video.getAttribute('src')) { + video.src = source; + } + + video.muted = true; + video.loop = !REDUCED.matches; + wantsPlay = true; + playing = true; + label(); + + const attempt = video.play(); + + if (attempt && typeof attempt.catch === 'function') { + attempt.catch(() => { + // Vom Browser nicht erlaubt: das Foto bleibt, die Schaltfläche bietet das Abspielen an. + playing = false; + wantsPlay = false; + label(); + }); + } + + hero.dataset.heroAuto = auto ? '1' : '0'; + } + + function pause(byUser) { + playing = false; + + if (byUser) { + wantsPlay = false; + } + + video.pause(); + label(); + } + + video.addEventListener('playing', () => hero.classList.add('is-hero-started')); + + video.addEventListener('ended', () => { + playing = false; + wantsPlay = false; + hero.classList.remove('is-hero-started'); + label(); + }); + + video.addEventListener('error', () => { + failed = true; + playing = false; + hero.classList.remove('is-hero-started'); + hero.classList.add('is-hero-failed'); + toggle.hidden = true; + }); + + toggle.addEventListener('click', () => { + if (playing) { + pause(true); + } else { + play(false); + } + }); + + if ('IntersectionObserver' in window) { + new IntersectionObserver((entries) => { + entries.forEach((entry) => { + if (entry.isIntersecting) { + if (armed && loaded && !wantsPlay && !document.hidden) { + armed = false; + play(true); + } else if (wantsPlay && !playing && !document.hidden) { + play(hero.dataset.heroAuto === '1'); + } + } else if (playing) { + pause(false); + } + }); + }, { threshold: 0.15 }).observe(hero); + } + + document.addEventListener('visibilitychange', () => { + if (document.hidden && playing) { + pause(false); + } else if (!document.hidden && wantsPlay && !playing && inView()) { + play(hero.dataset.heroAuto === '1'); + } + }); + + label(); + toggle.hidden = false; + hero.classList.add('is-hero-ready'); + + if (armed) { + whenLoaded(() => { + loaded = true; + + if (armed && !failed && !wantsPlay && inView() && !document.hidden) { + armed = false; + play(true); + } + }); + } +} + +function scan(root) { + if (root instanceof Element) { + if (root.matches('[data-hero-video]')) { + setup(root); + } + + root.querySelectorAll('[data-hero-video]').forEach(setup); + } +} + +scan(document.documentElement); + +new MutationObserver((records) => { + records.forEach((record) => record.addedNodes.forEach(scan)); +}).observe(document.documentElement, { childList: true, subtree: true }); diff --git a/resources/views/widgets/hero.blade.php b/resources/views/widgets/hero.blade.php index b263901..f77e061 100644 --- a/resources/views/widgets/hero.blade.php +++ b/resources/views/widgets/hero.blade.php @@ -3,19 +3,33 @@ Varianten: photo_split (Foto mit heller Textfläche), editorial_solid (Navy-Markenfläche ohne Foto). Höhen compact/normal/large sind Mindesthöhen ab 860 px Containerbreite; darunter Sicherheitsumbruch. Das Bild des ersten Widgets der Seite wird sofort geladen, alle anderen verzögert. + Video (nur photo_split): stummer, freigegebener Clip auf der Fläche des Fotos (HeroVideo). Das