Skip to main content

Hệ màu

Cập nhật lần cuối:

Hệ thống màu của Frutjam sử dụng mã thông báo CSS ngữ nghĩa được thiết kế để đáp ứng tỷ lệ tương phản WCAG AA ngay lập tức. Không có JavaScript, nhận biết chế độ tối, tương thích với Tailwind CSS v4. Hoạt động với Django, HTMX, Laravel và mọi ngăn xếp chỉ có CSS.

Frutjam sử dụng các thuộc tính tùy chỉnh CSS làm mã thông báo thiết kế cho tất cả các màu. Mỗi màu được xác định theo chủ đề và tự động hoạt động với các lớp tiện ích CSS của Tailwind mà không cần cấu hình bổ sung. Chỉ CSS, không cần JavaScript. Độ tương phản WCAG AA được đảm bảo trên mọi cặp màu, hoạt động với Django, HTMX, Laravel, React và bất kỳ dự án Tailwind CSS v4 nào.

Tên màu

Frutjam xác định các vai trò màu ngữ nghĩa sau đây. Mỗi màu có một sự phù hợp on-{color} mã thông báo cho văn bản nền trước có thể truy cập.

Màu sắcMã thông báoMục đích
căn cứ--color-baseNền trang
trung lập--color-neutralBề mặt, thanh bên, lớp phủ
sơ đẳng--color-primaryMàu thương hiệu chính
sơ trung--color-secondaryMàu thương hiệu phụ
giọng--color-accentMàu nhấn/nổi bật
thông tin--color-infotin nhắn thông tin
thành công--color-successTrạng thái thành công
cảnh báo--color-warningTrạng thái cảnh báo
lỗi--color-errorLỗi và trạng thái phá hủy

Thang màu (50–950)

Mỗi màu tạo ra thang đo 11 bước, được tính từ các biến chủ đề gốc của bạn với color-mix() trong OKLCH thay vì tại thời điểm xây dựng. Đặt màu thương hiệu và thực hiện tất cả 11 bước sau đó, do đó bạn không bao giờ đặt chúng bằng tay.

Mỗi bước là một biến CSS và tiện ích Tailwind cùng một lúc: sử dụng var(--color-primary-700) trong CSS của riêng bạn, hoặc bg-primary-700 trong đánh dấu. Di chuột một mẫu để xem cả hai tên.

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

Vì các bước được tính toán từ chủ đề của bạn chứ không phải được mã hóa cứng nên lưới này không phải là hình ảnh về màu sắc của Frutjam. Đó là màu sắc của bạn. Chuyển đổi chủ đề và mọi mẫu màu ở trên sẽ di chuyển theo chủ đề đó, đó cũng là lý do tại sao không có giá trị hex nào được in bên cạnh chúng.

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>
Biến CSSSự miêu tả
--color-{color}-5080% độ sáng, 20% màu
--color-{color}-100Ánh sáng 65%, màu sắc 35%
--color-{color}-20050% ánh sáng, 50% màu sắc
--color-{color}-300Ánh sáng 35%, màu sắc 65%
--color-{color}-400Ánh sáng 18%, màu sắc 82%
--color-{color}-500bản thân màu sắc, giống như --color-{color}
--color-{color}-60018% bóng tối, 82% màu sắc
--color-{color}-700Tối 34%, màu 66%
--color-{color}-80050% đậm, 50% màu
--color-{color}-90065% tối, 35% màu
--color-{color}-95080% tối, 20% màu

Các lớp tiện ích màu sắc

Tất cả các màu Frutjam đều hoạt động với mọi tiện ích màu CSS Tailwind. Thay thế {color} với bất kỳ tên màu nào từ bảng trên, tùy chọn theo sau là một bước từ thang điểm 50-950: bg-primary, bg-primary-100, text-error-900, border-success-300.

Lớp họcSự miêu tả
bg-{color}Màu nền
text-{color}Màu văn bản
border-{color}Màu viền
ring-{color}Màu nhẫn
outline-{color}Màu phác thảo
shadow-{color}Màu bóng
fill-{color}Màu tô SVG
stroke-{color}Màu nét SVG
decoration-{color}Màu sắc trang trí văn bản
caret-{color}Màu dấu mũ đầu vào
placeholder-{color}Màu văn bản giữ chỗ
divide-{color}Màu đường viền ngăn cách
{utility}-{color}-{step}Bất kỳ điều nào ở trên ở một bước quy mô, ví dụ 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>

Công cụ sửa đổi độ mờ

Kiểm soát độ mờ màu bằng /{value} công cụ sửa đổi, giống như bất kỳ màu Tailwind nào.

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>

Mềm mại & năng động

Các biến thể nhận biết trạng thái dành cho các thành phần tương tác, tự động thích ứng với chủ đề sáng và tối.

Biến CSSSự miêu tả
--color-{color}-softNền nhuốm màu tinh tế cho các biến thể mềm mại
--color-on-{color}-softMàu văn bản để sử dụng trên nền mềm
--color-{color}-activeBóng tối/sáng cho trạng thái di chuột và hoạt động
--color-bodyMàu văn bản nội dung được tính toán (được làm mềm một chút từ on-base)

Biến CSS chủ đề

Đây là các mã thông báo gốc mà bạn xác định khi tạo chủ đề tùy chỉnh. Tất cả các mã thông báo màu khác được tính toán tự động từ những mã này.

Biến CSSSự miêu tả
--scheme-colorCách phối màu: light hoặc dark
--border-radiusBán kính đường viền cơ sở cho các thành phần
--color-baseMàu nền trang
--color-on-baseMàu văn bản mặc định trên nền cơ sở
--color-neutralMàu bề mặt trung tính
--color-on-neutralMàu văn bản trên bề mặt trung tính
--color-primaryMàu thương hiệu chính
--color-on-primaryMàu văn bản trên nền chính
--color-secondaryMàu thương hiệu phụ
--color-on-secondaryMàu văn bản trên nền phụ
--color-accentMàu nhấn
--color-on-accentMàu văn bản trên nền có điểm nhấn
--color-infoMàu thông tin
--color-on-infoMàu văn bản trên nền thông tin
--color-successMàu thành công
--color-on-successMàu văn bản trên nền thành công
--color-warningMàu cảnh báo
--color-on-warningMàu văn bản trên nền cảnh báo
--color-errorLỗi màu
--color-on-errorMàu văn bản trên nền lỗi

Ví dụ về chủ đề tùy chỉnh

Ghi đè mã thông báo gốc để tạo chủ đề tùy chỉnh. Frutjam tự động tính toán tất cả các thang đo và trạng thái.

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.