Documentation développeur VN-Designer
09

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 :

  1. 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.
  2. 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

html
<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émentValeursPar défautSignification
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
namenom de champbgNom du champ ; clé dans block.values et nom dans l'expression
titletexteHintergrundLibellé dans le panneau
input[type=image]adresse dans valuevideType image ; l'attribut parallax active par défaut l'effet de parallaxe
input[type=color]#rrggbb dans value#000000Type couleur
input[type=video]adresse dans valuevideType vidéo (YouTube, Vimeo ou fichier)
selectedinterrupteur 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>] :

json
{ "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#

EndroitExpressionValeur
Modèle ({{…}}, vn-if, vn-class)bg.typeimage, color ou video
Modèlebg.valuePour image/vidéo : un objet qui renvoie aussi l'adresse sous forme de texte (toString) ; couleur : la valeur hexadécimale
Modèlebg.value.urlAdresse (image et vidéo)
Modèlebg.parallaxValeur booléenne
LESS@bg-type'image', 'color', 'video' (chaîne entre apostrophes)
LESS@bg-valuePour image et vidéo : l'adresse sous forme de chaîne, pour la couleur : la couleur
LESS@bg-parallaxtrue 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) :

css
/* 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.

less
& 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.

html
<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.

html
<div class="vn-overlay" opacity="0.4" bg-color="#000000"></div>
AttributValeurSignification
Classe vn-overlay—L'élément reçoit position:absolute; inset:0; pointer-events:none
opacity0–1Opacité (devient style="opacity", l'attribut disparaît)
bg-colorcouleurCouleur 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

html
<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-videoEffet
Adresse (YouTube, Vimeo, fichier)La vidéo est insérée
vide, false, undefined, null, 0pas 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é) :

css
: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.

SourceStructure
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 animationsprefers-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)

html
<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 &amp;&amp; !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émentSignification
section.vn-bgvidReconnaissance (l'export intègre vn-bgvideo.js)
video.vn-bgvid-elVidé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-posterImage d'aperçu (porte en même temps la classe de l'image de remplacement)
.vn-bgvid-overlayAssombrissement (style flat, bottom, top, none ; couleur, intensité)
.vn-bgvid-toggleBouton pause/lecture ; pose la classe vn-bgvid-paused sur la section
.vn-bgvid-scrollFlèche : fait défiler jusqu'au bloc suivant (en douceur, sans animation en cas de réduction des animations)
vn-bgvid-mobile-posterClasse : 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 champType de fichierAutoriséEmplacement
videoFileVidéomp4, webm, ogv, m4v ; 4 Go au maximumassets/videos/
videoFile2Vidéocomme ci-dessus (seconde version, p. ex. WebM)assets/videos/
subtitleFileSous-titresvtt ; 2 Mo au maximumassets/subtitles/
html
<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

html
<div vn-video class="ratio ratio-16x9">
  <iframe src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Video"></iframe>
</div>
ÉlémentSignification
vn-videoMarqueur sur le conteneur (seulement s'il contient iframe, video ou data-vn-video-empty)
data-vn-video-emptyUn 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 :

ValeurTypePar défautSignification
_videoUrl<i>Adressesrc de l'iframe dans le modèleYouTube, Vimeo ou fichier
_videoAuto<i>Interrupteurautoplay=1 du modèleDémarrer automatiquement (toujours muet ; jamais dans l'éditeur)
_videoLoop<i>Interrupteurloop=1 du modèleRépéter

Reconnaître et convertir les adresses#

parseVideoUrl classe chaque adresse ; embedSrc fournit l'adresse intégrable.

Type (kind)ReconnuIntégration
youtubeyoutube.com/watch?v=, /embed/, /shorts/, /live/, /v/, youtu.be/, youtube-nocookie.comhttps://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>)
vimeovimeo.com/<Nr>, /video/<Nr>, avec hashhttps://player.vimeo.com/video/<Nr> (+ h=<hash>, autoplay=1&muted=1, loop=1)
filese 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)
othertout le resteAdresse inchangée comme iframe
emptyvideLigne 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é :

text
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=1

Lorsque 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)

html
<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 &amp;&amp; !clickToLoad" src="{{videoFile}}">
        <source vn-if="!!videoFile &amp;&amp; clickToLoad" data-src="{{videoFile}}">
        <track vn-if="!!subtitleFile &amp;&amp; !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-elValeursEffet
data-controls1/0controls (pas avec data-lazy)
data-autoplay1/0autoplay + muted (jamais dans l'éditeur)
data-loop1/0loop
data-muted1/0muted (aussi avec lecture automatique ou data-viewplay="play")
data-nodownload1controlslist="nodownload" ; bloque aussi le menu du clic droit
data-nopip1disablepictureinpicture
data-nomenu1Bloquer 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) :

AttributValeursSignification
data-start, data-endsecondesHeure de début/de fin (en cas de répétition, retour au début)
data-ratenombre (0,5–2)Vitesse de lecture
data-volume0–100Volume (seulement sans muted)
data-viewplaynone, pause, playAu défilement : pause = mettre en pause lorsque moins de 50 % est visible ; play = démarrer en muet et mettre en pause
data-exclusive1Une seule vidéo à la fois (les autres sont mises en pause)
data-lazy1Charger seulement au clic (image d'aperçu + .vn-video-play) : source[data-src] et track[data-src] ne deviennent src qu'à ce moment
data-playervn ou nativevn : 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-loaded1Posé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.

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.

MarqueurEmplacementEffet
class="vn-zoom"imgCette 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-skipimg dans un conteneur .vn-zoomExclure cette image
class="vn-nozoom" ou data-vn-nozoomImage ou ancêtreNe jamais zoomer
data-vn-captionImage ou élémentLégende dans la lightbox (sinon alt, title, figcaption, title du lien)
data-vn-full (aussi data-large)imgAdresse 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>"imgLes images portant le même nom forment une galerie (défilement entre elles)
data-vn-badge="off"imgPas d'icône de loupe

Syntaxe

html
<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.

siteSettings.vnLightbox (une valeur invalide revient à la valeur par défaut) :

CléValeursPar défautSignification
enabledInterrupteurdésactivéIntégrer la lightbox (script + CSS)
modegallery, all, classgallerySeulement galeries + vn-zoom ; chaque image de contenu ; seulement vn-zoom
minWidth50–2000250Largeur minimale en px (mode all)
galleryInterrupteuractivéReprendre automatiquement les galeries importées
badgeInterrupteuractivéIcône de loupe
opacity30–10094Opacité de l'arrière-plan en %
maxScale2–156Zoom maximal
closeOnBackdropInterrupteuractivéUn clic à côté ferme
captionInterrupteuractivéAfficher la légende
captionColor, captionSize, counterSize, buttonSize, buttonColorcouleur, pxPar défautApparence (0 = automatique)
excludeune ligne par exceptionvideExceptions : 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 / marqueurSignification
vn-galerie-hostMarque de reconnaissance de la galerie (GALLERY_HOST_CLASS)
.vn-gal-wrapConteneur ; 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-karussellAffichage (grille, maçonnerie, carrousel, …) ; choix ansicht, lightbox, uebergangArt dans le panneau
.vn-gal-lb-radioBoutons 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-captionImage individuelle avec légende (la légende est modifiable par clic)
.vn-gal-bar, .vn-gal-prev, .vn-gal-next, .vn-gal-dotsFlè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

html
<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()) }}&amp;vnedit={{bearbeitungErlauben}}#search={{encodeURIComponent(anfangssuche)}}&amp;phrase={{exaktePhrase}}"
        title="PDF-Betrachter"></iframe>
ÉlémentSignification
data-vn-pdf-srcAdresse 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)

html
<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>&lsaquo;</button><span data-vntabelle-info></span><button type="button" data-vntabelle-next>&rsaquo;</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>
MarqueurSignification
data-vntabelle-rootRacine ; 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-readyPosé 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.

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)

html
<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-dataValeursSignification
data-langde, enLangue des textes
data-scopeall, page, pdfCe qui est recherché
data-maxresults3–400Nombre maximal de résultats
data-snippetwords6–64Mots autour du passage trouvé
data-placeholdertexteTexte indicatif (vide = selon la langue)
data-stickyInterrupteurMaintenir le champ de recherche en haut (--vns-sticky-top = distance)
data-nfmodeoff, enter, autoRedirection en cas d'absence de résultat
data-nfurl, data-nftext, data-nfdelay, data-nfpassqueryadresse, texte, secondes, interrupteurCible, 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) :

html
<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émentSignification
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 Base64Caractè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-onlyLa maquette avec des articles d'exemple est visible dans l'éditeur et supprimée à l'export (div.vnblog-preview)
noTaggingLes blocs ne passent pas par le marquage texte/bouton, sinon la maquette serait modifiable
BlocIncludeChamps du panneau (sélection)
Blog : liste + articleinclude/blog.phpview (cards, list), perPage (1–24), excerptWords, showSearch, showViewToggle, showMeta, buttonText, couleurs, radius
Blog : archivesinclude/archive.phpheading, blogPage (page contenant le bloc de blog), couleurs
Derniers articlesinclude/latest.phpheading, 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émentValeursSignification
ID de cibletN (texte), fiN (image libre), k:<champ> (image de champ)les identifiants stables issus de Contenus directement modifiables
namevoir la liste ci-dessousAnimation (un nom invalide = l'entrée est ignorée)
dur0,1–10Durée en s (par défaut 0,8)
delay0–10Délai en s (par défaut 0)
easeease, ease-out, ease-in, ease-in-out, linear, springCourbe ; spring = cubic-bezier(.34,1.56,.64,1)
loopInterrupteursans fin ; activé par défaut pour pulse, heartbeat, float, glow, spin
triggerscroll, 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) :

html
<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">
css
@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}}
VariableSignification
--vn-aNom des keyframes (vn-a-<name>)
--vn-d, --vn-dlDurée, délai
--vn-eFonction de courbe
--vn-n1 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 :

ContenuRè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é
placeholdersur input et textarea
valuesur 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#

MarqueurEffet
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-schaltertoujours exclus (le bouton de langue lui-même et ses fenêtres)
PagesDans 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émentDescription
Configurationwindow.VN_TRANSLATE_CONFIG = { endpunkt, original, sprachen, namen, position, darstellung } avant le script ; les clés ne figurent jamais dans le code de la page
Serveurvn-translate/translate.php (au niveau racine du site web) avec vn-translate-config.php (clés, verrouillé par .htaccess)
Sécurisationuniquement 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 visiteurdans localStorage sous vn-uebersetzer-sprache
Langue sourced'après lang de la page (en-GB devient en ; par défaut de)
Positionbr, bl, tr, tl
Présentationclassic, compact (dépliable sur mobile), compactall (aussi sur ordinateur)
Actif lorsqueactivé 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.