VN-Designer Entwickler-Dokumentation
06

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:

  1. 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).
  2. Bearbeiten: Änderungen des Nutzers landen nicht im Template, sondern in Overrides am Block. Das Template bleibt unverändert.
  3. Rendern (Editor): Nach jedem Render legt das Programm die Overrides wieder über das frisch gerenderte HTML und macht die Elemente klickbar.
  4. Export: Dieselben Overrides werden fest eingebacken; alle Editor-Spuren (Kennungen, contenteditable, Hilfsklassen) werden entfernt.
Override am BlockSchlüsselInhalt
textOverridest0, t1 …geänderter Inhalt (innerHTML) eines Textfelds
textTagOverridest0 …gewählter Tag (H1, H2, H3, P …)
textLinkOverridest0 …{ href, newTab, colorClass, rel, download } für Textfelder, die selbst ein <a> sind
textAlignOverridest0 …left, center, right, justify
buttonOverridesbtn0 …Text, Link, Farbe, Form, Symbol eines Buttons
iconOverridesicon0 …Symbol, Größe, Farbe, Link
navIconOverridest0 … (Menüpunkt)Symbol vor/hinter einem Menüpunkt
imageOverridesfi1 …Adresse eines freien Bilds
imageLinkOverridesfi1 oder k:<feld>{ href, target, rel, download } um ein Bild
imageAltOverridesfi1, k:<feld>; t:<id>; s:<id>Alt-Text; Titel (t:); Größe (s:)
animOverridest0, 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:

  1. Standard-Texttags: h1–h6, p, li, blockquote, figcaption (nur die jeweils äußersten, kein Doppelt-Markieren), dazu Menü-Links und lose Links (siehe unten).
  2. Listenfelder ul/ol mit data-multiline oder vn-article (siehe Listenfelder).
  3. 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

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

Ergebnis nach dem Import (geprüft)

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

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.

ElementTextfeld?Bemerkung
h1–h6, p, li, blockquote, figcaptionjaAußerhalb von Navigation, Formular, Button, Link
div, span, td, th, label, small, em, dt …ja, wenn BlattNur Text und Inline-Tags darin
Container mit Absatz-/Überschriftkindern (div.wrap > p)neinNur die Kinder werden Felder
a.nav-link, a.navbar-brand, a.dropdown-itemjaEigener Zweig, auch innerhalb von nav
a (lose Links, nicht .btn) mit TextjaDas <a> selbst ist das Feld, Link über die Textleiste
Text, der nur aus {{platzhalter}} bestehtneinGehört dem Eigenschaften-Panel
script, style, textarea, option, select, button, iframe, svg, noscript, template, pre, code, input, header (Panel-Kopf), fieldsetnieNEVER_TEXT_TAGS
Alles innerhalb von nav, button, select, form, a, vn-parametersneinSKIP_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

html
<h2 data-vn-text-id="t0">Titel</h2>
EigenschaftWertBedeutung
Formatt + Zahl (t0, t1 …)Fortlaufend ab dem höchsten vorhandenen Index
LebensdauerEditor und TemplateIm 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

html
<ul data-multiline>
  <li>Erster Punkt</li>
  <li>Zweiter Punkt</li>
</ul>
<ol vn-article>
  <li>Schritt eins</li>
</ol>
AttributWertStandardBedeutung
data-multilineSchalter (ohne Wert)ausAm ul, ol (erweiterbare Liste) oder am div: das Feld darf Listen, Absätze, Zitate und Überschriften enthalten
vn-articleSchalterausWie 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.

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

GruppeTags
Inline erlaubtstrong, 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
EntferntKommentare
Unverändert<script type="text/x-vn-php"> (geschützter PHP-Code)

Geprüftes Beispiel (Eingabe als gespeicherter Override, Ergebnis nach dem Einbacken):

html

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


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

Erlaubte Attribute und Klassen#

An erlaubten Inline-Tags bleiben nur diese Attribute:

TagErlaubte Attribute
ahref, target, rel, download, title, aria-label, data-vn-cookie-settings
qcite
timedatetime
datavalue
abbr, dfntitle
del, insdatetime, cite
bdodir
spanstyle (gefiltert, siehe unten), data-vn-text-color, data-vn-anim, data-vn-anim-t, data-vn-svg, data-vn-svg-mode, Tooltip-Attribute
alleclass (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:

QuelleEigenschaften
Textleistecolor, font-family, font-size, font-weight, font-style
VN Text-Effektetext-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 Animationdie Variablen --vn-a, --vn-d, --vn-dl, --vn-e, --vn-n und display:inline-block
Eigenes SVG-SymbolStil 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>.
  • stripForeignFrameworkMarkup bereinigt 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.

OverrideWirkung 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ächeErgebnis
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)
html
<p>Wir nutzen <span class="notranslate">VN-Designer</span> seit 2024.</p>

Ein Link im Text bekommt über die Textleiste eine Farbklasse direkt am <a>. Die Liste ist zugleich die Erlaubnisliste.

EintragKlasse
Linkfarbe: Standard(keine)
Primary, Secondary, Success, Info, Warning, Danger, Light, Darktext-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

html
<span class="bi bi-star vn-ic" style="font-size:1.5em;color:#c00" aria-hidden="true"></span>
<span class="vn-ic vn-ic-svg" data-vn-svg="assets/icons/herz.svg" data-vn-svg-mode="mask" aria-hidden="true"></span>
TeilWerteBedeutung
bi bi-NAMEName aus Bootstrap Icons ([a-z0-9-]{1,60})Symbolschrift, gezeichnet über ::before
vn-icKlasseMarker: im Editor klick- und änderbar
style="font-size:…em"^\d+(\.\d+)?em$Größe relativ zum Text
style="color:#rrggbb"HexFarbe (leer = Textfarbe)
vn-ic-svg + data-vn-svgassets/icons/….svg oder file:///….svgEigenes SVG aus dem Projekt; andere Adressen werden verworfen (SVG_ICON_SRC_RE)
data-vn-svg-modemask oder imagemask: 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

html
<span class="vn-tip" data-bs-toggle="tooltip" data-bs-placement="top" title="Erklärung"
      data-vn-tip-bg="#000000" data-vn-tip-fg="#ffffff" data-vn-tip-trigger="hover focus">Wort</span>
AttributWerteStandardBedeutung
classvn-tip (+ vn-tip-plain)—Marker; vn-tip-plain: ohne Unterstreichung
titleText—Tooltip-Text (Nur-Text-Fassung)
data-vn-tip-htmlbereinigtes HTML—Tooltip mit Umbruch/Formatierung; title trägt dann die Nur-Text-Fassung
data-bs-placementtop, bottom, left, righttopLage
data-vn-tip-bg, data-vn-tip-fg#rrggbbThemeFarben von Fläche und Schrift
data-vn-tip-triggerhover focus oder clickhover focusAuslö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.valuesBereichWirkung (Editor und Export gleich)
_textScalePct50–200 %zoom am Element: proportional zur eigenen Theme-Größe, Hierarchie bleibt
_textWidthPct20–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.

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

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

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

html
<img src="{{bild}}" alt="Landschaft" data-vn-image-key="bild">
RegelBeschreibung
Erkennungimg[src] mit src="{{feld}}" (Leerzeichen erlaubt), wobei feld ein image-Feld ist
Hintergrund im Stylestyle="background-image:url({{feld}})" (auch in vn-style) bekommt dieselbe Markierung am Element
Hintergrund-WidgetGibt 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)
WirkungKlick ö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

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

Ergebnis (geprüft)

html
<img src="assets/images/team.jpg" alt="Team" data-vn-free-image-id="fi1">
RegelBeschreibung
Nicht markiertimg mit {{platzhalter}} ohne passendes Bildfeld, img ohne src
Formatfi + fortlaufende Nummer ab 1
Im EditorKlasse 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.

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

GrenzeWert
Erlaubte Bildformatejpg, jpeg, png, gif, webp, svg (dazu ico)
Größe je Dateihö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 imageAltOverridesWertWirkung
<id>Textalt; leerer Text = bewusst leer (Deko-Bild)
t:<id>Texttitle (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.

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.

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

TeilBereichWirkung
Breite5–100 %width in % der umgebenden Breite plus max-width:100%, beides !important; bleibt am Handy mitskalierend
Höhe24–4000 pxheight und object-fit: cover (!important)
nur Breiteheight: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

html
<img class="haus" src="{{haus}}" alt=""
     data-vn-drag="Haus" data-vn-drag-x="l2x" data-vn-drag-y="l2y" data-vn-drag-size="l2size">
AttributWertBedeutung
data-vn-dragAnzeigenameMarkiert das Element als ziehbar (Name erscheint als Chip)
data-vn-drag-xFeldname (Bereichsregler, %)Seitliche Mitte in % der Bühnenbreite
data-vn-drag-yFeldname (%)Abstand vom Boden in % der Bühnenhöhe
data-vn-drag-sizeFeldname (%)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

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

Ergebnis (geprüft)

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

html
<a href="#" aria-label="Instagram"><i class="bi bi-instagram" data-vn-icon></i></a>
<i class="meinsymbol" data-vn-icon></i>
AttributWerteBedeutung
data-vn-iconSchalter (ohne Wert)Im Template: macht das Element zum Symbol
data-vn-icon-idicon + ZahlVom Import gesetzt, verschwindet im Export
data-vn-icon-extra-classesKlassenlisteEigene Klassen des Elements (ohne bi, bi-*)

Werte eines Symbols#

Der Symbol-Dialog (Suche über alle Bootstrap-Symbole) ändert diese Werte (iconOverrides[iconN]):

WertTypWirkung
iconName (star)Setzt bi bi-star
iconTypebootstrap oder customcustom: eigene SVG (iconUrl) oder Flagge
iconUrlProjektpfadAdresse der SVG
sizeZahl (rem)font-size: <n>rem am Element
color#rrggbbcolor mit !important; bei eigener SVG als einfarbige Maske
monoSchalterEigene SVG folgt der Textfarbe (currentColor)
href, newTab, rel, downloadLinkDas 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:

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

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.

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

Symbole verhindern oder ausschließen#

ZielWie
Symbol soll nicht änderbar seinKein <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 werdenNicht 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

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

Ergebnis (geprüft)

html
<a class="btn btn-primary" href="#kontakt" data-vn-button-id="btn0" data-vn-btn-extra-classes="">Kontakt</a>
AttributWerteBedeutung
data-vn-button-idbtn + Zahl ab 0Kennung (Schlüssel in buttonOverrides), im Export entfernt
data-vn-btn-extra-classesKlassenlisteAlle 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):

WertTypStandardBedeutung
textTextText des ElementsBeschriftung (wird escaped geschrieben)
hrefAdressehref des Elements; Cookie-Link als #cookie-settingsZiel
targetSchaltertarget="_blank"Im neuen Fenster
rel, downloadsiehe Link-Optionenaus ElementLink-Zusätze
colorprimary, secondary, success, danger, warning, info, light, dark, customerste Farbklasse, sonst primaryFarbe
customColor#rrggbb—Bei custom: Hintergrund, Rahmen; Textfarbe wird automatisch hell oder dunkel gewählt
outlineSchalterbtn-outline-…Nur Rahmen
shapedefault, rounded-pill, rounded-0, rounded-circleaus ElementForm
icon, iconType, iconUrl, iconPosition, iconSize, iconColor, iconMonosiehe untenSymbol 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).

html
<a class="btn btn-outline-dark" href="#"><i class="bi bi-download"></i> Herunterladen</a>
WertBedeutung
iconName des Bootstrap-Symbols
iconTypebootstrap oder custom
iconUrlAdresse der eigenen SVG/des Bilds
iconPositionbefore oder after
iconSize0.3–6 (em; 1 = Standard)
iconColor#rrggbb; bei eigener SVG als Maske
iconMonoeigene 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

html
<div vn-buttons vn-theme-style="display-7">
  <a class="btn btn-primary" href="#">Eins</a>
  <a class="btn btn-secondary" href="#">Zwei</a>
</div>
AttributWertBedeutung
vn-buttonsSchalterMarker: Behälter einer Button-Gruppe
vn-theme-styleKlassen (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).

html
<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-color und color als Inline-Stil am Element, ohne !important. Bei „nur Rahmen“ (outline) sind Hintergrund transparent sowie Rand und Text in der gewählten Farbe; sonst wählt das Programm die Textfarbe nach der Helligkeit (#212529 oder #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 !important gewinnt 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 !important gewinnt 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.
  • !important hilft 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.

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

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)

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

(aus themes/vn-studio-src/components/menu1)

Aktion im EditorWirkung am Template
Punkt hinzufügenDer Menüpunkt-Container (li, sonst .dropdown) wird geklont, Text „Menüpunkt“
Punkt verschiebenVor/hinter das Geschwister-Element im selben Menü
Punkt löschenContainer samt Untermenü entfernen
▾ MenüWandelt einen Punkt in ein Dropdown um oder hängt einen weiteren Eintrag an

Das Programm erzeugt ein Bootstrap-5-Dropdown. Ein Block kann dieselbe Struktur selbst mitbringen.

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

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.

Steht der Cursor in einem Eintrag eines Dropdowns, erzeugt dieselbe Schaltfläche („▾ Eintrag“) ein Untermenü, das seitlich aufklappt.

Syntax

html
<li class="vn-submenu">
  <a class="dropdown-item vn-submenu-toggle" href="#" aria-expanded="false">Eintrag</a>
  <ul class="dropdown-menu vn-submenu-list">
    <li><a class="dropdown-item" href="#">Unterpunkt</a></li>
  </ul>
</li>
TeilBedeutung
li.vn-submenuMarker des Elements mit Untermenü (löst den Export von vendor/vn-submenu aus)
a.vn-submenu-toggleAufklapp-Eintrag; ein Pfeil › wird per CSS davor gezeichnet
ul.dropdown-menu.vn-submenu-listDie 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.

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

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

(.vn-imp-menu-b1 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.

Alle Werte liegen in block.values, werden in renderer.js als CSS mit !important angehängt und gelten in Editor und Export gleich.

WertBereichSelektoren
_menuFontPx8–64 px (Regler 10–40).navbar-nav, .navbar-nav .nav-link, .navbar-nav .dropdown-item
_brandFontPx8–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#rrggbbsiehe Hamburger-Symbol

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

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.

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

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

WahlErgebnis am <a>
Adressehref
Neues Fenstertarget="_blank" und rel enthält noopener
Link-Art (Suchmaschinen)rel="nofollow", rel="sponsored" oder rel="ugc"
Datei herunterladen statt öffnendownload (nicht bei tel:, mailto:, #… und Cookie-Link)
Cookie-Einstellungen öffnenhref="#" 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.

Tippt der Nutzer eine Telefonnummer oder E-Mail-Adresse ins Adressfeld, wird sie beim Verlassen des Felds automatisch zu tel: bzw. mailto: (normalizeLinkInput).

EingabeErgebnis
info@example.commailto:info@example.com
+49 30 123456 oder 030 123456tel:+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 / Nachrichtentextmailto:…?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.

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

RegelWert
Zielassets/dateien/<Name>; Umlaute werden umgeschrieben, nur [A-Za-z0-9._-], höchstens 80 Zeichen im Namen
Gleicher NameGleicher Inhalt (SHA-256) wird wiederverwendet, sonst Zähler -2, -3 …
Größehöchstens 500 MB
Abgelehnt.php, .php3–.php7, .phtml, .phar, .cgi, .pl, .py, .sh, .asp, .aspx, .jsp, .htaccess, .htpasswd, .ini

„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: …“.

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

html
<a href="#" data-vn-cookie-settings>Cookie-Einstellungen</a>
AttributBedeutung
data-vn-cookie-settingsMarker 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#

OrtBedeutung
Panel, Abschnitt CMS, Schalterblock.cms = { enabled: true }; im Canvas trägt der Block die Marke „CMS“
PasswortEin 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
SeitennameDie Seite muss .php heißen (index.php), sonst fehlt der PHP-Auslesecode
Ohne PasswortEs kann niemand bearbeiten (config.php ist leer); der Export weist darauf hin
VorlageDer 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.

AttributWertWirkung
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_.:-]+)$.

TeilBeispielHerkunft
Blockm3k9x2Block-ID (nur [A-Za-z0-9_-]), zugleich Dateiname
Textt0, t4data-vn-text-id
Buttonbtn0data-vn-button-id
Freies Bildfi1data-vn-free-image-id
Feldbildk:bilddata-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#

  1. markCmsEditables vergibt die Attribute.
  2. Nach dem Einbacken fasst finalizeCmsMarkup den Textinhalt in Platzhalter-Kommentare (VNCMS-T).
  3. cmsToPhp macht daraus PHP-Aufrufe aus vendor/vn-cms/cms.php: vn_cms_t, vn_cms_img, vn_cms_alt, vn_cms_href, vn_cms_target, vn_cms_wrap_open, vn_cms_wrap_close. Ganz oben in die Seite kommt <?php require_once __DIR__ . '/vendor/vn-cms/cms.php'; ?>.
  4. Auf der Seite: vendor/vn-cms/vn-cms.css und vn-cms.js (nur wenn die Seite einen CMS-Block enthält).

Ergebnis (Auszug)

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

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#

ThemaVerhalten
AnmeldenDoppelklick auf den Block oder Adresse mit #cms-login; Passwort; danach gestrichelte Umrandung aller Felder
Speichernnur angemeldet, mit Anmelde-Token (CSRF) und gleicher Herkunft (Origin/Host)
Fehlversuchenach 5 Fehlversuchen 10 Minuten Pause (je Besucheradresse)
Bildernur JPG, PNG, GIF, WebP, höchstens 10 MB, Typ per getimagesize geprüft, zufälliger Dateiname
Inhalthöchstens 1,5 MB je Speichervorgang
Erlaubte Tags im Textb strong i em u s br span a p small mark sub sup h1–h6 ul ol li div blockquote code kbd abbr q
Entferntscript style iframe object embed link meta form input button textarea select svg math noscript template base; Ereignis-Attribute
Attributea: href (kein javascript:, data:, vbscript:, file:), target (_blank/_self), rel, title; alle: class (einfache Namen), lang, translate (Sprachkürzel)
Linksnur relative Adressen, #anker, http(s), mailto, tel

Jeder Block kann im Panel (Abschnitt Popup, Schalter „Als Popup anzeigen“) zu einem Popup werden. Der Block-Autor muss nichts am Template ändern.

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)

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

Laufzeit: vendor/vn-popup/vn-popup.css und vn-popup.js (nur wenn die Seite ein Popup enthält).

block.popup (alle Werte werden beim Laden geprüft, Fehler fallen auf den Standard zurück):

SchlüsselWerteStandardBedeutung
enabledSchalterausPopup an
autonone, delay, scroll, exitnoneAutomatisch öffnen (Link-Öffnen geht immer)
delay0–6005Sekunden (bei delay)
scroll1–10050Prozent der Seite (bei scroll)
freqalways, session, day, week, oncesessionWie oft von selbst öffnen (gemerkt in sessionStorage/localStorage, Schlüssel vnpopup:<id>)
sizesm, md, lg, fullmdBreite 420 px, 640 px, 960 px, 100 %
poscenter, top, bottomcenterLage
animnone, fade, zoom, slide, left, right, flip, bouncefadeEinblendung
overlayColor, overlayOpacity#rrggbb, 0–100#000000, 60Abdunkelung
backdropCloseSchalteranKlick daneben schließt
escCloseSchalteranEscape schließt (aus: nur über eigene Knöpfe, zum Beispiel Alterscheck)
showCloseSchalteranSchließen-Knopf oben rechts
bg#rrggbb#ffffffFensterhintergrund
radius0–6012Eckenrundung in px

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.

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

html
<a class="btn btn-secondary" href="#" data-vn-popup-close>Nein danke</a>
AufrufRückgabeWirkung
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 nullZustand

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.

Der Reiter „Eigener Code“ bietet einen fertigen Popup-Block (createPopupBlockEntry), der bereits eingeschaltet ist.

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