Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

@import — cargar otra hoja de estilos

La regla @import carga una hoja CSS desde una URL y puede condicionarla con capa de cascada, consulta de soporte o consulta de medios.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

@import [ <string> | <url> ]
        [ layer | layer(<layer-name>) ]?
        [ supports( [ <supports-condition> | <declaration> ] ) ]?
        <media-query-list>? ;

@import <url-or-string> [layer | layer(<name>)]? [supports(<condition>)]? <media-query-list>?; es una regla de instrucción terminada en punto y coma. Las reglas importadas se comportan como si estuvieran en la posición del import. layer las coloca en una capa, supports() puede evitar la carga si la condición es falsa y una lista de medios limita la aplicación.

@import debe preceder a reglas de estilo ordinarias y a casi todas las demás; antes pueden aparecer la declaración de codificación y ciertas instrucciones de orden de capas. Un import dentro de un bloque o tras una regla no permitida se ignora. Una URL relativa se resuelve respecto a la hoja importadora, no al HTML.

Cada import puede alargar la cadena de descarga; <link> o bundling suelen ser preferibles. Un fallo no descarta el resto de la hoja. El ejemplo carga una hoja Blob que importa otra data: y, tras load, lee un valor importado y otro local.

Ejemplos

const css = '@import url("data:text/css,.probe%7B--from-import%3Aloaded%7D"); .probe { --local: ready; }';
const url = URL.createObjectURL(new Blob([css], {type: 'text/css'}));
const link = document.createElement('link');
link.rel = 'stylesheet';
link.href = url;
document.head.append(link);
await new Promise((resolve, reject) => { link.onload = resolve; link.onerror = reject; });
const probe = document.createElement('div');
probe.className = 'probe';
document.body.append(probe);
const computed = getComputedStyle(probe);
console.log('import=' + computed.getPropertyValue('--from-import').trim() + '; local=' + computed.getPropertyValue('--local').trim());
URL.revokeObjectURL(url);

Resultado

import=loaded; local=ready

La regla @import carga una hoja CSS desde una URL y puede condicionarla con capa de cascada, consulta de soporte o consulta de medios.

Fuentes