Əsas məzmuna keç
FrontDepth, Ana səhifə

Dizayn sistemləri

Design token-lər və theming

Design token-lərin nə olduğu və necə qurulduğu: primitiv və semantik səviyyələrdən CSS custom property-lərə, yanıb-sönməyən tünd rejimə, token pipeline-larına, çoxbrendli theming-ə, kontrast yoxlamalarına və token-lərin idarə olunmasına qədər.

JuniorMiddleSeniorYenilənib: 16 noyabr 2026

Oxu səviyyəsi

Seçilmiş səviyyəyə qədər olan bölmələr göstərilir.

Başlamazdan əvvəl

İlkin şərt yoxdur.

Bu mövzu Junior səviyyəsindən başlayır.

JuniorKonsepsiya

Design token nədir

Design token adı olan dizayn qərarıdır: color-text-default — #1f2328, space-4 — 16px, radius-control — 6px. Ad dəyərin nə üçün olduğunu deyir, dəyər isə onun bu gün necə göründüyünü. Dizaynerlər və developer-lər adla danışır, dəyəri isə yalnız token mənbəyi bilir.

Token olmayanda eyni qərar yüzlərlə yerə əl ilə köçürülür:

CSS
.button {
  background: #0b5fff;
  border-radius: 6px;
  padding: 8px 16px;
}

.link {
  color: #0b5fff;
}

Brendin mavisi dəyişəndə kimsə bütün #0b5fff-ləri tapmalı və hər biri üçün qərar verməlidir: bu, "əsas əməliyyat rəngidir", yoxsa təsadüfən eyni mavidir? Token-lərlə komponentlər qərarın özünə istinad edir və dəyər bir yerdə dəyişir:

CSS
.button {
  background: var(--color-action-bg);
  border-radius: var(--radius-control);
  padding: var(--space-2) var(--space-4);
}

.link {
  color: var(--color-link);
}

Nə token olur

  • Rəng: fonlar, mətn, kənar xətləri, fokus halqaları, status rəngləri.
  • Boşluq və ölçü: boşluq şkalası (4, 8, 12, 16, 24…), kontrolların hündürlüyü, ikon ölçüləri.
  • Tipoqrafiya: şrift ailələri, ölçülər, qalınlıq, sətir hündürlüyü; çox vaxt text-body kimi stillərdə qruplaşdırılır.
  • Forma və dərinlik: radius, kənar qalınlığı, kölgələr, z-index qatları.
  • Hərəkət: animasiya müddətləri və easing əyriləri.

Hər rəqəmə token lazım deyil. Token o zaman özünü doğruldur ki, dəyər təkrarlanan və hər yerdə birdən dəyişməli olan qərardır.

Ortaq format

Token-lər adətən məlumat kimi saxlanılır və hər platforma üçün koda çevrilir. W3C Design Tokens Community Group bu məlumat üçün heç bir vendor-dan asılı olmayan format dərc edir: Design Tokens Format Module. Onun ilk stabil versiyası, 2025.10, 28 oktyabr 2025-ci ildə dərc olunub; bu, Community Group hesabatıdır, W3C standartı deyil. Token $value sahəsi olan obyektdir; $type bütün qrup üçün bir dəfə yazıla bilər, başqa token-ə istinad isə fiqurlu mötərizədə yazılır:

JSON
{
  "color": {
    "$type": "color",
    "blue-600": {
      "$value": { "colorSpace": "srgb", "components": [0.043, 0.373, 1], "hex": "#0b5fff" }
    },
    "action-bg": { "$value": "{color.blue-600}" }
  }
}
JuniorKonsepsiya

Səviyyələr və adlandırma: primitiv, semantik, komponent

Token dəstlərinin çoxu üç səviyyədən ibarətdir və hər səviyyə yalnız özündən aşağıdakına istinad edir.

  1. Primitiv (baza) token-lər xam dəyərləri saxlayır: palitranı və şkalaları. color-blue-600, color-gray-900, space-4. Onlar nə olduqlarına görə adlanır və hələ heç bir məna daşımır: blue-600 harada işləndiyi barədə heç nə demir.
  2. Semantik (alias) token-lər dəyərə məqsəd verir: color-bg-surface, color-text-muted, color-border-focus, color-status-danger. Onların dəyəri primitivə istinaddır. Temalar əsasən bu səviyyədə qurulur: tünd tema color-bg-surface-i ağa yox, gray-900-ə yönəldir.
  3. Komponent token-ləri (məcburi deyil) bir komponentə aiddir: button-primary-bg, input-border. Adətən semantik token-lərə istinad edir. Bir komponent bir brenddə fərqli görünməli olanda faydalıdır; hər komponentə heç kimin dəyişmədiyi onlarla token veriləndə isə baha başa gəlir.
CSS
:root {
  --color-blue-600: #0b5fff;
  --color-blue-700: #0047d6;
  --color-gray-0: #ffffff;
  --color-gray-900: #1f2328;

  --color-bg-surface: var(--color-gray-0);
  --color-text-default: var(--color-gray-900);
  --color-action-bg: var(--color-blue-600);
  --color-action-bg-hover: var(--color-blue-700);

  --button-primary-bg: var(--color-action-bg);
}

Komponentlər niyə semantik token-lərdən istifadə edir

--color-blue-600-ı oxuyan komponent qərarı koda bərkidib: "mənim fonum mavidir". Tünd rejimə və ya başqa brendə fərqli əməliyyat rəngi lazım olanda bu komponenti dəyişmək lazım gələcək. --color-action-bg-ni oxuyan komponent isə soruşur: "burada əməliyyat rəngi hansıdır?" — cavabı tema verir. Qayda belədir: komponentlər semantik və ya komponent token-lərini oxuyur, primitivləri yalnız tema faylları oxuyur. Komandalar bunu çox vaxt lint qaydası ilə qoruyur: komponent stillərində xam hex dəyərlərinə və primitiv adlara icazə verilmir.

Adlandırma

Yaxşı ad proqnozlaşdırıla bilən addır: onu axtarmadan təxmin edə bilirsən. Geniş yayılmış ardıcıllıq: kateqoriya, xassə, rol, sonra vəziyyət:

Text
color-bg-surface
color-bg-surface-raised
color-text-muted
color-border-focus
color-action-bg-hover
font-size-body

Semantik token-ləri dəyərə görə yox, rola görə adlandır: color-red yox, color-text-danger. Brend xətaları narıncı göstərməyə başladığı gün "red" adı yalana çevrilir. Şkala adlarını neytral saxla (blue-600, space-4) ki, yeni pillə əlavə edəndə qalanların adını dəyişməyəsən.

MiddleVeb platforma

CSS custom property-lərlə theming

Vebdə token-lər adətən CSS custom property-lərə çevrilir. Theming-i onların üç xüsusiyyəti işlək edir.

Miras alınırlar. -- ilə elan olunan custom property bütün nəsil elementlərə ötürülür, ta ki onlardan biri onu yenidən təyin edənə qədər. Ona görə də :root defolt dəyərləri saxlayır, tema isə sadəcə bəzi dəyərləri yenidən elan edən elementdir:

CSS
:root {
  --color-bg-surface: #ffffff;
  --color-text-default: #1f2328;
}

[data-theme="dark"] {
  --color-bg-surface: #0d1117;
  --color-text-default: #e6edf3;
}

.card {
  background: var(--color-bg-surface);
  color: var(--color-text-default);
}

Bütün səhifə tünd olsun deyə data-theme="dark"-ı <html>-ə, açıq səhifənin içində bir tünd blok üçün isə bir <section>-a qoy. Eyni .card qaydası hər iki halda işləyir, çünki hər element var()-ı özünə miras çatan dəyərlərlə həll edir.

Gec həll olunurlar. Brauzer custom property-ni parse edəndə demək olar ki, istənilən dəyəri qəbul edir və onu var() işlənən yerdə, stilləri hesablayanda yerinə qoyur. Bunun iki nəticəsi var:

  • var(--name, fallback) fallback-i yalnız --name-in dəyəri olmayanda işlədir; adətən bu, onun ağacın yuxarısında heç yerdə təyin olunmaması deməkdir. Birinci vergüldən sonrakı hər şey fallback sayılır, ona görə var(--a, red, blue)-nun fallback-i red, blue olur. Bir neçə fallback iç-içə yazılır: var(--a, var(--b, red)).
  • Yerinə qoyulan dəyər xassəyə uyğun gəlmirsə (--size: 20px; color: var(--size)), elan invalid at computed-value time olur. Bu halda xassə unset kimi davranır: color kimi miras alınan xassələr valideynin dəyərini, qalanları isə ilkin dəyərini alır. Əvvəlki color elanları artıq atılıb, fallback da işləmir, çünki --size təyin olunub.

Tipli ola bilərlər. @property custom property-ni sintaksis, miras bayrağı və ilkin dəyərlə qeydiyyata alır. Baseline 2024-dür (iyul 2024-dən yeni əlçatandır); syntax və inherits məcburidir, initial-value isə sintaksis "*" olmayanda məcburidir.

CSS
@property --color-accent {
  syntax: "<color>";
  inherits: true;
  initial-value: #0b5fff;
}

Sintaksisə uyğun gəlməyən dəyər rədd edilir, ona görə element düzgün rəngdə qalır (miras alınan dəyər və ya initial-value). Brauzer qeydiyyatdan keçmiş <color>-u animasiya edə də bilir, inherits: false isə token-in nəsil elementlərə sızmasının qarşısını alır.

JavaScript-dən getComputedStyle(element).getPropertyValue("--color-bg-surface") elementin gördüyü dəyəri oxuyur, element.style.setProperty("--color-accent", value) isə dəyəri inline təyin edir.

MiddleNümunə

Tünd rejim: sistem seçimi, istifadəçi seçimi, yanıb-sönmə olmadan

Tam tünd rejimin üç hissəsi var: sistemə uy, istifadəçiyə onu dəyişməyə imkan ver və heç vaxt ilk kadrı səhv temada çəkmə.

Sistemə uy. prefers-color-scheme media xüsusiyyəti istifadəçinin seçimini bildirir (yanvar 2020-dən Baseline, geniş əlçatandır). color-scheme-i də elan et ki, brauzerin öz UI-ı da uyğunlaşsın: defolt fon, form kontrolları, scrollbar-lar (yanvar 2022-dən Baseline, geniş əlçatandır). light-dark() funksiyası istifadə olunan rəng sxemi açıq olanda birinci rəngi, tünd olanda ikincini seçir. Ona color-scheme: light dark lazımdır və o, Baseline 2024-dür (may 2024-dən yeni əlçatandır), ona görə dəstəklədiyin brauzerləri yoxla.

CSS
:root {
  color-scheme: light dark;
  --color-bg-surface: light-dark(#ffffff, #0d1117);
  --color-text-default: light-dark(#1f2328, #e6edf3);
  --color-link: light-dark(#0b5fff, #4c8dff);
}

:root[data-theme="light"] {
  color-scheme: light;
}

:root[data-theme="dark"] {
  color-scheme: dark;
}

light-dark() olmadan eyni iş iki qayda tələb edir: tünd dəyərlər @media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) { … } } içində və bir də :root[data-theme="dark"]-da yazılır.

İstifadəçiyə seçim ver. Üç variantlı seçimi saxla — system, light və ya dark — və onu <html>-də data-theme atributu kimi göstər; system atributun olmaması deməkdir. CSS əməliyyat sistemindəki dəyişikliyə özü uyğunlaşır; matchMedia("(prefers-color-scheme: dark)")-ya yalnız JS ilə çəkilən şeylər üçün qulaq as, məsələn canvas qrafiki üçün.

Səhv temanın yanıb-sönməsi olmasın. Saxlanmış seçim React effektində tətbiq olunursa, ilk kadr defolt temada çəkilir və sonra dəyişir. Seçimi ilk paint-dən əvvəl, <head>-dəki kiçik inline skriptlə tətbiq et. Inline klassik skript olduğu üçün body parse və render olunmazdan əvvəl işləyir:

HTML
<head>
  <meta name="color-scheme" content="light dark" />
  <script>
    try {
      const theme = localStorage.getItem("theme");
      if (theme === "light" || theme === "dark") {
        document.documentElement.dataset.theme = theme;
      }
    } catch {}
  </script>
  <link rel="stylesheet" href="/app.css" />
</head>

Server render-də seçimi cookie-də də saxla ki, server dərhal <html data-theme="dark"> göndərə bilsin. Skript əvvəl <html>-in atributlarını dəyişəndə React uyğunsuzluq barədə xəbərdarlıq edir; <html>-dəki suppressHydrationWarning bunu yalnız həmin elementin atributları üçün susdurur.

MiddleTipik səhvlər

Temaları sındıran tələlər

Vaxtından əvvəl həll olunan alias. Bu, işlək brend dəyişdiricisinə oxşayır, amma qırmızı brenddə bütün düymələr mavi qalır:

CSS
:root {
  --brand-primary: blue;
  --button-bg: var(--brand-primary);
}

[data-brand="red"] {
  --brand-primary: red;
}

button {
  background: var(--button-bg);
}

Custom property-nin içindəki var() onu elan edən elementdə, yəni burada :root-da yerinə qoyulur. Nəsil elementlər düsturu yox, nəticəni (blue) miras alır. Həll: alias-ları tema təyin edə bilən hər elementdə elan et, məsələn :root, [data-brand] { --button-bg: var(--brand-primary); }, və ya hər tema bloku öz semantik token-lərini birbaşa təyin etsin.

Koda bərkidilmiş dəyərlər. #fff, rgba(0, 0, 0, 0.1), inline SVG-lərin içindəki rənglər, ağ fonlu şəkillər, JavaScript-də yazılmış qrafik palitrası. Açıq temada düzgün görünür, tünd temada sınır. İkonlarda currentColor işlət, canvas-da çəkmək üçün token-ləri getComputedStyle ilə oxu, komponent stillərindən xam dəyərləri lint ilə təmizlə.

Primitiv işlədən komponentlər. Komponentdəki var(--color-blue-600) temalı görünür, amma tünd rejimə də, başqa brendlərə də məhəl qoymur.

Səssiz yazı səhvləri. var(--color-bg-surfce) heç nə log etmir: xassə unset olur və kart şəffaflaşır. Editorda avtomatik tamamlanma üçün token adlarının siyahısını generasiya et, naməlum adları lint ilə tut, hər temada vizual reqressiya testləri işlət.

Tünd tema tərsinə çevrilmiş açıq tema deyil. Tünd fonda kölgələr demək olar ki, görünmür, ona görə hündürlük adətən daha açıq fonlarla göstərilir. Brend rənglərinə çox vaxt daha açıq pillə lazım olur: #0b5fff ağ fonda 5.13:1 verir, #0d1117 üzərində mətn kimi isə cəmi 3.69:1, yəni adi mətn üçün tələb olunan 4.5:1-dən aşağı. Hər temanın öz kontrast yoxlaması olmalıdır.

color-scheme yoxdur. Onsuz tünd temanın içində native input-lar, scrollbar-lar və <select> popup-ları açıq qalır.

Tema paint-dən sonra tətbiq olunur. Temanı effektdə və ya fetch-dən sonra təyin etmək tünd rejim bölməsində təsvir olunan yanıb-sönməyə gətirir, üstəlik bütün səhifə iki dəfə stillənir.

Heç kimin tapa bilmədiyi token-lər. gray-light-2 kimi adları olan əlli bir-birinə oxşar boz rəng insanları yenidən hex kopyalamağa vadar edir. Kiçik və sənədləşdirilmiş dəst hər şeyi əhatə edən dəstdən yaxşıdır.

SeniorVeb platforma

Bir mənbə, çox platforma: token pipeline-ı

Eyni məhsul veb, iOS və Android-də buraxılanda token-lərin bir həqiqət mənbəyi olmalıdır: pull request-lərdə redaktə olunan və ya dizayn alətindən ixrac edilən DTCG formatlı JSON faylları. Build addımı istinadları həll edir, token-lərin adlarını çevirir, vahidləri və rəngləri konvertasiya edir və hər platforma üçün kodu generasiya edir:

Text
tokens/*.tokens.json  (DTCG)
        |
        v
  Style Dictionary
        |
        +--> web/tokens.css, web/tokens.js, web/tokens.d.ts
        +--> ios/Tokens.swift
        +--> android/colors.xml, android/Tokens.kt

Ən geniş yayılmış build aləti Style Dictionary-dir. O, hər platforma üçün bir transform qrupu tətbiq edir (adları kebab və ya Pascal case-ə çevirir, ölçüləri rem-ə keçirir, rəngləri formatlayır) və faylları css/variables, javascript/es6, typescript/es6-declarations, ios-swift/class.swift, android/resources, compose/object kimi formatlarda yazır. 4-cü versiyadan DTCG formatını dəstəkləyir; sənədlərinə görə 2025.10-un tam dəstəyi hələ 5-ci versiyada üzərində işlənən məsələdir.

JavaScript
import StyleDictionary from "style-dictionary";

const sd = new StyleDictionary({
  source: ["tokens/**/*.tokens.json"],
  platforms: {
    css: {
      transformGroup: "css",
      buildPath: "dist/web/",
      files: [
        {
          destination: "tokens.css",
          format: "css/variables",
          options: { outputReferences: true },
        },
      ],
    },
    js: {
      transformGroup: "js",
      buildPath: "dist/web/",
      files: [{ destination: "tokens.js", format: "javascript/es6" }],
    },
  },
});

await sd.buildAllPlatforms();

outputReferences: true CSS-də istinadları saxlayır (--color-action-bg: var(--color-blue-600)): nəticə oxunaqlı olur, səviyyələr DevTools-da görünür. Bu seçim olmadan hər token hazır dəyər kimi yazılır və temalar primitivləri iç-içə elementlərdə dəyişəndə "vaxtından əvvəl həll olunan alias" tələsi yaranmır.

Pipeline-ı sağlam saxlayan qaydalar

  • Generasiya olunan fayllar build nəticəsidir. Heç kim tokens.css-i əl ilə redaktə etmir; review JSON diff-i üzərində aparılır.
  • Tipli çıxış. Generasiya olunan TypeScript elanları avtomatik tamamlanma verir, silinmiş token isə səssiz unset yox, kompilyasiya xətası olur.
  • Paketə versiya ver. Token-ləri semver ilə versiyalanan paket kimi dərc et: token-in adını dəyişmək və ya onu silmək breaking change-dir. Dəyərin dəyişməsi API mənasında breaking deyil, amma pikselləri dəyişir, ona görə buraxılışdan əvvəl vizual reqressiya testlərini işlət.
  • Həqiqətin bir istiqaməti. Figma kimi dizayn alətlərində mode-ları (light, dark, brend) olan variable-lar var. Mənbənin dizayn faylı, yoxsa repozitoriya olduğunu qərara al və sinxronizasiyanı bir istiqamətdə apar, yoxsa ikisi bir-birindən uzaqlaşacaq.
SeniorNümunə

Çoxbrendli theming: runtime, yoxsa build vaxtı

Platformadakı multi-brand-design-system system design məsələsi bir kod bazası və bir komponent kitabxanası tələb edir ki, bir neçə mağaza brendinə xidmət etsin; hər brendin öz görünüşü, şriftləri, funksiyaları və bazarları var. Token-lər yalnız görünüşü həll edir və məqsəd də elə budur: komponentlər brenddən xəbərsiz qalır, brend isə token dəyərlərinin dəstidir.

CSS
[data-brand="north"] {
  --font-family-brand: "Inter", system-ui, sans-serif;
  --radius-control: 4px;
  --color-action-bg: #0b5fff;
  --color-action-fg: #ffffff;
}

[data-brand="south"] {
  --font-family-brand: "Fraunces", Georgia, serif;
  --radius-control: 999px;
  --color-action-bg: #c2410c;
  --color-action-fg: #ffffff;
}

[data-brand="south"][data-theme="dark"] {
  --color-action-bg: #fb923c;
  --color-action-fg: #0d1117;
}

Temalar matris yaradır: brend × rejim (bəzən × sıxlıq və ya yüksək kontrast), və hər xana ayrıca palitradır. Son qaydaya diqqət et: #fb923c üzərində ağ mətn cəmi 2.26:1 verir, ona görə tünd tema mətn rəngini də dəyişir.

Funksiyalar və bazarlar token deyil. Feature flag-lər, dillər, valyutalar və ödəniş üsulları məlumatda saxlanan brend konfiqurasiyasına aiddir; onları token dəstinə qatmaq hər ikisini dəyişməyi çətinləşdirir. Şriftlər qismən token-dir (--font-family-brand), qismən isə yükləmə məsələsi: hər mağaza yalnız öz şrift fayllarını yükləməlidir, yoxsa hər ziyarətçi bütün brendlərin şriftlərini endirəcək.

Runtime, yoxsa build vaxtı

Runtime: CSS custom property-lərBuild vaxtı: dəyərlər hər brend üçün kompilyasiya olunur
DəyişməDərhal: atributu dəyiş (tünd rejim düyməsi, CMS-də brendə önbaxış)Başqa bundle və səhifənin yenilənməsi lazımdır
Göndərilən CSSBütün temalar bir stylesheet-də (adətən bir neçə KB dəyişən)Yalnız brendin dəyərləri
İç-içə temaTemalı alt ağac bir atributdurÇətindir
Məhdudiyyətlərvar() media query şərtlərində işləmir; dəyişmə bütün ağacı yenidən stilləyirN build, test və deploy olunmalı N artefakt

Geniş yayılmış hibrid: hər mağaza öz brendinin generasiya olunmuş tokens.css-ini yükləyir (build vaxtı), açıq/tünd rejim isə həmin brendin içində runtime atributu kimi qalır. JS tema obyektinin render zamanı stil yaratdığı runtime CSS-in-JS theming hər render-də JavaScript xərci yaradır və server komponentləri ilə pis uyuşur; CSS custom property-lər isə temanı JavaScript-dən tamamilə çıxarır.

SeniorKonsepsiya

Kontrast yoxlamaları və token-lərin idarə olunması

Hər tema üçün kontrast. WCAG 2.2-nin AA səviyyəsi mətn üçün ən azı 4.5:1 (1.4.3), iri mətn üçün (ən azı 18 punkt və ya qalın 14 punkt) 3:1 kontrast tələb edir. UI komponentləri və mənalı qrafika, o cümlədən fokus indikatorları qonşu rənglərə qarşı 3:1 tələb edir (1.4.11). Bu nisbətlər həddir və yuvarlaqlaşdırılmır: 4.49:1 keçmir. Token-lər məlumat olduğu üçün CI həqiqətən birlikdə işlənən cütləri hər brenddə və hər rejimdə yoxlaya bilər:

JavaScript
function luminance(hex) {
  const [r, g, b] = [1, 3, 5].map((i) => {
    const c = parseInt(hex.slice(i, i + 2), 16) / 255;
    return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
  });
  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
}

function contrast(a, b) {
  const [hi, lo] = [luminance(a), luminance(b)].sort((x, y) => y - x);
  return (hi + 0.05) / (lo + 0.05);
}

console.log(contrast("#ffffff", "#0b5fff").toFixed(2)); // "5.13"
console.log(contrast("#0b5fff", "#0d1117").toFixed(2)); // "3.69"

Cütləri token-lərin yanında elan et (bg-surface üzərində text-default, action-bg üzərində action-fg, bg-surface üzərində border-focus) və brend × rejim matrisinin hər hansı xanası həddən aşağı düşəndə build-i dayandır.

İdarəetmə. Token-lər dizayn sisteminin public API-sidir, ona görə istənilən API kimi diqqət tələb edir:

  • Əlavə etmək. Yeni semantik token-ə birdən çox yerdə işlənən real rol lazımdır. Yoxdursa, mövcud token-dən istifadə et və ya komponent token-i əlavə et.
  • Köhnəlmiş elan etmək. Token-i işarələ (DTCG formatında $deprecated var: true və ya izahat sətri), ən azı bir major versiya boyunca onu əvəzedicisinin alias-ı kimi saxla, build-də və ya linter-də xəbərdarlıq ver, istifadə yerlərinin adını dəyişən codemod hazırla və növbəti major versiyada sil.
  • Məsuliyyət. Yeni token-ləri kimsə təsdiqləyir, changelog hər dəyişikliyi qeyd edir, token silinməzdən əvvəl repozitoriyalar üzrə axtarış onu hələ kimin işlətdiyini göstərir.
  • Sənədləşmə. Hər token-in hər brend və rejimdəki dəyərini göstərən arayış səhifəsini generasiya et ki, heç kim JSON oxumağa məcbur qalmasın.
SeniorMüsahibə məsləhətləri

Müsahibə üçün məsləhətlər

30 saniyəlik tərif. "Design token adı olan dizayn qərarıdır: rəng, boşluq pilləsi və ya şrift ölçüsü. O, məlumat kimi saxlanılır və hər platforma üçün koda generasiya olunur. Primitiv token-lər xam palitranı saxlayır, semantik token-lər dəyərlərə rol verir, komponentlər isə yalnız semantik token-ləri oxuyur. Beləliklə tema və ya brend komponentlərə toxunmadan dəyərləri dəyişir." Ardınca :root-dakı defoltları və [data-theme="dark"] üstələməsini yaz.

Gözlənilən suallar

  • Tünd rejimi necə qurardın? Custom property kimi semantik token-lər, defolt seçim kimi prefers-color-scheme, <html>-də data-theme kimi saxlanan istifadəçi seçimi, native UI üçün color-scheme və ilk paint düzgün olsun deyə <head>-də inline skript (SSR-da isə cookie).
  • Primitiv və semantik token fərqi? Dəyər və rol. blue-600 oxuyan komponentin tünd temanı niyə sındırdığını izah et.
  • Bir neçə brend üçün bir komponent kitabxanası? multi-brand-design-system məsələsinə istinad et: brenddən xəbərsiz komponentlər, brend × rejim token matrisi, funksiyalar və bazarlar üçün brend konfiqurasiyası, hər brend üçün ayrıca yüklənən şriftlər, runtime və ya build vaxtı seçimin və onun trade-off-ları.
  • Token-lər iOS və Android-ə necə çatır? Bir DTCG mənbəyi, Style Dictionary kimi build addımı, generasiya olunan platforma faylları, versiyalanan paket.
  • --x səhv dəyər saxlayanda var(--x, red) nə edir? Fallback işləmir; xassə unset olur.

Bal itirdən səhvlər

  • Token-ləri dəyərə görə adlandırmaq (rol kimi color-blue) və ya komponentlərə primitiv işlətməyə icazə vermək.
  • Temanı useEffect-də tətbiq edib yanıb-sönməni "kiçik qüsur" adlandırmaq.
  • color-scheme-i unutmaq, nəticədə form kontrolları açıq qalır.
  • Kontrastı bir dəfə açıq tema üçün yoxlayıb bütün brend və rejimlərin keçdiyini fərz etmək.
  • Feature flag-ləri və bazarları theming-in bir hissəsi saymaq.

Senior səviyyəni göstərən məqamlar

Token-lərin ətrafındakı sistemdən danış: pipeline və onun çıxışları, tipli çıxış, semver və codemod-larla köhnəltmə, CI-da matrisin hər xanası üçün kontrast yoxlaması, vizual reqressiya testləri və nəyin build vaxtı qərara alındığını, nəyin runtime-da dəyişə bildiyini aydın ifadə etmək.

JuniorYoxlama siyahısı

Design token-ləri və theming-i review edərkən nəyi yoxlamalı

Bu siyahını özün yazmadığın stil və tema kodunu review edəndə işlət: komanda yoldaşının, kitabxananın və ya AI assistentin kodunu. Token səhvləri səssizdir: açıq tema qaydasında görünür, başqa tema isə sınır.

  • Komponent stilləri yalnız semantik token-ləri oxuyurmu? Diff-də xam dəyərləri (#fff, rgba(…)) və --color-blue-600 kimi primitivləri axtar: onların hər biri qalan temalara məhəl qoymur. Inline SVG-lərdəki rəngləri (currentColor işlət) və JavaScript-dəki qrafik rənglərini də yoxla.
  • var()-ın içindəki hər ad mövcuddurmu? var(--color-bg-surfce) kimi yazı səhvi heç nə log etmir və xassəni unset edir; fallback olanda isə var(--color-bg-surfce, #fff) hər temada səssizcə ağ rəng çəkir. getComputedStyle(el).getPropertyValue("--name") təyin olunmamış token üçün "" qaytarır.
  • Dəyişiklik hər temada, kontrastla birlikdə yoxlanıbmı? data-theme-i dəyiş və dəyişən hər ekrana bax. Mətnə 4.5:1 lazımdır (iri mətnə və fokus halqalarına 3:1), rəng isə bir temada keçib başqasında keçməyə bilər: #0b5fff ağ fonda 5.13:1, #0d1117 üzərində isə cəmi 3.69:1 verir.
  • Alias yalnız :root-da elan olunub, onun istinad etdiyi token-i isə iç-içə elementdəki tema dəyişirmi? Custom property-nin içindəki var() elan olunduğu elementdə həll olunur, nəsil elementlər isə nəticəni miras alır. Ona görə :root-dakı --button-bg: var(--color-accent) elanı --color-accent-i dəyişən [data-theme] bölməsinə məhəl qoymur; alias-ı :root, [data-theme] üzərində elan et.
  • Tünd rejim color-scheme təyin edirmi və saxlanmış seçimi ilk paint-dən əvvəl tətbiq edirmi? color-scheme olmadan form kontrolları və scrollbar-lar açıq qalır. useEffect-də tətbiq olunan seçim əvvəlcə defolt temanı göstərir, sonra dəyişir; onun yeri <head>-dəki inline skriptdir (server render-də isə cookie). Tünd seçim saxlanmış halda səhifəni yenilə və ilk kadra bax.
  • Yeni token-lər rola görə adlandırılıb və API kimi idarə olunurmu? color-red yox, color-text-danger. Token-in adını dəyişmək və ya onu silmək breaking change-dir: köhnə adı növbəti major versiyaya qədər alias kimi saxla. tokens.css kimi generasiya olunan fayllar heç vaxt əl ilə redaktə olunmur.

Özünü yoxla

  • Məşq

    Kodun nəticəsini təxmin et, açıq müsahibə suallarına cavab ver və özünü qiymətləndir.

    4 nəticə sualı · 3 açıq sual

  • Quiz

    İzahlı test sualları və yekun nəticə.

    6 sual

Bu mövzudan istifadə edən praktiki işlər.