Skip to main content

System kolorów

Ostatnia aktualizacja:

System kolorów Frutjam wykorzystuje semantyczne tokeny CSS zaprojektowane tak, aby od razu spełniać współczynniki kontrastu WCAG AA. Brak JavaScript, obsługa trybu ciemnego, kompatybilność z Tailwind CSS v4. Działa z Django, HTMX, Laravel i dowolnym stosem obsługującym tylko CSS.

Frutjam wykorzystuje niestandardowe właściwości CSS jako tokeny projektu dla wszystkich kolorów. Każdy kolor jest zdefiniowany dla motywu i automatycznie współpracuje z klasami narzędzi CSS Tailwind, bez konieczności dodatkowej konfiguracji. Tylko CSS, nie wymaga JavaScript. Kontrast WCAG AA gwarantowany dla każdej pary kolorów, współpracuje z Django, HTMX, Laravel, React i dowolnym projektem Tailwind CSS v4.

Nazwy kolorów

Frutjam definiuje następujące semantyczne role kolorów. Każdy kolor ma odpowiednik on-{color} token dla dostępnego tekstu na pierwszym planie.

KolorZnakZamiar
opierać--color-baseTło strony
neutralny--color-neutralPowierzchnie, paski boczne, nakładki
podstawowy--color-primaryPodstawowy kolor marki
wtórny--color-secondaryKolor drugorzędny marki
akcent--color-accentKolor akcentu/podkreślenia
informacje--color-infoKomunikaty informacyjne
sukces--color-successStany sukcesu
ostrzeżenie--color-warningStany ostrzegawcze
błąd--color-errorStany błędne i destrukcyjne

Skala kolorów (50–950)

Każdy kolor generuje 11-stopniową skalę obliczoną na podstawie głównych zmiennych motywu color-mix() w OKLCH, a nie w czasie kompilacji. Set a brand color and all eleven steps follow from it, so you never set them by hand.

Każdy krok jest jednocześnie zmienną CSS i narzędziem Tailwind: użyj var(--color-primary-700) we własnym CSS lub bg-primary-700 w znacznikach. Najedź kursorem na próbkę, aby zobaczyć oba imiona.

Colour50100200300400500600700800900950
primaryprimary 50primary 100primary 200primary 300primary 400primary 500primary 600primary 700primary 800primary 900primary 950
secondarysecondary 50secondary 100secondary 200secondary 300secondary 400secondary 500secondary 600secondary 700secondary 800secondary 900secondary 950
accentaccent 50accent 100accent 200accent 300accent 400accent 500accent 600accent 700accent 800accent 900accent 950
infoinfo 50info 100info 200info 300info 400info 500info 600info 700info 800info 900info 950
successsuccess 50success 100success 200success 300success 400success 500success 600success 700success 800success 900success 950
warningwarning 50warning 100warning 200warning 300warning 400warning 500warning 600warning 700warning 800warning 900warning 950
errorerror 50error 100error 200error 300error 400error 500error 600error 700error 800error 900error 950
neutralneutral 50neutral 100neutral 200neutral 300neutral 400neutral 500neutral 600neutral 700neutral 800neutral 900neutral 950
basebase 50base 100base 200base 300base 400base 500base 600base 700base 800base 900base 950

Ponieważ kroki są obliczane na podstawie motywu, a nie zakodowane na stałe, ta siatka nie jest obrazem kolorów Frutjama. To Twoje kolory. Zmień motyw, a każda powyższa próbka przesunie się wraz z nim, dlatego też obok nich nie są drukowane żadne wartości szesnastkowe.

Light tint, dark text
Dark shade, light text
Border and text
html
1
2
3
<div class="bg-primary-100 text-primary-900 p-4 rounded">Light tint, dark text</div>
<div class="bg-success-700 text-success-50 p-4 rounded">Dark shade, light text</div>
<div class="border-2 border-error-400 text-error-600 p-4 rounded">Border and text</div>
Zmienna CSSOpis
--color-{color}-5080% odcienia światła, 20% koloru
--color-{color}-10065% światła, 35% koloru
--color-{color}-20050% światła, 50% koloru
--color-{color}-30035% światła, 65% koloru
--color-{color}-40018% światła, 82% koloru
--color-{color}-500sam kolor taki sam jak --color-{color}
--color-{color}-60018% ciemnego odcienia, 82% koloru
--color-{color}-70034% ciemności, 66% koloru
--color-{color}-80050% ciemności, 50% koloru
--color-{color}-90065% ciemności, 35% koloru
--color-{color}-95080% ciemności, 20% koloru

Zajęcia z użyteczności kolorów

Wszystkie kolory Frutjam współpracują z dowolnym narzędziem do tworzenia kolorów CSS Tailwind. Zastępować {color} z dowolną nazwą koloru z tabeli powyżej, opcjonalnie z krokiem ze skali 50-950: bg-primary, bg-primary-100, text-error-900, border-success-300.

KlasaOpis
bg-{color}Kolor tła
text-{color}Kolor tekstu
border-{color}Kolor obramowania
ring-{color}Kolor pierścionka
outline-{color}Kolor konturu
shadow-{color}Kolor cienia
fill-{color}Kolor wypełnienia SVG
stroke-{color}Kolor obrysu SVG
decoration-{color}Kolor dekoracji tekstu
caret-{color}Wprowadź kolor karetki
placeholder-{color}Kolor tekstu zastępczego
divide-{color}Kolor obramowania rozdzielacza
{utility}-{color}-{step}Na przykład dowolne z powyższych w kroku skali bg-accent-200
Primary background
Secondary background
Primary border and text
html
1
2
3
<div class="bg-primary text-on-primary p-4 rounded">Primary background</div>
<div class="bg-secondary text-on-secondary p-4 rounded">Secondary background</div>
<div class="border border-primary text-primary p-4 rounded">Primary border and text</div>

Modyfikator krycia

Kontroluj przezroczystość kolorów za pomocą /{value} modyfikator, tak jak każdy kolor Tailwind.

10% primary background
20% primary background
60% opacity text
html
1
2
3
<div class="bg-primary/10 text-primary p-4 rounded">10% primary background</div>
<div class="bg-primary/20 text-primary p-4 rounded">20% primary background</div>
<div class="text-on-base/60 p-4">60% opacity text</div>

Miękkie i aktywne

Warianty świadome stanu elementów interaktywnych, automatycznie dostosowujące się do jasnych i ciemnych motywów.

Zmienna CSSOpis
--color-{color}-softSubtelnie przyciemnione tło dla miękkich wariantów
--color-on-{color}-softKolor tekstu do stosowania na miękkim tle
--color-{color}-activePrzyciemniony/rozjaśniony odcień dla stanów najechania i aktywności
--color-bodyObliczony kolor tekstu podstawowego (nieco zmiękczony z on-base)

Zmienne CSS motywu

Są to tokeny główne, które definiujesz podczas tworzenia niestandardowego motywu. Wszystkie inne żetony kolorów są obliczane automatycznie na ich podstawie.

Zmienna CSSOpis
--scheme-colorSchemat kolorów: light Lub dark
--border-radiusPodstawowy promień obramowania komponentów
--color-baseKolor tła strony
--color-on-baseDomyślny kolor tekstu na tle bazowym
--color-neutralNeutralny kolor powierzchni
--color-on-neutralKolor tekstu na neutralnych powierzchniach
--color-primaryPodstawowy kolor marki
--color-on-primaryKolor tekstu na tle podstawowym
--color-secondaryKolor drugorzędny marki
--color-on-secondaryKolor tekstu na tle wtórnym
--color-accentKolor akcentujący
--color-on-accentKolor tekstu na akcentowanym tle
--color-infoKolor informacji
--color-on-infoKolor tekstu na tłach informacyjnych
--color-successKolor sukcesu
--color-on-successKolor tekstu na tle sukcesu
--color-warningKolor ostrzegawczy
--color-on-warningKolor tekstu na tle ostrzeżeń
--color-errorKolor błędu
--color-on-errorKolor tekstu na tle błędów

Przykład niestandardowego motywu

Zastąp tokeny root, aby utworzyć niestandardowy motyw. Frutjam automatycznie oblicza wszystkie skale i stany.

css
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
@import "tailwindcss";
@plugin "frutjam";

[data-theme="mytheme"] {
  --scheme-color: light;
  --border-radius: 0.5rem;

  --color-base: oklch(98% 0 0);
  --color-on-base: oklch(15% 0 0);

  --color-neutral: oklch(20% 0 0);
  --color-on-neutral: oklch(98% 0 0);

  --color-primary: oklch(55% 0.25 260);
  --color-on-primary: oklch(98% 0 0);

  --color-secondary: oklch(60% 0.20 320);
  --color-on-secondary: oklch(98% 0 0);

  --color-accent: oklch(65% 0.22 180);
  --color-on-accent: oklch(15% 0 0);

  --color-info: oklch(68% 0.17 237);
  --color-on-info: oklch(15% 0 0);

  --color-success: oklch(75% 0.20 150);
  --color-on-success: oklch(15% 0 0);

  --color-warning: oklch(82% 0.19 90);
  --color-on-warning: oklch(15% 0 0);

  --color-error: oklch(58% 0.24 27);
  --color-on-error: oklch(98% 0 0);
}

Found this useful?

Star Frutjam on GitHub. It's how other developers discover it.