Desarrolladores

CSS personalizado

Use el contrato público de temas, mantenga la compatibilidad y recupere una interfaz dañada.

Abra Configuración → Desarrollador → CSS personalizado. Esta función es estrictamente de apariencia: no añade capacidades al servidor y no modifica los permisos.

Contrato recomendado

Utilice las variables públicas --nd-*. Las clases internas .nd-* pueden cambiar y no constituyen un contrato estable.

El diseño Calme predeterminado declara sus variables en body, también para temas y modo claro. Estos ejemplos apuntan a body[data-design="calme"] y usan !important para sustituir las declaraciones del tema y los valores de Apariencia guardados en línea. Quite la regla para devolver el control a Apariencia. Calme mantiene las tarjetas sin sombra aunque cambie su variable.

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

Colores y superficies

VariablesUso
--nd-bg, --nd-bg-surface, --nd-bg-gradientFondo global
--nd-card-bg-rgb, --nd-card-bg-opacity, --nd-card-bgSuperficies de tarjetas
--nd-subcard-bg, --nd-card-border, --nd-card-hover-border, --nd-card-shadowTarjetas anidadas, bordes y sombras
--nd-text, --nd-text-muted, --nd-text-dimmedJerarquía tipográfica
--nd-accent, --nd-accent-glow, --nd-accent-dimColor de acento
--nd-green, --nd-yellow, --nd-orange, --nd-redEstados
--nd-blue, --nd-purpleColores complementarios
--nd-progress-bg, --nd-progress-fillIndicadores de progreso
--nd-icon-bg, --nd-icon-borderContenedores de iconos

Formas y movimiento

--nd-card-radius controla las esquinas y --nd-transition la duración de las transiciones. Use Ajustes → Apariencia → Desenfoque de superficies para el desenfoque actual: define --nd-surface-blur y activa data-blur="on" en el cuerpo de la página. La variable antigua --nd-blur sigue teniendo usos heredados, pero no activa el desenfoque actual.

Móvil y accesibilidad

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

Mantenga un contraste suficiente, indicadores de foco visibles y tamaños de objetivos táctiles cómodos. Pruebe en modo claro, modo oscuro, móvil, tableta y escritorio.

Recuperación segura

Si el CSS oculta la navegación, abra:

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

El parámetro desactiva el CSS guardado para esta carga sin eliminarlo. Abra la configuración, corrija o restablezca el CSS y luego recargue la URL normal.

Limitaciones de seguridad

  • Tamaño máximo: 256 KiB;
  • Los scripts, protocolos peligrosos, escapes de HTML/estilo, expression(), comportamientos históricos y @import remotos se neutralizan;
  • Se eliminan los comentarios de CSS;
  • Un url(...) externo ordinario puede contactar un servidor de terceros y revelar la dirección IP del visitante.

La sanitización es una protección complementaria, no una razón para otorgar privilegios de administración a una persona no confiable.

El CSS guardado pertenece a config.json y forma parte de una copia completa. Guarde un estado funcional antes de cambios importantes.