تخطي إلى المحتوى الرئيسي انتقل إلى ملاحة المستندات
Check
in English

متغيرات CSS

استخدم خصائص CSS المخصصة لـ Bootstrap للتصميم والتطوير السريع والمستقبلي.

يتضمن Bootstrap العديد من خصائص CSS المخصصة (المتغيرات) في CSS المترجمة للتخصيص في الوقت الفعلي دون الحاجة إلى إعادة ترجمة Sass. يوفر ذلك وصولاً سهلاً إلى القيم شائعة الاستخدام مثل ألوان السمات ونقاط التوقف ومجموعات الخطوط الأساسية عند العمل في فاحص المتصفح أو صندوق حماية الكود أو النماذج الأولية العامة.

جميع خصائصنا المخصصة مسبوقة بـbs- لتجنب التعارض مع CSS لجهة خارجية.

متغيرات الجذر

فيما يلي المتغيرات التي نقوم بتضمينها (لاحظ أن :rootالمطلوب) التي يمكن الوصول إليها في أي مكان يتم فيه تحميل CSS الخاص بـ Bootstrap. إنها موجودة في _root.scssملفنا ومضمنة في ملفات dist المجمعة لدينا.

:root {
  --bs-blue: #0d6efd;
  --bs-indigo: #6610f2;
  --bs-purple: #6f42c1;
  --bs-pink: #d63384;
  --bs-red: #dc3545;
  --bs-orange: #fd7e14;
  --bs-yellow: #ffc107;
  --bs-green: #198754;
  --bs-teal: #20c997;
  --bs-cyan: #0dcaf0;
  --bs-black: #000;
  --bs-white: #fff;
  --bs-gray: #6c757d;
  --bs-gray-dark: #343a40;
  --bs-gray-100: #f8f9fa;
  --bs-gray-200: #e9ecef;
  --bs-gray-300: #dee2e6;
  --bs-gray-400: #ced4da;
  --bs-gray-500: #adb5bd;
  --bs-gray-600: #6c757d;
  --bs-gray-700: #495057;
  --bs-gray-800: #343a40;
  --bs-gray-900: #212529;
  --bs-primary: #0d6efd;
  --bs-secondary: #6c757d;
  --bs-success: #198754;
  --bs-info: #0dcaf0;
  --bs-warning: #ffc107;
  --bs-danger: #dc3545;
  --bs-light: #f8f9fa;
  --bs-dark: #212529;
  --bs-primary-rgb: 13, 110, 253;
  --bs-secondary-rgb: 108, 117, 125;
  --bs-success-rgb: 25, 135, 84;
  --bs-info-rgb: 13, 202, 240;
  --bs-warning-rgb: 255, 193, 7;
  --bs-danger-rgb: 220, 53, 69;
  --bs-light-rgb: 248, 249, 250;
  --bs-dark-rgb: 33, 37, 41;
  --bs-white-rgb: 255, 255, 255;
  --bs-black-rgb: 0, 0, 0;
  --bs-body-color-rgb: 33, 37, 41;
  --bs-body-bg-rgb: 255, 255, 255;
  --bs-font-sans-serif: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
  --bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
  --bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));
  --bs-body-font-family: var(--bs-font-sans-serif);
  --bs-body-font-size: 1rem;
  --bs-body-font-weight: 400;
  --bs-body-line-height: 1.5;
  --bs-body-color: #212529;
  --bs-body-bg: #fff;
  --bs-border-width: 1px;
  --bs-border-style: solid;
  --bs-border-color: #dee2e6;
  --bs-border-color-translucent: rgba(0, 0, 0, 0.175);
  --bs-border-radius: 0.375rem;
  --bs-border-radius-sm: 0.25rem;
  --bs-border-radius-lg: 0.5rem;
  --bs-border-radius-xl: 1rem;
  --bs-border-radius-2xl: 2rem;
  --bs-border-radius-pill: 50rem;
  --bs-link-color: #0d6efd;
  --bs-link-hover-color: #0a58ca;
  --bs-code-color: #d63384;
  --bs-highlight-bg: #fff3cd;
}

متغيرات المكون

يستخدم Bootstrap 5 بشكل متزايد الخصائص المخصصة كمتغيرات محلية لمكونات مختلفة. بهذه الطريقة نقوم بتقليل CSS المترجمة لدينا ، والتأكد من عدم توارث الأنماط في أماكن مثل الجداول المتداخلة ، والسماح ببعض عمليات إعادة التصميم الأساسية وتوسيع مكونات Bootstrap بعد تجميع Sass.

ألق نظرة على وثائق الجدول الخاصة بنا للحصول على بعض الأفكار حول كيفية استخدامنا لمتغيرات CSS . تستخدم أشرطة التنقل الخاصة بنا أيضًا متغيرات CSS اعتبارًا من الإصدار 5.2.0. نحن نستخدم أيضًا متغيرات CSS عبر شبكاتنا - بشكل أساسي لمزاريب شبكة CSS الجديدة - مع استخدام المزيد من المكونات في المستقبل.

كلما كان ذلك ممكنًا ، سنقوم بتعيين متغيرات CSS على مستوى المكون الأساسي (على سبيل المثال ، .navbarلـ navbar ومكوناته الفرعية). هذا يقلل من التخمين حول مكان وكيفية التخصيص ، ويسمح بإجراء تعديلات سهلة من قبل فريقنا في التحديثات المستقبلية.

بادئة

تستخدم معظم متغيرات CSS بادئة لتجنب الاصطدام مع قاعدة التعليمات البرمجية الخاصة بك. هذه البادئة هي بالإضافة إلى --ما هو مطلوب في كل متغير CSS.

تخصيص البادئة عبر $prefixمتغير Sass. بشكل افتراضي ، يتم تعيينه على bs-(لاحظ الشرطة اللاحقة).

أمثلة

توفر متغيرات CSS مرونة مماثلة لمتغيرات Sass ، ولكن دون الحاجة إلى التجميع قبل تقديمها إلى المتصفح. على سبيل المثال ، نقوم هنا بإعادة تعيين أنماط الخط والارتباط الخاصة بصفحتنا باستخدام متغيرات CSS.

body {
  font: 1rem/1.5 var(--bs-font-sans-serif);
}
a {
  color: var(--bs-blue);
}

نقاط توقف الشبكة

بينما نقوم بتضمين نقاط توقف الشبكة الخاصة بنا كمتغيرات CSS (باستثناء xs) ، يجب أن تدرك أن متغيرات CSS لا تعمل في استعلامات الوسائط . هذا حسب التصميم في مواصفات CSS للمتغيرات ، ولكن قد يتغير في السنوات القادمة مع دعم env()المتغيرات. تحقق من إجابة Stack Overflow هذه للحصول على بعض الروابط المفيدة. في غضون ذلك ، يمكنك استخدام هذه المتغيرات في مواقف CSS الأخرى ، وكذلك في JavaScript.