Direkt bearbeitbare Inhalte
Was im Canvas per Klick bearbeitbar ist (Text, Bilder, Symbole, Buttons, Menüs, Links), wie der Baustein-Autor es im Template markiert, auslöst oder verhindert, und wie CMS- und Popup-Funktionen am Block hängen.
Überblick#
Im Canvas wird fast alles direkt angeklickt und geändert: Texte, Bilder, Symbole, Buttons, Menüpunkte, Links. Ein Baustein-Autor schreibt dafür keinen Editor-Code. Er schreibt normales HTML in template.html; das Programm erkennt beim Import, was bearbeitbar ist, und vergibt stabile Kennungen.
Der Ablauf ist immer gleich:
- Import: Hilfsfunktionen (
tagEditableText,tagButtons,tagIcons,tagFreeImages,tagImageFields) setzen Kennungen ins Template (data-vn-text-id,data-vn-button-id,data-vn-icon-id,data-vn-free-image-id,data-vn-image-key). Dieselben Funktionen laufen bei jedem Laden eines Projekts erneut (idempotent: vorhandene Kennungen bleiben, nur neue Elemente bekommen frische). - Bearbeiten: Änderungen des Nutzers landen nicht im Template, sondern in Overrides am Block. Das Template bleibt unverändert.
- Rendern (Editor): Nach jedem Render legt das Programm die Overrides wieder über das frisch gerenderte HTML und macht die Elemente klickbar.
- Export: Dieselben Overrides werden fest eingebacken; alle Editor-Spuren (Kennungen,
contenteditable, Hilfsklassen) werden entfernt.
| Override am Block | Schlüssel | Inhalt |
|---|---|---|
textOverrides | t0, t1 … | geänderter Inhalt (innerHTML) eines Textfelds |
textTagOverrides | t0 … | gewählter Tag (H1, H2, H3, P …) |
textLinkOverrides | t0 … | { href, newTab, colorClass, rel, download } für Textfelder, die selbst ein <a> sind |
textAlignOverrides | t0 … | left, center, right, justify |
buttonOverrides | btn0 … | Text, Link, Farbe, Form, Symbol eines Buttons |
iconOverrides | icon0 … | Symbol, Größe, Farbe, Link |
navIconOverrides | t0 … (Menüpunkt) | Symbol vor/hinter einem Menüpunkt |
imageOverrides | fi1 … | Adresse eines freien Bilds |
imageLinkOverrides | fi1 oder k:<feld> | { href, target, rel, download } um ein Bild |
imageAltOverrides | fi1, k:<feld>; t:<id>; s:<id> | Alt-Text; Titel (t:); Größe (s:) |
animOverrides | t0, fi1, k:<feld> | Animation (siehe Animationen) |
Text#
Welche Elemente werden Textfelder#
Jedes Element, das Fließtext trägt, wird automatisch ein Textfeld (contenteditable) mit einer Kennung data-vn-text-id="tN". Der Autor muss nichts markieren. Erfasst werden, in dieser Reihenfolge der Kennungsvergabe:
- Standard-Texttags:
h1–h6,p,li,blockquote,figcaption(nur die jeweils äußersten, kein Doppelt-Markieren), dazu Menü-Links und lose Links (siehe unten). - Listenfelder
ul/olmitdata-multilineodervn-article(siehe Listenfelder). - Blatt-Elemente: jedes weitere Element, das nur Text und Inline-Tags enthält, zum Beispiel
<div>Text</div>,<span>,<td>,<label>,<small>,<em>,<dt>.
Syntax
<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>Ergebnis nach dem Import (geprüft)
<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>Die Kennungen werden in dieser Reihenfolge vergeben: erst Überschriften, Absätze und Listeneinträge, dann Menü-Links und lose Links, zuletzt die Blatt-Elemente. Ein Link innerhalb eines Absatzes bekommt eine eigene, verschachtelte Kennung (im Beispiel t2): Der Link ist ein eigenes Feld für Adresse und Farbe, sein Text bleibt Teil des Absatzes.
| Element | Textfeld? | Bemerkung |
|---|---|---|
h1–h6, p, li, blockquote, figcaption | ja | Außerhalb von Navigation, Formular, Button, Link |
div, span, td, th, label, small, em, dt … | ja, wenn Blatt | Nur Text und Inline-Tags darin |
Container mit Absatz-/Überschriftkindern (div.wrap > p) | nein | Nur die Kinder werden Felder |
a.nav-link, a.navbar-brand, a.dropdown-item | ja | Eigener Zweig, auch innerhalb von nav |
a (lose Links, nicht .btn) mit Text | ja | Das <a> selbst ist das Feld, Link über die Textleiste |
Text, der nur aus {{platzhalter}} besteht | nein | Gehört dem Eigenschaften-Panel |
script, style, textarea, option, select, button, iframe, svg, noscript, template, pre, code, input, header (Panel-Kopf), fieldset | nie | NEVER_TEXT_TAGS |
Alles innerhalb von nav, button, select, form, a, vn-parameters | nein | SKIP_ANCESTOR_TAGS; für Menü-Links und lose Links gilt eine engere Liste (nav ist dort erlaubt) |
data-vn-text-id#
Vom Programm vergebene Kennung eines Textfelds. Sie ist die Verbindung zwischen Template und textOverrides. Autoren setzen sie nicht selbst. Sie ist wichtig für alles, was später ein Feld ansprechen soll: Animationen, CMS-Schlüssel und Erweiterungen (ctx.blocks.texts).
Syntax
<h2 data-vn-text-id="t0">Titel</h2>| Eigenschaft | Wert | Bedeutung |
|---|---|---|
| Format | t + Zahl (t0, t1 …) | Fortlaufend ab dem höchsten vorhandenen Index |
| Lebensdauer | Editor und Template | Im Export entfernt (bakeTextOverridesForExport) |
Listenfelder: data-multiline und vn-article#
Eine Liste, in der Enter einen neuen Eintrag anlegen soll, ist ein einziges Textfeld. Das kennzeichnen Sie am ul/ol selbst. Die Einträge darin sind dann keine eigenen Felder.
Syntax
<ul data-multiline>
<li>Erster Punkt</li>
<li>Zweiter Punkt</li>
</ul>
<ol vn-article>
<li>Schritt eins</li>
</ol>| Attribut | Wert | Standard | Bedeutung |
|---|---|---|---|
data-multiline | Schalter (ohne Wert) | aus | Am ul, ol (erweiterbare Liste) oder am div: das Feld darf Listen, Absätze, Zitate und Überschriften enthalten |
vn-article | Schalter | aus | Wie data-multiline, am ul/ol |
Geschachtelte Listen: nur die äußerste ist das Feld. Ein div-Feld oder ein Feld mit data-multiline behält beim Speichern ul, ol, li, p, blockquote, h1–h6 (siehe Erlaubte Tags).
Platzhalter im Text#
Besteht der gesamte Text eines Elements aus einem {{platzhalter}}, ist das Element kein Textfeld; der Wert wird im Eigenschaften-Panel gepflegt. Steht ein Platzhalter nur mitten im Text (x {{a}} y), ist das Element ein Textfeld.
<h2>{{title}}</h2>
<p>Preis ab {{preis}} €</p> Erlaubte Tags beim Speichern (Sanitizer)#
Jede Änderung wird beim Rendern und beim Export durch sanitizeRichTextHtml bereinigt. Eine Erlaubnisliste bestimmt, was im Text bleibt:
| Gruppe | Tags |
|---|---|
| Inline erlaubt | 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 |
Blöcke, nur in Mehrzeilenfeldern (div oder data-multiline) | ul, ol, li, p, blockquote, h1–h6 |
Aufgelöst (Inhalt bleibt, Hülle fällt weg, ehemalige Blockgrenze wird <br>) | div, section, article, table-Teile, figure, header, footer, main, aside, nav, hr, pre, form und alles Unbekannte |
| Entfernt | Kommentare |
| Unverändert | <script type="text/x-vn-php"> (geschützter PHP-Code) |
Geprüftes Beispiel (Eingabe als gespeicherter Override, Ergebnis nach dem Einbacken):
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>Erlaubte Attribute und Klassen#
An erlaubten Inline-Tags bleiben nur diese Attribute:
| Tag | Erlaubte Attribute |
|---|---|
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 (gefiltert, siehe unten), data-vn-text-color, data-vn-anim, data-vn-anim-t, data-vn-svg, data-vn-svg-mode, Tooltip-Attribute |
| alle | class (gefiltert) |
Klassen bleiben erhalten, wenn der Name ein einfaches Token ist (keine Anführungszeichen, <, >, &, =, Backtick). Es fallen weg: Klassen, die mit vn-editable beginnen, vn-anim-…, vn-tip/vn-tip-plain (setzt der Tooltip-Zweig selbst) und bekannte Fremdklassen von Webseiten-Frameworks. Ein <span class="akzent"> im Text überlebt also Speichern, Export und Neuladen.
Erlaubte Stile am span#
Ein <span> darf diese Inline-Stile behalten:
| Quelle | Eigenschaften |
|---|---|
| Textleiste | color, font-family, font-size, font-weight, font-style |
| VN Text-Effekte | text-shadow, background-color, background-image, background-clip (mit -webkit-background-clip), background-repeat, background-size, padding-left, padding-right, die vier border-*-radius, box-decoration-break (mit Vorsilbe), -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 | die Variablen --vn-a, --vn-d, --vn-dl, --vn-e, --vn-n und display:inline-block |
| Eigenes SVG-Symbol | Stil wird aus data-vn-svg und data-vn-svg-mode neu gebaut |
Werte mit url(…), expression, javascript, @import, < oder > werden verworfen. Alle anderen Eigenschaften (zum Beispiel position) fallen weg.
Fremdes Markup aus Webseiten#
Fügt ein Nutzer Text aus einer KI-Chatseite oder einer Suchmaschine ein, kommt fremdes Markup mit (Attribute jscontroller, jsaction, data-sfc-…, data-section-id zusammen mit data-start/data-end und bekannte Framework-Klassen). Dagegen gibt es zwei Schutzstufen:
- Einfügen und Ziehen in ein Textfeld läuft immer als reiner Text. Zeilenumbrüche werden zu
<br>. stripForeignFrameworkMarkupbereinigt beim Laden und beim Übernehmen im Code-Editor ein ganzes Template von diesen Fingerabdrücken: das Element wird aufgelöst, sein Inhalt bleibt. Steht davor ein leeres Textfeld, rutscht der Inhalt hinein.
Überschrift-Ebene und Ausrichtung#
Die Textleiste bietet für ein Feld: Absatz oder Überschrift 1–3, und die Ausrichtung links, mitte, rechts, Blocksatz.
| Override | Wirkung im Template-Element |
|---|---|
textTagOverrides[tN] = 'H2' | Das Element wird durch ein neues mit diesem Tag ersetzt (alle Attribute und Kinder bleiben) |
textAlignOverrides[tN] | text-align mit !important; bei Blocktags (p, h1–h6, div, blockquote, ul, ol, figcaption) zusätzlich margin-left/margin-right (0 oder auto), außer bei Blocksatz |
Format-Auswahl und „Keine Übersetzung“#
Die Format-Auswahl der Textleiste umhüllt eine Markierung mit einem Inline-Tag:
| Eintrag der Oberfläche | Ergebnis |
|---|---|
| Code | <code> |
| Markiert | <mark> |
| Klein | <small> |
| Hochgestellt | <sup> |
| Tiefgestellt | <sub> |
| Tastenkombination | <kbd> |
| Zitat | <q> |
| Abkürzung | <abbr> |
| Durchgestrichen | <s> |
| Keine Übersetzung | <span class="notranslate"> (kein Tag; siehe Übersetzer) |
<p>Wir nutzen <span class="notranslate">VN-Designer</span> seit 2024.</p>Linkfarben#
Ein Link im Text bekommt über die Textleiste eine Farbklasse direkt am <a>. Die Liste ist zugleich die Erlaubnisliste.
| Eintrag | Klasse |
|---|---|
| Linkfarbe: Standard | (keine) |
| Primary, Secondary, Success, Info, Warning, Danger, Light, Dark | text-primary, text-secondary, text-success, text-info, text-warning, text-danger, text-light, text-dark |
Die Klassen sind Bootstrap-Hilfsklassen mit !important und gewinnen deshalb gegen Theme-Linkfarben.
Symbole im Text#
Der Symbol-Knopf der Textleiste fügt an der Schreibmarke ein Symbol ein, das Größe und Farbe des Textes erbt.
Syntax
<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>| Teil | Werte | Bedeutung |
|---|---|---|
bi bi-NAME | Name aus Bootstrap Icons ([a-z0-9-]{1,60}) | Symbolschrift, gezeichnet über ::before |
vn-ic | Klasse | Marker: im Editor klick- und änderbar |
style="font-size:…em" | ^\d+(\.\d+)?em$ | Größe relativ zum Text |
style="color:#rrggbb" | Hex | Farbe (leer = Textfarbe) |
vn-ic-svg + data-vn-svg | assets/icons/….svg oder file:///….svg | Eigenes SVG aus dem Projekt; andere Adressen werden verworfen (SVG_ICON_SRC_RE) |
data-vn-svg-mode | mask oder image | mask: einfarbig in Textfarbe; image: mit eigenen Farben |
Ein im Template fest stehendes <i class="bi bi-…"> oder <span class="bi bi-…"> innerhalb eines Textfelds wird im Editor automatisch zu einem änderbaren Symbol (Klasse vn-ic), nicht aber im Menüpunkt (dort gilt das ★-Menüsymbol).
Tooltips auf Wörtern#
Die Textleiste setzt auf ein Wort einen Tooltip. Im Export aktiviert vendor/vn-tooltip das Bootstrap-Tooltip (nur wenn die Seite mindestens eines enthält).
Syntax
<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 | Werte | Standard | Bedeutung |
|---|---|---|---|
class | vn-tip (+ vn-tip-plain) | — | Marker; vn-tip-plain: ohne Unterstreichung |
title | Text | — | Tooltip-Text (Nur-Text-Fassung) |
data-vn-tip-html | bereinigtes HTML | — | Tooltip mit Umbruch/Formatierung; title trägt dann die Nur-Text-Fassung |
data-bs-placement | top, bottom, left, right | top | Lage |
data-vn-tip-bg, data-vn-tip-fg | #rrggbb | Theme | Farben von Fläche und Schrift |
data-vn-tip-trigger | hover focus oder click | hover focus | Auslöser; Klick außerhalb schließt |
Das Skript setzt tabindex="0" (Tastatur), merkt sich die Initialisierung in data-vn-tip-ready und fällt ohne Bootstrap 5 auf den title-Hinweis des Browsers zurück.
Text-Effekte und Animation am Wort#
Die Werkzeuge VN Text-Effekte und VN Animation schreiben ihre Wirkung als gefilterte Stile und Attribute auf ein <span> (siehe Erlaubte Stile). Ein Autor schreibt sie nicht von Hand; er muss nur wissen, dass diese Eigenschaften das Speichern überleben, alle anderen nicht.
Größe, Breite und Position pro Block#
Im Eigenschaften-Panel hat jeder Block drei Regler für alle seine Textfelder und Buttons (Elemente mit data-vn-text-id oder data-vn-button-id). Menüpunkte und Marken (nav-link, dropdown-item, navbar-brand) sind ausgenommen, sie haben eigene Regler.
Wert in block.values | Bereich | Wirkung (Editor und Export gleich) |
|---|---|---|
_textScalePct | 50–200 % | zoom am Element: proportional zur eigenen Theme-Größe, Hierarchie bleibt |
_textWidthPct | 20–100 % (100 = aus) | max-width in %, mit margin-left/right: auto |
_textOffsetYPx | −150–150 px (0 = aus) | transform: translateY(…): verschiebt rein optisch, der Textfluss bleibt |
Für die Freie Fläche (Block mit freeSurface) entfallen Breite und Position, dort bestimmen die Elemente selbst.
Bild und Menü-Symbol im Textelement#
Ein direktes Kind img, picture, svg oder ein Menü-Symbol (data-vn-nav-icon) in einem Textfeld gehört nicht zum bearbeiteten Text. Es wird nie in den Override übernommen und beim Ersetzen des Inhalts an derselben Seite (vorn oder hinten) wieder eingesetzt. So überlebt zum Beispiel das Logo im Markenlink eines Menüs die Textbearbeitung.
<a class="navbar-brand" href="#"><img src="{{logo}}" alt="Logo"><span>Marke</span></a>Geschützter PHP-Code im Text#
Ein <script type="text/x-vn-php"> mitten im Text bleibt beim Bereinigen unverändert stehen (Attribute außer type werden entfernt). Im Browser ist es inert; tippen kann man es nicht. Der Export setzt den PHP-Code roh ein.
<p>Stand: <script type="text/x-vn-php"><?php echo date('d.m.Y'); ?></script></p>Bilder#
Bildfeld: data-vn-image-key#
Ein <img>, dessen src genau ein Platzhalter eines Bildfelds ist, wird mit einem Klick austauschbar. Der Import setzt data-vn-image-key="<feldname>".
Syntax
<vn-parameters>
<input type="image" title="Bild" name="bild" value="../_images/land-d.jpg">
</vn-parameters>
<img src="{{bild}}" alt="Landschaft">Ergebnis (geprüft am Import)
<img src="{{bild}}" alt="Landschaft" data-vn-image-key="bild">| Regel | Beschreibung |
|---|---|
| Erkennung | img[src] mit src="{{feld}}" (Leerzeichen erlaubt), wobei feld ein image-Feld ist |
| Hintergrund im Style | style="background-image:url({{feld}})" (auch in vn-style) bekommt dieselbe Markierung am Element |
| Hintergrund-Widget | Gibt es ein fieldset type="background", wird das Wurzelelement des Blocks als Ziel markiert; ein Klick zählt nur, wenn die freie Fläche selbst getroffen wird (e.target ist das Wurzelelement) |
| Wirkung | Klick öffnet die Bildauswahl und schreibt in block.values[feld] |
Freies Bild: data-vn-free-image-id#
Alle anderen <img src="…"> mit echter Adresse (Deko-Fotos, Logos, Beispielbilder) bekommen data-vn-free-image-id="fiN". Auch sie sind per Klick austauschbar; der Wert liegt in imageOverrides.
Syntax
<img src="assets/images/team.jpg" alt="Team">Ergebnis (geprüft)
<img src="assets/images/team.jpg" alt="Team" data-vn-free-image-id="fi1">| Regel | Beschreibung |
|---|---|
| Nicht markiert | img mit {{platzhalter}} ohne passendes Bildfeld, img ohne src |
| Format | fi + fortlaufende Nummer ab 1 |
| Im Editor | Klasse vn-free-image, Klick öffnet die Bildauswahl (stoppt das Weiterreichen des Klicks) |
Hintergrundbild im Inline-Style#
Elemente mit style="background-image:url(…)" (oder in vn-style) und echter Adresse sind ebenfalls freie Bilder (data-vn-free-image-id); der Tausch ersetzt die Adresse im Attribut.
<div class="hero" style="background-image:url(assets/images/hero.jpg)"></div>Bildauswahl und Dateien#
Ein Klick auf ein Bild mit Kennung öffnet „Bild ändern“: eine neue Datei hochladen oder (je nach Block) eines der Projektbilder wählen. Die Datei wird ins Projekt kopiert (assets/images/) und behält ihren Namen (Namensbelegung: gleicher Inhalt = vorhandene Datei wiederverwenden, sonst Zähler -2, -3). Der Export nimmt nur Dateien mit, auf die verwiesen wird, und schreibt file:///-Adressen relativ um.
| Grenze | Wert |
|---|---|
| Erlaubte Bildformate | jpg, jpeg, png, gif, webp, svg (dazu ico) |
| Größe je Datei | höchstens 15 MB |
Alt-Text, Titel und Link#
Für jedes img mit Bildkennung (Feldbild oder freies Bild) gibt es im Bild-Dialog Alt-Text, Titel und Link. Die Werte liegen in imageAltOverrides und imageLinkOverrides.
Schlüssel in imageAltOverrides | Wert | Wirkung |
|---|---|---|
<id> | Text | alt; leerer Text = bewusst leer (Deko-Bild) |
t:<id> | Text | title (Tooltip); leer entfernt das Attribut |
s:<id> | "<Breite>%|<Höhe>px" | Größe (siehe Skalieren) |
<id> ist fiN für freie Bilder und k:<feld> für Feldbilder.
Bild-Link#
imageLinkOverrides[<id>] = { href, target, rel, download } legt ein <a> um das Bild (oder ändert das vorhandene). Im Editor ist der Link markiert (data-vn-img-link) und folgt nicht; Link-Optionen wie rel, download und data-vn-cookie-settings gelten wie in Links.
<a href="https://example.com/team" target="_blank" rel="noopener"><img src="assets/images/team.jpg" alt="Team"></a>Steckt das Bild schon in einem <a> der Vorlage, ändert der Dialog dessen Adresse. Ein Logo im Markenlink ist ein solcher Fall.
Bilder mit der Maus skalieren#
Fährt die Maus über ein Bild mit Kennung, erscheinen drei Griffe: rechts (Breite), unten (Höhe, das Bild wird zugeschnitten statt verzerrt), Ecke (beides, Seitenverhältnis bleibt; mit Umschalt frei). Doppelklick auf einen Griff setzt zurück. Abschaltbar in den Seiteneinstellungen („Bilder mit der Maus skalieren“).
Gespeichert wird in imageAltOverrides["s:<id>"] als "<Breite in %>|<Höhe in px>", zum Beispiel "62%|240px", "62%|" (nur Breite), "|240px" (nur Höhe).
| Teil | Bereich | Wirkung |
|---|---|---|
| Breite | 5–100 % | width in % der umgebenden Breite plus max-width:100%, beides !important; bleibt am Handy mitskalierend |
| Höhe | 24–4000 px | height und object-fit: cover (!important) |
| nur Breite | height:auto !important |
Ebenen ziehen: data-vn-drag#
Szenen-Blöcke (mehrere übereinander liegende Bildebenen) markieren eine Ebene, damit der Nutzer sie auf der Arbeitsfläche mit der Maus verschieben und skalieren kann.
Syntax
<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 | Wert | Bedeutung |
|---|---|---|
data-vn-drag | Anzeigename | Markiert das Element als ziehbar (Name erscheint als Chip) |
data-vn-drag-x | Feldname (Bereichsregler, %) | Seitliche Mitte in % der Bühnenbreite |
data-vn-drag-y | Feldname (%) | Abstand vom Boden in % der Bühnenhöhe |
data-vn-drag-size | Feldname (%) | Breite in % der Bühnenbreite |
Bedienung: ziehen = verschieben; Eckgriff = Größe; Klick wählt, weitere Klicks wählen die nächste Ebene darunter; Pfeiltasten 1 % (mit Umschalt 5 %); Esc hebt auf; Doppelklick tauscht das Bild. Hat die Ebene die Klasse vn-nox, wird nur die Höhe verändert. Die drei Felder müssen im vn-parameters-Block als Zahlenfelder (type="range") stehen; Grenzen und Schrittweite liest das Programm aus der Felddefinition und schreibt nur deren Werte. Das Element selbst positionieren Sie per CSS aus diesen Feldern.
Im Export werden data-vn-drag, data-vn-drag-x, data-vn-drag-y und data-vn-drag-size entfernt.
Symbole#
Bootstrap-Symbol: i.bi#
Jedes <i class="bi bi-NAME"> und <span class="bi bi-NAME"> im Template wird automatisch ein änderbares Symbol, außer es liegt in einem Textfeld, in einem Button, in einem Menüpunkt oder ist selbst ein Text-Symbol (vn-ic).
Syntax
<i class="bi bi-check2-circle"></i>Ergebnis (geprüft)
<i class="" data-vn-icon-id="icon0" data-vn-icon-extra-classes=""></i>Die Klassen bi und bi-NAME werden aus dem Template entfernt und bei jedem Rendern aus dem aktuellen Symbolwert wieder gesetzt. Alle anderen Klassen bleiben (data-vn-icon-extra-classes).
data-vn-icon#
Markiert ein Element ausdrücklich als Symbol, auch wenn es kein Bootstrap-Symbol ist (zum Beispiel ein leeres <span> oder <i> für ein eigenes SVG). Der Marker verschwindet nach dem Import und wird durch data-vn-icon-id="iconN" ersetzt.
Syntax
<a href="#" aria-label="Instagram"><i class="bi bi-instagram" data-vn-icon></i></a>
<i class="meinsymbol" data-vn-icon></i>| Attribut | Werte | Bedeutung |
|---|---|---|
data-vn-icon | Schalter (ohne Wert) | Im Template: macht das Element zum Symbol |
data-vn-icon-id | icon + Zahl | Vom Import gesetzt, verschwindet im Export |
data-vn-icon-extra-classes | Klassenliste | Eigene Klassen des Elements (ohne bi, bi-*) |
Werte eines Symbols#
Der Symbol-Dialog (Suche über alle Bootstrap-Symbole) ändert diese Werte (iconOverrides[iconN]):
| Wert | Typ | Wirkung |
|---|---|---|
icon | Name (star) | Setzt bi bi-star |
iconType | bootstrap oder custom | custom: eigene SVG (iconUrl) oder Flagge |
iconUrl | Projektpfad | Adresse der SVG |
size | Zahl (rem) | font-size: <n>rem am Element |
color | #rrggbb | color mit !important; bei eigener SVG als einfarbige Maske |
mono | Schalter | Eigene SVG folgt der Textfarbe (currentColor) |
href, newTab, rel, download | Link | Das Symbol wird in ein <a> gepackt (neuer Wrapper: color:inherit;text-decoration:none) |
Hat das Symbol schon einen Link-Wrapper aus der Vorlage (ein <a>, das nur das Symbol enthält), wird dieser benutzt. Ohne href im Override bleiben Links des Themes unberührt.
Eigene SVG-Symbole und Flaggen#
Eigene SVG-Dateien und die Flaggen (Paket im Symbol-Dialog, etwa 270 Länder, 4:3 oder quadratisch, in vendor/flags) werden ins Projekt kopiert. Ohne gewählte Farbe erscheinen sie als <img> mit eigenen Farben, mit Farbe oder „einfarbig“ als Maske:
<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>Der Export schreibt die Adressen relativ um und nimmt die Dateien mit.
Senkrechte Ausrichtung#
Eigene Symbole (Bild, Maske, eingebettetes SVG) neben Text sollen mit der Mitte der Großbuchstaben abschließen, egal wie groß sie sind. Das Programm setzt dafür vertical-align nach der Formel 0,36 − H/2 em (H = Höhe in em; 0,36 em liegt die Mitte der Großbuchstaben über der Grundlinie). In Flex-Behältern (Buttons mit align-items:center) wirkt vertical-align nicht; dort zentriert der Behälter.
<img src="assets/icons/x.svg" alt="" style="height:1.2em;width:auto;vertical-align:-0.24em;">Symbole verhindern oder ausschließen#
| Ziel | Wie |
|---|---|
| Symbol soll nicht änderbar sein | Kein <i class="bi …">/<span class="bi …"> verwenden: ein SVG inline (<svg>), ein <img> (dann freies Bild) oder eine CSS-Maske in style.less |
Symbol im Text soll nicht vn-ic werden | Nicht möglich im Textfeld; das Symbol als eigenes Element außerhalb des Textfelds setzen |
Buttons#
a.btn#
Jedes <a class="btn …"> ist ein Button. Der Import setzt data-vn-button-id="btnN" und liest die Vorgabewerte aus dem Element (Text, Link, Farbe, Form, Symbol). Ein Klick im Editor öffnet den Button-Dialog statt dem Link zu folgen.
Syntax
<a class="btn btn-primary" href="#kontakt">Kontakt</a>Ergebnis (geprüft)
<a class="btn btn-primary" href="#kontakt" data-vn-button-id="btn0" data-vn-btn-extra-classes="">Kontakt</a>| Attribut | Werte | Bedeutung |
|---|---|---|
data-vn-button-id | btn + Zahl ab 0 | Kennung (Schlüssel in buttonOverrides), im Export entfernt |
data-vn-btn-extra-classes | Klassenliste | Alle Klassen außer btn, Farb- und Formklasse; bleiben bei jeder Änderung erhalten, im Export entfernt |
Werte eines Buttons#
buttonOverrides[btnN], Vorgaben aus dem Template (buttonDefaults):
| Wert | Typ | Standard | Bedeutung |
|---|---|---|---|
text | Text | Text des Elements | Beschriftung (wird escaped geschrieben) |
href | Adresse | href des Elements; Cookie-Link als #cookie-settings | Ziel |
target | Schalter | target="_blank" | Im neuen Fenster |
rel, download | siehe Link-Optionen | aus Element | Link-Zusätze |
color | primary, secondary, success, danger, warning, info, light, dark, custom | erste Farbklasse, sonst primary | Farbe |
customColor | #rrggbb | — | Bei custom: Hintergrund, Rahmen; Textfarbe wird automatisch hell oder dunkel gewählt |
outline | Schalter | btn-outline-… | Nur Rahmen |
shape | default, rounded-pill, rounded-0, rounded-circle | aus Element | Form |
icon, iconType, iconUrl, iconPosition, iconSize, iconColor, iconMono | siehe unten | Symbol im Button |
Geschrieben wird class = "btn <farbe> <form> <extra>". Bei eigener Farbe setzt das Programm background-color, border-color und color direkt am Element (Inline-Stil ohne !important, die Farbklasse entfällt; siehe Eigene Farbe). Text und href übernimmt das Programm als roher Text aus dem Template: Platzhalter {{…}} werden dort nicht ausgewertet (Platzhalter in Buttons).
Symbol im Button#
Ein <i class="bi bi-…"> oder <img> innerhalb des Buttons gilt als Button-Symbol und wird aus dem Template gelesen (vorn oder hinten je nach Position im Text).
<a class="btn btn-outline-dark" href="#"><i class="bi bi-download"></i> Herunterladen</a>| Wert | Bedeutung |
|---|---|
icon | Name des Bootstrap-Symbols |
iconType | bootstrap oder custom |
iconUrl | Adresse der eigenen SVG/des Bilds |
iconPosition | before oder after |
iconSize | 0.3–6 (em; 1 = Standard) |
iconColor | #rrggbb; bei eigener SVG als Maske |
iconMono | eigene SVG in Textfarbe |
Behälter vn-buttons und vn-theme-style#
vn-buttons ist ein Marker am Behälter mehrerer Buttons. Er hat keine eigene Bearbeitungswirkung. Seine einzige Funktion: Trägt der Behälter vn-theme-style="display-7", wird die Klasse an jeden .btn im Behälter geschrieben (Theme-Schriftgröße/-art für alle Knöpfe einer Gruppe).
Syntax
<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 | Wert | Bedeutung |
|---|---|---|
vn-buttons | Schalter | Marker: Behälter einer Button-Gruppe |
vn-theme-style | Klassen (display-7) | Wird zu den Klassen der enthaltenen .btn (im Extra-Klassen-Wert gespeichert) |
Platzhalter in Buttons#
In <a class="btn"> bleibt ein Platzhalter {{…}} wörtlich stehen, im Text und im href, im Editor und im Export. Der Grund: tagButtons liest Text und Adresse als Vorgabewerte aus dem rohen Template, bevor die Platzhalter ersetzt werden, und baut den Button bei jedem Zeichnen aus diesen Werten und den Änderungen des Nutzers neu auf (applyButtonValue).
<a class="btn btn-primary" href="{{ziel}}">{{beschriftung}}</a> Schreiben Sie den Text und das Ziel fest ins Template; der Nutzer ändert sie im Button-Dialog. Wollen Sie beides aus dem Eigenschaften-Panel füttern, nehmen Sie einen gewöhnlichen Link ohne die Klasse btn (<a class="mein-knopf" href="{{ziel}}">{{text}}</a>) und stylen Sie ihn selbst. Siehe auch Platzhalter in Knöpfen.
Eigene Farbe#
Im Button-Dialog gibt es neben den acht Bootstrap-Farben eine eigene Farbe (color: 'custom', customColor: '#rrggbb'). Dann gilt:
- Die Farbklasse (
btn-primary,btn-outline-primary…) entfällt; Form- und Zusatzklassen bleiben. - Das Programm setzt
background-color,border-colorundcolorals Inline-Stil am Element, ohne!important. Bei „nur Rahmen“ (outline) sind Hintergrundtransparentsowie Rand und Text in der gewählten Farbe; sonst wählt das Programm die Textfarbe nach der Helligkeit (#212529oder#fff). - Wechselt der Nutzer zurück auf eine Bootstrap-Farbe, entfernt das Programm den Inline-Stil wieder.
Farben und Links im Block-CSS#
Für Buttons und Links gilt dieselbe Rangfolge wie für alles Block-CSS (Rangfolge):
- Eine Block-Regel ohne
!importantgewinnt gegen Bootstrap im Editor und im Export (im Editor liegt das Block-CSS in einem späteren Layer, im Export gewinnt die höhere Spezifität durch die Instanzklasse). - Eine Block-Regel mit
!importantgewinnt gegen Bootstrap-Regeln ohne!important. Gegen eine!important-Regel von Bootstrap oder des Theme-CSS gewinnt sie im Export, verliert aber im Editor (Layer-Umkehr bei!important). Das Ergebnis weicht dann zwischen Editor und fertiger Seite ab. !importanthilft gegen Theme-CSS mit höherer Spezifität und gegen die Schrift- und Typografieregeln der Site-Einstellungen (Site-Einstellungen); deshalb setzen die mitgelieferten Bausteine Farben, Rahmen und Schrift von Buttons und Links mit!important.
Menüs#
Ein Block ist ein Menü-Block, wenn sein Template navbar-nav oder nav-link enthält. Solche Blöcke bekommen im Panel zusätzliche Regler (Menü-Schrift, Dropdown-Farben, Hamburger-Farbe).
Menüpunkte und Marke#
a.nav-link, a.dropdown-item und a.navbar-brand sind Textfelder mit besonderer Behandlung: Klick wählt den ganzen Text (kurze Labels), Farbe, Schrift und Link über die Textleiste, Klick folgt nicht dem Link.
Syntax (Bootstrap-Konvention)
<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>(aus themes/vn-studio-src/components/menu1)
| Aktion im Editor | Wirkung am Template |
|---|---|
| Punkt hinzufügen | Der Menüpunkt-Container (li, sonst .dropdown) wird geklont, Text „Menüpunkt“ |
| Punkt verschieben | Vor/hinter das Geschwister-Element im selben Menü |
| Punkt löschen | Container samt Untermenü entfernen |
| ▾ Menü | Wandelt einen Punkt in ein Dropdown um oder hängt einen weiteren Eintrag an |
Dropdown#
Das Programm erzeugt ein Bootstrap-5-Dropdown. Ein Block kann dieselbe Struktur selbst mitbringen.
<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>Gibt es keinen li-Container (Menüs ohne Listenstruktur), umhüllt das Programm den Punkt mit einem <div class="dropdown">. Im Editor setzt es an jedem [data-bs-toggle="dropdown"] zusätzlich data-bs-auto-close="outside", damit ein Klick auf einen Eintrag das Menü nicht schließt, bevor er bearbeitet werden kann. Das Attribut kommt nie ins Template.
Untermenü: vn-submenu#
Steht der Cursor in einem Eintrag eines Dropdowns, erzeugt dieselbe Schaltfläche („▾ Eintrag“) ein Untermenü, das seitlich aufklappt.
Syntax
<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>| Teil | Bedeutung |
|---|---|
li.vn-submenu | Marker des Elements mit Untermenü (löst den Export von vendor/vn-submenu aus) |
a.vn-submenu-toggle | Aufklapp-Eintrag; ein Pfeil › wird per CSS davor gezeichnet |
ul.dropdown-menu.vn-submenu-list | Die Unterebene |
Verhalten (vendor/vn-submenu/vn-submenu.js): Am Rechner öffnet es beim Darüberfahren oder per Tastatur-Fokus rechts neben dem Eintrag, bei Platzmangel links; ist es höher als das Fenster, bekommt es eine Bildlaufleiste; am Handy und im eingeklappten Hamburger-Menü steht es eingerückt direkt unter dem Eintrag und öffnet per Tippen (Pfeil ▾). Das Skript braucht kein Bootstrap-JS und wirkt auch in der Arbeitsfläche.
Hamburger-Symbol#
Das Hamburger-Symbol ist .navbar-toggler-icon. Seine Farbe stellt der Nutzer im Panel ein (block.values._togglerColor). Das Programm erzeugt dazu ein neu gefärbtes SVG und neutralisiert beide gängigen Zeichenarten (eingebettetes SVG im background-image oder drei CSS-Balken mit ::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 steht hier für die Instanzklasse des Blocks.)
Ein eigenes Hamburger-Symbol eines Blocks soll deshalb das Element .navbar-toggler-icon verwenden, wenn die Farbwahl funktionieren soll.
Regler eines Menü-Blocks#
Alle Werte liegen in block.values, werden in renderer.js als CSS mit !important angehängt und gelten in Editor und Export gleich.
| Wert | Bereich | Selektoren |
|---|---|---|
_menuFontPx | 8–64 px (Regler 10–40) | .navbar-nav, .navbar-nav .nav-link, .navbar-nav .dropdown-item |
_brandFontPx | 8–96 px (Regler 10–60) | .navbar-brand, .navbar-caption-wrap, .navbar-caption |
_ddBg | #rrggbb | .dropdown-menu Hintergrund |
_ddText | #rrggbb | .dropdown-menu .dropdown-item Farbe |
_ddHoverBg, _ddHoverText | #rrggbb | :hover, :focus, :active der Einträge; schaltet die allgemeine Abdunklung ab (filter:none) |
_togglerColor | #rrggbb | siehe Hamburger-Symbol |
Symbol vor dem Menüpunkt#
Der Symbol-Knopf der Textleiste setzt ein Symbol vor oder hinter einen Menüpunkt (navIconOverrides[tN]: icon, iconType, iconUrl, size in rem, color, mono, pos = after oder vorn). Das Programm fügt ein <i data-vn-nav-icon> als erstes oder letztes Kind des a ein (Abstand 0.4em). Die Markierung data-vn-nav-icon gehört nicht zum Text und wird beim Bearbeiten und Speichern des Linktextes geschützt (siehe Bild und Menü-Symbol im Textelement).
Der Marker vn-menu#
vn-menu ist wie vn-buttons ein Marker am Behälter, hier der Menüpunkte (.nav-link, .dropdown-item). Er hat keine Bearbeitungswirkung; nur vn-theme-style an diesem Behälter wird an jeden Menüpunkt geschrieben.
<ul vn-menu vn-theme-style="display-4" class="navbar-nav">
<li class="nav-item"><a class="nav-link" href="#">Start</a></li>
</ul>Links#
Link-Dialog und Optionen#
Alle Link-Dialoge (Textleiste und Menü, Bild, Button, Symbol) teilen dieselben Zusatzwahlen aus src/link-options.js. Gespeichert wird immer als { href, newTab/target, rel, download }; das Programm schreibt daraus die Attribute am <a>.
| Wahl | Ergebnis am <a> |
|---|---|
| Adresse | href |
| Neues Fenster | target="_blank" und rel enthält noopener |
| Link-Art (Suchmaschinen) | rel="nofollow", rel="sponsored" oder rel="ugc" |
| Datei herunterladen statt öffnen | download (nicht bei tel:, mailto:, #… und Cookie-Link) |
| Cookie-Einstellungen öffnen | href="#" und data-vn-cookie-settings |
Das Programm verwaltet in rel nur seine Werte (nofollow, sponsored, ugc, noopener); fremde rel-Werte des Templates bleiben erhalten. Ein Link-Override ohne rel-Wert (ältere Projekte) lässt das Element unverändert.
Telefon, WhatsApp und E-Mail#
Tippt der Nutzer eine Telefonnummer oder E-Mail-Adresse ins Adressfeld, wird sie beim Verlassen des Felds automatisch zu tel: bzw. mailto: (normalizeLinkInput).
| Eingabe | Ergebnis |
|---|---|
info@example.com | mailto:info@example.com |
+49 30 123456 oder 030 123456 | tel:+4930123456; führende 00 wird +; (0) entfällt |
| „Anruf (tel:)“ / „WhatsApp-Nachricht“ | Umschalter bei Nummern; WhatsApp ergibt https://wa.me/<Ziffern> (+ ?text=… bei Vortext) und öffnet im neuen Fenster |
| Betreff / Nachrichtentext | mailto:…?subject=…&body=… (URL-kodiert) |
Eine nationale Nummer mit führender 0 wird für WhatsApp als deutsche (49) gewertet. Schon bestehende Schemata (https:, #, /) werden nicht verändert; Datumsangaben wie 12.10.2026 werden nicht als Telefonnummer erkannt.
Link auf eine Datei#
„Oder eine Datei wählen“ kopiert die Datei nach assets/dateien/ im Projekt und trägt den Pfad ein; der Export nimmt sie mit. Bei einer PDF wird „Neuer Tab“ gleich mit angehakt.
| Regel | Wert |
|---|---|
| Ziel | assets/dateien/<Name>; Umlaute werden umgeschrieben, nur [A-Za-z0-9._-], höchstens 80 Zeichen im Namen |
| Gleicher Name | Gleicher Inhalt (SHA-256) wird wiederverwendet, sonst Zähler -2, -3 … |
| Größe | höchstens 500 MB |
| Abgelehnt | .php, .php3–.php7, .phtml, .phar, .cgi, .pl, .py, .sh, .asp, .aspx, .jsp, .htaccess, .htpasswd, .ini |
Anker auf dieser Seite#
„Oder Anker auf dieser Seite wählen“ listet die Anker-IDs der Blöcke und trägt #<anker> ein (die Anker-ID eines Blocks wird im Panel gesetzt, sonst blk-<id>). Popup-Blöcke erscheinen als „Popup: …“.
Cookie-Einstellungen öffnen#
Ein Link mit data-vn-cookie-settings öffnet im Export das Fenster des VN Cookie-Consent. Im Link-Dialog ist es die Schaltfläche „Cookie-Einstellungen öffnen“; ein zweiter Klick nimmt die Wahl zurück.
Syntax
<a href="#" data-vn-cookie-settings>Cookie-Einstellungen</a>| Attribut | Bedeutung |
|---|---|
data-vn-cookie-settings | Marker am <a> (oder jedem anderen Element; vendor/vn-cookie-consent reagiert auf einen Klick auf jedes Element mit diesem Attribut, preventDefault) |
| Platzhalteradresse im Dialog | #cookie-settings (nur intern, im Link steht href="#") |
Das Attribut steht auf der Erlaubnisliste des Text-Sanitizers (nicht auf anderen Tags als a). Voraussetzung ist der eingeschaltete Cookie-Banner in den Projekt-Einstellungen; siehe Cookie-Consent.
CMS: Texte und Bilder auf der fertigen Seite#
Jeder Block kann so eingestellt werden, dass sein Betreiber Texte, Button-Beschriftungen, Links und Bilder später direkt auf der fertigen Seite ändert (Flat-File-CMS ohne Datenbank). Der Block-Autor schreibt nichts Besonderes: Alle Textfelder, Buttons und <img>-Bilder des Blocks werden erfasst.
Einschalten#
| Ort | Bedeutung |
|---|---|
| Panel, Abschnitt CMS, Schalter | block.cms = { enabled: true }; im Canvas trägt der Block die Marke „CMS“ |
| Passwort | Ein Passwort je Projekt; liegt im Programm-Profil, nicht im Projekt, und kommt als PBKDF2-SHA256-Hash (100 000 Runden, 16 Byte Salz) in vendor/vn-cms/config.php |
| Seitenname | Die Seite muss .php heißen (index.php), sonst fehlt der PHP-Auslesecode |
| Ohne Passwort | Es kann niemand bearbeiten (config.php ist leer); der Export weist darauf hin |
| Vorlage | Der Baustein „CMS-Block (Text + Bild)“ im Reiter „Eigener Code“ |
Markierungen im fertigen HTML#
Der Export setzt diese Attribute (vor dem Einbacken der Overrides, solange die Kennungen noch da sind). Von Hand sollen sie nicht geschrieben werden; sie sind hier aufgeführt, weil Erweiterungen und die Laufzeit sich darauf stützen.
| Attribut | Wert | Wirkung |
|---|---|---|
data-vn-cms-block | <Block> | Am Wurzelelement des Blocks: Bearbeitungsfläche |
data-vn-cms | <Block>:<Schlüssel> | Textfeld oder Button-Beschriftung ist änderbar |
data-vn-cms-img | <Block>:<Schlüssel> | <img>: Klick = Austauschen, Alt-Text, Link |
data-vn-cms-link | <Block>:<Schlüssel> | <a>: Adresse und „neues Fenster“ änderbar |
Verschachtelte Textfelder: nur das äußere wird erfasst. Buttons (a.btn) bekommen data-vn-cms und data-vn-cms-link; Textfelder, die selbst ein Link sind, ebenfalls data-vn-cms-link. Bilder entfernen srcset und sizes (das alte Bild würde sonst gegen das getauschte gewinnen).
Schlüsselformat#
Ein Schlüssel hat die Form <Block>:<Schlüssel> mit der Regel ^([A-Za-z0-9_-]+):([A-Za-z0-9_.:-]+)$.
| Teil | Beispiel | Herkunft |
|---|---|---|
| Block | m3k9x2 | Block-ID (nur [A-Za-z0-9_-]), zugleich Dateiname |
| Text | t0, t4 | data-vn-text-id |
| Button | btn0 | data-vn-button-id |
| Freies Bild | fi1 | data-vn-free-image-id |
| Feldbild | k:bild | data-vn-image-key mit Vorsatz k: |
Ein vollständiges Attribut: data-vn-cms="m3k9x2:t0", data-vn-cms-img="m3k9x2:k:bild". Schlüssel dürfen höchstens 60 Zeichen lang sein ([A-Za-z0-9_.:-]).
Was beim Export mit der Seite passiert#
markCmsEditablesvergibt die Attribute.- Nach dem Einbacken fasst
finalizeCmsMarkupden Textinhalt in Platzhalter-Kommentare (VNCMS-T). cmsToPhpmacht daraus PHP-Aufrufe ausvendor/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. Ganz oben in die Seite kommt<?php require_once __DIR__ . '/vendor/vn-cms/cms.php'; ?>.- Auf der Seite:
vendor/vn-cms/vn-cms.cssundvn-cms.js(nur wenn die Seite einen CMS-Block enthält).
Ergebnis (Auszug)
<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', ''); ?>">Die gespeicherten Inhalte liegen in vn-cms-data/<Block>.json (t Texte, i Bilder, a Alt-Texte, l Links), die letzte Fassung bleibt als .prev.json erhalten, hochgeladene Bilder gehen nach uploads/cms/. Beim Veröffentlichen werden diese Dateien nicht überschrieben.
Bedienung und Sicherheit auf der Seite#
| Thema | Verhalten |
|---|---|
| Anmelden | Doppelklick auf den Block oder Adresse mit #cms-login; Passwort; danach gestrichelte Umrandung aller Felder |
| Speichern | nur angemeldet, mit Anmelde-Token (CSRF) und gleicher Herkunft (Origin/Host) |
| Fehlversuche | nach 5 Fehlversuchen 10 Minuten Pause (je Besucheradresse) |
| Bilder | nur JPG, PNG, GIF, WebP, höchstens 10 MB, Typ per getimagesize geprüft, zufälliger Dateiname |
| Inhalt | höchstens 1,5 MB je Speichervorgang |
| Erlaubte Tags im Text | 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 |
| Entfernt | script style iframe object embed link meta form input button textarea select svg math noscript template base; Ereignis-Attribute |
| Attribute | a: href (kein javascript:, data:, vbscript:, file:), target (_blank/_self), rel, title; alle: class (einfache Namen), lang, translate (Sprachkürzel) |
| Links | nur relative Adressen, #anker, http(s), mailto, tel |
Popup#
Jeder Block kann im Panel (Abschnitt Popup, Schalter „Als Popup anzeigen“) zu einem Popup werden. Der Block-Autor muss nichts am Template ändern.
Wie das Popup entsteht#
Der Export packt den Block in einen Behälter (popupWrapperHtml), ausgeblendet bis zum Öffnen. Die Anker-ID des Blocks wandert vom Wurzelelement auf den Behälter.
Ergebnis (aus 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>Laufzeit: vendor/vn-popup/vn-popup.css und vn-popup.js (nur wenn die Seite ein Popup enthält).
Einstellungen#
block.popup (alle Werte werden beim Laden geprüft, Fehler fallen auf den Standard zurück):
| Schlüssel | Werte | Standard | Bedeutung |
|---|---|---|---|
enabled | Schalter | aus | Popup an |
auto | none, delay, scroll, exit | none | Automatisch öffnen (Link-Öffnen geht immer) |
delay | 0–600 | 5 | Sekunden (bei delay) |
scroll | 1–100 | 50 | Prozent der Seite (bei scroll) |
freq | always, session, day, week, once | session | Wie oft von selbst öffnen (gemerkt in sessionStorage/localStorage, Schlüssel vnpopup:<id>) |
size | sm, md, lg, full | md | Breite 420 px, 640 px, 960 px, 100 % |
pos | center, top, bottom | center | Lage |
anim | none, fade, zoom, slide, left, right, flip, bounce | fade | Einblendung |
overlayColor, overlayOpacity | #rrggbb, 0–100 | #000000, 60 | Abdunkelung |
backdropClose | Schalter | an | Klick daneben schließt |
escClose | Schalter | an | Escape schließt (aus: nur über eigene Knöpfe, zum Beispiel Alterscheck) |
showClose | Schalter | an | Schließen-Knopf oben rechts |
bg | #rrggbb | #ffffff | Fensterhintergrund |
radius | 0–60 | 12 | Eckenrundung in px |
Öffnen per Link: href="#anker"#
Jeder Link oder Button, dessen href auf die Anker-ID des Popup-Blocks zeigt (#blk-ab12 oder seite.php#blk-ab12), öffnet das Popup. Im Link-Dialog: „Anker auf dieser Seite“ → „Popup: …“. Auch die Adresse mit #blk-ab12 öffnet das Popup beim Laden.
<a class="btn btn-primary" href="#angebot">Angebot ansehen</a>Schließen aus dem Inhalt: data-vn-popup-close#
Jedes Element im Popup mit data-vn-popup-close schließt es per Klick (preventDefault), zum Beispiel ein „Nein danke“-Knopf.
<a class="btn btn-secondary" href="#" data-vn-popup-close>Nein danke</a>JavaScript-Schnittstelle: VNPopup#
| Aufruf | Rückgabe | Wirkung |
|---|---|---|
VNPopup.open(id) | true/false | Öffnet das Popup mit dieser Behälter-ID |
VNPopup.close(id) | — | Schließt |
VNPopup.isOpen() | ID des offenen Popups oder null | Zustand |
Weitere Verhaltensregeln der Laufzeit: Scroll wird gesperrt; Fokus bleibt im Fenster (Tab-Falle) und kehrt zum auslösenden Element zurück; Videos und Audio im Popup werden beim Schließen angehalten und YouTube-/Vimeo-Rahmen geleert (Adresse in data-vn-src), beim Öffnen wieder geladen. Bei „weniger Bewegung“ im System oder anim: none schließt es ohne Animation.
Vorlage „Popup“#
Der Reiter „Eigener Code“ bietet einen fertigen Popup-Block (createPopupBlockEntry), der bereits eingeschaltet ist.
<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>