Sistem warna Frutjam menggunakan token CSS semantik yang dirancang untuk memenuhi rasio kontras WCAG AA yang siap digunakan. Tanpa JavaScript, mendukung mode gelap, kompatibel dengan Tailwind CSS v4. Bekerja dengan Django, HTMX, Laravel, dan tumpukan khusus CSS apa pun.
Frutjam menggunakan properti khusus CSS sebagai token desain untuk semua warna. Setiap warna ditentukan per tema dan secara otomatis berfungsi dengan kelas utilitas Tailwind CSS, tidak diperlukan konfigurasi tambahan. Hanya CSS, tidak diperlukan JavaScript. Kontras WCAG AA dijamin pada setiap pasangan warna, berfungsi dengan Django, HTMX, Laravel, React, dan proyek Tailwind CSS v4 apa pun.
Nama Warna
Frutjam mendefinisikan peran warna semantik berikut. Setiap warna mempunyai kecocokan on-{color} token untuk teks latar depan yang dapat diakses.
on-{color} pasangan disetel secara manual di OKLCH untuk memenuhi persyaratan kontras WCAG AA. Tidak seperti perpustakaan yang menghitung warna latar depan secara otomatis, Frutjam memberi Anda pasangan warna yang eksplisit dan terverifikasi, sehingga komponen Anda dapat diakses berdasarkan desain, bukan secara kebetulan.| Warna | Token | Tujuan |
|---|---|---|
| basis | --color-base | Latar belakang halaman |
| netral | --color-neutral | Permukaan, sidebar, overlay |
| utama | --color-primary | Warna merek utama |
| sekunder | --color-secondary | Warna merek sekunder |
| aksen | --color-accent | Warna aksen/highlight |
| info | --color-info | Pesan informasi |
| kesuksesan | --color-success | Status sukses |
| peringatan | --color-warning | Status peringatan |
| kesalahan | --color-error | Kesalahan dan keadaan destruktif |
Skala Warna (50–950)
Setiap warna menghasilkan skala 11 langkah, dihitung dari variabel tema akar Anda dengan color-mix() di OKLCH daripada pada waktu pembuatan. Tetapkan warna merek dan kesebelas langkah mengikuti darinya, jadi Anda tidak pernah mengaturnya dengan tangan.
Setiap langkah adalah variabel CSS dan utilitas Tailwind sekaligus: gunakan var(--color-primary-700) di CSS Anda sendiri, atau bg-primary-700 dalam penandaan. Arahkan kursor ke contoh untuk melihat kedua nama tersebut.
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 950Karena langkah-langkahnya dihitung dari tema Anda dan bukan dari hardcode, grid ini bukanlah gambar warna Frutjam. Itu adalah warnamu. Ganti tema dan setiap contoh di atas akan ikut berpindah, itulah sebabnya tidak ada nilai hex yang tercetak di sebelahnya.
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- warna, jadi tidak ada yang menjamin kontras terhadapnya. Saat teks berada pada suatu warna, gunakan tes perpustakaan berpasangan: bg-primary dengan text-on-primary.| Variabel CSS | Keterangan |
|---|---|
--color-{color}-50 | 80% warna terang, 20% warna |
--color-{color}-100 | 65% terang, 35% warna |
--color-{color}-200 | 50% terang, 50% warna |
--color-{color}-300 | 35% terang, 65% warna |
--color-{color}-400 | 18% terang, 82% warna |
--color-{color}-500 | warnanya sendiri, sama seperti --color-{color} |
--color-{color}-600 | 18% warna gelap, 82% warna |
--color-{color}-700 | 34% gelap, 66% berwarna |
--color-{color}-800 | 50% gelap, 50% berwarna |
--color-{color}-900 | 65% gelap, 35% berwarna |
--color-{color}-950 | 80% gelap, 20% berwarna |
Kelas Utilitas Warna
Semua warna Frutjam dapat digunakan dengan utilitas warna Tailwind CSS apa pun. Mengganti {color} dengan nama warna apa pun dari tabel di atas, secara opsional diikuti dengan langkah dari skala 50-950: bg-primary, bg-primary-100, text-error-900, border-success-300.
| Kelas | Keterangan |
|---|---|
bg-{color} | Warna latar belakang |
text-{color} | Warna teks |
border-{color} | Warna perbatasan |
ring-{color} | Warna cincin |
outline-{color} | Warna garis luar |
shadow-{color} | Warna bayangan |
fill-{color} | Warna isian SVG |
stroke-{color} | Warna guratan SVG |
decoration-{color} | Warna dekorasi teks |
caret-{color} | Masukkan warna tanda sisipan |
placeholder-{color} | Warna teks placeholder |
divide-{color} | Warna batas pembatas |
{utility}-{color}-{step} | Salah satu hal di atas dalam skala besar, misalnya 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> |
Pengubah Opasitas
Kontrol opacity warna dengan /{value} pengubah, sama seperti warna Tailwind lainnya.
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> |
Lembut & Aktif
Varian yang sadar negara untuk elemen interaktif, secara otomatis beradaptasi dengan tema terang dan gelap.
| Variabel CSS | Keterangan |
|---|---|
--color-{color}-soft | Latar belakang berwarna halus untuk varian lembut |
--color-on-{color}-soft | Warna teks untuk digunakan pada latar belakang lembut |
--color-{color}-active | Warna gelap/terang untuk keadaan melayang dan aktif |
--color-body | Warna teks isi yang dihitung (sedikit diperhalus dari on-base) |
Variabel CSS Tema
Ini adalah token root yang Anda tentukan saat membuat tema khusus. Semua token warna lainnya dihitung secara otomatis dari ini.
| Variabel CSS | Keterangan |
|---|---|
--scheme-color | Skema warna: light atau dark |
--border-radius | Radius batas dasar untuk komponen |
--color-base | Warna latar belakang halaman |
--color-on-base | Warna teks default pada latar belakang dasar |
--color-neutral | Warna permukaan netral |
--color-on-neutral | Warna teks pada permukaan netral |
--color-primary | Warna merek utama |
--color-on-primary | Warna teks pada latar belakang utama |
--color-secondary | Warna merek sekunder |
--color-on-secondary | Warna teks pada latar belakang sekunder |
--color-accent | Warna aksen |
--color-on-accent | Warna teks pada latar belakang aksen |
--color-info | Info warna |
--color-on-info | Warna teks pada latar belakang info |
--color-success | Warna sukses |
--color-on-success | Warna teks pada latar belakang kesuksesan |
--color-warning | Warna peringatan |
--color-on-warning | Warna teks pada latar belakang peringatan |
--color-error | Warna kesalahan |
--color-on-error | Warna teks pada latar belakang kesalahan |
Contoh Tema Kustom
Ganti token root untuk membuat tema khusus. Frutjam menghitung semua skala dan status secara otomatis.
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); } |