Przejdź do głównej treści

Komponent powierzchniowy

Ostatnia aktualizacja:

Powierzchnia CSS Tailwind obsługująca tylko CSS, umożliwiająca zastosowanie tematycznych kolorów tła i tekstu do kontenera. Wszystkie warianty kolorystyczne. Dostępny WCAG AA, współpracuje z Django, HTMX, Laravel, React i dowolnym stosem.

Komponenty powierzchni to wszechstronne prymitywy układu, które tworzą warstwowe hierarchie wizualne i kontenery treści. Powierzchnie zbudowane w semantycznym formacie HTML zapewniają elastyczną głębię i opcje stylizacji. System powierzchni Frutjam obsługuje wiele rozmiarów, kształtów i warstw — idealnie nadaje się do alternatywnych kart, bloków treści i układów zagnieżdżonych.

Tylko CSS, nie wymaga JavaScript. Dostępny w WCAG AA i niezależny od frameworka — współpracuje z Django, HTMX, Laravel, React i dowolnym stosem.

Klasa Typ Opis
surfaceOpieraćPojemnik powierzchniowy bazowy
surface-1StylPoziom uniesienia 1 (subtelny)
surface-2StylPoziom wzniesienia 2
surface-outlineStylPrzezroczyste wypełnienie z widoczną krawędzią
surface-dashedStylStyl przerywanej granicy
surface-roundedStylUmiarkowanie zaokrąglone rogi
surface-xsRozmiarBardzo mała wyściółka
surface-smRozmiarMała wyściółka
surface-mdRozmiarŚrednie wypełnienie (domyślne)
surface-lgRozmiarDuża wyściółka
surface-xlRozmiarBardzo duża wyściółka

Podstawowe użycie

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>

Warstwy powierzchniowe

Użyj surface-1 i surface-2, aby utworzyć hierarchię głębi poprzez zmieszanie koloru podstawowego z kolorem pierwszego planu.

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>

Kształty powierzchni

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

Style graniczne

Użyj surface-outline lub surface-dashed w przypadku przezroczystych kontenerów zdefiniowanych przez obramowanie. Działają one poprawnie, gdy są zagnieżdżone w kolorowych warstwach, ponieważ tło jest wyraźnie przezroczyste.

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>

Rozmiary powierzchni

Narzędzia size ustawiają wewnętrzne dopełnienie poprzez --surface--padding. Nie łącz z narzędziami Tailwind p-* — zastąpią zmienną i pokonają klasę rozmiaru.

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>

Zagnieżdżone powierzchnie

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>

Używasz kodu Claude'a, kursora lub innego edytora AI?

Cherry MCP na żądanie udostępnia edytorowi AI dokładne nazwy i strukturę klas Powierzchnia. Żadnych więcej zajęć z halucynacjami.

Try Cherry MCP