Développeurs

CSS personnalisé

Utiliser le contrat public de thème, rester compatible et récupérer une interface cassée.

Ouvrez Réglages → Développeur → CSS personnalisé. Cette fonction sert uniquement à l'apparence : elle n'ajoute pas de capacité serveur et ne change pas les permissions.

Contrat recommandé

Utilisez les variables publiques --nd-*. Les classes internes .nd-* peuvent évoluer et ne constituent pas un contrat stable.

Le style Calme par défaut déclare ses variables sur body, y compris dans les thèmes et le mode clair. Ces exemples ciblent body[data-design="calme"] et utilisent !important pour remplacer les déclarations du thème et les valeurs d’Apparence enregistrées en ligne. Retirez la surcharge pour redonner le contrôle à Apparence. Calme conserve les cartes sans ombre même si la variable d’ombre change.

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;
}

Couleurs et surfaces

VariablesUsage
--nd-bg, --nd-bg-surface, --nd-bg-gradientarrière-plan global
--nd-card-bg-rgb, --nd-card-bg-opacity, --nd-card-bgsurface des cartes
--nd-subcard-bg, --nd-card-border, --nd-card-hover-border, --nd-card-shadowcartes imbriquées, bordures et ombre
--nd-text, --nd-text-muted, --nd-text-dimmedhiérarchie typographique
--nd-accent, --nd-accent-glow, --nd-accent-dimcouleur d'accent
--nd-green, --nd-yellow, --nd-orange, --nd-redétats
--nd-blue, --nd-purplecouleurs complémentaires
--nd-progress-bg, --nd-progress-fillprogressions
--nd-icon-bg, --nd-icon-borderconteneurs d'icônes

Formes et mouvement

--nd-card-radius contrôle les angles et --nd-transition la durée des transitions. Utilisez Paramètres → Apparence → Flou des surfaces pour le flou actuel : ce réglage définit --nd-surface-blur et active data-blur="on" sur le corps de la page. L’ancienne variable --nd-blur reste utilisée par certains éléments historiques, mais n’active pas le flou actuel.

Mobile et accessibilité

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;
  }
}

Conservez un contraste suffisant, un focus visible et des tailles tactiles confortables. Testez en clair, sombre, mobile, tablette et desktop.

Récupération sûre

Si le CSS masque la navigation, ouvrez :

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

Le paramètre désactive le CSS sauvegardé pour ce chargement sans le supprimer. Ouvrez les réglages, corrigez ou réinitialisez, puis rechargez l'URL normale.

Limites de sécurité

  • taille maximale : 256 Kio ;
  • scripts, protocoles dangereux, breakouts HTML/style, expression(), comportements historiques et @import distants sont neutralisés ;
  • les commentaires CSS sont retirés ;
  • un url(...) externe ordinaire peut contacter un serveur tiers et révéler l'IP du visiteur.

La sanitisation est une protection complémentaire, pas une permission à donner l'administration à une personne non fiable.

Le CSS enregistré appartient à config.json et est inclus dans une sauvegarde complète. Gardez une copie fonctionnelle avant les grandes modifications.