Skip to main content

Sistem Warna

Terakhir diperbarui:

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.

WarnaTokenTujuan
basis--color-baseLatar belakang halaman
netral--color-neutralPermukaan, sidebar, overlay
utama--color-primaryWarna merek utama
sekunder--color-secondaryWarna merek sekunder
aksen--color-accentWarna aksen/highlight
info--color-infoPesan informasi
kesuksesan--color-successStatus sukses
peringatan--color-warningStatus peringatan
kesalahan--color-errorKesalahan 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.

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

Karena 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.

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>
Variabel CSSKeterangan
--color-{color}-5080% warna terang, 20% warna
--color-{color}-10065% terang, 35% warna
--color-{color}-20050% terang, 50% warna
--color-{color}-30035% terang, 65% warna
--color-{color}-40018% terang, 82% warna
--color-{color}-500warnanya sendiri, sama seperti --color-{color}
--color-{color}-60018% warna gelap, 82% warna
--color-{color}-70034% gelap, 66% berwarna
--color-{color}-80050% gelap, 50% berwarna
--color-{color}-90065% gelap, 35% berwarna
--color-{color}-95080% 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.

KelasKeterangan
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
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>

Pengubah Opasitas

Kontrol opacity warna dengan /{value} pengubah, sama seperti warna Tailwind lainnya.

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>

Lembut & Aktif

Varian yang sadar negara untuk elemen interaktif, secara otomatis beradaptasi dengan tema terang dan gelap.

Variabel CSSKeterangan
--color-{color}-softLatar belakang berwarna halus untuk varian lembut
--color-on-{color}-softWarna teks untuk digunakan pada latar belakang lembut
--color-{color}-activeWarna gelap/terang untuk keadaan melayang dan aktif
--color-bodyWarna 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 CSSKeterangan
--scheme-colorSkema warna: light atau dark
--border-radiusRadius batas dasar untuk komponen
--color-baseWarna latar belakang halaman
--color-on-baseWarna teks default pada latar belakang dasar
--color-neutralWarna permukaan netral
--color-on-neutralWarna teks pada permukaan netral
--color-primaryWarna merek utama
--color-on-primaryWarna teks pada latar belakang utama
--color-secondaryWarna merek sekunder
--color-on-secondaryWarna teks pada latar belakang sekunder
--color-accentWarna aksen
--color-on-accentWarna teks pada latar belakang aksen
--color-infoInfo warna
--color-on-infoWarna teks pada latar belakang info
--color-successWarna sukses
--color-on-successWarna teks pada latar belakang kesuksesan
--color-warningWarna peringatan
--color-on-warningWarna teks pada latar belakang peringatan
--color-errorWarna kesalahan
--color-on-errorWarna teks pada latar belakang kesalahan

Contoh Tema Kustom

Ganti token root untuk membuat tema khusus. Frutjam menghitung semua skala dan status secara otomatis.

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.