الفرق بين المراجعتين لصفحة: «Sass/extending»
إضافة الصفحة |
ط استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}' |
||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
توفر Sass عددًا من التّخصيصات | <noinclude>{{DISPLAYTITLE:توسعة Sass}}</noinclude> | ||
توفر Sass عددًا من التّخصيصات المتقدِّمة لأجل المستخدمين ذوي المتطلبات الفريدة. استخدام هذه الميزات يتطلب فهمًا جيدًا للغة [[Ruby]]. | |||
== تعريف دوال | == تعريف دوال مخصَّصةٍ في Sass == | ||
يمكن للمستخدمين تعريف دوال Sass خاصةً بهم باستخدام Ruby API. لمزيدٍ من | يمكن للمستخدمين تعريف دوال Sass خاصةً بهم باستخدام Ruby API. انظر لمزيدٍ من المعلومات [[Sass/functions|توثيق الدوال]]. | ||
== التخزين المؤقت (Cache Stores) == | == التخزين المؤقت (Cache Stores) == | ||
تُخزِّن Sass مؤقتًا الملفّات المُحلّلة (parsed documents) | تُخزِّن Sass مؤقتًا الملفّات المُحلّلة (parsed documents) وبذلك يمكن إعادة استخدامها دون إعادة تحليلها إلّا إن حدثت تغيرات في الملف. افتراضيًا، ستكتب Sass هذه الملفات المُخزّنة مؤقتًا في مكانٍ في نظام الملفات (filesystem) المشار إليه في <code>[[Sass/usage#.D8.A7.D9.84.D8.AA.D8.AE.D8.B2.D9.8A.D9.86 .D8.A7.D9.84.D9.85.D8.A4.D9.82.D8.AA|:cache_location]]</code>. إن لم تكن قادرًا على الكتابة على نظام الملفات أو كنت تحتاج إلى مشاركة النّسخة المُخزّنة بين عمليات النظام (system processes) وعمليات روبي، فيمكنك حينها تعريف المَخزَن المؤقت (cache store) الخاص بك وضبط الخيار <code>[[Sass/usage|:cache_store]]</code>. إن أردت الاستزادة حول إنشاء مخزنٍ مؤقتٍ، فيرجى الاطّلاع على [https://sass-lang.com/documentation/Sass/CacheStores/Base.html التوثيق المصدري]. | ||
== المستوردات المخصصة (Custom Importers) == | == المستوردات المخصصة (Custom Importers) == | ||
مستورِدات Sass هي المسؤولة عن أخذ المسارات المُمرَّرة إلى <code>[[Sass/@ rules|@import]]</code> وإيجاد الكود البرمجي للغة Sass المناسب لتلك المسارات. افتراضيًا، يُحمّّل هذا الكود من نظام | مستورِدات Sass هي المسؤولة عن أخذ المسارات المُمرَّرة إلى <code>[[Sass/@ rules|@import]]</code> وإيجاد الكود البرمجي للغة Sass المناسب لتلك المسارات. افتراضيًا، يُحمّّل هذا الكود من نظام الملفات ولكن يمكن جعل المستوردات تُحمِّل من قاعدة بيانات معيّنةٍ أو عبر البروتوكول HTTP أو جعلها تستخدم نظام تسمية مختلف للملفّات عمّا هو مُتوقّعٌ في Sass. | ||
يتولّى كل مستوردٍ مسارَ تحميلٍ واحدٍ (single load path، أو أيًّا كان المفهوم المقابل في السند الخلفي). يمكن وضع المستوردات في مصفوفات <code>[[Sass/usage|:load_paths]]</code> جنبًا إلى جنبٍ مع مسارات نظام الملفات العادية. | يتولّى كل مستوردٍ مسارَ تحميلٍ واحدٍ (single load path، أو أيًّا كان المفهوم المقابل في السند الخلفي). يمكن وضع المستوردات في مصفوفات <code>[[Sass/usage|:load_paths]]</code> جنبًا إلى جنبٍ مع مسارات نظام الملفات العادية. | ||
عند استبيان قيمة <code>[[Sass/@ rules|@import]]</code>، ستبحث Sass في مسارات التحميل عن مستوردٍ نجح في استيراد | عند استبيان قيمة <code>[[Sass/@ rules|@import]]</code>، ستبحث Sass في مسارات التحميل عن مستوردٍ نجح في استيراد المسار؛ عند إيجاد واحدٍ، فسيُستخدم الملف المُستورَد. | ||
ينبغي على المستورِدات التي أنشأها المستخدمون أن ترث من <code>Sass::Importers::Base</code>. | ينبغي على المستورِدات التي أنشأها المستخدمون أن ترث من <code>Sass::Importers::Base</code>. | ||
| سطر 18: | سطر 19: | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/file.SASS_REFERENCE.html#extending_sass قسم Extending Sass من توثيق Sass الرسمي]. | * [https://sass-lang.com/documentation/file.SASS_REFERENCE.html#extending_sass قسم Extending Sass من توثيق Sass الرسمي]. | ||
[[تصنيف:Sass|{{SUBPAGENAME}}]] | |||
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
توفر Sass عددًا من التّخصيصات المتقدِّمة لأجل المستخدمين ذوي المتطلبات الفريدة. استخدام هذه الميزات يتطلب فهمًا جيدًا للغة Ruby.
تعريف دوال مخصَّصةٍ في Sass
يمكن للمستخدمين تعريف دوال Sass خاصةً بهم باستخدام Ruby API. انظر لمزيدٍ من المعلومات توثيق الدوال.
التخزين المؤقت (Cache Stores)
تُخزِّن Sass مؤقتًا الملفّات المُحلّلة (parsed documents) وبذلك يمكن إعادة استخدامها دون إعادة تحليلها إلّا إن حدثت تغيرات في الملف. افتراضيًا، ستكتب Sass هذه الملفات المُخزّنة مؤقتًا في مكانٍ في نظام الملفات (filesystem) المشار إليه في :cache_location. إن لم تكن قادرًا على الكتابة على نظام الملفات أو كنت تحتاج إلى مشاركة النّسخة المُخزّنة بين عمليات النظام (system processes) وعمليات روبي، فيمكنك حينها تعريف المَخزَن المؤقت (cache store) الخاص بك وضبط الخيار :cache_store. إن أردت الاستزادة حول إنشاء مخزنٍ مؤقتٍ، فيرجى الاطّلاع على التوثيق المصدري.
المستوردات المخصصة (Custom Importers)
مستورِدات Sass هي المسؤولة عن أخذ المسارات المُمرَّرة إلى @import وإيجاد الكود البرمجي للغة Sass المناسب لتلك المسارات. افتراضيًا، يُحمّّل هذا الكود من نظام الملفات ولكن يمكن جعل المستوردات تُحمِّل من قاعدة بيانات معيّنةٍ أو عبر البروتوكول HTTP أو جعلها تستخدم نظام تسمية مختلف للملفّات عمّا هو مُتوقّعٌ في Sass.
يتولّى كل مستوردٍ مسارَ تحميلٍ واحدٍ (single load path، أو أيًّا كان المفهوم المقابل في السند الخلفي). يمكن وضع المستوردات في مصفوفات :load_paths جنبًا إلى جنبٍ مع مسارات نظام الملفات العادية.
عند استبيان قيمة @import، ستبحث Sass في مسارات التحميل عن مستوردٍ نجح في استيراد المسار؛ عند إيجاد واحدٍ، فسيُستخدم الملف المُستورَد.
ينبغي على المستورِدات التي أنشأها المستخدمون أن ترث من Sass::Importers::Base.