Styles in theme.json für Editor und Website festlegen

Ein Block-Theme braucht gemeinsame Gestaltungsregeln für die Website und den WordPress-Editor. Der Bereich styles in der theme.json bündelt Typografie, Farben, Abstände und Vorgaben für einzelne Blöcke an einer zentralen Stelle.

3 Min. von Matthias Ulrich

Die theme.json beschreibt die Gestaltung eines WordPress-Block-Themes. Neben Farben und Schriftarten lassen sich dort Abstände, Rahmen und weitere CSS-Eigenschaften strukturiert festlegen.

WordPress übernimmt diese Vorgaben im Editor und im Frontend. Globale Regeln bilden die gemeinsame Grundlage, während Elemente und einzelne Blöcke eigene Ergänzungen erhalten können.

Papiercollage zur Anwendung globaler Styles auf die Website, semantische Elemente und einzelne WordPress-Blöcke.
Globale Vorgaben bilden die gestalterische Grundlage; Element- und Block-Styles ergänzen sie für konkrete Bestandteile.

Designwerte und Gestaltung verteilen

Die Bereiche settings und styles übernehmen unterschiedliche Aufgaben. Unter settings werden Designwerte und verfügbare Werkzeuge definiert, etwa Farbpaletten, Schriftfamilien oder Abstandsgrössen.

styles wendet diese Werte auf die Website an. Ein Theme kann Presets aus settings über die von WordPress erzeugten CSS-Variablen verwenden. Definition und Anwendung bleiben so miteinander verbunden.

{
	"$schema": "https://schemas.wp.org/trunk/theme.json",
	"version": 3,
	"settings": {
		"appearanceTools": true,
		"color": {
			"palette": [
				{
					"name": "Text",
					"slug": "text",
					"color": "#252525"
				},
				{
					"name": "Akzent",
					"slug": "accent",
					"color": "#2f6b4f"
				},
				{
					"name": "Fläche",
					"slug": "surface",
					"color": "#faf9f2"
				}
			]
		},
		"typography": {
			"fontFamilies": [
				{
					"name": "Helvetica",
					"slug": "helvetica",
					"fontFamily": "Helvetica, sans-serif"
				}
			]
		}
	},
	"styles": {
		"color": {
			"background": "var(--wp--preset--color--surface)",
			"text": "var(--wp--preset--color--text)"
		},
		"typography": {
			"fontFamily": "var(--wp--preset--font-family--helvetica)",
			"fontSize": "1rem",
			"lineHeight": "1.5"
		}
	}
}

Grundgestaltung im Theme festlegen

Eigenschaften direkt unter styles gelten als Grundlage für die gesamte Website. WordPress erzeugt daraus Styles für das Wurzelelement. Häufig werden hier Hintergrund- und Textfarbe sowie die grundlegende Typografie festgelegt.

Auch Abstände folgen der Struktur ihrer CSS-Eigenschaften:

"styles": {
	"spacing": {
		"blockGap": "1.5rem",
		"padding": {
			"top": "2rem",
			"right": "2rem",
			"bottom": "2rem",
			"left": "2rem"
		}
	}
}

Elemente auf der ganzen Website gestalten

Der Bereich elements richtet Styles an semantischen Elementen aus. Dazu gehören Überschriften, Links, Buttons und Bildunterschriften. Eine Linkfarbe wird deshalb als Element-Style definiert:

"styles": {
	"elements": {
		"heading": {
			"typography": {
				"fontWeight": "600",
				"lineHeight": "1.15"
			}
		},
		"link": {
			"color": {
				"text": "var(--wp--preset--color--accent)"
			}
		},
		"button": {
			"color": {
				"background": "var(--wp--preset--color--accent)",
				"text": "#ffffff"
			},
			"border": {
				"radius": "999px"
			}
		}
	}
}

Diese Einordnung gibt Links, Buttons und Überschriften eine wiederkehrende Gestaltung, auch wenn sie in unterschiedlichen Inhaltsblöcken vorkommen.

Einzelne Blöcke ergänzen

Unter styles.blocks lassen sich Regeln für bestimmte Blocktypen ergänzen. Als Schlüssel dient der registrierte Blockname, beispielsweise core/quote für den Zitat-Block:

"styles": {
	"blocks": {
		"core/quote": {
			"border": {
				"left": {
					"color": "var(--wp--preset--color--accent)",
					"style": "solid",
					"width": "4px"
				}
			},
			"spacing": {
				"padding": {
					"left": "1.5rem"
				}
			},
			"typography": {
				"fontSize": "1.125rem"
			}
		}
	}
}

WordPress erzeugt daraus den passenden Selektor für den Block. Die Gestaltung bleibt dadurch an der Block-Architektur des Themes ausgerichtet.

Gemeinsame Regeln systematisch aufbauen

Globale Styles bilden die gemeinsame Grundlage. Element-Styles gestalten wiederkehrende Bestandteile wie Überschriften, Links und Buttons. Block-Styles ergänzen Regeln für einzelne Inhaltsblöcke.

Spezifischere Ebenen ergänzen oder überschreiben die übergeordneten Werte. So bleiben allgemeine Regeln zentral gepflegt, während projektspezifische Anpassungen bei den jeweiligen Elementen und Blöcken stehen.

Ergebnis

Gestaltung im Block-Theme zentral zusammenführen

settings und styles verbinden Designwerte, globale Vorgaben sowie Ergänzungen für Elemente und Blöcke. Editor und Frontend arbeiten dadurch mit derselben gestalterischen Grundlage.

Designwerte zentral definieren

settings stellt Farben, Schriften und weitere Werte für die Gestaltung des Themes bereit.

Elemente einheitlich gestalten

styles überträgt die gemeinsamen Vorgaben in den WordPress-Editor und auf die Website.

Einzelne Blöcke ergänzen

Element- und Block-Styles erweitern die Grundlage dort, wo Bestandteile eigene Regeln benötigen.