جوهرة روبي تابلر لروبي أون ريلز.
يرجى الاطلاع على الدليل المناسب للبيئة التي تختارها:
Ruby on Rails 4+ أو بيئة Sprockets الأخرى.
أطر عمل روبي الأخرى غير الموجودة على Rails.
v0.1.4 التغيير الجذري:
لم تعد الصور مضمنة بشكل افتراضي. بدلاً من ذلك، يمكنك تضمين كافة مجموعات الصور أو مجموعات الصور المحددة التي تريدها (إما المتصفح و/أو العلم و/أو الدفعات). اقرأ أدناه للحصول على مزيد من المعلومات حول كيفية القيام بذلك.
أضف bootstrap و tabler-rubygem إلى ملف Gemfile الخاص بك:
جوهرة 'bootstrap'، '~> 4.1.1'جوهرة 'tabler-rubygem'
تأكد من أن sprockets-rails هي الإصدار 2.3.2 على الأقل.
bundle install وإعادة تشغيل الخادم الخاص بك لإتاحة الملفات عبر المسار.
قم باستيراد أنماط Tabler وأنماط وأيقونات Tabler Plugin اختياريًا في app/assets/stylesheets/application.scss :
// يجب تعيين أو استيراد متغيرات الجدول المخصصة *قبل* bootstrap وtabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler.plugins"; // اختياري@import "tabler.icons"; // اختياري يشمل [المتصفح، العلم، المدفوعات]
المتغيرات المتاحة يمكن العثور عليها هنا.
تتضمن مكونات Tabler الإضافية ملفات CSS الخاصة بجافا سكريبت الموجودة هنا.
يمكنك أيضًا اختيار تضمين المكون الإضافي css على أساس كل مكون إضافي، على سبيل المثال:
// يجب تعيين أو استيراد متغيرات الجدول المخصصة *قبل* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/plugins/charts-c3/plugin.scss" ;
أو تضمين أيقونات CSS لكل نوع، على سبيل المثال:
// يجب تعيين أو استيراد متغيرات الجدول المخصصة *قبل* tabler.@import "tabler/variables";@import "bootstrap";@import "tabler";@import "tabler/icons/flag";
تأكد من أن الملف يحتوي على امتداد .scss (أو .sass لبناء جملة Sass). إذا قمت للتو بإنشاء تطبيق Rails جديد، فقد يأتي مع ملف .css بدلاً من ذلك. إذا كان هذا الملف موجودًا، فسيتم تقديمه بدلاً من Sass، لذا أعد تسميته:
$ mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss
بعد ذلك، قم بإزالة جميع عبارات *= require و *= require_tree من ملف Sass. بدلاً من ذلك، استخدم @import لاستيراد ملفات Sass.
لا تستخدم *= require في Sass وإلا فلن تتمكن أوراق الأنماط الأخرى من الوصول إلى مزيج ومتغيرات Tabler.
أضف Tabler وملحقات Tabler اختياريًا إلى application.js الخاص بك:
//= يتطلب tabler//= يتطلب tabler.plugins
يتضمن Tabler بالفعل jQuery وBootstrap javascript.
تتضمن مكونات Tabler الإضافية نصوص جافا سكريبت الموجودة هنا.
إذا قمت بالفعل بتضمين jQuery في مشروعك، فيمكنك تضمين tabler's js على أساس كل ملف لتجنب التعارضات:
// = يتطلب tabler/tabler// = يتطلب tabler/vendors/bootstrap.bundle.min// = يتطلب tabler/vendors/circle-progress.min// = يتطلب tabler/vendors/jquery.sparkline.min// = يتطلب الجدول/الأساسية
يمكنك أيضًا اختيار تضمين plugin js على أساس كل مكون إضافي، على سبيل المثال:
//= تتطلب tabler//= تتطلب tabler/plugins/charts-c3/js/d3.v3.min//= تتطلب tabler/plugins/charts-c3/js/c3.min
إذا كان إطار العمل الخاص بك يستخدم Sprockets أو Hanami، فسيتم تسجيل الأصول في Sprockets عندما تكون الجوهرة مطلوبة، ويمكنك استخدامها وفقًا لقسم Rails في الدليل.
وإلا فقد تحتاج إلى تسجيل الأصول يدويًا. ارجع إلى وثائق الإطار الخاص بك حول هذا الموضوع.
يتطلب Tabler استخدام Autoprefixer. يضيف Autoprefixer بادئات البائع إلى قواعد CSS باستخدام قيم من هل يمكنني استخدامها.
إذا كنت تستخدم tabler مع Rails، فسيتم إعداد البادئة التلقائية لك تلقائيًا. بخلاف ذلك، يرجى الرجوع إلى وثائق Autoprefixer.
بشكل افتراضي، يتم استيراد كل Tabler.
يمكنك أيضًا استيراد المكونات بشكل صريح. للبدء بقائمة كاملة من الوحدات، انسخ ملف _tabler.scss إلى أصولك باسم _tabler-custom.scss . ثم قم بالتعليق على المكونات التي لا تريدها من _tabler-custom . في ملف Sass للتطبيق، استبدل @import 'tabler' بـ:
@import 'tabler-custom';