انتقل إلى المحتوى
TopClass UI

السمات

وضع فاتح وداكن ووضعك الخاص من كتلة CSS صغيرة واحدة، دون لمس أي مكوّن.

مفاتيح الضبط

مفتاح الضبط متغيّر CSS واحد تقرؤه أصناف كثيرة. غيّره مرة واحدة، فتتبعه كل المكوّنات.

المفتاح, القيمة الافتراضية, ما يحرّكه
المفتاحالقيمة الافتراضيةما يحرّكه
--tc-radius0.5remكل استدارات الزوايا: عنصر التحكم والصندوق والشريحة
--tc-density1ارتفاع كل عنصر تحكم وحشوته
--tc-motion1كل انتقال حركي، ويصبح 0 مع prefers-reduced-motion
--tc-list-rows7عدد الصفوف التي تعرضها القائمة قبل أن تبدأ بالتمرير
--tc-ring-width2pxحلقة التركيز
--tc-line-width1pxكل الحدود

الوضع كتلة واحدة

لا يوجد كائن سمة، ولا خاصية في المزوّد للألوان. الوضع كتلة CSS يختارها data-theme.

topclassui/tokens.css
[data-theme='ocean'] {
  --tc-primary-solid: var(--color-cyan-700);
  --tc-primary-on-solid: var(--color-white);
  /* cyan-800 not cyan-700: the whole ocean soft ramp fails at cyan-700. */
  --tc-primary-on-soft: var(--color-cyan-800);
  --tc-primary-hover: var(--color-cyan-800);
  --tc-primary-active: var(--color-cyan-900);
  --tc-radius: 9999px;
}

هذا وضع المحيط كاملًا: يغيّر نبرة واحدة ومفتاح ضبط واحدًا.

حصر السمة في قسم

يعمل data-theme على أي عنصر، لا على الجذر وحده. ضعه على لوحة فيُعاد حساب كل ما بداخلها، بما في ذلك الصبغات الخفيفة وحلقة التركيز.

<section data-theme="dark" className="bg-page text-body">
  {/* every component in here is dark, including
      its focus ring and its soft tints */}
</section>
في وضع الصفحة
داخل data-theme="ocean"

ما لا يقبل التخصيص عن قصد

سلّم أحجام الخط وسلّم المسافات وبنية المكوّنات ثابتة، كي يصطفّ أي مكوّنين في صف واحد دائمًا.

إن لم تجد مفتاح الضبط الذي تحتاجه، فافتح بلاغًا. تجاوز أحد الرموز في CSS الخاص بك يعمل، لكن لا شيء يفحص تباينه بعد ذلك.
التاليمن اليمين إلى اليسار