Zum Hauptinhalt springen

Oberflächenkomponente

Zuletzt aktualisiert:

Nur CSS-basierte Tailwind-CSS-Oberfläche zum Anwenden thematischer Hintergrund- und Textfarben auf einen Container. Alle Farbvarianten. WCAG AA zugänglich, funktioniert mit Django, HTMX, Laravel, React und jedem Stack.

Oberflächenkomponenten sind vielseitige Layout-Primitive, die geschichtete visuelle Hierarchien und Inhaltscontainer erstellen. Mit semantischem HTML erstellte Oberflächen bieten flexible Tiefen- und Gestaltungsoptionen. Das Frutjam-Oberflächensystem unterstützt mehrere Größen, Formen und Ebenen – ideal für Kartenalternativen, Inhaltsblöcke und verschachtelte Layouts.

Nur CSS, kein JavaScript erforderlich. WCAG AA zugänglich und Framework-unabhängig – funktioniert mit Django, HTMX, Laravel, React und jedem Stack.

Klasse Typ Beschreibung
surfaceBaseGrundflächenbehälter
surface-1StilHöhenstufe 1 (subtil)
surface-2StilHöhenstufe 2
surface-outlineStilTransparente Füllung mit sichtbarem Rand
surface-dashedStilGestrichelter Randstil
surface-roundedStilMäßig abgerundete Ecken
surface-xsGrößeExtra kleine Polsterung
surface-smGrößeKleine Polsterung
surface-mdGrößeMittlere Polsterung (Standard)
surface-lgGrößeGroße Polsterung
surface-xlGrößeExtra große Polsterung

Grundlegende Verwendung

Surface Container

Content displayed on a surface

1
2
3
4
<div class="surface p-6">
  <h2>Surface Container</h2>
  <p>Content displayed on a surface</p>
</div>
1
2
3
4
<div className="surface p-6">
  <h2>Surface Container</h2>
  <p>Content displayed on a surface</p>
</div>

Oberflächenschichten

Verwenden Sie surface-1 und surface-2, um eine Tiefenhierarchie zu erstellen, indem Sie die Grundfarbe mit der Vordergrundfarbe mischen.

Base
Surface 1 — subtle lift
Surface 2 — more contrast
html
1
2
3
<div class="surface p-4">Base</div>
<div class="surface surface-1 p-4">Surface 1 — subtle lift</div>
<div class="surface surface-2 p-4">Surface 2 — more contrast</div>

Oberflächenformen

Default (square)
Rounded
html
1
2
<div class="surface surface-md">Default (square)</div>
<div class="surface surface-md surface-rounded">Rounded</div>

Rahmenstile

Verwenden Sie surface-outline oder surface-dashed für transparente Container, die durch einen Rahmen definiert sind. Diese funktionieren ordnungsgemäß, wenn sie in farbigen Ebenen verschachtelt sind, da der Hintergrund explizit transparent ist.

Surface 1 (colored parent)

Outline — transparent fill, solid border
Dashed — transparent fill, dashed border
html
1
2
3
4
5
6
7
<div class="surface surface-1 surface-rounded surface-md">
  <p class="mb-3 font-medium">Surface 1 (colored parent)</p>
  <div class="flex gap-3">
    <div class="surface surface-outline surface-rounded surface-sm grow">Outline — transparent fill, solid border</div>
    <div class="surface surface-dashed surface-rounded surface-sm grow">Dashed — transparent fill, dashed border</div>
  </div>
</div>

Oberflächengrößen

Größendienstprogramme legen die interne Polsterung über --surface--padding fest. Nicht mit Tailwind p-*-Dienstprogrammen kombinieren – diese überschreiben die Variable und machen die Größenklasse zunichte.

Extra small (0.5rem)
Small (1rem)
Medium (1.5rem)
Large (2rem)
Extra large (2.5rem)
html
1
2
3
4
5
<div class="surface surface-xs surface-rounded">Extra small (0.5rem)</div>
<div class="surface surface-sm surface-rounded">Small (1rem)</div>
<div class="surface surface-md surface-rounded">Medium (1.5rem)</div>
<div class="surface surface-lg surface-rounded">Large (2rem)</div>
<div class="surface surface-xl surface-rounded">Extra large (2.5rem)</div>

Verschachtelte Oberflächen

Outer Surface

Inner Surface

html
1
2
3
4
5
6
<div class="surface surface-1 p-6 rounded-lg">
  <h3>Outer Surface</h3>
  <div class="surface surface-2 p-4 rounded mt-4">
    <p>Inner Surface</p>
  </div>
</div>

Verwenden Sie Claude Code, Cursor oder einen anderen KI-Editor?

Cherry MCP stellt Ihrem KI-Editor bei Bedarf die genauen Oberfläche-Klassennamen und -Strukturen zur Verfügung. Keine halluzinierten Klassen mehr.

Probieren Sie Cherry MCP