Frutjam'ın renk sistemi, WCAG AA kontrast oranlarını kutudan çıkar çıkmaz karşılamak üzere tasarlanmış anlamsal CSS belirteçlerini kullanır. JavaScript yok, karanlık mod uyumlu, Tailwind CSS v4 ile uyumlu. Django, HTMX, Laravel ve yalnızca CSS yığınlarıyla çalışır.
Frutjam, tüm renkler için tasarım belirteçleri olarak CSS özel özelliklerini kullanır. Her renk, temaya göre tanımlanır ve otomatik olarak Tailwind CSS yardımcı program sınıflarıyla çalışır; ekstra yapılandırmaya gerek yoktur. Yalnızca CSS, JavaScript gerekmez. WCAG AA kontrastı her renk çiftinde garanti edilir; Django, HTMX, Laravel, React ve herhangi bir Tailwind CSS v4 projesiyle çalışır.
Renk İsimleri
Frutjam aşağıdaki anlamsal renk rollerini tanımlar. Her rengin bir eşleşmesi vardır on-{color} erişilebilir ön plan metni için belirteç.
on-{color} çifti, WCAG AA kontrast gereksinimlerini karşılayacak şekilde OKLCH'de elle ayarlanmıştır. Ön plan renklerini otomatik olarak hesaplayan kitaplıkların aksine, Frutjam size açık, doğrulanmış çiftler sunar, böylece bileşenlerinize tesadüfen değil, tasarım gereği erişilebilir.| Renk | Jeton | Amaç |
|---|---|---|
| temel | --color-base | Sayfa arka planı |
| doğal | --color-neutral | Yüzeyler, kenar çubukları, kaplamalar |
| öncelik | --color-primary | Birincil marka rengi |
| ikincil | --color-secondary | İkincil marka rengi |
| aksan | --color-accent | Vurgu / vurgu rengi |
| bilgi | --color-info | Bilgilendirici mesajlar |
| başarı | --color-success | Başarı durumları |
| uyarı | --color-warning | Uyarı durumları |
| hata | --color-error | Hata ve yıkıcı durumlar |
Renk Skalası (50–950)
Her renk, kök tema değişkenlerinizden hesaplanan 11 adımlı bir ölçek oluşturur. color-mix() derleme zamanında değil OKLCH'de. Bir marka rengi belirleyin ve on bir adımın tümü bundan takip eder, böylece bunları asla elle ayarlamazsınız.
Her adım aynı anda bir CSS değişkeni ve bir Tailwind yardımcı programıdır: var(--color-primary-700) kendi CSS'nizde veya bg-primary-700 işaretlemede. Her iki adı da görmek için bir renk örneğinin üzerine gelin.
primaryprimary 50primary 100primary 200primary 300primary 400primary 500primary 600primary 700primary 800primary 900primary 950secondarysecondary 50secondary 100secondary 200secondary 300secondary 400secondary 500secondary 600secondary 700secondary 800secondary 900secondary 950accentaccent 50accent 100accent 200accent 300accent 400accent 500accent 600accent 700accent 800accent 900accent 950infoinfo 50info 100info 200info 300info 400info 500info 600info 700info 800info 900info 950successsuccess 50success 100success 200success 300success 400success 500success 600success 700success 800success 900success 950warningwarning 50warning 100warning 200warning 300warning 400warning 500warning 600warning 700warning 800warning 900warning 950errorerror 50error 100error 200error 300error 400error 500error 600error 700error 800error 900error 950neutralneutral 50neutral 100neutral 200neutral 300neutral 400neutral 500neutral 600neutral 700neutral 800neutral 900neutral 950basebase 50base 100base 200base 300base 400base 500base 600base 700base 800base 900base 950Adımlar sabit kod yerine temanıza göre hesaplandığından, bu ızgara Frutjam'ın renklerinin bir resmi değildir. O sizin renklerinizdir. Temayı değiştirdiğinizde yukarıdaki her renk örneği onunla birlikte hareket eder, bu da yanlarında onaltılık değerlerin basılmamasının nedenidir.
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> |
on- renk olduğundan hiçbir şey ona karşı kontrastı garanti etmez. Metin bir rengin üzerinde durduğunda kitaplığın test ettiği çifti kullanın: bg-primary ile text-on-primary.| CSS Değişkeni | Tanım |
|---|---|
--color-{color}-50 | Açık gölgenin %80'i, rengin %20'si |
--color-{color}-100 | %65 ışık, %35 renkli |
--color-{color}-200 | %50 ışık, %50 renkli |
--color-{color}-300 | %35 ışık, %65 renkli |
--color-{color}-400 | %18 ışık, %82 renkli |
--color-{color}-500 | rengin kendisi, aynı --color-{color} |
--color-{color}-600 | %18 koyu gölge, %82 renkli |
--color-{color}-700 | %34 koyu, %66 renkli |
--color-{color}-800 | %50 koyu, %50 renkli |
--color-{color}-900 | %65 koyu, %35 renkli |
--color-{color}-950 | %80 koyu, %20 renkli |
Renk Yardımcı Program Sınıfları
Tüm Frutjam renkleri herhangi bir Tailwind CSS renk yardımcı programıyla çalışır. Yer değiştirmek {color} Yukarıdaki tablodan herhangi bir renk adıyla, isteğe bağlı olarak ardından 50-950 ölçeğinden bir adımla: bg-primary, bg-primary-100, text-error-900, border-success-300.
| Sınıf | Tanım |
|---|---|
bg-{color} | Arka plan rengi |
text-{color} | Metin rengi |
border-{color} | Kenarlık rengi |
ring-{color} | Halka rengi |
outline-{color} | Anahat rengi |
shadow-{color} | Gölge rengi |
fill-{color} | SVG dolgu rengi |
stroke-{color} | SVG kontur rengi |
decoration-{color} | Metin dekorasyon rengi |
caret-{color} | Giriş düzeltme işareti rengi |
placeholder-{color} | Yer tutucu metin rengi |
divide-{color} | Bölücü kenarlık rengi |
{utility}-{color}-{step} | Örneğin bir ölçek adımında yukarıdakilerden herhangi biri bg-accent-200 |
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> |
Opaklık Değiştirici
Renk opaklığını kontrol edin /{value} değiştirici, tıpkı herhangi bir Tailwind rengi gibi.
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> |
Yumuşak ve Aktif
Açık ve koyu temalara otomatik olarak uyum sağlayan, etkileşimli öğeler için durum bilinçli değişkenler.
| CSS Değişkeni | Tanım |
|---|---|
--color-{color}-soft | Yumuşak çeşitler için ince renkli arka plan |
--color-on-{color}-soft | Yumuşak arka planlarda kullanım için metin rengi |
--color-{color}-active | Fareyle üzerine gelme ve etkin durumlar için koyulaştırılmış/açıklaştırılmış gölge |
--color-body | Hesaplanan gövde metni rengi (biraz yumuşatılmış) on-base) |
Tema CSS Değişkenleri
Bunlar, özel bir tema oluştururken tanımladığınız kök belirteçlerdir. Diğer tüm renk belirteçleri bunlardan otomatik olarak hesaplanır.
| CSS Değişkeni | Tanım |
|---|---|
--scheme-color | Renk şeması: light veya dark |
--border-radius | Bileşenler için taban kenarlık yarıçapı |
--color-base | Sayfa arka plan rengi |
--color-on-base | Temel arka planda varsayılan metin rengi |
--color-neutral | Nötr yüzey rengi |
--color-on-neutral | Nötr yüzeylerde metin rengi |
--color-primary | Birincil marka rengi |
--color-on-primary | Birincil arka planlarda metin rengi |
--color-secondary | İkincil marka rengi |
--color-on-secondary | İkincil arka planlarda metin rengi |
--color-accent | Vurgu rengi |
--color-on-accent | Vurgulu arka planlarda metin rengi |
--color-info | Bilgi rengi |
--color-on-info | Bilgi arka planlarındaki metin rengi |
--color-success | Başarı rengi |
--color-on-success | Başarı arka planlarındaki metin rengi |
--color-warning | Uyarı rengi |
--color-on-warning | Uyarı arka planlarındaki metin rengi |
--color-error | Hata rengi |
--color-on-error | Hata arka planlarındaki metin rengi |
Özel Tema Örneği
Özel bir tema oluşturmak için kök belirteçlerini geçersiz kılın. Frutjam tüm ölçekleri ve durumları otomatik olarak hesaplar.
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); } |