Documentation développeur VN-Designer
06

Contenus modifiables directement

Ce qui est modifiable d’un clic dans la zone de travail (texte, images, icônes, boutons, menus, liens), comment l’auteur d’un bloc le marque, le déclenche ou l’empêche dans le modèle, et comment les fonctions CMS et popup se rattachent au bloc.

Vue d’ensemble#

Dans la zone de travail (canvas), presque tout se clique et se modifie directement : textes, images, icônes, boutons, éléments de menu, liens. L’auteur d’un bloc n’écrit aucun code d’éditeur pour cela. Il écrit du HTML ordinaire dans template.html ; à l’importation, le programme reconnaît ce qui est modifiable et attribue des identifiants stables.

Le déroulement est toujours le même :

  1. Importation : des fonctions utilitaires (tagEditableText, tagButtons, tagIcons, tagFreeImages, tagImageFields) placent des identifiants dans le modèle (data-vn-text-id, data-vn-button-id, data-vn-icon-id, data-vn-free-image-id, data-vn-image-key). Les mêmes fonctions s’exécutent de nouveau à chaque chargement d’un projet (idempotentes : les identifiants existants sont conservés, seuls les nouveaux éléments en reçoivent de nouveaux).
  2. Modification : les changements de l’utilisateur ne vont pas dans le modèle, mais dans des surcharges (overrides) du bloc. Le modèle reste inchangé.
  3. Rendu (éditeur) : après chaque rendu, le programme replace les surcharges sur le HTML fraîchement rendu et rend les éléments cliquables.
  4. Exportation : les mêmes surcharges sont intégrées définitivement ; toutes les traces de l’éditeur (identifiants, contenteditable, classes auxiliaires) sont supprimées.
Surcharge du blocCléContenu
textOverridest0, t1 …contenu modifié (innerHTML) d’un champ de texte
textTagOverridest0 …balise choisie (H1, H2, H3, P …)
textLinkOverridest0 …{ href, newTab, colorClass, rel, download } pour les champs de texte qui sont eux-mêmes un <a>
textAlignOverridest0 …left, center, right, justify
buttonOverridesbtn0 …texte, lien, couleur, forme, icône d’un bouton
iconOverridesicon0 …icône, taille, couleur, lien
navIconOverridest0 … (élément de menu)icône avant/après un élément de menu
imageOverridesfi1 …adresse d’une image libre
imageLinkOverridesfi1 ou k:<champ>{ href, target, rel, download } autour d’une image
imageAltOverridesfi1, k:<champ> ; t:<id> ; s:<id>texte alternatif ; titre (t:) ; taille (s:)
animOverridest0, fi1, k:<champ>animation (voir Animations)

Texte#

Quels éléments deviennent des champs de texte#

Tout élément qui porte du texte courant devient automatiquement un champ de texte (contenteditable) avec un identifiant data-vn-text-id="tN". L’auteur n’a rien à marquer. Sont pris en compte, dans cet ordre d’attribution des identifiants :

  1. Balises de texte standard : h1–h6, p, li, blockquote, figcaption (uniquement les plus externes, sans double marquage), ainsi que les liens de menu et les liens isolés (voir ci-dessous).
  2. Champs de liste ul/ol avec data-multiline ou vn-article (voir Champs de liste).
  3. Éléments terminaux : tout autre élément qui ne contient que du texte et des balises en ligne, par exemple <div>Text</div>, <span>, <td>, <label>, <small>, <em>, <dt>.

Syntaxe

html
<h2>Überschrift</h2>
<p>Absatz mit <b>fett</b> und <a href="#kontakt">Link</a>.</p>
<div class="hinweis">Ein Blatt-Element mit Text</div>

Résultat après l’importation (vérifié)

html
<h2 data-vn-text-id="t0">Überschrift</h2>
<p data-vn-text-id="t1">Absatz mit <b>fett</b> und <a href="#kontakt" data-vn-text-id="t2">Link</a>.</p>
<div class="hinweis" data-vn-text-id="t3">Ein Blatt-Element mit Text</div>

Les identifiants sont attribués dans cet ordre : d’abord les titres, paragraphes et éléments de liste, puis les liens de menu et les liens isolés, enfin les éléments terminaux. Un lien à l’intérieur d’un paragraphe reçoit son propre identifiant imbriqué (t2 dans l’exemple) : le lien est un champ distinct pour l’adresse et la couleur, son texte reste une partie du paragraphe.

ÉlémentChamp de texte ?Remarque
h1–h6, p, li, blockquote, figcaptionouiEn dehors d’une navigation, d’un formulaire, d’un bouton, d’un lien
div, span, td, th, label, small, em, dt …oui, si terminalUniquement du texte et des balises en ligne à l’intérieur
Conteneur avec des enfants paragraphe/titre (div.wrap > p)nonSeuls les enfants deviennent des champs
a.nav-link, a.navbar-brand, a.dropdown-itemouiBranche à part, y compris à l’intérieur de nav
a (liens isolés, pas .btn) avec du texteouiLe <a> lui-même est le champ, le lien se règle via la barre de texte
Texte composé uniquement de {{platzhalter}}nonRelève du panneau des propriétés
script, style, textarea, option, select, button, iframe, svg, noscript, template, pre, code, input, header (en-tête de panneau), fieldsetjamaisNEVER_TEXT_TAGS
Tout ce qui se trouve dans nav, button, select, form, a, vn-parametersnonSKIP_ANCESTOR_TAGS ; pour les liens de menu et les liens isolés, une liste plus restreinte s’applique (nav y est autorisé)

data-vn-text-id#

Identifiant d’un champ de texte attribué par le programme. C’est le lien entre le modèle et textOverrides. Les auteurs ne le définissent pas eux-mêmes. Il est important pour tout ce qui devra ensuite cibler un champ : Animations, clés CMS et extensions (ctx.blocks.texts).

Syntaxe

html
<h2 data-vn-text-id="t0">Titel</h2>
PropriétéValeurSignification
Formatt + nombre (t0, t1 …)Continu à partir de l’indice le plus élevé existant
Durée de vieÉditeur et modèleSupprimé à l’exportation (bakeTextOverridesForExport)

Champs de liste : data-multiline et vn-article#

Une liste dans laquelle Entrée doit créer une nouvelle entrée est un seul champ de texte. Vous l’indiquez sur le ul/ol lui-même. Les entrées qu’elle contient ne sont alors plus des champs distincts.

Syntaxe

html
<ul data-multiline>
  <li>Erster Punkt</li>
  <li>Zweiter Punkt</li>
</ul>
<ol vn-article>
  <li>Schritt eins</li>
</ol>
AttributValeurPar défautSignification
data-multilineInterrupteur (sans valeur)désactivéSur ul, ol (liste extensible) ou sur div : le champ peut contenir des listes, des paragraphes, des citations et des titres
vn-articleInterrupteurdésactivéComme data-multiline, sur ul/ol

Listes imbriquées : seule la plus externe est le champ. Un champ div ou un champ avec data-multiline conserve à l’enregistrement ul, ol, li, p, blockquote, h1–h6 (voir Balises autorisées).

Espaces réservés dans le texte#

Si tout le texte d’un élément se compose d’un seul {{platzhalter}}, l’élément n’est pas un champ de texte ; la valeur est gérée dans le panneau des propriétés. Si un espace réservé se trouve seulement au milieu du texte (x {{a}} y), l’élément est un champ de texte.

html
<h2>{{title}}</h2>          
<p>Preis ab {{preis}} €</p>  

Balises autorisées à l’enregistrement (nettoyeur)#

Chaque modification est nettoyée par sanitizeRichTextHtml lors du rendu et de l’exportation. Une liste d’autorisation détermine ce qui reste dans le texte :

GroupeBalises
Autorisées en lignestrong, b, em, i, u, a, span, br, code, mark, sub, sup, small, abbr, kbd, samp, var, q, cite, dfn, s, strike, del, ins, time, data, wbr, bdi, bdo, ruby, rt, rp
Blocs, uniquement dans les champs multilignes (div ou data-multiline)ul, ol, li, p, blockquote, h1–h6
Dissoutes (le contenu reste, l’enveloppe disparaît, l’ancienne limite de bloc devient <br>)div, section, article, parties de table, figure, header, footer, main, aside, nav, hr, pre, form et tout ce qui est inconnu
SupprimésCommentaires
Inchangé<script type="text/x-vn-php"> (code PHP protégé)

Exemple vérifié (entrée sous forme de surcharge enregistrée, résultat après l’intégration définitive) :

html

Hallo <b class="foo" onclick="x()">B</b> <div>blk</div>
<span style="color:red;position:fixed;text-shadow:0 0 4px #f00" class="akzent vn-editable-x n6owBd">s</span>
<img src=x onerror=1><i class="bi bi-star vn-ic" style="font-size:2em">i</i>


Hallo <b class="foo">B</b><br>blk<br>
<span style="color:red;text-shadow:rgb(255, 0, 0) 0px 0px 4px" class="akzent">s</span>
<i class="bi bi-star vn-ic">i</i>

Attributs et classes autorisés#

Sur les balises en ligne autorisées, seuls ces attributs sont conservés :

BaliseAttributs autorisés
ahref, target, rel, download, title, aria-label, data-vn-cookie-settings
qcite
timedatetime
datavalue
abbr, dfntitle
del, insdatetime, cite
bdodir
spanstyle (filtré, voir ci-dessous), data-vn-text-color, data-vn-anim, data-vn-anim-t, data-vn-svg, data-vn-svg-mode, attributs d’info-bulle
toutesclass (filtrée)

Les classes sont conservées lorsque le nom est un simple jeton (sans guillemets, <, >, &, =, accent grave). Sont supprimées : les classes commençant par vn-editable, vn-anim-…, vn-tip/vn-tip-plain (posées par la branche info-bulle elle-même) et les classes étrangères connues des frameworks de sites web. Un <span class="akzent"> dans le texte survit donc à l’enregistrement, à l’exportation et au rechargement.

Styles autorisés sur le span#

Un <span> peut conserver ces styles en ligne :

SourcePropriétés
Barre de textecolor, font-family, font-size, font-weight, font-style
VN Effets de textetext-shadow, background-color, background-image, background-clip (avec -webkit-background-clip), background-repeat, background-size, padding-left, padding-right, les quatre border-*-radius, box-decoration-break (avec préfixe), -webkit-text-stroke-width, -webkit-text-stroke-color, -webkit-text-fill-color, paint-order, text-decoration-line, text-decoration-style, text-decoration-color, text-decoration-thickness, text-underline-offset, letter-spacing, text-transform, font-variant-caps
VN Animationles variables --vn-a, --vn-d, --vn-dl, --vn-e, --vn-n et display:inline-block
Icône SVG personnaliséele style est reconstruit à partir de data-vn-svg et data-vn-svg-mode

Les valeurs contenant url(…), expression, javascript, @import, < ou > sont rejetées. Toutes les autres propriétés (par exemple position) sont supprimées.

Balisage étranger issu de pages web#

Si un utilisateur colle du texte provenant d’une page de chat IA ou d’un moteur de recherche, du balisage étranger l’accompagne (attributs jscontroller, jsaction, data-sfc-…, data-section-id avec data-start/data-end, et classes de frameworks connues). Deux niveaux de protection existent :

  • Le collage et le glisser-déposer dans un champ de texte se font toujours en texte brut. Les sauts de ligne deviennent <br>.
  • stripForeignFrameworkMarkup nettoie un modèle entier de ces empreintes au chargement et lors de la validation dans l’éditeur de code : l’élément est dissous, son contenu reste. Si un champ de texte vide le précède, le contenu s’y glisse.

Niveau de titre et alignement#

La barre de texte propose pour un champ : paragraphe ou titre 1–3, et l’alignement à gauche, centré, à droite, justifié.

SurchargeEffet sur l’élément du modèle
textTagOverrides[tN] = 'H2'L’élément est remplacé par un nouveau avec cette balise (tous les attributs et enfants sont conservés)
textAlignOverrides[tN]text-align avec !important ; pour les balises de bloc (p, h1–h6, div, blockquote, ul, ol, figcaption) en plus margin-left/margin-right (0 ou auto), sauf pour le texte justifié

Sélecteur de format et « Aucune traduction »#

Le sélecteur de format de la barre de texte enveloppe une sélection avec une balise en ligne :

Entrée de l’interfaceRésultat
Code<code>
Surligné<mark>
Petit<small>
Exposant<sup>
Indice<sub>
Raccourci clavier<kbd>
Citation<q>
Abréviation<abbr>
Barré<s>
Aucune traduction<span class="notranslate"> (pas une balise ; voir Traducteur)
html
<p>Wir nutzen <span class="notranslate">VN-Designer</span> seit 2024.</p>

Un lien dans le texte reçoit, via la barre de texte, une classe de couleur directement sur le <a>. La liste sert aussi de liste d’autorisation.

EntréeClasse
Couleur du lien : par défaut(aucune)
Primary, Secondary, Success, Info, Warning, Danger, Light, Darktext-primary, text-secondary, text-success, text-info, text-warning, text-danger, text-light, text-dark

Ces classes sont des classes utilitaires Bootstrap avec !important et l’emportent donc sur les couleurs de lien du thème.

Icônes dans le texte#

Le bouton d’icône de la barre de texte insère à la position du curseur une icône qui hérite de la taille et de la couleur du texte.

Syntaxe

html
<span class="bi bi-star vn-ic" style="font-size:1.5em;color:#c00" aria-hidden="true"></span>
<span class="vn-ic vn-ic-svg" data-vn-svg="assets/icons/herz.svg" data-vn-svg-mode="mask" aria-hidden="true"></span>
ÉlémentValeursSignification
bi bi-NAMENom issu de Bootstrap Icons ([a-z0-9-]{1,60})Police d’icônes, dessinée via ::before
vn-icClasseMarqueur : cliquable et modifiable dans l’éditeur
style="font-size:…em"^\d+(\.\d+)?em$Taille relative au texte
style="color:#rrggbb"HexadécimalCouleur (vide = couleur du texte)
vn-ic-svg + data-vn-svgassets/icons/….svg ou file:///….svgSVG personnalisé issu du projet ; les autres adresses sont rejetées (SVG_ICON_SRC_RE)
data-vn-svg-modemask ou imagemask : monochrome dans la couleur du texte ; image : avec ses propres couleurs

Un <i class="bi bi-…"> ou <span class="bi bi-…"> figurant tel quel dans le modèle à l’intérieur d’un champ de texte devient automatiquement dans l’éditeur une icône modifiable (classe vn-ic), mais pas dans un élément de menu (où s’applique l’icône de menu ★).

Info-bulles sur des mots#

La barre de texte place une info-bulle sur un mot. À l’exportation, vendor/vn-tooltip active l’info-bulle Bootstrap (uniquement si la page en contient au moins une).

Syntaxe

html
<span class="vn-tip" data-bs-toggle="tooltip" data-bs-placement="top" title="Erklärung"
      data-vn-tip-bg="#000000" data-vn-tip-fg="#ffffff" data-vn-tip-trigger="hover focus">Wort</span>
AttributValeursPar défautSignification
classvn-tip (+ vn-tip-plain)—Marqueur ; vn-tip-plain : sans soulignement
titleTexte—Texte de l’info-bulle (version en texte brut)
data-vn-tip-htmlHTML nettoyé—Info-bulle avec saut de ligne/mise en forme ; title porte alors la version en texte brut
data-bs-placementtop, bottom, left, righttopPosition
data-vn-tip-bg, data-vn-tip-fg#rrggbbThèmeCouleurs du fond et du texte
data-vn-tip-triggerhover focus ou clickhover focusDéclencheur ; un clic à l’extérieur ferme

Le script définit tabindex="0" (clavier), mémorise l’initialisation dans data-vn-tip-ready et, sans Bootstrap 5, se rabat sur l’indication title du navigateur.

Effets de texte et animation sur un mot#

Les outils VN Effets de texte et VN Animation écrivent leur effet sous forme de styles et d’attributs filtrés sur un <span> (voir Styles autorisés). Un auteur ne les écrit pas à la main ; il doit seulement savoir que ces propriétés survivent à l’enregistrement, et pas les autres.

Taille, largeur et position par bloc#

Dans le panneau des propriétés, chaque bloc dispose de trois curseurs pour tous ses champs de texte et boutons (éléments avec data-vn-text-id ou data-vn-button-id). Les éléments de menu et les marques (nav-link, dropdown-item, navbar-brand) sont exclus, ils ont leurs propres curseurs.

Valeur dans block.valuesPlageEffet (identique dans l’éditeur et à l’exportation)
_textScalePct50–200 %zoom sur l’élément : proportionnel à sa propre taille de thème, la hiérarchie est conservée
_textWidthPct20–100 % (100 = désactivé)max-width en %, avec margin-left/right: auto
_textOffsetYPx−150–150 px (0 = désactivé)transform: translateY(…) : déplace de façon purement visuelle, le flux du texte est conservé

Pour la surface libre (bloc avec freeSurface), la largeur et la position ne s’appliquent pas, ce sont les éléments eux-mêmes qui les déterminent.

Image et icône de menu dans l’élément de texte#

Un enfant direct img, picture, svg ou une icône de menu (data-vn-nav-icon) dans un champ de texte ne fait pas partie du texte modifié. Il n’est jamais repris dans la surcharge et, lors du remplacement du contenu, il est remis du même côté (devant ou derrière). C’est ainsi que, par exemple, le logo dans le lien de marque d’un menu survit à la modification du texte.

html
<a class="navbar-brand" href="#"><img src="{{logo}}" alt="Logo"><span>Marke</span></a>

Code PHP protégé dans le texte#

Un <script type="text/x-vn-php"> au milieu du texte reste inchangé lors du nettoyage (les attributs autres que type sont supprimés). Dans le navigateur, il est inerte ; on ne peut pas le saisir. L’exportation insère le code PHP tel quel.

html
<p>Stand: <script type="text/x-vn-php"><?php echo date('d.m.Y'); ?></script></p>

Images#

Champ d’image : data-vn-image-key#

Un <img> dont le src est exactement un espace réservé d’un champ d’image devient remplaçable d’un clic. L’importation définit data-vn-image-key="<nom du champ>".

Syntaxe

html
<vn-parameters>
  <input type="image" title="Bild" name="bild" value="../_images/land-d.jpg">
</vn-parameters>
<img src="{{bild}}" alt="Landschaft">

Résultat (vérifié à l’importation)

html
<img src="{{bild}}" alt="Landschaft" data-vn-image-key="bild">
RègleDescription
Détectionimg[src] avec src="{{champ}}" (espaces autorisés), où champ est un champ image
Arrière-plan dans le stylestyle="background-image:url({{champ}})" (également dans vn-style) reçoit le même marquage sur l’élément
Widget d’arrière-planS’il existe un fieldset type="background", l’élément racine du bloc est marqué comme cible ; un clic ne compte que si la surface libre elle-même est touchée (e.target est l’élément racine)
EffetLe clic ouvre la sélection d’image et écrit dans block.values[champ]

Image libre : data-vn-free-image-id#

Tous les autres <img src="…"> avec une vraie adresse (photos décoratives, logos, images d’exemple) reçoivent data-vn-free-image-id="fiN". Eux aussi sont remplaçables d’un clic ; la valeur se trouve dans imageOverrides.

Syntaxe

html
<img src="assets/images/team.jpg" alt="Team">

Résultat (vérifié)

html
<img src="assets/images/team.jpg" alt="Team" data-vn-free-image-id="fi1">
RègleDescription
Non marquésimg avec {{platzhalter}} sans champ d’image correspondant, img sans src
Formatfi + numéro continu à partir de 1
Dans l’éditeurClasse vn-free-image, le clic ouvre la sélection d’image (arrête la propagation du clic)

Image d’arrière-plan dans le style en ligne#

Les éléments avec style="background-image:url(…)" (ou dans vn-style) et une vraie adresse sont eux aussi des images libres (data-vn-free-image-id) ; le remplacement change l’adresse dans l’attribut.

html
<div class="hero" style="background-image:url(assets/images/hero.jpg)"></div>

Sélection d’image et fichiers#

Un clic sur une image dotée d’un identifiant ouvre « Changer l’image » : téléverser un nouveau fichier ou (selon le bloc) choisir l’une des images du projet. Le fichier est copié dans le projet (assets/images/) et garde son nom (attribution des noms : même contenu = réutilisation du fichier existant, sinon compteur -2, -3). L’exportation n’emporte que les fichiers auxquels il est fait référence et réécrit les adresses file:/// en chemins relatifs.

LimiteValeur
Formats d’image autorisésjpg, jpeg, png, gif, webp, svg (plus ico)
Taille par fichier15 Mo au maximum

Texte alternatif, titre et lien#

Pour chaque img doté d’un identifiant d’image (image de champ ou image libre), la boîte de dialogue d’image propose texte alternatif, titre et lien. Les valeurs se trouvent dans imageAltOverrides et imageLinkOverrides.

Clé dans imageAltOverridesValeurEffet
<id>Textealt ; texte vide = volontairement vide (image décorative)
t:<id>Textetitle (info-bulle) ; vide supprime l’attribut
s:<id>"<Breite>%|<Höhe>px"Taille (voir Redimensionner)

<id> est fiN pour les images libres et k:<champ> pour les images de champ.

imageLinkOverrides[<id>] = { href, target, rel, download } place un <a> autour de l’image (ou modifie celui qui existe). Dans l’éditeur, le lien est marqué (data-vn-img-link) et n’est pas suivi ; les options de lien comme rel, download et data-vn-cookie-settings s’appliquent comme dans Liens.

html
<a href="https://example.com/team" target="_blank" rel="noopener"><img src="assets/images/team.jpg" alt="Team"></a>

Si l’image se trouve déjà dans un <a> du modèle, la boîte de dialogue modifie l’adresse de celui-ci. Un logo dans le lien de marque en est un exemple.

Redimensionner les images avec la souris#

Lorsque la souris survole une image dotée d’un identifiant, trois poignées apparaissent : à droite (largeur), en bas (hauteur, l’image est rognée au lieu d’être déformée), dans le coin (les deux, le rapport d’aspect est conservé ; avec Maj, libre). Un double-clic sur une poignée réinitialise. Désactivable dans les paramètres de la page (« Redimensionner les images avec la souris »).

L’enregistrement se fait dans imageAltOverrides["s:<id>"] sous la forme "<largeur en %>|<hauteur en px>", par exemple "62%|240px", "62%|" (largeur seule), "|240px" (hauteur seule).

ÉlémentPlageEffet
Largeur5–100 %width en % de la largeur environnante plus max-width:100%, les deux en !important ; continue de s’adapter sur mobile
Hauteur24–4000 pxheight et object-fit: cover (!important)
largeur seuleheight:auto !important

Glisser des calques : data-vn-drag#

Les blocs de scène (plusieurs calques d’image superposés) marquent un calque pour que l’utilisateur puisse le déplacer et le redimensionner à la souris sur la zone de travail.

Syntaxe

html
<img class="haus" src="{{haus}}" alt=""
     data-vn-drag="Haus" data-vn-drag-x="l2x" data-vn-drag-y="l2y" data-vn-drag-size="l2size">
AttributValeurSignification
data-vn-dragNom affichéMarque l’élément comme déplaçable (le nom apparaît comme pastille)
data-vn-drag-xNom de champ (curseur de plage, %)Centre latéral en % de la largeur de la scène
data-vn-drag-yNom de champ (%)Distance au bas en % de la hauteur de la scène
data-vn-drag-sizeNom de champ (%)Largeur en % de la largeur de la scène

Utilisation : glisser = déplacer ; poignée d’angle = taille ; un clic sélectionne, d’autres clics sélectionnent le calque suivant en dessous ; touches fléchées 1 % (avec Maj 5 %) ; Échap désélectionne ; un double-clic remplace l’image. Si le calque a la classe vn-nox, seule la hauteur est modifiée. Les trois champs doivent figurer dans le bloc vn-parameters comme champs numériques (type="range") ; le programme lit les bornes et le pas dans la définition du champ et n’écrit que leurs valeurs. Positionnez l’élément lui-même par CSS à partir de ces champs.

À l’exportation, data-vn-drag, data-vn-drag-x, data-vn-drag-y et data-vn-drag-size sont supprimés.

Icônes#

Icône Bootstrap : i.bi#

Chaque <i class="bi bi-NAME"> et <span class="bi bi-NAME"> du modèle devient automatiquement une icône modifiable, sauf s’il se trouve dans un champ de texte, dans un bouton, dans un élément de menu ou s’il est lui-même une icône de texte (vn-ic).

Syntaxe

html
<i class="bi bi-check2-circle"></i>

Résultat (vérifié)

html
<i class="" data-vn-icon-id="icon0" data-vn-icon-extra-classes=""></i>

Les classes bi et bi-NAME sont retirées du modèle et reposées à chaque rendu à partir de la valeur actuelle de l’icône. Toutes les autres classes sont conservées (data-vn-icon-extra-classes).

data-vn-icon#

Marque explicitement un élément comme icône, même s’il ne s’agit pas d’une icône Bootstrap (par exemple un <span> ou un <i> vide pour un SVG personnalisé). Le marqueur disparaît après l’importation et est remplacé par data-vn-icon-id="iconN".

Syntaxe

html
<a href="#" aria-label="Instagram"><i class="bi bi-instagram" data-vn-icon></i></a>
<i class="meinsymbol" data-vn-icon></i>
AttributValeursSignification
data-vn-iconInterrupteur (sans valeur)Dans le modèle : fait de l’élément une icône
data-vn-icon-idicon + nombreDéfini par l’importation, disparaît à l’exportation
data-vn-icon-extra-classesListe de classesClasses propres de l’élément (sans bi, bi-*)

Valeurs d’une icône#

La boîte de dialogue d’icône (recherche parmi toutes les icônes Bootstrap) modifie ces valeurs (iconOverrides[iconN]) :

ValeurTypeEffet
iconNom (star)Définit bi bi-star
iconTypebootstrap ou customcustom : SVG personnalisé (iconUrl) ou drapeau
iconUrlChemin du projetAdresse du SVG
sizeNombre (rem)font-size: <n>rem sur l’élément
color#rrggbbcolor avec !important ; pour un SVG personnalisé, comme masque monochrome
monoInterrupteurLe SVG personnalisé suit la couleur du texte (currentColor)
href, newTab, rel, downloadLienL’icône est placée dans un <a> (nouvelle enveloppe : color:inherit;text-decoration:none)

Si l’icône possède déjà une enveloppe de lien issue du modèle (un <a> qui contient uniquement l’icône), celle-ci est utilisée. Sans href dans la surcharge, les liens du thème restent intacts.

SVG personnalisés et drapeaux#

Les fichiers SVG personnalisés et les drapeaux (paquet dans la boîte de dialogue d’icône, environ 270 pays, 4:3 ou carré, dans vendor/flags) sont copiés dans le projet. Sans couleur choisie, ils apparaissent comme <img> avec leurs propres couleurs ; avec une couleur ou « monochrome », comme masque :

html
<span style="display:inline-block;width:1em;height:1em;vertical-align:-0.14em;background-color:currentColor;-webkit-mask:url('assets/icons/herz.svg') center/contain no-repeat;mask:url('assets/icons/herz.svg') center/contain no-repeat;"></span>

L’exportation réécrit les adresses en chemins relatifs et emporte les fichiers.

Alignement vertical#

Les icônes personnalisées (image, masque, SVG intégré) à côté du texte doivent s’aligner sur le milieu des majuscules, quelle que soit leur taille. Le programme définit pour cela vertical-align selon la formule 0,36 − H/2 em (H = hauteur en em ; le milieu des majuscules se situe à 0,36 em au-dessus de la ligne de base). Dans les conteneurs flex (boutons avec align-items:center), vertical-align n’a aucun effet ; c’est le conteneur qui centre.

html
<img src="assets/icons/x.svg" alt="" style="height:1.2em;width:auto;vertical-align:-0.24em;">

Empêcher ou exclure des icônes#

ObjectifComment
L’icône ne doit pas être modifiableNe pas utiliser <i class="bi …">/<span class="bi …"> : un SVG en ligne (<svg>), un <img> (alors image libre) ou un masque CSS dans style.less
L’icône dans le texte ne doit pas devenir vn-icImpossible dans un champ de texte ; placer l’icône comme élément à part en dehors du champ de texte

Boutons#

a.btn#

Chaque <a class="btn …"> est un bouton. L’importation définit data-vn-button-id="btnN" et lit les valeurs par défaut dans l’élément (texte, lien, couleur, forme, icône). Dans l’éditeur, un clic ouvre la boîte de dialogue de bouton au lieu de suivre le lien.

Syntaxe

html
<a class="btn btn-primary" href="#kontakt">Kontakt</a>

Résultat (vérifié)

html
<a class="btn btn-primary" href="#kontakt" data-vn-button-id="btn0" data-vn-btn-extra-classes="">Kontakt</a>
AttributValeursSignification
data-vn-button-idbtn + nombre à partir de 0Identifiant (clé dans buttonOverrides), supprimé à l’exportation
data-vn-btn-extra-classesListe de classesToutes les classes sauf btn, la classe de couleur et la classe de forme ; conservées à chaque modification, supprimées à l’exportation

Valeurs d’un bouton#

buttonOverrides[btnN], valeurs par défaut issues du modèle (buttonDefaults) :

ValeurTypePar défautSignification
textTexteTexte de l’élémentLibellé (écrit avec échappement)
hrefAdressehref de l’élément ; lien de cookies comme #cookie-settingsCible
targetInterrupteurtarget="_blank"Dans une nouvelle fenêtre
rel, downloadvoir Options de lienissu de l’élémentCompléments du lien
colorprimary, secondary, success, danger, warning, info, light, dark, custompremière classe de couleur, sinon primaryCouleur
customColor#rrggbb—Avec custom : arrière-plan, bordure ; la couleur du texte est choisie automatiquement claire ou foncée
outlineInterrupteurbtn-outline-…Bordure seulement
shapedefault, rounded-pill, rounded-0, rounded-circleissu de l’élémentForme
icon, iconType, iconUrl, iconPosition, iconSize, iconColor, iconMonovoir ci-dessousIcône dans le bouton

Ce qui est écrit est class = "btn <couleur> <forme> <extra>". Pour une couleur personnalisée, le programme définit background-color, border-color et color directement sur l’élément (style en ligne sans !important, la classe de couleur disparaît ; voir Couleur personnalisée). Le texte et le href sont repris du modèle comme texte brut : les espaces réservés {{…}} n’y sont pas évalués (Espaces réservés dans les boutons).

Icône dans le bouton#

Un <i class="bi bi-…"> ou <img> à l’intérieur du bouton est considéré comme icône de bouton et lu depuis le modèle (devant ou derrière selon la position dans le texte).

html
<a class="btn btn-outline-dark" href="#"><i class="bi bi-download"></i> Herunterladen</a>
ValeurSignification
iconNom de l’icône Bootstrap
iconTypebootstrap ou custom
iconUrlAdresse du SVG personnalisé/de l’image
iconPositionbefore ou after
iconSize0.3–6 (em ; 1 = standard)
iconColor#rrggbb ; pour un SVG personnalisé, comme masque
iconMonoSVG personnalisé dans la couleur du texte

Conteneurs vn-buttons et vn-theme-style#

vn-buttons est un marqueur sur le conteneur de plusieurs boutons. Il n’a pas d’effet de modification propre. Sa seule fonction : si le conteneur porte vn-theme-style="display-7", la classe est écrite sur chaque .btn du conteneur (taille/style de police du thème pour tous les boutons d’un groupe).

Syntaxe

html
<div vn-buttons vn-theme-style="display-7">
  <a class="btn btn-primary" href="#">Eins</a>
  <a class="btn btn-secondary" href="#">Zwei</a>
</div>
AttributValeurSignification
vn-buttonsInterrupteurMarqueur : conteneur d’un groupe de boutons
vn-theme-styleClasses (display-7)Devient les classes des .btn contenus (enregistré dans la valeur des classes supplémentaires)

Espaces réservés dans les boutons#

Dans <a class="btn">, un espace réservé {{…}} reste tel quel, dans le texte comme dans le href, dans l’éditeur comme dans l’export. La raison : tagButtons lit le texte et l’adresse comme valeurs par défaut dans le modèle brut, avant le remplacement des espaces réservés, et reconstruit le bouton à chaque affichage à partir de ces valeurs et des modifications de l’utilisateur (applyButtonValue).

html
<a class="btn btn-primary" href="{{ziel}}">{{beschriftung}}</a>   

Écrivez le texte et la cible directement dans le modèle ; l’utilisateur les modifie dans la boîte de dialogue du bouton. Si vous voulez alimenter les deux depuis le panneau des propriétés, utilisez un lien ordinaire sans la classe btn (<a class="mein-knopf" href="{{ziel}}">{{text}}</a>) et stylisez-le vous-même. Voir aussi Espaces réservés dans les boutons.

Couleur personnalisée#

Outre les huit couleurs Bootstrap, la boîte de dialogue du bouton propose une couleur personnalisée (color: 'custom', customColor: '#rrggbb'). Alors :

  • La classe de couleur (btn-primary, btn-outline-primary …) disparaît ; les classes de forme et les classes supplémentaires restent.
  • Le programme définit background-color, border-color et color comme style en ligne sur l’élément, sans !important. Avec « contour seul » (outline), le fond est transparent, la bordure et le texte prennent la couleur choisie ; sinon le programme choisit la couleur du texte selon la luminosité (#212529 ou #fff).
  • Si l’utilisateur revient à une couleur Bootstrap, le programme supprime de nouveau le style en ligne.

Couleurs et liens dans le CSS du bloc#

Pour les boutons et les liens, la même hiérarchie s’applique que pour tout le CSS de bloc (Qui l'emporte) :

  • Une règle de bloc sans !important l’emporte sur Bootstrap dans l’éditeur et dans l’export (dans l’éditeur, le CSS du bloc se trouve dans une couche ultérieure ; dans l’export, la spécificité plus élevée de la classe d’instance l’emporte).
  • Une règle de bloc avec !important l’emporte sur les règles Bootstrap sans !important. Face à une règle !important de Bootstrap ou du CSS du thème, elle l’emporte dans l’export, mais perd dans l’éditeur (inversion des couches pour !important). Le résultat diffère alors entre l’éditeur et la page terminée.
  • !important aide contre le CSS du thème de spécificité plus élevée et contre les règles de police et de typographie des réglages du site (Réglages du site) ; c’est pourquoi les blocs fournis définissent avec !important les couleurs, bordures et police des boutons et des liens.

Un bloc est un bloc de menu si son modèle contient navbar-nav ou nav-link. De tels blocs reçoivent dans le panneau des curseurs supplémentaires (police du menu, couleurs du menu déroulant, couleur du hamburger).

a.nav-link, a.dropdown-item et a.navbar-brand sont des champs de texte à traitement particulier : un clic sélectionne tout le texte (libellés courts), couleur, police et lien via la barre de texte, le clic ne suit pas le lien.

Syntaxe (convention Bootstrap)

html
<nav class="navbar navbar-expand-lg">
  <a class="navbar-brand" href="#"><img src="{{logo}}" alt="Logo"><span>Marke</span></a>
  <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#{{vn-id}}-nav"
          aria-controls="{{vn-id}}-nav" aria-expanded="false" aria-label="Menü öffnen">
    <span class="navbar-toggler-icon"></span>
  </button>
  <div class="collapse navbar-collapse" id="{{vn-id}}-nav">
    <ul class="navbar-nav ms-auto">
      <li class="nav-item"><a class="nav-link" href="#leistungen">Leistungen</a></li>
      <li class="nav-item"><a class="nav-link" href="#kontakt">Kontakt</a></li>
    </ul>
  </div>
</nav>

(issu de themes/vn-studio-src/components/menu1)

Action dans l’éditeurEffet sur le modèle
Ajouter un élémentLe conteneur de l’élément de menu (li, sinon .dropdown) est cloné, texte « Élément de menu »
Déplacer un élémentDevant/derrière l’élément voisin dans le même menu
Supprimer un élémentLe conteneur est retiré avec son sous-menu
▾ MenuTransforme un élément en menu déroulant ou ajoute une entrée supplémentaire

Le programme génère un menu déroulant Bootstrap 5. Un bloc peut apporter lui-même la même structure.

html
<li class="nav-item dropdown">
  <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" role="button" aria-expanded="false">Leistungen</a>
  <ul class="dropdown-menu" style="max-height:calc(100vh - 6rem);overflow-y:auto">
    <li><a class="dropdown-item" href="#">Bad</a></li>
    <li><a class="dropdown-item" href="#">Heizung</a></li>
  </ul>
</li>

S’il n’y a pas de conteneur li (menus sans structure de liste), le programme enveloppe l’élément dans un <div class="dropdown">. Dans l’éditeur, il ajoute en plus data-bs-auto-close="outside" sur chaque [data-bs-toggle="dropdown"], afin qu’un clic sur une entrée ne ferme pas le menu avant qu’elle puisse être modifiée. Cet attribut n’arrive jamais dans le modèle.

Lorsque le curseur se trouve dans une entrée d’un menu déroulant, le même bouton (« ▾ Entrée ») crée un sous-menu qui s’ouvre latéralement.

Syntaxe

html
<li class="vn-submenu">
  <a class="dropdown-item vn-submenu-toggle" href="#" aria-expanded="false">Eintrag</a>
  <ul class="dropdown-menu vn-submenu-list">
    <li><a class="dropdown-item" href="#">Unterpunkt</a></li>
  </ul>
</li>
ÉlémentSignification
li.vn-submenuMarqueur de l’élément avec sous-menu (déclenche l’exportation de vendor/vn-submenu)
a.vn-submenu-toggleEntrée de déploiement ; une flèche › est dessinée devant par CSS
ul.dropdown-menu.vn-submenu-listLe niveau inférieur

Comportement (vendor/vn-submenu/vn-submenu.js) : sur ordinateur, il s’ouvre au survol ou par focus clavier à droite de l’entrée, à gauche s’il manque de la place ; s’il est plus haut que la fenêtre, il reçoit une barre de défilement ; sur mobile et dans le menu hamburger replié, il se place en retrait directement sous l’entrée et s’ouvre par un appui (flèche ▾). Le script n’a pas besoin du JS Bootstrap et fonctionne aussi dans la zone de travail.

L’icône hamburger est .navbar-toggler-icon. Sa couleur est réglée par l’utilisateur dans le panneau (block.values._togglerColor). Le programme génère pour cela un SVG recoloré et neutralise les deux modes de dessin courants (SVG intégré dans background-image ou trois barres CSS avec ::before/::after) :

css
.vn-imp-menu-b1 .navbar-toggler-icon { background-image: url("data:image/svg+xml,…") !important; width: 1.5em !important; height: 1.5em !important; }
.vn-imp-menu-b1 .navbar-toggler-icon::before, .vn-imp-menu-b1 .navbar-toggler-icon::after { content: none !important; background: none !important; }

(.vn-imp-menu-b1 représente ici la classe d’instance du bloc.)

Une icône hamburger propre à un bloc doit donc utiliser l’élément .navbar-toggler-icon si le choix de la couleur doit fonctionner.

Toutes les valeurs se trouvent dans block.values, sont ajoutées dans renderer.js comme CSS avec !important et s’appliquent de la même manière dans l’éditeur et à l’exportation.

ValeurPlageSélecteurs
_menuFontPx8–64 px (curseur 10–40).navbar-nav, .navbar-nav .nav-link, .navbar-nav .dropdown-item
_brandFontPx8–96 px (curseur 10–60).navbar-brand, .navbar-caption-wrap, .navbar-caption
_ddBg#rrggbb.dropdown-menu arrière-plan
_ddText#rrggbb.dropdown-menu .dropdown-item couleur
_ddHoverBg, _ddHoverText#rrggbb:hover, :focus, :active des entrées ; désactive l’assombrissement général (filter:none)
_togglerColor#rrggbbvoir Icône hamburger

Le bouton d’icône de la barre de texte place une icône devant ou derrière un élément de menu (navIconOverrides[tN] : icon, iconType, iconUrl, size en rem, color, mono, pos = after ou devant). Le programme insère un <i data-vn-nav-icon> comme premier ou dernier enfant du a (espacement 0.4em). Le marquage data-vn-nav-icon ne fait pas partie du texte et est protégé lors de la modification et de l’enregistrement du texte du lien (voir Image et icône de menu dans l’élément de texte).

vn-menu est, comme vn-buttons, un marqueur sur le conteneur, ici celui des éléments de menu (.nav-link, .dropdown-item). Il n’a pas d’effet de modification ; seul vn-theme-style sur ce conteneur est écrit sur chaque élément de menu.

html
<ul vn-menu vn-theme-style="display-4" class="navbar-nav">
  <li class="nav-item"><a class="nav-link" href="#">Start</a></li>
</ul>

Toutes les boîtes de dialogue de lien (barre de texte et menu, image, bouton, icône) partagent les mêmes choix supplémentaires issus de src/link-options.js. L’enregistrement se fait toujours sous la forme { href, newTab/target, rel, download } ; le programme en écrit les attributs sur le <a>.

ChoixRésultat sur le <a>
Adressehref
Nouvelle fenêtretarget="_blank" et rel contient noopener
Type de lien (moteurs de recherche)rel="nofollow", rel="sponsored" ou rel="ugc"
Télécharger le fichier au lieu de l’ouvrirdownload (pas avec tel:, mailto:, #… et lien de cookies)
Ouvrir les réglages des cookieshref="#" et data-vn-cookie-settings

Le programme ne gère dans rel que ses propres valeurs (nofollow, sponsored, ugc, noopener) ; les valeurs rel étrangères du modèle sont conservées. Une surcharge de lien sans valeur rel (anciens projets) laisse l’élément inchangé.

Si l’utilisateur saisit un numéro de téléphone ou une adresse e-mail dans le champ d’adresse, il devient automatiquement tel: ou mailto: en quittant le champ (normalizeLinkInput).

SaisieRésultat
info@example.commailto:info@example.com
+49 30 123456 ou 030 123456tel:+4930123456 ; un 00 initial devient + ; (0) est supprimé
« Appel (tel:) » / « Message WhatsApp »Commutateur pour les numéros ; WhatsApp donne https://wa.me/<chiffres> (+ ?text=… avec un texte préalable) et s’ouvre dans une nouvelle fenêtre
Objet / texte du messagemailto:…?subject=…&body=… (encodé URL)

Un numéro national avec un 0 initial est interprété pour WhatsApp comme allemand (49). Les schémas déjà présents (https:, #, /) ne sont pas modifiés ; les dates comme 12.10.2026 ne sont pas reconnues comme numéro de téléphone.

« Ou choisir un fichier » copie le fichier dans assets/dateien/ du projet et enregistre le chemin ; l’exportation l’emporte. Pour un PDF, « Nouvel onglet » est coché en même temps.

RègleValeur
Cibleassets/dateien/<nom> ; les voyelles infléchies sont réécrites, uniquement [A-Za-z0-9._-], 80 caractères au maximum dans le nom
Même nomUn contenu identique (SHA-256) est réutilisé, sinon compteur -2, -3 …
Taille500 Mo au maximum
Refusés.php, .php3–.php7, .phtml, .phar, .cgi, .pl, .py, .sh, .asp, .aspx, .jsp, .htaccess, .htpasswd, .ini

« Ou choisir une ancre sur cette page » liste les ID d’ancre des blocs et enregistre #<ancre> (l’ID d’ancre d’un bloc se définit dans le panneau, sinon blk-<id>). Les blocs popup apparaissent comme « Popup : … ».

Un lien avec data-vn-cookie-settings ouvre à l’exportation la fenêtre du VN Cookie-Consent. Dans la boîte de dialogue de lien, c’est le bouton « Ouvrir les réglages des cookies » ; un second clic annule le choix.

Syntaxe

html
<a href="#" data-vn-cookie-settings>Cookie-Einstellungen</a>
AttributSignification
data-vn-cookie-settingsMarqueur sur le <a> (ou sur tout autre élément ; vendor/vn-cookie-consent réagit à un clic sur tout élément portant cet attribut, preventDefault)
Adresse d’espace réservé dans la boîte de dialogue#cookie-settings (uniquement en interne, le lien contient href="#")

L’attribut figure sur la liste d’autorisation du nettoyeur de texte (pas sur d’autres balises que a). La condition est que la bannière de cookies soit activée dans les paramètres du projet ; voir Cookie-Consent.

CMS : textes et images sur la page terminée#

Chaque bloc peut être réglé de sorte que son exploitant modifie textes, libellés de boutons, liens et images plus tard, directement sur la page terminée (CMS à fichiers plats, sans base de données). L’auteur du bloc n’écrit rien de particulier : tous les champs de texte, boutons et images <img> du bloc sont capturés.

Activation#

LieuSignification
Panneau, section CMS, interrupteurblock.cms = { enabled: true } ; dans la zone de travail, le bloc porte la marque « CMS »
Mot de passeUn mot de passe par projet ; il se trouve dans le profil du programme, pas dans le projet, et arrive sous forme de hachage PBKDF2-SHA256 (100 000 itérations, sel de 16 octets) dans vendor/vn-cms/config.php
Nom de la pageLa page doit s’appeler .php (index.php), sinon le code PHP de lecture est absent
Sans mot de passePersonne ne peut modifier (config.php est vide) ; l’exportation le signale
ModèleLe bloc « Bloc CMS (texte + image) » dans l’onglet « Code personnalisé »

Marquages dans le HTML terminé#

L’exportation définit ces attributs (avant l’intégration définitive des surcharges, tant que les identifiants sont encore présents). Ils ne doivent pas être écrits à la main ; ils sont listés ici parce que les extensions et l’exécution s’appuient dessus.

AttributValeurEffet
data-vn-cms-block<bloc>Sur l’élément racine du bloc : surface de modification
data-vn-cms<bloc>:<clé>Le champ de texte ou le libellé de bouton est modifiable
data-vn-cms-img<bloc>:<clé><img> : clic = remplacer, texte alternatif, lien
data-vn-cms-link<bloc>:<clé><a> : adresse et « nouvelle fenêtre » modifiables

Champs de texte imbriqués : seul l’externe est capturé. Les boutons (a.btn) reçoivent data-vn-cms et data-vn-cms-link ; les champs de texte qui sont eux-mêmes un lien reçoivent également data-vn-cms-link. Les images suppriment srcset et sizes (l’ancienne image l’emporterait sinon sur celle remplacée).

Format des clés#

Une clé a la forme <bloc>:<clé> avec la règle ^([A-Za-z0-9_-]+):([A-Za-z0-9_.:-]+)$.

PartieExempleOrigine
Blocm3k9x2ID du bloc (uniquement [A-Za-z0-9_-]), aussi nom de fichier
Textet0, t4data-vn-text-id
Boutonbtn0data-vn-button-id
Image librefi1data-vn-free-image-id
Image de champk:bilddata-vn-image-key avec le préfixe k:

Un attribut complet : data-vn-cms="m3k9x2:t0", data-vn-cms-img="m3k9x2:k:bild". Les clés peuvent comporter 60 caractères au maximum ([A-Za-z0-9_.:-]).

Ce qui arrive à la page lors de l’exportation#

  1. markCmsEditables attribue les attributs.
  2. Après l’intégration définitive, finalizeCmsMarkup enveloppe le contenu textuel dans des commentaires d’espace réservé (VNCMS-T).
  3. cmsToPhp en fait des appels PHP issus de vendor/vn-cms/cms.php : vn_cms_t, vn_cms_img, vn_cms_alt, vn_cms_href, vn_cms_target, vn_cms_wrap_open, vn_cms_wrap_close. Tout en haut de la page vient <?php require_once __DIR__ . '/vendor/vn-cms/cms.php'; ?>.
  4. Sur la page : vendor/vn-cms/vn-cms.css et vn-cms.js (uniquement si la page contient un bloc CMS).

Résultat (extrait)

html
<h2 data-vn-cms="m3k9x2:t0"><?php vn_cms_t('m3k9x2', 't0', <<<'VNCMS_D'
Aktuelles aus unserem Haus
VNCMS_D
); ?></h2>
<img data-vn-cms-img="m3k9x2:k:bild" src="<?php vn_cms_img('m3k9x2', 'k:bild', 'assets/images/team.jpg'); ?>" alt="<?php vn_cms_alt('m3k9x2', 'k:bild', ''); ?>">

Les contenus enregistrés se trouvent dans vn-cms-data/<bloc>.json (t textes, i images, a textes alternatifs, l liens), la dernière version est conservée sous .prev.json, les images téléversées vont dans uploads/cms/. Ces fichiers ne sont pas écrasés lors de la publication.

Utilisation et sécurité sur la page#

SujetComportement
ConnexionDouble-clic sur le bloc ou adresse avec #cms-login ; mot de passe ; ensuite, contour en pointillés autour de tous les champs
Enregistrementuniquement connecté, avec jeton de connexion (CSRF) et même origine (Origin/Host)
Échecs de connexionaprès 5 échecs, pause de 10 minutes (par adresse de visiteur)
Imagesuniquement JPG, PNG, GIF, WebP, 10 Mo au maximum, type vérifié par getimagesize, nom de fichier aléatoire
Contenu1,5 Mo au maximum par enregistrement
Balises autorisées dans le texteb strong i em u s br span a p small mark sub sup h1–h6 ul ol li div blockquote code kbd abbr q
Suppriméesscript style iframe object embed link meta form input button textarea select svg math noscript template base ; attributs d’événement
Attributsa : href (pas de javascript:, data:, vbscript:, file:), target (_blank/_self), rel, title ; tous : class (noms simples), lang, translate (codes de langue)
Liensuniquement adresses relatives, #ancre, http(s), mailto, tel

Chaque bloc peut devenir un popup dans le panneau (section Popup, interrupteur « Afficher comme popup »). L’auteur du bloc n’a rien à changer dans le modèle.

L’exportation place le bloc dans un conteneur (popupWrapperHtml), masqué jusqu’à l’ouverture. L’ID d’ancre du bloc passe de l’élément racine au conteneur.

Résultat (issu de popup.js)

html
<div class="vn-popup" id="blk-ab12" data-pos="center" data-size="md" data-anim="fade"
     data-vn-popup='{"auto":"none","delay":5,"scroll":50,"freq":"session","anim":"fade","backdropClose":true,"escClose":true}'
     style="--vnp-overlay:rgba(0, 0, 0, 0.60);--vnp-width:640px;--vnp-bg:#ffffff;--vnp-radius:12px" hidden aria-hidden="true">
  <div class="vn-popup-backdrop"></div>
  <div class="vn-popup-dialog" role="dialog" aria-modal="true" tabindex="-1">
    <button type="button" class="vn-popup-close" aria-label="Schließen">&times;</button>
    <div class="vn-popup-body"></div>
  </div>
</div>

Exécution : vendor/vn-popup/vn-popup.css et vn-popup.js (uniquement si la page contient un popup).

block.popup (toutes les valeurs sont vérifiées au chargement, les erreurs reviennent à la valeur par défaut) :

CléValeursPar défautSignification
enabledInterrupteurdésactivéPopup activé
autonone, delay, scroll, exitnoneOuverture automatique (l’ouverture par lien fonctionne toujours)
delay0–6005Secondes (avec delay)
scroll1–10050Pourcentage de la page (avec scroll)
freqalways, session, day, week, oncesessionFréquence d’ouverture spontanée (mémorisée dans sessionStorage/localStorage, clé vnpopup:<id>)
sizesm, md, lg, fullmdLargeur 420 px, 640 px, 960 px, 100 %
poscenter, top, bottomcenterPosition
animnone, fade, zoom, slide, left, right, flip, bouncefadeApparition
overlayColor, overlayOpacity#rrggbb, 0–100#000000, 60Assombrissement
backdropCloseInterrupteuractivéUn clic à côté ferme
escCloseInterrupteuractivéÉchap ferme (désactivé : uniquement via des boutons propres, par exemple une vérification d’âge)
showCloseInterrupteuractivéBouton de fermeture en haut à droite
bg#rrggbb#ffffffArrière-plan de la fenêtre
radius0–6012Arrondi des coins en px

Tout lien ou bouton dont le href pointe vers l’ID d’ancre du bloc popup (#blk-ab12 ou seite.php#blk-ab12) ouvre le popup. Dans la boîte de dialogue de lien : « Ou une ancre sur cette page » → « Popup : … ». L’adresse avec #blk-ab12 ouvre aussi le popup au chargement.

html
<a class="btn btn-primary" href="#angebot">Angebot ansehen</a>

Fermer depuis le contenu : data-vn-popup-close#

Tout élément du popup portant data-vn-popup-close le ferme par un clic (preventDefault), par exemple un bouton « Non merci ».

html
<a class="btn btn-secondary" href="#" data-vn-popup-close>Nein danke</a>
AppelRetourEffet
VNPopup.open(id)true/falseOuvre le popup avec cet ID de conteneur
VNPopup.close(id)—Ferme
VNPopup.isOpen()ID du popup ouvert ou nullÉtat

Autres règles de comportement de l’exécution : le défilement est bloqué ; le focus reste dans la fenêtre (piège à tabulation) et revient à l’élément déclencheur ; les vidéos et l’audio du popup sont mis en pause à la fermeture et les cadres YouTube/Vimeo sont vidés (adresse dans data-vn-src), puis rechargés à l’ouverture. Avec « réduire les animations » dans le système ou anim: none, il se ferme sans animation.

L’onglet « Code personnalisé » propose un bloc popup prêt à l’emploi (createPopupBlockEntry), déjà activé.

html
<section class="vn-popup-content">
  <vn-parameters>
    <header>Farben</header>
    <input type="color" title="Hintergrund" name="bgColor" value="#ffffff">
  </vn-parameters>
  <div class="vn-popup-inner">
    <h2 class="vn-popup-title">Schön, dass du da bist!</h2>
    <p class="vn-popup-text">Hier steht dein Text.</p>
    <a class="btn btn-primary" href="#" data-vn-popup-close>Mehr erfahren</a>
  </div>
</section>