Repository navigation
Theming and Tokens vi
github-actions[bot] edited this page Nov 3, 2026
·
1 revision
English: Theming-and-Tokens.
<YugenProvider applyToDocument theme="dark" brand="sakura" dir="rtl">…</YugenProvider>| Thuộc tính | Giá trị |
|---|---|
theme |
light · dark · high-contrast
|
brand |
sakura (mặc định) · web (Fluent Blue) · teams · brand tự tạo |
dir |
ltr · rtl
|
Provider lồng nhau được (ví dụ một vùng dark trong trang light). Portal (Dialog, Menu…) tự theo provider gần nhất qua
usePortalThemeProps().
- Mở Theme Designer, chọn màu key (bậc 80).
- Kiểm tra các ô tương phản (≥ 4.5:1), chỉnh vibrancy / hue torsion nếu cần.
-
Xuất:
-
CSS → dán khối
[data-brand="ten-brand"] { --brand-10 … --brand-160 }vào CSS của bạn. - W3C Design Tokens (DTCG) → Style Dictionary 4, Figma Variables, Penpot.
-
Tokens Studio → plugin Tokens Studio for Figma (bộ
global/light/dark).
-
CSS → dán khối
- Đặt
brand="ten-brand"choYugenProvider.
Bằng code: generateBrandRamp("#0F6CBD"), rampToCss(), rampToDesignTokens(), rampToTokensStudio() — đều export từ yugen-ui.
.my-panel {
background: var(--colorNeutralBackground1);
color: var(--colorNeutralForeground2);
padding: var(--spacingL);
border-radius: var(--borderRadiusMedium);
box-shadow: var(--shadow4);
}Chỉ cần biến CSS? import "yugen-ui/tokens.css".
- Neutral cho bề mặt / chữ; brand chỉ cho CTA, trạng thái chọn, focus, link; semantic chỉ cho trạng thái.
- Không phủ brand lên diện tích lớn; gradient chỉ cho hero / minh hoạ, không bao giờ trên control.
- Chữ ≥ 4.5:1, thành phần UI ≥ 3:1; không dùng màu làm tín hiệu duy nhất.
Đầy đủ: Design.md §4 và trang Màu sắc.
Yugen UI © trandat1114 · MIT · Inspired by Microsoft Fluent 2, not a Microsoft product · Edit the wiki through the wiki/ folder · Lấy cảm hứng từ Microsoft Fluent 2, không phải sản phẩm của Microsoft · Sửa wiki qua thư mục wiki/
Use
Develop
Project
Tiếng Việt
- Trang chủ
- Bắt đầu
- Theme & token
- Câu hỏi thường gặp
- Kiến trúc
- Viết component
- Kiểm thử & CI
- Viết nội dung
- Nhánh & kênh phát hành
- Phát hành
- Cộng đồng & phân loại
- Sổ tay vận hành
Links