# Hoja de estilos

## Qué es

Una hoja de estilos, denominada style sheet en las especificaciones y a menudo simplemente archivo CSS, es un conjunto de reglas CSS que un navegador obtiene, analiza y aplica a un documento como una sola unidad.

Una página puede recibir hojas de estilos de cuatro maneras. Un elemento `link` con `rel="stylesheet"` apunta a un archivo separado. Un elemento `style` incluye reglas en el propio HTML. Una regla `@import` al principio de una hoja incorpora otra. Y un script puede crear una con `new CSSStyleSheet()` y asociarla a un documento o a una raíz de un DOM de sombra mediante `adoptedStyleSheets`. Las dos primeras tienen este aspecto en la cabecera de una página:

```html
<link rel="stylesheet" href="/css/site.css" />
<link rel="stylesheet" href="/css/print.css" media="print" />
<style>
    .banner {
        border-block-end: 2px solid;
    }
</style>
```

Las hojas del autor no son las únicas que intervienen. Todos los navegadores incluyen una hoja de estilos predeterminada, por lo que un encabezado sin estilos propios sigue apareciendo grande y en negrita, y el lector puede añadir su propia hoja de usuario; la cascada sopesa los tres orígenes. El atributo `style` de un elemento es algo distinto: declaraciones sin selector, que pertenecen a ese elemento y a ninguna hoja.

Una vez cargada, la hoja se convierte en un objeto `CSSStyleSheet` del modelo de objetos de CSS, la especificación de la que procede la definición de este término. El objeto registra el elemento al que pertenece la hoja, los medios a los que se aplica, su título, si está desactivada y su lista de reglas; `document.styleSheets` enumera las hojas de una página en orden. Por motivos de privacidad existe un indicador: una hoja obtenida de otro origen sin CORS no es origin-clean, y un script que solicite sus reglas recibe un error de seguridad.

El atributo `media` limita una hoja a un entorno. Una hoja marcada con `media="print"` se descarga igualmente, pero el navegador solo espera a las hojas cuyo medio coincide, de modo que una hoja de impresión no retrasa la visualización en pantalla.

## Por qué importa

Una hoja de estilos determina qué tiene que obtener el navegador antes de mostrar algo. El estándar HTML considera que un enlace a una hoja habilitada, encontrado por el analizador antes de que exista el cuerpo, bloquea el renderizado cuando su medio coincide; por tanto, el primer dibujado suele esperar a que ese archivo llegue y se analice, en lugar de dibujar la página sin estilos y volver a dibujarla ante el lector. Su tamaño, el host que la sirve y los viajes de ida y vuelta necesarios para descubrirla se interponen entre un clic y lo primero que ve el lector.

El número de archivos es la primera decisión. Un archivo que agrupa los estilos de todas las páginas se obtiene una vez y después se sirve desde la caché; una hoja por página envía menos al principio y más a medida que el lector navega. Las reglas incluidas en un elemento `style` no requieren otra solicitud, pero vuelven a viajar con cada página porque no pueden almacenarse en caché por separado del documento que las contiene. Cada `@import` añade un paso de descubrimiento: el navegador conoce la dirección importada al leer la hoja que la importa, y obtener una importación que no esté en caché puede añadir otro viaje de red de ida y vuelta.

La caché es la segunda decisión. Una hoja almacenada durante un año acelera todas las páginas posteriores, pero los cambios tienen que llegar a lectores que conservan la copia antigua. La respuesta habitual es un nombre de archivo con huella digital, que contiene un hash del contenido: un archivo modificado tiene una dirección nueva y el anterior puede permanecer en caché todo el tiempo que se quiera, mientras que el HTML que apunta a él se conserva durante poco tiempo.

La confianza es la tercera. Una hoja decide qué se ve y dónde; puede ocultar un aviso, cambiar el aspecto de un botón o solicitar imágenes a cualquier dirección que indiquen sus reglas. Cargarla de un tercero le entrega ese poder, además de añadir un host sin el cual la página no puede renderizarse. Subresource Integrity permite declarar un hash criptográfico del archivo, y el navegador rechaza cualquier archivo cuyos bytes difieran.

## Cómo se aplica en la práctica

La revisión de las hojas de estilos del sitio en julio de 2026 muestra cuánto puede inclinar la balanza un solo recurso incrustado. Con 87 KB, el paquete suponía, para un sitio de documentos sin framework, la mayor parte del peso de una página antes de que llegara contenido alguno, y dos tercios de la hoja más grande resultaron ser una sola fuente codificada en base64: unos 56 KB de texto que codificaban unos 42 KB de fuente. Se había incrustado para mejorar el primer dibujado, algo que también consigue un archivo externo precargado, y todas las páginas pagaban ese coste, necesitaran o no ese grosor. Extraerla redujo aquel archivo de 84 KB a 28 y [el paquete completo de 87 KB a 31 KB](/es/portfolio/cut-the-stylesheet-bundle-from-87-kb-to-31-kb/), precargando en su lugar los archivos de los distintos grosores. Base64 escribe cada tres bytes como cuatro caracteres, de modo que un archivo binario incrustado en una hoja siempre pesa aproximadamente un tercio más que si se sirve por separado.

El papel también es un medio al que debe atender una hoja de estilos. Los casos prácticos del sitio son lo que alguien imprime y lleva a una reunión. En la implementación de agosto de 2026, [una hoja de 637 líneas](/es/portfolio/built-a-637-line-print-stylesheet/), con una sola regla de página y un bloque de impresión, permitió imprimirlos en papel de tamaño desconocido y con ambos temas de color. La regla de página fija un margen y deliberadamente ningún tamaño de papel, y una longitud de línea de unos setenta y dos caracteres evita que una hoja apaisada lleve la línea hasta unos ciento diez. Se documentaron como trampas cuatro comportamientos de los motores, cada uno responsable de un defecto real: unidades de ventana gráfica medidas respecto a la caja de página por un motor y respecto a la ventana por otro, lo que recortaba un tercio de cada línea; elementos de posición fija que aparecen en todas las hojas; una paleta que utiliza por defecto texto blanco para el tema oscuro y dejó cuatro etiquetas de sección en blanco sobre blanco; y una caja flex o grid que los medios paginados no pueden dividir, lo que produjo una primera hoja en blanco. La comprobación asociada, dividida en seis partes, cubrió seis combinaciones de papel y orientación, ambas preferencias de esquema de color y el número real de páginas; fue esa comprobación la que detectó que un cierre de comentario suelto hacía que el linter de CSS se saltara una regla entera y diera el visto bueno dos veces.

La [página de seguridad](/es/security/) del sitio enumera Subresource Integrity en la hoja de estilos: se calcula la huella digital y el hash del paquete durante la construcción, para que el navegador del lector pueda verificar que llegó sin modificaciones. La misma página pide contar los hosts en el panel de red del navegador y da la respuesta: uno, el del propio sitio.

## Dónde surgen los problemas

Una hoja que el navegador descubre tarde retrasa su aplicación. Un enlace al final del cuerpo o una hoja inyectada por un script pueden llegar después del primer dibujado; el texto sin formato adopta de golpe su diseño o un diseño ya terminado cambia de posición. En cambio, una cadena de reglas `@import` en una hoja que bloquea el renderizado puede prolongar la espera del primer dibujado. Una cadena de importaciones parece inofensiva en el código fuente:

```css
/* site.css: the browser finds base.css only after this file arrives */
@import url("base.css");
@import url("theme.css");
```

Coloque los enlaces a las hojas en la cabecera e integre las importaciones en el paquete durante la construcción.

Un despliegue puede combinar marcado nuevo con reglas antiguas. Los lectores cuya caché contiene la hoja anterior reciben HTML que espera clases que el archivo antiguo nunca conoció, y su diseño se rompe hasta que caduque la caché, mientras que quienes prueban con una caché vacía ven un sitio funcional. La causa es un nombre de hoja que nunca cambia combinado con un periodo largo de validez en caché; un nombre con huella digital la elimina.

Una hoja servida con un tipo de contenido incorrecto se ignora. El estándar HTML solo aplica una hoja enlazada cuando llega como `text/css`, con una excepción para archivos del mismo origen en páginas en modo de compatibilidad quirks. Un servidor que etiqueta archivos `.css` como `text/plain`, o responde a un archivo inexistente con una página HTML y un estado de éxito, deja la página sin estilos mientras el panel de red muestra una solicitud que aparentemente funcionó. Compruebe la cabecera del archivo desplegado.

Un hash de integridad queda obsoleto cuando el archivo cambia después de calcularlo: una edición manual en el servidor, una CDN que minifica el contenido al pasarlo o una construcción que calcula el hash antes de su última reescritura. El navegador trata la discrepancia como un error de red y renderiza sin la hoja. En otro origen, la integridad también necesita CORS: un atributo `crossorigin` en el enlace y una cabecera correspondiente del servidor. Calcule el hash en el paso que escribe el archivo definitivo.

Antes se justificaba una hoja de un framework en una CDN pública porque los lectores ya podían tenerla en caché desde otros sitios. El estándar Fetch divide la caché HTTP por sitio de nivel superior, así que la copia de cada sitio se obtiene y guarda por separado; lo que queda es un segundo host en la ruta crítica y bajo control ajeno. Servir el archivo desde el propio host del sitio cuesta los mismos bytes sin la conexión adicional.

## Lecturas adicionales

- [Modelo de objetos de CSS (CSSOM)](https://www.w3.org/TR/cssom-1/#css-style-sheet) — qué es una hoja de estilos dentro del navegador y la interfaz con la que los scripts la leen y modifican.
- [Estándar HTML: enlaces](https://html.spec.whatwg.org/multipage/links.html) — el tipo de enlace `stylesheet`, la regla del tipo de contenido y cuándo una hoja bloquea el renderizado.
- [Subresource Integrity](https://www.w3.org/TR/SRI/) — el atributo `integrity` y lo que hace el navegador con un archivo que no supera la comprobación.
- [Estándar Fetch: particiones de la caché HTTP](https://fetch.spec.whatwg.org/#http-cache-partitions) — cómo se organiza la clave de caché por sitio de nivel superior.
- [Módulo de medios paginados de CSS, nivel 3](https://www.w3.org/TR/css-page-3/) — la regla `@page` y los márgenes con los que trabaja una hoja de impresión.
- [Media Queries, nivel 5](https://www.w3.org/TR/mediaqueries-5/) — impresión, pantalla, preferencias de esquema de color y las demás condiciones que puede comprobar un atributo `media`.

<https://engineer.company/es/glossary/stylesheet/>
