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
| Variables | Usage |
|---|---|
--nd-bg, --nd-bg-surface, --nd-bg-gradient | arrière-plan global |
--nd-card-bg-rgb, --nd-card-bg-opacity, --nd-card-bg | surface des cartes |
--nd-subcard-bg, --nd-card-border, --nd-card-hover-border, --nd-card-shadow | cartes imbriquées, bordures et ombre |
--nd-text, --nd-text-muted, --nd-text-dimmed | hiérarchie typographique |
--nd-accent, --nd-accent-glow, --nd-accent-dim | couleur d'accent |
--nd-green, --nd-yellow, --nd-orange, --nd-red | états |
--nd-blue, --nd-purple | couleurs complémentaires |
--nd-progress-bg, --nd-progress-fill | progressions |
--nd-icon-bg, --nd-icon-border | conteneurs 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=1Le 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@importdistants 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.