Styling & CSS
Astro wurde entwickelt, um das Styling und Schreiben von CSS zu einem Kinderspiel zu machen. Schreibe dein eigenes CSS direkt in einer Astro-Komponente oder importiere deine Lieblings-CSS-Bibliothek wie Tailwind. Fortgeschrittene Style-Sprachen wie Sass und Less werden ebenfalls unterstützt.
Styles (Stile) in Astro
Abschnitt betitelt Styles (Stile) in AstroDie Gestaltung einer Astro-Komponente ist so einfach wie das Hinzufügen eines <style>
-Tags zu deiner Komponente oder Seitenvorlage. Wenn du einen <style>
-Tag innerhalb einer Astro-Komponente platzierst, erkennt Astro das CSS und verarbeitet die Styles automatisch für dich.
Scoped Styles (auf Komponenten begrenzte lokale CSS-Stile)
Abschnitt betitelt Scoped Styles (auf Komponenten begrenzte lokale CSS-Stile)Astro <style>
CSS-Regeln sind standardmäßig automatisch scoped. Scoped Styles werden hinter den Kulissen kompiliert und gelten nur für HTML, das innerhalb der gleichen Komponente geschrieben wurde. Das CSS, das du innerhalb einer Astro-Komponente schreibst, wird automatisch innerhalb dieser Komponente gekapselt.
Dieses CSS:
Kompiliert dazu:
Styles mit Scopes wirken sich nicht außerhalb der definierenden Komponente aus und haben keinen Effekt auf den Rest deiner Website. In Astro ist es in Ordnung, Selektoren mit geringer Spezifität wie h1 {}
oder p {}
zu verwenden, da sie in der endgültigen Ausgabe mit Scopes kompiliert werden.
Scoped Styles gelten auch nicht für andere Astro-Komponenten, die in deiner Vorlage enthalten sind. Wenn du eine untergeordnete Komponente stylen musst, solltest du diese Komponente in ein <div>
(oder ein anderes Element) einpacken, das du dann gestalten kannst.
Die Spezifität von Scoped Styles wird beibehalten, sodass sie konsistent mit anderen CSS-Dateien oder CSS-Bibliotheken arbeiten können, während die exklusiven Grenzen erhalten bleiben, die verhindern, dass Styles außerhalb der Komponente angewendet werden.
Globale Styles
Abschnitt betitelt Globale StylesObwohl wir für die meisten Komponenten Scoped Styles empfehlen, kann es vorkommen, dass du einen triftigen Grund hast, globales, unscoped CSS zu schreiben. Mit dem Attribut <style is:global>
kannst du das automatische CSS-Scoping deaktivieren.
Du kannst auch globale und scoped CSS-Regeln im selben <style>
-Tag mischen, indem du den :global()
-Selektor verwendest. Dies ist ein mächtiges Pattern, um CSS-Styles auf untergeordnete Elemente deiner Komponente anzuwenden.
Das ist eine gute Möglichkeit, um beispielsweise Blog-Posts oder Dokumente mit CMS-gestützten Inhalten zu gestalten, deren Inhalte außerhalb von Astro liegen. Aber Vorsicht: Komponenten, deren Aussehen davon abhängt, ob sie eine bestimmte übergeordnete Komponente haben oder nicht, können bei der Fehlersuche Probleme bereiten.
Scoped Styles sollten so oft wie möglich genutzt werden. Globale Styles sollten nur bei Bedarf verwendet werden.
Kombinieren von Klassen mit class:list
Abschnitt betitelt Kombinieren von Klassen mit class:listWenn du Klassen in einem Element dynamisch kombinieren musst, kannst du das Attribut class:list
in .astro
-Dateien verwenden.
📚 Auf unserer Seite Vorlagen-Direktiven (EN) erfährst du mehr über class:list
.
CSS-Variablen
Abschnitt betitelt CSS-Variablenastro@0.21.0
Der Astro-<style>
kann auf alle CSS-Variablen verweisen, die auf der Seite verfügbar sind. Du kannst CSS-Variablen auch direkt von deiner Komponente mit der Direktive define:vars
übergeben.
📚 Siehe unsere Vorlagen-Direktiven (EN) Seite, um mehr über define:vars
zu erfahren.
Übergabe einer class
an eine untergeordnete Komponente
Abschnitt betitelt Übergabe einer class an eine untergeordnete KomponenteIn Astro werden HTML-Attribute wie class
nicht automatisch an untergeordnete Komponenten weitergegeben.
Stattdessen nimmst du eine class
-Eigenschaft in der untergeordneten Komponente an und wendest sie auf das Wurzelelement an. Bei der Destrukturierung musst du sie umbenennen, denn class
ist ein reserviertes Wort in JavaScript.
Mit diesem Pattern kannst du untergeordnete Komponenten direkt gestalten. Astro übergibt den Klassennamen der Elternkomponente (z.B. astro-hhnqfkh6
) automatisch über den Parameter class
und schließt die Kindkomponente in den Geltungsbereich der Elternkomponente ein. Beachte, dass dieses Pattern nur funktioniert, wenn deine scopedStyleStrategy
-Option (EN) entweder 'where'
oder 'class'
ist.
Da die Eigenschaft class
das Kind in den Geltungsbereich des Elternteils einbezieht, ist es möglich, dass Styles vom Elternteil auf das Kind übertragen werden. Um unbeabsichtigte Nebeneffekte zu vermeiden, solltest du sicherstellen, dass du eindeutige Klassennamen in der untergeordneten Komponente verwendest.
Inline Styles
Abschnitt betitelt Inline StylesDu kannst HTML-Elemente mit dem Attribut style
inline stylen. Dies kann ein CSS-String oder ein Objekt mit CSS-Eigenschaften sein:
Externe Styles
Abschnitt betitelt Externe StylesEs gibt zwei Möglichkeiten, externe globale Styles aufzulösen: ein ESM-Import für Dateien, die sich in deinem Projekt-Quellcode befinden, oder ein absoluter URL-Link für Dateien in deinem public/
-Verzeichnis oder außerhalb deines Projekts.
📚 Lies mehr über die Verwendung von statischen Assets, die sich in public/
oder src/
befinden.
Importiere ein lokales Stylesheet
Abschnitt betitelt Importiere ein lokales StylesheetMöglicherweise musst du deine astro.config
aktualisieren, wenn du aus npm-Paketen importierst. Siehe den Abschnitt “CSS aus einem npm-Paket importieren” unten.
Du kannst CSS mit der ESM-Import-Syntax in dein Astro-Komponenten-Frontmatter importieren. CSS-Importe funktionieren wie jeder andere ESM-Import in einer Astro-Komponente, der als relativ zur Komponente referenziert werden sollte und mit allen anderen Importen am Beginn deines Komponentenskripts geschrieben werden muss.
CSS import
über ESM wird in jeder JavaScript-Datei unterstützt, auch in JSX-Komponenten wie React und Preact. Dies kann nützlich sein, um granulare, komponentenbezogene Styles für deine React-Komponenten zu schreiben.
Importiere CSS aus einem npm-Paket
Abschnitt betitelt Importiere CSS aus einem npm-PaketMöglicherweise musst du auch CSS aus einem externen npm-Paket laden. Das ist vor allem bei Dienstprogrammen wie Open Props üblich. Wenn dein Paket die Verwendung einer Dateierweiterung empfiehlt (z. B. paket-name/styles.css
statt paket-name/styles
), sollte dies wie jedes lokale Stylesheet funktionieren:
Wenn dein Paket keine Dateierweiterung vorschlägt (z.B. paket-name/styles
), musst du zuerst deine Astro-Konfiguration aktualisieren!
Angenommen, du importierst eine CSS-Datei mit dem Namen normalize
(ohne die Dateierweiterung) aus paket-name
. Um sicherzustellen, dass wir deine Seite korrekt darstellen können, füge paket-name
zum Array vite.ssr.noExternal
hinzu:
Dies ist eine Vite-spezifische Einstellung, die sich nicht auf Astro SSR bezieht (oder diese benötigt).
Jetzt kannst du paket-name/normalize
importieren. Dieses wird von Astro wie jedes andere lokale Stylesheet gebündelt und optimiert.
Laden eines statischen Stylesheets über “Link”-Tags
Abschnitt betitelt Laden eines statischen Stylesheets über “Link”-TagsDu kannst auch das Element <link>
verwenden, um CSS auf der Seite zu laden. Dies sollte ein absoluter URL-Pfad zu einer CSS-Datei sein, die sich in deinem /public
Verzeichnis befindet, oder eine URL zu einer externen Website. Relative <link>
href-Werte werden nicht unterstützt.
Da diese Methode das Verzeichnis public/
verwendet, überspringt sie die normale CSS-Verarbeitung, Bündelung und Optimierung, die Astro bietet. Wenn du diese Umwandlungen benötigst, verwende die oben beschriebene Methode Importiere CSS.
Kaskadierungs-Reihenfolge
Abschnitt betitelt Kaskadierungs-ReihenfolgeAstro-Komponenten müssen manchmal mehrere CSS-Quellen auswerten. Deine Komponente könnte zum Beispiel CSS importieren, ein eigenes <style>
-Tag enthalten und in einem Layout gerendert werden, das CSS importiert.
Wenn widersprüchliche CSS-Regeln für dasselbe Element gelten, verwenden die Browser zuerst die Spezifität und dann die Reihenfolge des Auftretens, um zu bestimmen, welcher Wert angezeigt werden soll.
Wenn eine Regel spezifischer ist als eine andere, hat ihr Wert Vorrang, egal wo die CSS-Regel erscheint:
Wenn zwei Regeln die gleiche Spezifität haben, wird die Reihenfolge des Auftretens ausgewertet, und der Wert der letzten Regel hat Vorrang:
Astro-CSS-Regeln werden in der Reihenfolge ihres Erscheinens ausgewertet:
<link>
-Tags imhead
(niedrigster Vorrang)- Importiere Styles
- Scoped Styles (höchster Vorrang)
Scoped Styles
Abschnitt betitelt Scoped StylesDie Verwendung von Scoped Styles erhöht nicht die Spezifität deines CSS, aber sie stehen immer an letzter Stelle in der Reihenfolge des Auftretens. Sie haben daher Vorrang vor anderen Styles mit der gleichen Spezifität. Wenn du zum Beispiel CSS importierst, das mit einem Scoped Style in Konflikt steht, gilt der Wert des Scoped Styles:
Wenn du den importierten Stil spezifischer gestaltest, hat er einen höheren Vorrang als der Scoped Style:
Import-Reihenfolge
Abschnitt betitelt Import-ReihenfolgeWenn du mehrere CSS-Stylesheets in eine Astro-Komponente importierst, werden die CSS-Regeln in der Reihenfolge ausgewertet, in der sie importiert werden. Eine höhere Spezifität bestimmt immer, welche Styles angezeigt werden, unabhängig davon, wann das CSS ausgewertet wird. Wenn jedoch widersprüchliche Stile die gleiche Spezifität haben, gewinnt der letzte importierte Stil:
Während <style>
-Tags scoped sind und nur für die Komponente gelten, die sie deklariert, kann importiertes CSS “auslaufen”. Das Importieren einer Komponente wendet jedes CSS an, das sie importiert, auch wenn die Komponente nie verwendet wird:
Ein gängiges Pattern in Astro ist der Import von globalem CSS innerhalb einer Layout-Komponente. Achte darauf, dass du die Layout-Komponente vor anderen Importen importierst, damit sie den niedrigsten Vorrang hat.
Link-Tags
Abschnitt betitelt Link-TagsStyles, die über Link-Tags geladen werden, werden in der Reihenfolge vor allen anderen Styles in einer Astro-Datei ausgewertet. Daher haben diese Styles einen geringeren Vorrang als importierte Stylesheets und Scoped Styles:
CSS-Integrationen
Abschnitt betitelt CSS-IntegrationenAstro unterstützt das Hinzufügen beliebter CSS-Bibliotheken, -Tools und -Frameworks zu deinem Projekt, wie z.B. Tailwind und mehr!
Tailwind
Abschnitt betitelt TailwindUm Tailwind in deinem Projekt zu verwenden, installiere die offizielle Astro Tailwind-Integration mit dem Befehl astro add
für deinen Paketmanager:
📚 Im Integrationsleitfaden findest du Anweisungen zum Installieren, Importieren und Konfigurieren dieser Integrationen.
CSS-Präprozessoren
Abschnitt betitelt CSS-PräprozessorenAstro unterstützt CSS-Präprozessoren wie Sass, Stylus und Less durch Vite.
Sass und SCSS
Abschnitt betitelt Sass und SCSSVerwende <style lang="scss">
oder <style lang="sass">
in .astro
-Dateien.
Verwende <style lang="styl">
oder <style lang="stylus">
in .astro
-Dateien.
Verwende <style lang="less">
in .astro
-Dateien.
In Framework-Komponenten
Abschnitt betitelt In Framework-KomponentenDu kannst alle oben genannten CSS-Präprozessoren auch in JS-Frameworks verwenden! Achte darauf, dass du den Pattern folgst, die jedes Framework empfiehlt:
- React / Preact:
import Styles from './styles.module.scss'
; - Vue:
<style lang="scss">
- Svelte:
<style lang="scss">
PostCSS
Abschnitt betitelt PostCSSAstro wird mit PostCSS als Teil von Vite ausgeliefert. Um PostCSS für dein Projekt zu konfigurieren, erstelle eine Datei postcss.config.cjs
im Stammverzeichnis des Projekts. Du kannst Plugins mit require()
importieren, nachdem du sie installiert hast (zum Beispiel npm install autoprefixer
).
Frameworks und Bibliotheken
Abschnitt betitelt Frameworks und Bibliotheken📘 React / Preact
Abschnitt betitelt 📘 React / Preact.jsx
-Dateien unterstützen sowohl globales CSS als auch CSS-Module. Um letztere zu aktivieren, verwende die Erweiterung .module.css
(oder .module.scss
/.module.sass
bei Verwendung von Sass).
Vue in Astro unterstützt die gleichen Methoden wie vue-loader
:
📕 Svelte
Abschnitt betitelt 📕 SvelteSvelte in Astro funktioniert auch genau wie erwartet: Svelte Styling Docs.
Markdown-Styling
Abschnitt betitelt Markdown-StylingAlle Astro-Stylingmethoden sind für eine Markdown-Layoutkomponente verfügbar, aber die Auswirkungen der verschiedenen Methoden auf das Styling deiner Seite unterscheiden sich.
Du kannst globale Styles auf deinen Markdown-Inhalt anwenden, indem du importierte Stylesheets zu dem Layout hinzufügst, das deinen Seiteninhalt umschließt. Es ist auch möglich, dein Markdown mit <style is:global>
-Tags in der Layoutkomponente zu stylen. Beachte, dass alle hinzugefügten Styles der Astro-Kaskadierungs-Reihenfolge unterliegen und du deine gerenderte Seite sorgfältig überprüfen solltest, um sicherzustellen, dass deine Styles wie vorgesehen angewendet werden.
Du kannst auch CSS-Integrationen einschließlich Tailwind hinzufügen. Wenn du Tailwind verwendest, kann das Typografie-Plugin für das Styling von Markdown nützlich sein.
Produktion
Abschnitt betitelt ProduktionBündelungs-Kontrolle
Abschnitt betitelt Bündelungs-KontrolleWenn Astro deine Seite für die Produktions-Veröffentlichung erstellt, minimiert es dein CSS und kombiniert es in Chunks. Jede Seite deiner Website erhält einen eigenen Chunk. Außerdem wird CSS, das von mehreren Seiten gemeinsam genutzt wird, zur Wiederverwendung in eigene Chunks aufgeteilt.
Wenn sich jedoch mehrere Seiten Styles teilen, können einige gemeinsam genutzte Chunks sehr klein werden. Würden diese alle separat gesendet, würde dies zu vielen Stylesheet-Anfragen führen und die Leistung der Website beeinträchtigen.
Daher verlinkt Astro standardmäßig nur Styles größer als 4 KB in deinem HTML-Code mit <link rel="stylesheet">
-Tags, während kleinere in <style type="text/css">
eingefügt werden. Dieser Ansatz sorgt für ein Gleichgewicht zwischen der Anzahl zusätzlicher Anfragen und der Menge an CSS, die zwischen den Seiten zwischengespeichert werden kann.
Du kannst die Größe (in Bytes), ab der Stylesheets extern verlinkt werden, mithilfe der Vite-Build-Option assetsInlineLimit
konfigurieren. Beachte, dass sich diese Option auch auf das Inlining von Skripten und Bildern auswirkt.
Wenn du möchtest, dass alle Projektstile extern bleiben, kannst du die Build-Option inlineStylesheets
konfigurieren.
Du kannst diese Option auch auf 'always'
setzen, wodurch alle Stylesheets direkt in den HTML-Code eingebettet werden.
Fortgeschrittene Anwendungsfälle
Abschnitt betitelt Fortgeschrittene AnwendungsfälleSei vorsichtig, wenn du die integrierte CSS-Bündelung von Astro umgehst! Die Styles werden nicht automatisch in die erstellte Ausgabe übernommen, und es liegt in deiner Verantwortung, sicherzustellen, dass die referenzierte Datei in der endgültigen Seitenausgabe korrekt enthalten ist.
?raw
CSS-Importe
Abschnitt betitelt ?raw CSS-ImporteFür fortgeschrittene Anwendungsfälle kann CSS direkt von der Festplatte gelesen werden, ohne von Astro gebündelt oder optimiert zu werden. Dies kann nützlich sein, wenn du die vollständige Kontrolle über einen CSS-Ausschnitt brauchst und die automatische CSS-Verarbeitung von Astro umgehen willst.
Dies wird für die meisten Nutzer nicht empfohlen.
Siehe Vite’s docs für alle Details.
?url
CSS-Importe
Abschnitt betitelt ?url CSS-ImporteFür fortgeschrittene Anwendungsfälle kannst du eine direkte URL-Referenz für eine CSS-Datei innerhalb des Verzeichnisses src/
deines Projekts importieren. Das kann nützlich sein, wenn du die volle Kontrolle darüber haben willst, wie eine CSS-Datei auf der Seite geladen wird. Allerdings wird dadurch die Optimierung dieser CSS-Datei mit dem Rest deiner Seite verhindert.
Dies wird für die meisten Benutzer nicht empfohlen. Platziere deine CSS-Dateien stattdessen innerhalb von public/
, um eine einheitliche URL-Referenz zu erhalten.
Wenn du eine kleinere CSS-Datei mit ?url
importierst, kann es sein, dass der base64-kodierte Inhalt der CSS-Datei als Daten-URL in deinem endgültigen Build zurückgegeben wird. Entweder schreibst du deinen Code so, dass er kodierte Daten-URLs unterstützt (data:text/css;base64,...
) oder du setzt die Konfigurationsoption vite.build.assetsInlineLimit
auf 0
, um diese Funktion zu deaktivieren.
Siehe Vite’s docs für alle Details.
Learn