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 :
- 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). - 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é.
- Rendu (éditeur) : après chaque rendu, le programme replace les surcharges sur le HTML fraîchement rendu et rend les éléments cliquables.
- 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 bloc | Clé | Contenu |
|---|---|---|
textOverrides | t0, t1 … | contenu modifié (innerHTML) d’un champ de texte |
textTagOverrides | t0 … | balise choisie (H1, H2, H3, P …) |
textLinkOverrides | t0 … | { href, newTab, colorClass, rel, download } pour les champs de texte qui sont eux-mêmes un <a> |
textAlignOverrides | t0 … | left, center, right, justify |
buttonOverrides | btn0 … | texte, lien, couleur, forme, icône d’un bouton |
iconOverrides | icon0 … | icône, taille, couleur, lien |
navIconOverrides | t0 … (élément de menu) | icône avant/après un élément de menu |
imageOverrides | fi1 … | adresse d’une image libre |
imageLinkOverrides | fi1 ou k:<champ> | { href, target, rel, download } autour d’une image |
imageAltOverrides | fi1, k:<champ> ; t:<id> ; s:<id> | texte alternatif ; titre (t:) ; taille (s:) |
animOverrides | t0, 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 :
- 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). - Champs de liste
ul/olavecdata-multilineouvn-article(voir Champs de liste). - É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
<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é)
<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ément | Champ de texte ? | Remarque |
|---|---|---|
h1–h6, p, li, blockquote, figcaption | oui | En dehors d’une navigation, d’un formulaire, d’un bouton, d’un lien |
div, span, td, th, label, small, em, dt … | oui, si terminal | Uniquement du texte et des balises en ligne à l’intérieur |
Conteneur avec des enfants paragraphe/titre (div.wrap > p) | non | Seuls les enfants deviennent des champs |
a.nav-link, a.navbar-brand, a.dropdown-item | oui | Branche à part, y compris à l’intérieur de nav |
a (liens isolés, pas .btn) avec du texte | oui | Le <a> lui-même est le champ, le lien se règle via la barre de texte |
Texte composé uniquement de {{platzhalter}} | non | Relè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), fieldset | jamais | NEVER_TEXT_TAGS |
Tout ce qui se trouve dans nav, button, select, form, a, vn-parameters | non | SKIP_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
<h2 data-vn-text-id="t0">Titel</h2>| Propriété | Valeur | Signification |
|---|---|---|
| Format | t + nombre (t0, t1 …) | Continu à partir de l’indice le plus élevé existant |
| Durée de vie | Éditeur et modèle | Supprimé à 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
<ul data-multiline>
<li>Erster Punkt</li>
<li>Zweiter Punkt</li>
</ul>
<ol vn-article>
<li>Schritt eins</li>
</ol>| Attribut | Valeur | Par défaut | Signification |
|---|---|---|---|
data-multiline | Interrupteur (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-article | Interrupteur | dé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.
<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 :
| Groupe | Balises |
|---|---|
| Autorisées en ligne | strong, 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és | Commentaires |
| 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) :
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 :
| Balise | Attributs autorisés |
|---|---|
a | href, target, rel, download, title, aria-label, data-vn-cookie-settings |
q | cite |
time | datetime |
data | value |
abbr, dfn | title |
del, ins | datetime, cite |
bdo | dir |
span | style (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 |
| toutes | class (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 :
| Source | Propriétés |
|---|---|
| Barre de texte | color, font-family, font-size, font-weight, font-style |
| VN Effets de texte | text-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 Animation | les variables --vn-a, --vn-d, --vn-dl, --vn-e, --vn-n et display:inline-block |
| Icône SVG personnalisée | le 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>. stripForeignFrameworkMarkupnettoie 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é.
| Surcharge | Effet 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’interface | Ré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) |
<p>Wir nutzen <span class="notranslate">VN-Designer</span> seit 2024.</p>Couleurs de lien#
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ée | Classe |
|---|---|
| Couleur du lien : par défaut | (aucune) |
| Primary, Secondary, Success, Info, Warning, Danger, Light, Dark | text-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
<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ément | Valeurs | Signification |
|---|---|---|
bi bi-NAME | Nom issu de Bootstrap Icons ([a-z0-9-]{1,60}) | Police d’icônes, dessinée via ::before |
vn-ic | Classe | Marqueur : cliquable et modifiable dans l’éditeur |
style="font-size:…em" | ^\d+(\.\d+)?em$ | Taille relative au texte |
style="color:#rrggbb" | Hexadécimal | Couleur (vide = couleur du texte) |
vn-ic-svg + data-vn-svg | assets/icons/….svg ou file:///….svg | SVG personnalisé issu du projet ; les autres adresses sont rejetées (SVG_ICON_SRC_RE) |
data-vn-svg-mode | mask ou image | mask : 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
<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>| Attribut | Valeurs | Par défaut | Signification |
|---|---|---|---|
class | vn-tip (+ vn-tip-plain) | — | Marqueur ; vn-tip-plain : sans soulignement |
title | Texte | — | Texte de l’info-bulle (version en texte brut) |
data-vn-tip-html | HTML nettoyé | — | Info-bulle avec saut de ligne/mise en forme ; title porte alors la version en texte brut |
data-bs-placement | top, bottom, left, right | top | Position |
data-vn-tip-bg, data-vn-tip-fg | #rrggbb | Thème | Couleurs du fond et du texte |
data-vn-tip-trigger | hover focus ou click | hover focus | Dé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.values | Plage | Effet (identique dans l’éditeur et à l’exportation) |
|---|---|---|
_textScalePct | 50–200 % | zoom sur l’élément : proportionnel à sa propre taille de thème, la hiérarchie est conservée |
_textWidthPct | 20–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.
<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.
<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
<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)
<img src="{{bild}}" alt="Landschaft" data-vn-image-key="bild">| Règle | Description |
|---|---|
| Détection | img[src] avec src="{{champ}}" (espaces autorisés), où champ est un champ image |
| Arrière-plan dans le style | style="background-image:url({{champ}})" (également dans vn-style) reçoit le même marquage sur l’élément |
| Widget d’arrière-plan | S’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) |
| Effet | Le 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
<img src="assets/images/team.jpg" alt="Team">Résultat (vérifié)
<img src="assets/images/team.jpg" alt="Team" data-vn-free-image-id="fi1">| Règle | Description |
|---|---|
| Non marqués | img avec {{platzhalter}} sans champ d’image correspondant, img sans src |
| Format | fi + numéro continu à partir de 1 |
| Dans l’éditeur | Classe 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.
<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.
| Limite | Valeur |
|---|---|
| Formats d’image autorisés | jpg, jpeg, png, gif, webp, svg (plus ico) |
| Taille par fichier | 15 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 imageAltOverrides | Valeur | Effet |
|---|---|---|
<id> | Texte | alt ; texte vide = volontairement vide (image décorative) |
t:<id> | Texte | title (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.
Lien d’image#
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.
<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ément | Plage | Effet |
|---|---|---|
| Largeur | 5–100 % | width en % de la largeur environnante plus max-width:100%, les deux en !important ; continue de s’adapter sur mobile |
| Hauteur | 24–4000 px | height et object-fit: cover (!important) |
| largeur seule | height: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
<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">| Attribut | Valeur | Signification |
|---|---|---|
data-vn-drag | Nom affiché | Marque l’élément comme déplaçable (le nom apparaît comme pastille) |
data-vn-drag-x | Nom de champ (curseur de plage, %) | Centre latéral en % de la largeur de la scène |
data-vn-drag-y | Nom de champ (%) | Distance au bas en % de la hauteur de la scène |
data-vn-drag-size | Nom 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
<i class="bi bi-check2-circle"></i>Résultat (vérifié)
<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
<a href="#" aria-label="Instagram"><i class="bi bi-instagram" data-vn-icon></i></a>
<i class="meinsymbol" data-vn-icon></i>| Attribut | Valeurs | Signification |
|---|---|---|
data-vn-icon | Interrupteur (sans valeur) | Dans le modèle : fait de l’élément une icône |
data-vn-icon-id | icon + nombre | Défini par l’importation, disparaît à l’exportation |
data-vn-icon-extra-classes | Liste de classes | Classes 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]) :
| Valeur | Type | Effet |
|---|---|---|
icon | Nom (star) | Définit bi bi-star |
iconType | bootstrap ou custom | custom : SVG personnalisé (iconUrl) ou drapeau |
iconUrl | Chemin du projet | Adresse du SVG |
size | Nombre (rem) | font-size: <n>rem sur l’élément |
color | #rrggbb | color avec !important ; pour un SVG personnalisé, comme masque monochrome |
mono | Interrupteur | Le SVG personnalisé suit la couleur du texte (currentColor) |
href, newTab, rel, download | Lien | L’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 :
<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.
<img src="assets/icons/x.svg" alt="" style="height:1.2em;width:auto;vertical-align:-0.24em;">Empêcher ou exclure des icônes#
| Objectif | Comment |
|---|---|
| L’icône ne doit pas être modifiable | Ne 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-ic | Impossible 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
<a class="btn btn-primary" href="#kontakt">Kontakt</a>Résultat (vérifié)
<a class="btn btn-primary" href="#kontakt" data-vn-button-id="btn0" data-vn-btn-extra-classes="">Kontakt</a>| Attribut | Valeurs | Signification |
|---|---|---|
data-vn-button-id | btn + nombre à partir de 0 | Identifiant (clé dans buttonOverrides), supprimé à l’exportation |
data-vn-btn-extra-classes | Liste de classes | Toutes 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) :
| Valeur | Type | Par défaut | Signification |
|---|---|---|---|
text | Texte | Texte de l’élément | Libellé (écrit avec échappement) |
href | Adresse | href de l’élément ; lien de cookies comme #cookie-settings | Cible |
target | Interrupteur | target="_blank" | Dans une nouvelle fenêtre |
rel, download | voir Options de lien | issu de l’élément | Compléments du lien |
color | primary, secondary, success, danger, warning, info, light, dark, custom | première classe de couleur, sinon primary | Couleur |
customColor | #rrggbb | — | Avec custom : arrière-plan, bordure ; la couleur du texte est choisie automatiquement claire ou foncée |
outline | Interrupteur | btn-outline-… | Bordure seulement |
shape | default, rounded-pill, rounded-0, rounded-circle | issu de l’élément | Forme |
icon, iconType, iconUrl, iconPosition, iconSize, iconColor, iconMono | voir ci-dessous | Icô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).
<a class="btn btn-outline-dark" href="#"><i class="bi bi-download"></i> Herunterladen</a>| Valeur | Signification |
|---|---|
icon | Nom de l’icône Bootstrap |
iconType | bootstrap ou custom |
iconUrl | Adresse du SVG personnalisé/de l’image |
iconPosition | before ou after |
iconSize | 0.3–6 (em ; 1 = standard) |
iconColor | #rrggbb ; pour un SVG personnalisé, comme masque |
iconMono | SVG 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
<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>| Attribut | Valeur | Signification |
|---|---|---|
vn-buttons | Interrupteur | Marqueur : conteneur d’un groupe de boutons |
vn-theme-style | Classes (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).
<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-coloretcolorcomme style en ligne sur l’élément, sans!important. Avec « contour seul » (outline), le fond esttransparent, la bordure et le texte prennent la couleur choisie ; sinon le programme choisit la couleur du texte selon la luminosité (#212529ou#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
!importantl’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
!importantl’emporte sur les règles Bootstrap sans!important. Face à une règle!importantde 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. !importantaide 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!importantles couleurs, bordures et police des boutons et des liens.
Menus#
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).
Éléments de menu et marque#
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)
<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’éditeur | Effet sur le modèle |
|---|---|
| Ajouter un élément | Le conteneur de l’élément de menu (li, sinon .dropdown) est cloné, texte « Élément de menu » |
| Déplacer un élément | Devant/derrière l’élément voisin dans le même menu |
| Supprimer un élément | Le conteneur est retiré avec son sous-menu |
| ▾ Menu | Transforme un élément en menu déroulant ou ajoute une entrée supplémentaire |
Menu déroulant#
Le programme génère un menu déroulant Bootstrap 5. Un bloc peut apporter lui-même la même structure.
<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.
Sous-menu : vn-submenu#
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
<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ément | Signification |
|---|---|
li.vn-submenu | Marqueur de l’élément avec sous-menu (déclenche l’exportation de vendor/vn-submenu) |
a.vn-submenu-toggle | Entrée de déploiement ; une flèche › est dessinée devant par CSS |
ul.dropdown-menu.vn-submenu-list | Le 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.
Icône hamburger#
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) :
.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.
Curseurs d’un bloc de menu#
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.
| Valeur | Plage | Sélecteurs |
|---|---|---|
_menuFontPx | 8–64 px (curseur 10–40) | .navbar-nav, .navbar-nav .nav-link, .navbar-nav .dropdown-item |
_brandFontPx | 8–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 | #rrggbb | voir Icône hamburger |
Icône devant l’élément de menu#
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).
Le marqueur vn-menu#
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.
<ul vn-menu vn-theme-style="display-4" class="navbar-nav">
<li class="nav-item"><a class="nav-link" href="#">Start</a></li>
</ul>Liens#
Boîte de dialogue de lien et options#
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>.
| Choix | Résultat sur le <a> |
|---|---|
| Adresse | href |
| Nouvelle fenêtre | target="_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’ouvrir | download (pas avec tel:, mailto:, #… et lien de cookies) |
| Ouvrir les réglages des cookies | href="#" 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é.
Téléphone, WhatsApp et e-mail#
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).
| Saisie | Résultat |
|---|---|
info@example.com | mailto:info@example.com |
+49 30 123456 ou 030 123456 | tel:+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 message | mailto:…?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.
Lien vers un fichier#
« 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ègle | Valeur |
|---|---|
| Cible | assets/dateien/<nom> ; les voyelles infléchies sont réécrites, uniquement [A-Za-z0-9._-], 80 caractères au maximum dans le nom |
| Même nom | Un contenu identique (SHA-256) est réutilisé, sinon compteur -2, -3 … |
| Taille | 500 Mo au maximum |
| Refusés | .php, .php3–.php7, .phtml, .phar, .cgi, .pl, .py, .sh, .asp, .aspx, .jsp, .htaccess, .htpasswd, .ini |
Ancre sur cette page#
« 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 : … ».
Ouvrir les réglages des cookies#
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
<a href="#" data-vn-cookie-settings>Cookie-Einstellungen</a>| Attribut | Signification |
|---|---|
data-vn-cookie-settings | Marqueur 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#
| Lieu | Signification |
|---|---|
| Panneau, section CMS, interrupteur | block.cms = { enabled: true } ; dans la zone de travail, le bloc porte la marque « CMS » |
| Mot de passe | Un 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 page | La page doit s’appeler .php (index.php), sinon le code PHP de lecture est absent |
| Sans mot de passe | Personne ne peut modifier (config.php est vide) ; l’exportation le signale |
| Modèle | Le 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.
| Attribut | Valeur | Effet |
|---|---|---|
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_.:-]+)$.
| Partie | Exemple | Origine |
|---|---|---|
| Bloc | m3k9x2 | ID du bloc (uniquement [A-Za-z0-9_-]), aussi nom de fichier |
| Texte | t0, t4 | data-vn-text-id |
| Bouton | btn0 | data-vn-button-id |
| Image libre | fi1 | data-vn-free-image-id |
| Image de champ | k:bild | data-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#
markCmsEditablesattribue les attributs.- Après l’intégration définitive,
finalizeCmsMarkupenveloppe le contenu textuel dans des commentaires d’espace réservé (VNCMS-T). cmsToPhpen fait des appels PHP issus devendor/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'; ?>.- Sur la page :
vendor/vn-cms/vn-cms.cssetvn-cms.js(uniquement si la page contient un bloc CMS).
Résultat (extrait)
<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#
| Sujet | Comportement |
|---|---|
| Connexion | Double-clic sur le bloc ou adresse avec #cms-login ; mot de passe ; ensuite, contour en pointillés autour de tous les champs |
| Enregistrement | uniquement connecté, avec jeton de connexion (CSRF) et même origine (Origin/Host) |
| Échecs de connexion | après 5 échecs, pause de 10 minutes (par adresse de visiteur) |
| Images | uniquement JPG, PNG, GIF, WebP, 10 Mo au maximum, type vérifié par getimagesize, nom de fichier aléatoire |
| Contenu | 1,5 Mo au maximum par enregistrement |
| Balises autorisées dans le texte | b 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ées | script style iframe object embed link meta form input button textarea select svg math noscript template base ; attributs d’événement |
| Attributs | a : href (pas de javascript:, data:, vbscript:, file:), target (_blank/_self), rel, title ; tous : class (noms simples), lang, translate (codes de langue) |
| Liens | uniquement adresses relatives, #ancre, http(s), mailto, tel |
Popup#
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.
Comment naît le popup#
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)
<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">×</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).
Paramètres#
block.popup (toutes les valeurs sont vérifiées au chargement, les erreurs reviennent à la valeur par défaut) :
| Clé | Valeurs | Par défaut | Signification |
|---|---|---|---|
enabled | Interrupteur | désactivé | Popup activé |
auto | none, delay, scroll, exit | none | Ouverture automatique (l’ouverture par lien fonctionne toujours) |
delay | 0–600 | 5 | Secondes (avec delay) |
scroll | 1–100 | 50 | Pourcentage de la page (avec scroll) |
freq | always, session, day, week, once | session | Fréquence d’ouverture spontanée (mémorisée dans sessionStorage/localStorage, clé vnpopup:<id>) |
size | sm, md, lg, full | md | Largeur 420 px, 640 px, 960 px, 100 % |
pos | center, top, bottom | center | Position |
anim | none, fade, zoom, slide, left, right, flip, bounce | fade | Apparition |
overlayColor, overlayOpacity | #rrggbb, 0–100 | #000000, 60 | Assombrissement |
backdropClose | Interrupteur | activé | Un clic à côté ferme |
escClose | Interrupteur | activé | Échap ferme (désactivé : uniquement via des boutons propres, par exemple une vérification d’âge) |
showClose | Interrupteur | activé | Bouton de fermeture en haut à droite |
bg | #rrggbb | #ffffff | Arrière-plan de la fenêtre |
radius | 0–60 | 12 | Arrondi des coins en px |
Ouvrir par un lien : href="#ancre"#
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.
<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 ».
<a class="btn btn-secondary" href="#" data-vn-popup-close>Nein danke</a>Interface JavaScript : VNPopup#
| Appel | Retour | Effet |
|---|---|---|
VNPopup.open(id) | true/false | Ouvre 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.
Modèle « Popup »#
L’onglet « Code personnalisé » propose un bloc popup prêt à l’emploi (createPopupBlockEntry), déjà activé.
<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>