WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

@import — weiteres Stylesheet laden

Die Regel @import lädt ein CSS-Stylesheet von einer URL und kann es durch Kaskadenebene, Support- oder Medienabfrage bedingen.

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

Syntax

@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>?; ist eine mit Semikolon beendete Anweisungsregel. Importierte Regeln verhalten sich, als stünden sie an der Importposition. layer ordnet sie einer anonymen oder benannten Ebene zu, supports() kann das Laden bei falscher Bedingung vermeiden und eine Medienliste begrenzt die Anwendung.

@import muss vor normalen Stilregeln und den meisten anderen Regeln stehen; eine Kodierungsdeklaration und erlaubte Ebenenreihenfolgen dürfen vorangehen. Ein Import in einem Block oder nach einer unzulässigen Regel wird ignoriert. Relative URLs beziehen sich auf die URL des importierenden Stylesheets, nicht direkt auf das HTML-Dokument.

Jeder Import kann die Ladeabhängigkeiten verlängern; <link> oder Bundling sind oft schneller. Ein fehlgeschlagener Import verwirft den Rest des Stylesheets nicht. Das Beispiel lädt ein Blob-Stylesheet, das ein zweites data:-Sheet importiert, und liest nach load je einen Wert aus Import und lokaler Regel.

Beispiele

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

Ergebnis

import=loaded; local=ready

Die Regel @import lädt ein CSS-Stylesheet von einer URL und kann es durch Kaskadenebene, Support- oder Medienabfrage bedingen.

Quellen