Entwicklung

Eigenes CSS

Verwenden Sie den öffentlichen Theme-Vertrag, stellen Sie die Kompatibilität sicher und beheben Sie eine fehlerhafte Benutzeroberfläche.

Öffnen Sie Einstellungen → Entwickler → Eigenes CSS. Diese Funktion dient ausschließlich der Darstellung: Sie fügt keine Serverfunktionen hinzu und ändert keine Berechtigungen.

Empfohlener Vertrag

Verwenden Sie die öffentlichen Variablen --nd-*. Interne Klassen .nd-* können sich ändern und stellen keinen stabilen Vertrag dar.

Das Standarddesign Calme definiert Variablen auf body, auch für Themen und hellen Modus. Diese Beispiele verwenden body[data-design="calme"] und !important, um Themendeklarationen und gespeicherte Inline-Werte aus Darstellung zu überschreiben. Entfernen Sie die Überschreibung, damit Darstellung den Wert wieder steuert. Calme behält flache Karten ohne Schatten bei, auch wenn die Schattenvariable geändert wird.

body[data-design="calme"] {
  --nd-accent: #7c3aed !important;
  --nd-accent-glow: rgba(124, 58, 237, 0.18) !important;
  --nd-card-radius: 16px !important;
  --nd-card-border: rgba(124, 58, 237, 0.24) !important;
}

Farben und Flächen

VariablenVerwendung
--nd-bg, --nd-bg-surface, --nd-bg-gradientGlobaler Hintergrund
--nd-card-bg-rgb, --nd-card-bg-opacity, --nd-card-bgKartenflächen
--nd-subcard-bg, --nd-card-border, --nd-card-hover-border, --nd-card-shadowVerschachtelte Karten, Ränder und Schatten
--nd-text, --nd-text-muted, --nd-text-dimmedTypografische Hierarchie
--nd-accent, --nd-accent-glow, --nd-accent-dimAkzentfarbe
--nd-green, --nd-yellow, --nd-orange, --nd-redZustände
--nd-blue, --nd-purpleErgänzende Farben
--nd-progress-bg, --nd-progress-fillFortschrittsanzeigen
--nd-icon-bg, --nd-icon-borderIcon-Container

Formen und Animationen

--nd-card-radius steuert Ecken und --nd-transition die Übergangsdauer. Nutzen Sie Einstellungen → Darstellung → Oberflächenunschärfe für die aktuelle Unschärfe: Sie setzt --nd-surface-blur und aktiviert data-blur="on" am Seitenkörper. Die ältere Variable --nd-blur wird noch von älteren Elementen genutzt, aktiviert aber nicht die aktuelle Oberflächenunschärfe.

Mobil und Barrierefreiheit

body[data-design="calme"] {
  --nd-card-radius: 18px !important;
}

@media (max-width: 700px) {
  body[data-design="calme"] {
    --nd-card-radius: 10px !important;
  }
}

@media (prefers-reduced-motion: reduce) {
  body[data-design="calme"] {
    --nd-transition: 0ms !important;
  }
}

Wahren Sie einen ausreichenden Kontrast, sichtbare Fokusanzeigen und komfortable Touch-Größen. Testen Sie im hellen Modus, im dunklen Modus, auf Mobilgeräten, Tablets und Desktops.

Sichere Wiederherstellung

Wenn das CSS die Navigation ausblendet, öffnen Sie:

https://your-nasdash.example/?safe-css=1

Der Parameter deaktiviert das gespeicherte CSS für diesen Ladevorgang, ohne es zu löschen. Öffnen Sie die Einstellungen, beheben oder setzen Sie das CSS zurück und laden Sie anschließend die normale URL neu.

Sicherheitsbeschränkungen

  • Maximale Größe: 256 KiB;
  • Skripte, gefährliche Protokolle, HTML/CSS-Ausbrüche, expression(), historische Verhaltensweisen und externe @import werden neutralisiert;
  • CSS-Kommentare werden entfernt;
  • Eine gewöhnliche externe url(...) kann einen Drittanbieter-Server kontaktieren und die IP-Adresse des Besuchers offenlegen.

Die Sanitisierung ist eine ergänzende Schutzmaßnahme und kein Grund, einer unzuverlässigen Person Administrationsrechte zu erteilen.

Gespeichertes CSS gehört zu config.json und zur vollständigen Sicherung. Sichern Sie einen funktionierenden Stand vor größeren Änderungen.