Skip to content

SCSS: Z-index

La escala de z-index evita números mágicos en capascomúnes como headers, overlays, modales y toasts.

TokenValorUso esperado
$z-base0Capa normal
$z-raised1Elementos elevados locales
$z-sticky10Sticky dentro de layout
$z-header100Headers o navegación fija
$z-overlay1000Backdrops y overlays
$z-modal1100Modales y drawers
$z-toast1200Mensajes temporales

Resultado visual

$z-base · 0contenido base
$z-raised · 1contenido elevado
$z-header · 100header/sticky
$z-overlay · 1000overlay
$z-modal · 1100modal/drawer
$z-toast · 1200toast

Import

scss
@use '@micazoyolli/foundation/scss' as foundation;

Uso correcto

scss
.modal {
  z-index: foundation.$z-modal;
}

Cuándo usarlo

  • Cuando la capa escomún y semántica.
  • Cuando quieres evitar 999999.
  • Cuando el componente no vive dentro de un stacking context especial.

Cuándo no usarlo

  • Para tapar bugs sin revisar position, transform u overflow.
  • Para componentes con una escala local propia.

Archivo/export relacionado: src/scss/tokens/_z-index.scss