نظرة عامة
تقرأ مكونات Twenty UI خصائص CSS المخصصة العامة التي تبدأ بالبادئة--t-. فضّل الرموز الدلالية مثل background.secondary وfont.color.primary عند تنسيق مكوناتك الخاصة؛ إذ تتكيف هذه القيم مع لوحة الألوان النشطة.
استخدم الرموز في الأنماط
يربطthemeCssVariables مسارات الرموز بمراجع متغيرات CSS. استخدمه للقيم التي تحلها CSS:
اقرأ القيم المحلولة
تقرأuseTheme() الرموز المحسوبة للموفر النشط. استخدمها عندما يتوقع أحد المكونات رقم JavaScript، مثل حجم الأيقونة. يحتاج الموفر إلى تحميل ورقة أنماط السمة في المتصفح لحل متغيرات CSS.
themeCssVariables هو سلسلة مرجع CSS، بما في ذلك الرموز الرقمية. لا تجرِ عمليات حسابية على تلك السلاسل. على الخادم، لا تتوفر قيم المتصفح المحلولة؛ راجع العرض على الخادم.
احصر تجاوزًا
مررapplyToRoot={false} لتطبيق سمة على شجرة فرعية. تجاوز متغيرات CSS العامة باستخدام أسمائها الكاملة:
display: contents؛ ولا ينشئ مربع تخطيط. كما يوفر حاوية للمكونات التي تدعم البوابات ذات السمات. تحتاج البوابات التي تنشئها مكتبات أخرى إلى إعداد الحاوية الخاص بها.
المتغيرات التي تبدأ بالبادئة --tw- هي تفاصيل خاصة بالمكونات. استخدم الخصائص العامة ورموز --t- بدلًا من الاعتماد على تلك المتغيرات.
راجع مرجع الرموز للاطلاع على الأسماء وقيم لوحة الألوان المتاحة.
القيم الصريحة والمقياس
يوفّر الخاصيةtheme قيم نسق JavaScript المحلولة بدلًا من قراءة الأنماط المحسوبة. ويتدفق أيضًا إلى الموفّرين المتداخلين ما لم يوفّروا نسقًا صريحًا آخر. يغيّر هذا القيم التي تقرؤها الخطافات؛ حمّل ورقة الأنماط المناسبة واستخدم تجاوزات CSS لتنسيق المكوّنات.
تكتب scale القيمة --t-scale-user في جذر المستند. يؤثر ذلك فقط في الواجهات التي يستهلك CSS الخاص بها ذلك المتغير، ويتجاهله الموفّرون المحددون النطاق. تُطبَّق className على غلاف محدد النطاق؛ وتمريرها وحدها لا ينشئ غلافًا. تنشئ overrides نطاقًا حتى عندما تبقى applyToRoot بالقيمة true.
خصائص ThemeProvider
boolean
افتراضي:"true"
Applies the color-scheme class to the document root. Set false for a scoped wrapper.
ReactNode
مطلوب
Components that share this theme.
string
Class applied to a scoped wrapper; no wrapper is created for className alone.
"dark" | "light"
مطلوب
Explicit light or dark palette; load its stylesheet before rendering.
ThemeOverrides
CSS custom-property overrides. Supplying them creates a scoped wrapper.
number
Root interface scale stored in —t-scale-user. Ignored for scoped providers; application CSS must consume the variable.
ThemeType | typeof THEME_LIGHT
Explicit resolved theme values, bypassing computed-style token resolution.