Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

@import — carregar outra folha de estilos

A regra @import carrega uma folha CSS por URL e pode condicioná-la com camada de cascata, consulta de suporte ou consulta de media.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

@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>?; é uma instrução terminada por ponto e vírgula. As regras importadas comportam-se como se estivessem na posição do import. layer coloca-as numa camada, supports() pode evitar a descarga se a condição for falsa e uma lista de media limita a aplicação.

@import tem de preceder regras de estilo normais e quase todas as outras; uma declaração de codificação e certas ordens de camadas podem vir antes. Um import num bloco ou após regra não permitida é ignorado. Um URL relativo resolve-se relativamente à folha importadora, não diretamente ao HTML.

Cada import pode alongar a cadeia de carregamento; <link> ou bundling são muitas vezes preferíveis. Uma falha não elimina o resto da folha. O exemplo carrega uma folha Blob que importa uma folha data: e, após load, lê um valor importado e outro local.

Exemplos

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

A regra @import carrega uma folha CSS por URL e pode condicioná-la com camada de cascata, consulta de suporte ou consulta de media.

Fontes