Arrière-plans, médias et blocs-outils
Widget d'arrière-plan (image, couleur, vidéo, parallaxe, surcouche), arrière-plan vidéo et conteneur vidéo, vidéo auto-hébergée, lightbox, galerie, lecteur PDF, recherche, blog, animations et traducteur – chacun avec les marqueurs que l'auteur de bloc pose et ce que le programme en fait.
Vue d'ensemble#
Les médias et les blocs-outils suivent deux schémas :
- Marqueur dans le modèle : l'auteur de bloc pose un attribut, une classe ou un widget (
fieldset type="background",data-bg-video,class="vn-zoom",[vn-video]…). Le programme le reconnaît lors du rendu ou de l'export. - Bibliothèque d'exécution : uniquement si la page exportée en contient une trace, l'export copie le fichier correspondant depuis
vendor/et l'intègre (voir Bibliothèques fournies).
Widget d'arrière-plan#
fieldset type="background"#
Le widget d'arrière-plan du panneau des propriétés se compose d'un fieldset comportant jusqu'à trois entrées : image, couleur, vidéo. L'utilisateur choisit l'un des types.
Syntaxe
<vn-parameters>
<header>Hintergrund</header>
<fieldset type="background" name="bg" title="Hintergrund">
<input type="image" title="Bild" value="">
<input type="color" title="Farbe" value="#f8fafc" selected>
<input type="video" title="Video" value="">
</fieldset>
</vn-parameters>(extrait de gallery-content/vn-bloecke/src/artikel/inhalt/template.html, ici seulement image et couleur)
| Élément | Valeurs | Par défaut | Signification |
|---|---|---|---|
fieldset (type="background") | — | — | Le widget : tout fieldset du bloc vn-parameters qui contient un input de type image, color ou video. type="background" est la convention d'écriture |
name | nom de champ | bg | Nom du champ ; clé dans block.values et nom dans l'expression |
title | texte | Hintergrund | Libellé dans le panneau |
input[type=image] | adresse dans value | vide | Type image ; l'attribut parallax active par défaut l'effet de parallaxe |
input[type=color] | #rrggbb dans value | #000000 | Type couleur |
input[type=video] | adresse dans value | vide | Type vidéo (YouTube, Vimeo ou fichier) |
selected | interrupteur sur une entrée | — | Le type présélectionné |
Quel type s'applique en premier : la vidéo, si elle est selected ou si le widget n'a rien d'autre ; sinon l'image, si elle est selected ou s'il n'y a pas de couleur ; sinon la couleur.
Ce qui est enregistré dans block.values[<name>] :
{ "type": "image", "value": { "url": "assets/images/hero.jpg" }, "parallax": true }
{ "type": "color", "value": "#112233", "parallax": false }
{ "type": "video", "value": { "url": "https://youtu.be/abc12345678" }, "parallax": false }Accès dans le modèle et dans LESS#
| Endroit | Expression | Valeur |
|---|---|---|
Modèle ({{…}}, vn-if, vn-class) | bg.type | image, color ou video |
| Modèle | bg.value | Pour image/vidéo : un objet qui renvoie aussi l'adresse sous forme de texte (toString) ; couleur : la valeur hexadécimale |
| Modèle | bg.value.url | Adresse (image et vidéo) |
| Modèle | bg.parallax | Valeur booléenne |
| LESS | @bg-type | 'image', 'color', 'video' (chaîne entre apostrophes) |
| LESS | @bg-value | Pour image et vidéo : l'adresse sous forme de chaîne, pour la couleur : la couleur |
| LESS | @bg-parallax | true ou false |
Là où des adresses d'image figurent comme variable LESS, écrivez url(@bg-value) et non url({{…}}) : @bg-value est déjà une chaîne sans url(…). Les comparaisons comme (@bg-type = "image") avec des guillemets doubles sont réécrites par le programme avec des apostrophes.
Vérifié (bloc avec widget, trois états rendus) :
/* bg = Bild + Parallax */
.vn-imp-test-b1 { min-height: 300px; background-image: url("assets/images/a.jpg"); }
.vn-imp-test-b1 { background-attachment: fixed; }
/* bg = Farbe: kein Bild, kein Parallax */
.vn-imp-test-b1 { min-height: 300px; }Parallaxe#
Si le widget est de type « Image » et que « Effet de parallaxe » est activé (bg.parallax), le programme ajoute background-attachment: fixed au CSS du bloc. Cela se produit en plus de @bg-parallax, car le LESS des anciens blocs ne connaît pas la variable. Pour la couleur et la vidéo, il n'y a pas de parallaxe.
& when (@bg-type = 'image') { background-image: url(@bg-value); background-size: cover; background-position: center; }Surcouche : assombrir l'arrière-plan#
Il existe deux moyens d'assombrir une image.
1. Champs et LESS propres (recommandé, contrôle total) : couleur et intensité comme champs du panneau, un calque via CSS.
<input type="color" title="Bild abdunkeln: Farbe" name="overlayColor" value="#000000" condition="bg.type == 'image'">
<input type="range" inline title="Bild abdunkeln (%)" name="overlay" min="0" max="85" step="5" value="40" condition="bg.type == 'image'">2. L'élément de surcouche vn-overlay : un élément portant la classe vn-overlay devient un calque opaque.
<div class="vn-overlay" opacity="0.4" bg-color="#000000"></div>| Attribut | Valeur | Signification |
|---|---|---|
Classe vn-overlay | — | L'élément reçoit position:absolute; inset:0; pointer-events:none |
opacity | 0–1 | Opacité (devient style="opacity", l'attribut disparaît) |
bg-color | couleur | Couleur d'arrière-plan (devient style="background-color") |
Vérifié : <div class="vn-overlay" opacity="0.4" bg-color="#000000"> devient style="position: absolute; inset: 0px; pointer-events: none; opacity: 0.4; background-color: rgb(0, 0, 0);". L'élément parent doit avoir position: relative.
Arrière-plan vidéo#
data-bg-video#
Un bloc dont l'élément racine porte data-bg-video="<adresse>" reçoit, à l'export, une vidéo d'arrière-plan. L'adresse est le plus souvent une expression issue du widget.
Syntaxe
<section data-bg-video="{{bg.type == 'video' && bg.value.url}}">
<vn-parameters>
<fieldset type="background" name="bg">
<input type="image" title="Bild" value="">
<input type="video" title="Video" value="">
</fieldset>
</vn-parameters>
<div class="container"> … Inhalt … </div>
</section>Valeur de data-bg-video | Effet |
|---|---|
| Adresse (YouTube, Vimeo, fichier) | La vidéo est insérée |
vide, false, undefined, null, 0 | pas de vidéo (les blocs qui ne sont pas en mode vidéo rendent data-bg-video="false") |
L'export intègre vendor/vn-bgvideo/vn-bgvideo.js dès qu'un bloc quelconque a un data-bg-video avec une valeur (ou la classe vn-bgvid).
Vérifié : avec bg.type = 'video', l'exemple rend data-bg-video="https://youtu.be/abc12345678" ; pour image et couleur, data-bg-video="false".
Calque de l'image de remplacement#
Lors du rendu, le programme insère comme premier enfant un calque qui affiche l'image de l'arrière-plan jusqu'au démarrage de la vidéo (et en cas de réduction des animations). Il porte la classe mbr-fallback-image ; si le bloc contient déjà un élément de cette classe, celui-ci est utilisé. En outre, renderer.js pose avec :where() (faible spécificité, les thèmes ont la priorité) :
:where(.vn-imp-x-b1) { position: relative; overflow: hidden; }
:where(.vn-imp-x-b1) > .mbr-fallback-image { position: absolute; left: 0; top: 0; width: 100%; height: 100%; background-size: cover; background-position: center; z-index: 0; }
:where(.vn-imp-x-b1) > .container, :where(.vn-imp-x-b1) > .container-fluid { position: relative; z-index: 2; }Le contenu d'un bloc se trouve dans .container ou .container-fluid, au-dessus de la vidéo (z-index: 2).
Lecture sur la page#
vn-bgvideo.js crée pour chaque [data-bg-video] un conteneur div.vn-bgv (aria-hidden, pointer-events:none) et l'insère après l'image de remplacement.
| Source | Structure |
|---|---|
| YouTube | <iframe> vers https://www.youtube-nocookie.com/embed/<ID>?autoplay=1&mute=1&loop=1&playlist=<ID>&controls=0&disablekb=1&fs=0&modestbranding=1&playsinline=1&rel=0&iv_load_policy=3, rempli en 16:9 (fit avec 2 % de débordement), fondu après le chargement (délai de 1,2 s) |
| Vimeo | <iframe> vers https://player.vimeo.com/video/<ID>?background=1&autoplay=1&loop=1&muted=1&byline=0&title=0&portrait=0 (+ &h=<hash>) |
| Fichier | <video muted loop autoplay playsinline preload="auto"> avec object-fit: cover ; mis en pause hors de l'écran (IntersectionObserver, seuil de 5 %) ; en cas d'erreur, le conteneur est supprimé |
| Réduction des animations | prefers-reduced-motion: reduce : rien n'est lu, l'image de remplacement reste |
Les formes d'adresse reconnues sont youtube.com/watch?v=, youtube.com/embed/, youtube.com/shorts/, youtube.com/live/, youtu.be/, youtube-nocookie.com/embed/, vimeo.com/<numéro> (aussi avec hash) ; tout le reste est considéré comme un fichier.
Consentement aux cookies (à partir de la version 1.3.100) : les iframes YouTube et Vimeo ne sont créées qu'à l'exécution dans vn-bgvideo.js, l'export ne peut donc pas les bloquer à l'avance. Le script vérifie donc lui-même : si VN Cookie-Consent est activé pour la page (window.vnCookieConsent existe), il ne construit la vidéo qu'une fois que le visiteur a accepté « Marketing ». D'ici là, l'image de remplacement reste affichée. Le script écoute pour cela l'événement vn-cc-consent (Événement vn-cc-consent), déclenché sur le document après chaque « Enregistrer », « Tout accepter » et « Nécessaires uniquement » ; si le consentement est déjà enregistré, la vidéo se charge immédiatement. Si le consentement aux cookies n'est pas activé pour la page, YouTube et Vimeo se chargent immédiatement, comme avant.
Le bloc « Arrière-plan vidéo » (vn-bgvid)#
Le bloc prêt à l'emploi (onglet « Code personnalisé ») est un hero avec une vidéo en arrière-plan et, par-dessus, du texte et des boutons librement modifiables.
Syntaxe (structure tirée de src/vn-bgvideo-block.js, entrées abrégées)
<section class="vn-bgvid" group="Video-Hintergrund" data-bg-video="{{videoUrl}}"
vn-class="{'vn-bgvid-left': align === 'left', 'vn-bgvid-mobile-poster': mobilePoster}">
<vn-parameters>
<input type="text" title="Video-Datei (MP4/WebM) — Adresse oder Datei wählen" name="videoFile" value="">
<input type="text" title="Zweite Fassung (optional, z. B. WebM)" name="videoFile2" value="">
<input type="text" title="Oder: YouTube-/Vimeo-Adresse" name="videoUrl" value="">
<input type="image" title="Vorschaubild" name="poster" value="">
<input type="checkbox" title="Video auch im Editor abspielen" name="editorPlay" checked>
<input type="checkbox" title="Auf Handys nur das Vorschaubild zeigen" name="mobilePoster">
<input type="checkbox" title="Pause-Knopf für Besucher anzeigen" name="showToggle" checked>
</vn-parameters>
<img class="mbr-fallback-image vn-bgvid-poster" vn-if="!!poster" src="{{poster}}" alt="">
<video class="vn-bgvid-el" vn-if="!!videoFile" autoplay muted loop playsinline preload="auto" poster="{{poster}}" aria-hidden="true">
<source src="{{videoFile}}">
<source vn-if="!!videoFile2" src="{{videoFile2}}">
</video>
<div class="vn-bgvid-overlay"></div>
<div class="vn-bgvid-empty" data-vn-editor-only vn-if="!videoFile && !videoUrl">Noch kein Video gewählt …</div>
<div class="vn-bgvid-content"> … Kicker, Überschrift, Text, Knöpfe … </div>
<button type="button" class="vn-bgvid-toggle" vn-if="showToggle" aria-label="Video pausieren oder abspielen"> … </button>
<a class="vn-bgvid-scroll" href="#" vn-if="showScroll" aria-label="Weiter nach unten"> … </a>
</section>| Élément | Signification |
|---|---|
section.vn-bgvid | Reconnaissance (l'export intègre vn-bgvideo.js) |
video.vn-bgvid-el | Vidéo-fichier directement dans le modèle : elle tourne donc aussi dans l'éditeur (editorPlay) |
data-bg-video="{{videoUrl}}" | Adresse YouTube/Vimeo. Le titre du champ du panneau dit « seulement si aucun fichier n'est choisi » ; or le modèle pose toujours l'attribut à partir de videoUrl. Ne renseignez donc pas les deux |
.vn-bgvid-poster | Image d'aperçu (porte en même temps la classe de l'image de remplacement) |
.vn-bgvid-overlay | Assombrissement (style flat, bottom, top, none ; couleur, intensité) |
.vn-bgvid-toggle | Bouton pause/lecture ; pose la classe vn-bgvid-paused sur la section |
.vn-bgvid-scroll | Flèche : fait défiler jusqu'au bloc suivant (en douceur, sans animation en cas de réduction des animations) |
vn-bgvid-mobile-poster | Classe : en dessous de 768 px, seule l'image d'aperçu s'affiche, la vidéo est masquée |
Particularités du script pour cet élément : il mémorise l'initialisation comme propriété JS (sec.__vnBgvid), met la vidéo en pause hors de l'écran (sauf si le visiteur a lui-même mis en pause) et pose muted.
Champs de fichier : videoFile, videoFile2, subtitleFile#
Les champs du panneau de type text portant ces noms reçoivent automatiquement une sélection de fichier (« Choisir un fichier … ») à côté du champ de saisie (VIDEO_FILE_FIELDS).
| Nom du champ | Type de fichier | Autorisé | Emplacement |
|---|---|---|---|
videoFile | Vidéo | mp4, webm, ogv, m4v ; 4 Go au maximum | assets/videos/ |
videoFile2 | Vidéo | comme ci-dessus (seconde version, p. ex. WebM) | assets/videos/ |
subtitleFile | Sous-titres | vtt ; 2 Mo au maximum | assets/subtitles/ |
<input type="text" title="Video-Datei (MP4/WebM) — Adresse oder Datei wählen" name="videoFile" value="">Le fichier est copié de disque à disque (même plusieurs Go, sans le charger en mémoire), le nom d'origine est conservé (même fichier = pas de seconde copie). Le champ reçoit l'adresse dans le projet ; l'export la réécrit en relatif. Saisir une adresse (https://…) est également possible. Dans la zone libre, la même chose vaut pour les champs e<Nr>_file.
Conteneur vidéo vn-video#
L'élément [vn-video]#
Un élément portant l'attribut vn-video et contenant un <iframe> (ou <video>) est un conteneur vidéo. Le programme propose pour cela, dans le panneau, un champ « Adresse vidéo » par vidéo et convertit l'adresse en adresse intégrable (éditeur et export).
Syntaxe
<div vn-video class="ratio ratio-16x9">
<iframe src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Video"></iframe>
</div>| Élément | Signification |
|---|---|
vn-video | Marqueur sur le conteneur (seulement s'il contient iframe, video ou data-vn-video-empty) |
data-vn-video-empty | Un conteneur sans vidéo est conservé comme espace réservé |
Valeurs du panneau par conteneur (index i dans l'ordre du document à partir de 0), dans block.values :
| Valeur | Type | Par défaut | Signification |
|---|---|---|---|
_videoUrl<i> | Adresse | src de l'iframe dans le modèle | YouTube, Vimeo ou fichier |
_videoAuto<i> | Interrupteur | autoplay=1 du modèle | Démarrer automatiquement (toujours muet ; jamais dans l'éditeur) |
_videoLoop<i> | Interrupteur | loop=1 du modèle | Répéter |
Reconnaître et convertir les adresses#
parseVideoUrl classe chaque adresse ; embedSrc fournit l'adresse intégrable.
Type (kind) | Reconnu | Intégration |
|---|---|---|
youtube | youtube.com/watch?v=, /embed/, /shorts/, /live/, /v/, youtu.be/, youtube-nocookie.com | https://www.youtube-nocookie.com/embed/<ID>?rel=0&modestbranding=1&playsinline=1 (+ start=<s>, avec lecture automatique autoplay=1&mute=1, avec répétition loop=1&playlist=<ID>) |
vimeo | vimeo.com/<Nr>, /video/<Nr>, avec hash | https://player.vimeo.com/video/<Nr> (+ h=<hash>, autoplay=1&muted=1, loop=1) |
file | se termine par .mp4 .webm .ogv .m4v, commence par file: ou contient assets/videos/ | <video controls playsinline preload="metadata"> (avec lecture automatique autoplay muted ; avec répétition loop) |
other | tout le reste | Adresse inchangée comme iframe |
empty | vide | Ligne d'aide « Saisissez l'adresse de la vidéo dans le panneau des propriétés » (data-vn-editor-only) |
Heure de début à partir de l'adresse : start=/t= avec des secondes (65) ou 1m5s. L'iframe générée reçoit allow="autoplay; fullscreen; picture-in-picture; encrypted-media", allowfullscreen, loading="lazy", referrerpolicy="strict-origin-when-cross-origin", title="Video".
Vérifié :
https://youtu.be/abc12345678?start=5 + Autoplay + Wiederholen
→ https://www.youtube-nocookie.com/embed/abc12345678?rel=0&modestbranding=1&playsinline=1&start=5&autoplay=1&mute=1&loop=1&playlist=abc12345678
https://vimeo.com/123456789/abcdef1234 + Autoplay
→ https://player.vimeo.com/video/123456789?h=abcdef1234&autoplay=1&muted=1Lorsque le consentement aux cookies est activé, l'export bloque l'iframe YouTube (youtube-nocookie.com) et, à partir de la version 1.3.100, aussi l'iframe Vimeo (player.vimeo.com/video/…) ; les deux relèvent de la catégorie « marketing » (voir Blocage automatique).
Vidéo dans une fenêtre popup : iframe[data-src]#
Pour un <iframe data-src="{{modalVideo}}"> (la vidéo n'est chargée qu'à l'ouverture d'une fenêtre), seule l'adresse est convertie : si elle est de type YouTube ou Vimeo, data-src devient l'adresse intégrable (avec autoplay/loop issus de l'adresse). Le chargement lui-même est assuré par la fenêtre du bloc (par exemple un modal Bootstrap ou le Popup : là, vn-popup.js vide les iframes à la fermeture et les rétablit à partir de data-vn-src).
Vidéo auto-hébergée : le bloc « Vidéo »#
Le bloc « Vidéo (auto-hébergée) » se trouve dans l'onglet « Code personnalisé ». Aucune requête n'est envoyée à des services tiers ; le fichier se trouve dans assets/videos/.
Syntaxe (cœur tiré de src/vn-video.js)
<section class="vn-video" group="Video" vn-class="{'vn-video-full': width === 'full', 'vn-video-lazy': clickToLoad}">
<vn-parameters> … </vn-parameters>
<div class="vn-video-inner">
<div class="vn-video-frame">
<video class="vn-video-el" playsinline preload="{{clickToLoad ? 'none' : preload}}" poster="{{poster}}"
aria-label="{{ariaLabel}}" data-controls="{{controls ? 1 : 0}}" data-autoplay="{{autoplay ? 1 : 0}}"
data-loop="{{loop ? 1 : 0}}" data-muted="{{muted ? 1 : 0}}" data-start="{{startTime}}" data-end="{{endTime}}"
data-rate="{{rate}}" data-volume="{{volume}}" data-viewplay="{{viewPlay}}"
data-exclusive="{{exclusive ? 1 : 0}}" data-lazy="{{clickToLoad ? 1 : 0}}" data-player="{{player}}">
<source vn-if="!!videoFile && !clickToLoad" src="{{videoFile}}">
<source vn-if="!!videoFile && clickToLoad" data-src="{{videoFile}}">
<track vn-if="!!subtitleFile && !clickToLoad" kind="subtitles" src="{{subtitleFile}}" srclang="{{subLang}}" label="{{subLabel}}" data-default="{{subDefault ? 1 : 0}}">
</video>
<button type="button" class="vn-video-play" vn-if="clickToLoad" aria-label="Video abspielen"> … </button>
</div>
</div>
</section>Les interrupteurs figurent comme valeurs data-… et deviennent de vrais attributs : un {{…}} placé directement dans un attribut comme controls serait détruit lors du traitement. applyVideoAttributes (éditeur et export) en fait :
Attribut sur video.vn-video-el | Valeurs | Effet |
|---|---|---|
data-controls | 1/0 | controls (pas avec data-lazy) |
data-autoplay | 1/0 | autoplay + muted (jamais dans l'éditeur) |
data-loop | 1/0 | loop |
data-muted | 1/0 | muted (aussi avec lecture automatique ou data-viewplay="play") |
data-nodownload | 1 | controlslist="nodownload" ; bloque aussi le menu du clic droit |
data-nopip | 1 | disablepictureinpicture |
data-nomenu | 1 | Bloquer le menu du clic droit |
track[data-default="1"] | — | default sur les sous-titres ; le data-default est supprimé |
Fonctions supplémentaires à l'exécution (vendor/vn-video/vn-video.js, racine .vn-video ; uniquement si la page contient video.vn-video-el ; sans le script, la vidéo se lit normalement) :
| Attribut | Valeurs | Signification |
|---|---|---|
data-start, data-end | secondes | Heure de début/de fin (en cas de répétition, retour au début) |
data-rate | nombre (0,5–2) | Vitesse de lecture |
data-volume | 0–100 | Volume (seulement sans muted) |
data-viewplay | none, pause, play | Au défilement : pause = mettre en pause lorsque moins de 50 % est visible ; play = démarrer en muet et mettre en pause |
data-exclusive | 1 | Une seule vidéo à la fois (les autres sont mises en pause) |
data-lazy | 1 | Charger seulement au clic (image d'aperçu + .vn-video-play) : source[data-src] et track[data-src] ne deviennent src qu'à ce moment |
data-player | vn ou native | vn : barre de commande propre, identique dans tous les navigateurs (couleur via --vn-vp-accent) ; native : barre de commande du navigateur |
data-vn-ready, data-vn-loaded | 1 | Posés par le script (initialisé / sources chargées) |
Classe vn-video-error | — | Posée sur .vn-video lorsque la vidéo ne se charge pas (le CSS affiche « La vidéo n'est pas disponible. ») |
Classe vn-video-started | — | Après le premier démarrage en mode lazy |
Le lecteur VN prend en charge le clavier (c = sous-titres, Home, End …), la barre de lecture, le volume et le plein écran.
Lightbox#
La lightbox VN rend les images de tout le site zoomables et déplaçables. Elle s'active dans les paramètres du site (pas dans le bloc). L'auteur de bloc marque seulement ce qui doit être zoomé, ou exclut des images.
Marqueurs#
| Marqueur | Emplacement | Effet |
|---|---|---|
class="vn-zoom" | img | Cette image ouvre la lightbox (icône de loupe au survol) |
class="vn-zoom" | Conteneur (pas img) | Toutes les images qu'il contient sont saisies et forment une galerie |
data-vn-skip | img dans un conteneur .vn-zoom | Exclure cette image |
class="vn-nozoom" ou data-vn-nozoom | Image ou ancêtre | Ne jamais zoomer |
data-vn-caption | Image ou élément | Légende dans la lightbox (sinon alt, title, figcaption, title du lien) |
data-vn-full (aussi data-large) | img | Adresse de la version grand format (sinon src ; les adresses data: d'espace réservé et les data-src, data-lazy-src, data-original, data-echo à chargement différé sont pris en compte) |
data-vn-group="<nom>" | img | Les images portant le même nom forment une galerie (défilement entre elles) |
data-vn-badge="off" | img | Pas d'icône de loupe |
Syntaxe
<img class="vn-zoom" src="assets/images/foto.jpg" alt="Foto" data-vn-caption="Unser Team 2026" data-vn-group="team">
<div class="vn-zoom">
<img src="assets/images/a.jpg" alt="A"><img src="assets/images/b.jpg" alt="B"><img src="assets/images/logo.svg" alt="" data-vn-skip>
</div>Galeries sans marqueur : dans le mode « Galeries + vn-zoom » (par défaut), la lightbox saisit automatiquement les images avec déclencheur de modal (img[data-bs-toggle="modal"], data-toggle="modal", data-bs-slide-to, data-slide-to), regroupées par data-bs-target/data-target. Dans le mode « Chaque image de contenu » (all), s'ajoutent les images non marquées si elles sont assez larges ; sont exclus les logos et les symboles (noms de classe contenant logo, icon, avatar, badge, bullet, arrow, sprite ; images .svg), les images dans nav, .navbar, button, .modal et les images dans des liens avec une vraie adresse.
Paramètres de la page#
siteSettings.vnLightbox (une valeur invalide revient à la valeur par défaut) :
| Clé | Valeurs | Par défaut | Signification |
|---|---|---|---|
enabled | Interrupteur | désactivé | Intégrer la lightbox (script + CSS) |
mode | gallery, all, class | gallery | Seulement galeries + vn-zoom ; chaque image de contenu ; seulement vn-zoom |
minWidth | 50–2000 | 250 | Largeur minimale en px (mode all) |
gallery | Interrupteur | activé | Reprendre automatiquement les galeries importées |
badge | Interrupteur | activé | Icône de loupe |
opacity | 30–100 | 94 | Opacité de l'arrière-plan en % |
maxScale | 2–15 | 6 | Zoom maximal |
closeOnBackdrop | Interrupteur | activé | Un clic à côté ferme |
caption | Interrupteur | activé | Afficher la légende |
captionColor, captionSize, counterSize, buttonSize, buttonColor | couleur, px | Par défaut | Apparence (0 = automatique) |
exclude | une ligne par exception | vide | Exceptions : motif de page (impressum.html, blog/*, *preis*), identifiant de bloc (#galerie1 ou galerie1) ou expression CSS (.keine-lightbox, [data-schutz]) ; les lignes commençant par / sont des commentaires |
La configuration figure comme window.VN_LIGHTBOX_CONFIG avant le script. La lightbox se désactive lorsque body porte la classe is-builder (le programme ne la pose pas). Les images insérées après coup (CMS, filtre, Ajax) sont saisies par un MutationObserver.
Galerie : VN Galerie#
Le bloc « VN Galerie » est créé par l'outil VN Galerie (sélection multiple, ordre, légendes). Les auteurs de blocs ne l'écrivent pas à la main ; cette entrée montre quels marqueurs l'exécution évalue.
| Classe / marqueur | Signification |
|---|---|
vn-galerie-host | Marque de reconnaissance de la galerie (GALLERY_HOST_CLASS) |
.vn-gal-wrap | Conteneur ; paramètres sous forme de variables CSS (--vn-gal-spalten, --vn-gal-spalten-handy, --vn-gal-groesse, --vn-gal-hoehe, --vn-gal-abstand, --vn-gal-rundung, --vn-gal-rahmenfarbe, --vn-gal-lightboxfarbe …) |
.vn-gal-grid + vn-gal-karussell | Affichage (grille, maçonnerie, carrousel, …) ; choix ansicht, lightbox, uebergangArt dans le panneau |
.vn-gal-lb-radio | Boutons radio masqués : la lightbox fonctionne uniquement en CSS (radio + label for) ; désactivée dans l'éditeur (disabled) pour qu'un clic ne superpose pas l'affichage agrandi à la zone de travail |
figure.vn-gal-item, img.vn-gal-thumb, figcaption.vn-gal-caption | Image individuelle avec légende (la légende est modifiable par clic) |
.vn-gal-bar, .vn-gal-prev, .vn-gal-next, .vn-gal-dots | Flèches et points du carrousel (script ; sans script, une barre de défilement subsiste) |
Le script du carrousel se trouve dans le bloc lui-même (GALLERY_CAROUSEL_SCRIPT) et mémorise l'initialisation comme propriété JS (grid.vnGalInit) ; la réduction des animations désactive le défilement en douceur.
Visionneuse PDF et tableaux#
PDF : iframe[data-vn-pdf-src]#
Le bloc « VN Lecteur PDF » intègre Mozilla PDF.js 3.11.174, fourni avec le programme. Le PDF est placé octet pour octet sous assets/vn-pdf-viewer/dateien/ (uniquement [A-Za-z0-9._-]+.pdf, 300 Mo au maximum).
Syntaxe
<iframe class="vn-pdf-frame" style="height:{{hoehe}}px"
data-vn-pdf-src="assets/vn-pdf-viewer/pdfjs-3.11.174/web/viewer.html?file={{ /[\/:]/.test(pdfDatei) ? encodeURI(String(pdfDatei).trim()) : '../../dateien/' + encodeURIComponent(String(pdfDatei).trim()) }}&vnedit={{bearbeitungErlauben}}#search={{encodeURIComponent(anfangssuche)}}&phrase={{exaktePhrase}}"
title="PDF-Betrachter"></iframe>| Élément | Signification |
|---|---|
data-vn-pdf-src | Adresse de la visionneuse ; dans le modèle, pas src : dans l'éditeur, le programme la pose sur la visionneuse fournie (sans src, rien ne se charge dans le vide), à l'export elle devient src (resolvePdfIframesForExport) |
?file= | PDF relatif à la visionneuse (../../dateien/<nom>.pdf) ou une adresse complète |
&vnedit= | true active l'édition PDF de la visionneuse |
#search=…&phrase= | Recherche à l'ouverture ; phrase=true = suite de mots exacte |
L'export copie la visionneuse (environ 6 Mo) uniquement si une page contient l'adresse de la visionneuse, ainsi que précisément les PDF vers lesquels un bloc renvoie (viewer.html?file=../../dateien/<nom>.pdf).
Champs du panneau du bloc : pdfDatei, titel, breite (30–100 %), hoehe (400–1600 px), blockFarbe, anfangssuche, exaktePhrase, bearbeitungErlauben, paddingTop, paddingBottom. Le bloc ne passe pas par le marquage texte/bouton (noTagging).
CSV et XLSX en tableau : VN Table#
À partir d'un fichier CSV ou Excel, le bloc « VN Table » produit un tableau fixe, consultable et triable ; le fichier source n'est pas publié. Tout s'exécute dans le navigateur.
Syntaxe (structure)
<div data-vntabelle-root data-vntabelle-name="Preisliste">
<div class="vntabelle-werkzeuge">
<input type="search" data-vntabelle-search placeholder="Suchen …">
<div class="vntabelle-aktionen">
<button type="button" data-vntabelle-export>CSV exportieren</button>
<button type="button" data-vntabelle-print>Drucken</button>
</div>
<div class="vntabelle-blaettern">
<select data-vntabelle-size data-vntabelle-start="25"><option>10</option><option>25</option><option>50</option><option>100</option></select>
<button type="button" data-vntabelle-prev>‹</button><span data-vntabelle-info></span><button type="button" data-vntabelle-next>›</button>
</div>
</div>
<div class="vntabelle-rahmen"><div class="vntabelle-wrap">
<table><thead><tr><th data-vnsort="0">Artikel</th></tr></thead><tbody><tr><td data-label="Artikel">Schraube</td></tr></tbody></table>
</div></div>
</div>| Marqueur | Signification |
|---|---|
data-vntabelle-root | Racine ; data-vntabelle-name = titre (pour l'export CSV) |
th[data-vnsort="<colonne>"] | Un clic trie selon cette colonne (index à partir de 0) |
td[data-label] | Nom de la colonne pour chaque cellule (pour l'affichage mobile) |
data-vntabelle-search, -export, -print, -size, -prev, -next, -info | Éléments de commande ; data-vntabelle-start = lignes au démarrage |
data-vntabelle-ready | Posé par le script |
Champs du panneau : titel, zeigeSuche, zeigeSeiten, startZeilen (10/25/50/100), zeigeExport, zeigeDruck, couleurs (blockFarbe, kopfFarbe, kopfTextFarbe, tabellenFarbe, textFarbe, wechselFarbe, linienFarbe), tailles (schriftGroesse, kopfGroesse, zellenAbstand, rundung) et marges. Le script se trouve dans le bloc lui-même.
Recherche : VN Recherche#
Le champ de recherche (pages et PDF) appelle à l'exécution assets/vn-search/search.php par fetch. Le backend (texte intégral SQLite, extrait de texte des PDF, administration avec mot de passe) est copié par l'export dans assets/vn-search/ lorsque le bloc porte la classe vn-search.
Syntaxe (structure)
<section class="vn-search" group="Form" id="{{vn-id}}" style="--vns-accent:{{accentColor}};--vns-radius:{{inputRadius}}px">
<vn-parameters> … </vn-parameters>
<div class="vns-data" data-lang="{{vnsLang}}" data-scope="{{searchScope}}" data-maxresults="{{maxResults}}"
data-snippetwords="{{snippetWords}}" data-placeholder="{{placeholderText}}" data-sticky="{{stickySearch}}"
data-nfmode="{{vnsNfMode}}" data-nfurl="{{vnsNfUrl}}" data-nftext="{{vnsNfText}}"
data-nfdelay="{{vnsNfDelay}}" data-nfpassquery="{{vnsNfPassQuery}}" style="display:none;"></div>
<div class="container">
<div class="vns-builder-dummy"> … Attrappe für den Editor … </div>
<div class="vns-out"></div>
</div>
<script> … </script>
</section>data-… sur .vns-data | Valeurs | Signification |
|---|---|---|
data-lang | de, en | Langue des textes |
data-scope | all, page, pdf | Ce qui est recherché |
data-maxresults | 3–400 | Nombre maximal de résultats |
data-snippetwords | 6–64 | Mots autour du passage trouvé |
data-placeholder | texte | Texte indicatif (vide = selon la langue) |
data-sticky | Interrupteur | Maintenir le champ de recherche en haut (--vns-sticky-top = distance) |
data-nfmode | off, enter, auto | Redirection en cas d'absence de résultat |
data-nfurl, data-nftext, data-nfdelay, data-nfpassquery | adresse, texte, secondes, interrupteur | Cible, message, délai d'attente, ajouter ?q= |
Le script retrouve son bloc avec document.currentScript (repli : document.querySelector('section.vn-search')). Il évalue html.is-builder (toujours faux dans l'éditeur, voir Détection de l'éditeur). L'administration de la base de recherche est accessible après la publication à l'adresse …/assets/vn-search/admin/ ; l'accès (utilisateur, mot de passe) est enregistré par l'outil VN Recherche dans le profil du programme et écrit à l'export dans admin-config.php.
Blog : VN Blog#
Trois blocs (« Blog : liste + article », « Blog : archives », « Derniers articles ») intègrent un blog PHP propre, situé par site web dans vn-blog/ (SQLite, administration avec TinyMCE, téléversement d'images).
Comment le bloc intègre le PHP#
Le PHP se trouve dans un script protégé ; les paramètres passent à l'include sous forme de JSON (Base64) :
<script type="text/x-vn-php"><?php
$vnblog_opts = json_decode(base64_decode('{{ btoa(unescape(encodeURIComponent(JSON.stringify({ view: view, perPage: Number(perPage) })))) }}'), true); /*VNBLOGLANG*/
include __DIR__ . '/vn-blog/include/blog.php';
?></script>| Élément | Signification |
|---|---|
type="text/x-vn-php" | Code PHP protégé : l'éditeur ne l'exécute pas, l'export l'insère tel quel ; la page doit s'appeler .php |
| JSON Base64 | Caractères A–Z a–z 0–9 + / = : ne peut pas faire éclater une chaîne PHP |
/*VNBLOGLANG*/ | L'export le remplace par $vnblog_lang = 'de' ou 'en' (selon lang de la page) |
data-vn-editor-only | La maquette avec des articles d'exemple est visible dans l'éditeur et supprimée à l'export (div.vnblog-preview) |
noTagging | Les blocs ne passent pas par le marquage texte/bouton, sinon la maquette serait modifiable |
| Bloc | Include | Champs du panneau (sélection) |
|---|---|---|
| Blog : liste + article | include/blog.php | view (cards, list), perPage (1–24), excerptWords, showSearch, showViewToggle, showMeta, buttonText, couleurs, radius |
| Blog : archives | include/archive.php | heading, blogPage (page contenant le bloc de blog), couleurs |
| Derniers articles | include/latest.php | heading, limit (1–20), showDate, blogPage, couleurs |
Installer et administrer#
Après le premier téléversement, appelez une fois …/vn-blog/install/ (créer l'utilisateur administrateur et le mot de passe), puis rédigez vos articles sous …/vn-blog/admin/. Les dossiers vn-blog/data/ et vn-blog/uploads/ ne sont créés que sur le serveur et ne font jamais partie de l'export ; un nouvel export n'écrase ni les articles, ni les images, ni l'accès. Si la page ne se trouve pas à la racine du domaine, réglez BASE_PATH dans inc/config.php avant le téléversement.
Animations : VN Animation#
L'outil VN Animation applique des animations CSS aux textes et aux images. L'enregistrement se fait par bloc dans block.animOverrides = { [zielId]: { name, dur, delay, ease, loop, trigger } } ; sans animOverrides (anciens projets), rien ne se passe.
Cibles et paramètres#
| Élément | Valeurs | Signification |
|---|---|---|
| ID de cible | tN (texte), fiN (image libre), k:<champ> (image de champ) | les identifiants stables issus de Contenus directement modifiables |
name | voir la liste ci-dessous | Animation (un nom invalide = l'entrée est ignorée) |
dur | 0,1–10 | Durée en s (par défaut 0,8) |
delay | 0–10 | Délai en s (par défaut 0) |
ease | ease, ease-out, ease-in, ease-in-out, linear, spring | Courbe ; spring = cubic-bezier(.34,1.56,.64,1) |
loop | Interrupteur | sans fin ; activé par défaut pour pulse, heartbeat, float, glow, spin |
trigger | scroll, load, hover | À l'apparition (par défaut) ; au chargement ; au survol |
26 animations : apparition : fadeIn, fadeUp, fadeDown, fadeLeft, fadeRight, zoomIn, zoomOut, rotateIn, flipX, flipY, blurIn, revealUp, revealLeft, bounceIn, dropIn. Attention : pulse, heartbeat, float, shake, wobble, swing, tada, rubber, flash, glow, spin.
Ce qui figure dans l'export#
L'élément reçoit data-vn-anim, data-vn-anim-t et des variables inline ; les @keyframes et les règles courtes figurent une seule fois dans le <head> (uniquement les animations utilisées) ; pour « à l'apparition », un petit script en fin de page démarre l'animation (classe vn-in).
Vérifié (titre avec fadeUp au défilement, image avec zoomIn au survol) :
<h2 style="--vn-a:vn-a-fadeUp;--vn-d:1s;--vn-dl:0.2s;--vn-e:ease-out;--vn-n:1" data-vn-anim="fadeUp" data-vn-anim-t="scroll">Titel</h2>
<img src="a.jpg" style="--vn-a:vn-a-zoomIn;--vn-d:0.8s;--vn-dl:0s;--vn-e:ease;--vn-n:1" data-vn-anim="zoomIn" data-vn-anim-t="hover">@keyframes vn-a-fadeUp{from{opacity:0;transform:translateY(40px)}to{opacity:1;transform:none}}
[data-vn-anim-t="load"]{animation:var(--vn-a) var(--vn-d) var(--vn-e) var(--vn-dl) var(--vn-n) backwards}
[data-vn-anim-t="scroll"]{animation:var(--vn-a) var(--vn-d) var(--vn-e) var(--vn-dl) var(--vn-n) backwards;animation-play-state:paused}
[data-vn-anim-t="scroll"].vn-in{animation-play-state:running}
[data-vn-anim-t="hover"]:hover{animation:var(--vn-a) var(--vn-d) var(--vn-e) var(--vn-dl) var(--vn-n) backwards}
@media (prefers-reduced-motion:reduce){[data-vn-anim]{animation:none!important}}| Variable | Signification |
|---|---|
--vn-a | Nom des keyframes (vn-a-<name>) |
--vn-d, --vn-dl | Durée, délai |
--vn-e | Fonction de courbe |
--vn-n | 1 ou infinite |
De plus, un <noscript><style>[data-vn-anim]{animation:none!important}</style></noscript> figure dans le <head>. Sans JavaScript ou en cas de réduction des animations, tout reste immobile.
Animation sur des mots isolés#
Sur un mot du texte, l'animation figure sous la forme <span data-vn-anim="fadeUp" data-vn-anim-t="scroll" style="--vn-a:…;display:inline-block">. Le sanitiseur de texte laisse passer data-vn-anim (uniquement [A-Za-z0-9]{1,30}), data-vn-anim-t (scroll, load, hover ; sinon scroll) et les variables --vn-* (voir Styles autorisés).
Dans l'éditeur#
Dans l'éditeur, l'animation ne s'exécute que dans l'aperçu de l'outil (classe vn-anim-play, jamais de façon permanente). Les éléments portent data-vn-anim-edit="<name>" ; lorsque l'outil est ouvert, les éléments animés sont entourés d'un trait en pointillés.
Traducteur : VN Traducteur#
Le visiteur dispose d'un bouton de langue ; le texte de la page est traduit en direct via DeepL, Microsoft Translator ou Google Cloud Translation (clé d'accès propre). L'auteur de bloc ne marque que les exceptions.
Ce qui est traduit#
vendor/vn-translate/vn-translate.js parcourt le texte de la page et traduit :
| Contenu | Règle |
|---|---|
Nœuds de texte dans le <body> | tout texte visible, quel que soit le tag ; le contenu de script, style, noscript, template et textarea est ignoré |
placeholder | sur input et textarea |
value | sur input[type=submit] et input[type=button] |
Ne sont pas traduits : les textes de moins de deux caractères, les nombres/symboles purs (^[\d.,€$%\-–—/]+$), tous les attributs sauf ceux ci-dessus (donc pas alt, title, aria-label).
Marquer des exceptions#
| Marqueur | Effet |
|---|---|
class="notranslate" | L'élément et tout ce qu'il contient restent non traduits |
<span class="notranslate">Marke</span> | la même chose pour un mot (barre de texte : format « Aucune traduction », voir Sélection du format) |
.vn-menue, [id$='-fenster'], .vn-uebersetzer-schalter | toujours exclus (le bouton de langue lui-même et ses fenêtres) |
| Pages | Dans les paramètres, on peut exclure des pages (excludePages, par exemple les mentions légales) : aucun script n'y est intégré |
Déroulement et configuration#
| Élément | Description |
|---|---|
| Configuration | window.VN_TRANSLATE_CONFIG = { endpunkt, original, sprachen, namen, position, darstellung } avant le script ; les clés ne figurent jamais dans le code de la page |
| Serveur | vn-translate/translate.php (au niveau racine du site web) avec vn-translate-config.php (clés, verrouillé par .htaccess) |
| Sécurisation | uniquement les langues configurées ; 500 textes au maximum par requête ; langue cible uniquement sous forme de code de langue ; cache par texte et par langue dans vn-translate-cache/ |
| Choix du visiteur | dans localStorage sous vn-uebersetzer-sprache |
| Langue source | d'après lang de la page (en-GB devient en ; par défaut de) |
| Position | br, bl, tr, tl |
| Présentation | classic, compact (dépliable sur mobile), compactall (aussi sur ordinateur) |
| Actif lorsque | activé et clé et au moins une langue cible ; sinon rien n'est exporté |
La liste des langues est séparée par des virgules (par exemple en,fr,es), 30 codes au maximum, format ^[a-z]{2,3}([-_][a-z0-9]{2,8})?$. Les noms dans le menu sont dans la langue de la page.