الفرق بين المراجعتين لصفحة: «Sass/functions»

مراجعة 18:58، 22 أبريل 2018

هذه قائمة بالدوال الموجودة في Sass.

`declare()‎`

تُصرّح بإمضاء (signature) خاص بلغة Sass لأجل دوال Ruby. يتضمن الإمضاءُ أسماءَ الوسائط، وهل ستأخذ الدالة عددًا متغيرًا من الوسائط، وما إن كانت الدالة ستقبل مجموعة عشوائيةً من الوسائط المُسمّاة (keyword arguments).

`random_number_generator()‎`

تُعيد المولد الداخلي للأعداد العشوائية في Sass.

`random_seed()‎`

تضبِطُ قيمةَ بذرة (seed) التوليد العشوائي المستخدمة من قبل المولد الداخلي للأعداد العشوائية في Sass.

`signature()‎`

تحدد الدالة ()signature الإمضاء (signature) الصحيح لعدد الوسائط المُمرّرة إلى دالة معينة. في حالة عدم التطابق مع أيٍّ من الإمضاءات، فسيُعاد الإمضاء الأول في رسالة الخطأ.

`abs()‎`

تعيد الدالة abs()‎ القيمة المطلقة لعددٍ مُمرِّرٍ إليها.

`adjust_color()‎`

تزيد الدالة adjust_color أو تقلل خاصية واحدة أو أكثر من خاصيات لونٍ. يمكنها أن تُغيّر شفافية وتشبّع وقيمة اللون الأحمر والأخضر والأزرق. تُحدّد الخاصيات على شكل وسائط مُسمّاة، وتُضاف أو تُنقص من القيمة الحالية لخاصية اللون تلك.

`adjust_hue()‎`

تُغير صبغة اللون. إذ تأخذ لونًا وعددًا من الدرجات (يكون عادةً ما بين ‎-‎360deg و 360deg) ، وتُعيد لونًا مع تدوير الصبغة (hue) على طول اللون بالمقدار المُحدّد.

`alpha()‎`

تعيد الدالة ()alpha‎ مكوّن الشفافية (opacity)، تكون قيمته عادةً 1، إلا في حال إعطائه قيمةً أخرى.

`append()‎`

تُضيف الدالة append()‎ قيمة ما إلى قائمةٍ.

`blue()‎`

تعيد الدالة ()blue‎ المركّب الأزرق للون معيّن، وقد تُحسب من الصيغة HSL عند الضرورة عبر هذه الخوارزمية.

`call()‎`

الدالة ()call تستدعي دالة بشكل ديناميكي، سواء كانت الدالة مُعرّفة من قبل المستخدم أو كانت مُضمّنةً أو دالة CSS. ينبغي تمرير كل الوسائط، بما فيها الوسائط المُسمّاة (keyword arguments) للدالة المُستدعاة.

`ceil()‎`

تعيد الدالة ()ceil‎ أقرب عدد صحيحٍ أكبر من الوسيط المٌمرّر.

`change_color()‎`

تغيّر الدالة ()change_color خاصيات اللون: الأحمر والأخضر والأزرق والتشبع (saturation) والصبغة (hue) والشفافية. تُحدَّد الخاصيات على شكل وسائط مُسمّاة. وتُعوَِّض القيم الحالية لتلك الخاصيات في اللون.

`comparable()‎`

تحدد الدالة comparable()‎ ما إذا كان بالإمكان القيام بعمليات الإضافة أو الطرح أو المقارنة بين عددين.

`complement()‎`

تعيد الدالة ()complement مكمّل اللون (complement of a color). وهي تكافئ استدعاء الدالة adjust-hue(color, 180deg)‎.

`content_exists()‎`

تحدّد الدالة content_exists()‎ ما إذا مُرِّرت كتلةٌ من المحتوى إلى المخلوط (mixin).

`counter()‎`

الدالة ()counter موجودة فقط كحل بديل للعلة content: counter الموجودة في متصفح IE7. وتعمل بشكل مماثل مع أي دالة من دوال CSS، إلا أنها تتجنب إضافة مسافات بين فواصل الوسائط.

`counters()‎`

الدالة ()counters موجودة فقط كحل بديل للعلة content: counter الموجودة في متصفح IE7. وتعمل بشكل مماثل مع أي دالة من دوال CSS، إلا أنها تتجنب إضافة مسافات بين فواصل الوسائط.

`darken()‎`

تجعل الدالة ()darken اللون أكثر ظلمة. وتأخذ لونا وعددا بين ‎0% و ‎100%.وتعيد لونًا بعد تقليل الإضاءة.

`desaturate()‎`

تجعل الدالة ()desaturate اللون أقل تشبُّعًا. وتأخذ لونًا وعددًا بين ‎0% و ‎100%، وتعيد لونًا بعد زيادة التشبع.

`feature_exists()‎`

تحدّد الدالة feature_exists()‎ ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل Sass.

`floor()‎`

تعيد الدالة floor()‎ العدد الصحيح الأقرب والأصغر من العدد ‎$number.

`function_exists()‎`

تحدّد الدالة function_exists()‎ ما إذا كانت دالة ما موجودةً.

`get_function()‎`

تعيد الدالة ()get_function مرجعًا إلى دالة من أجل استدعائها لاحقًا باستخدام الدالة ()call.

`global_variable_exists()‎`

تحدّد الدالة global_variable_exists()‎ ما إذا كان متغير ما موجودًا في النطاق العام (global scope)، أي في المستوى الأعلى من الملف.

`grayscale()‎`

تجعل الدالة ()grayscale اللون بتدرج الرمادي. وهي تكافئ استدعاء الدالة desaturate(color, 100%)‎.

`green()‎`

تجعل الدالة ()grayscale اللون بتدرج الرمادي. وهي تكافئ استدعاء الدالة desaturate(color, 100%)‎.

`hsl()‎`

تُنشئ لونًا انطلاقا من قيم الصبغة (hue) والتشبع (saturation) والإضاءة (lightness). تستخدم الدالة خوارزمية من مواصفات CSS.

`hsla()‎`

تُنشئ لونًا انطلاقا من قيم الصبغة (hue) والتشبع (saturation) والإضاءة (lightness) والشفافية (alpha). تستخدم الدالة خوارزمية من مواصفاتCSS.

`hue()‎`

تُعيدُ الدالة ()hue مُكوّن الصبغة الخاص باللون.

`ie_hex_str()‎`

تحوّل الدالة ()ie_hex_str اللون إلى صيغة تفهمها الخاصية filters التابعة لمتصفح IE.

`if()‎`

تعيد الدالة ()if قيمة واحدةً من بين قيمتين، اعتمادًا على ما إذا كان ‎$condition صحيحًا أم لا. تمامًا مثل ‎@if، تُعدّ جميع القيم صحيحةً باستثناءfalse و null.

`index()‎`

تعيد الدالة index()‎ موضع عنصرٍ في القائمة. إن لم يكن العنصر موجودًا فستعيد القيمة المعدومة null. لاحظ أنه على عكس بعض اللغات ، يكون رقم العنصر الأول في قوائم Sass هو 1، والثاني رقمه 2، وهكذا.

`inspect()‎`

تعيد الدالة inspect()‎ سلسلة نصّية تحتوي قيمة تمثيلها في Sass.

`invert()‎`

تعيد الدالة ()invert معكوس اللون. أي تعكس قيم المركبات الحمراء والخضراء والزرقاء دون المساس بالشفافية (opacity).

`is_bracketed()‎`

تحدد الدالة is_bracketed()‎ ما إذا كانت القائمة تستخدم الأقواس المربعة أم لا.

`is_superselector()‎`

تبيّن الدالة is_superselector()‎ ما إذا كان ‎$super محدّدًا فائقًا (superselector) للمحدد ‎$sub. هذا يعني أنّ ‎$super يُطابق جميع العناصر التي يطابقها ‎$sub ، بالإضافة إلى عناصر أخرى. عمومًا، تميل المحددات الأبسط إلى أن تكون محدّدات فائقة للمحددات الأكثر تعقيدًا.

`join()‎`

تجمع الدالة join()‎ قائمتين في قائمة واحدة.

`keywords()‎`

تعيد الدالة keywords()‎ قاموسًا من الوسائط المسماة المُمرّرة إلى دالة أو مخلوط (mixin) والذي يأخذ قائمة متغيرةً من الوسائط. اسماء الوسائط هي سلاسل نصيةٌ، ولا تحتوي على البادئة $.

`length()‎`

تعيد الدالة ()length طول قائمة.

`lighten()‎`

تجعل الدالة ()lighten اللون أكثر إضاءةً (lightness). وتأخذ لونا وعددا بين ‎0% و ‎100% وتعيد لونًا بعد تعديل الإضاءة.♠

`lightness()‎`

تُعيدُ الدالة ()lightness مُكوّن الإضاءة (lightness) الخاص باللون.

`list_separator()‎`

تعيد الدالة list_separator()‎ فاصلة القائمة. إن لم يكن للقائمة فاصلة بسبب احتوائها على أقل من عنصرين فستعيد القيمة space.

`map_get()‎`

تعيد الدالة map_get()‎ القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة null.

`map_has_key()‎`

تحدّد الدالة map_has_key()‎ إن ما كان في القاموس قيمة مرتبطة بمفتاح معيّن.

`map_keys()‎`

تعيد الدالة map_keys()‎ قائمة مكونةً من مفاتيح القاموس.

`map_merge()‎`

تدمج الدالة map_merge()‎ قاموسين في قاموسٍ جديدٍ. المفاتيح في القاموس ‎$map2ستكون لها الأسبقية على المفاتيح في القاموس ‎$map1. هذه هي أفضل طريقة لإضافة قيم جديدة إلى قاموس.

`map_remove()‎`

تعيد الدالة map_remove()‎ قاموسًا جديدًا بعد حذف مفاتيح معيّنة منه. ومثل جميع دوال القواميس، فالدالة map_remove()‎ تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا.

`map_values()‎`

تعيد الدالة map_values()‎ قائمة مكونةً من قيم القاموس. هذه القائمة قد تحتوي على قيم مكرّرة، إن كان لعدة مفاتيح نفس القيمة.

`max()‎`

تعيد الدالة max()‎ القيمة الأكبر بين مجموعة من الأعداد. وتقبل أي عدد من المعاملات.

`min()‎`

تعيد الدالة min()‎ القيمة الأصغر بين مجموعة من الأعداد.

`mix()‎`

تمزج الدالة mix()‎ بين لونين. على وجه التحديد، فهي تأخذ متوسط كل مكون من مكونات RGB، موزونة (اختياريًا) بنسبة مئوية معيّنة. تؤخذ شفافية اللون بالحُسبان عند تعديل وترجيح المكونات.

`mixin_exists()‎`

تحدّد الدالة mixin_exists()‎ ما إذا كان مخلوطٌ (mixin) ما موجودًا.

`nth()‎`

تُعيد الدالة nth()‎ العنصر ذا الرقم n (عدد) في قائمة. لاحظ أنه على عكس بعض اللغات ، العنصر الأول في قوائم Sass يكون رقمه 1، والعنصر الثاني 2، وهكذا. يمكن لهذه الدالة أن تُعيد الزوج رقم n في قاموس. لاحظ أنَّ القيم السالبة تُحسب بترتيب عكسي ، بدءًا من آخر عنصر في القائمة.

`opacify()‎`

تجعل الدالة ()opacify (تٌسمّى كذلك fade_in) اللون أكثر عتامةً. تأخذ لونًا وعددًا بين 0 و 1، وتعيد لونًا مع زيادة عتامته بذلك المقدار.

`opacity()‎`

تعيد الدالة ()opacity قيمة alpha (العتامة) الخاصة بلون معين. قيمتها تساوي 1 إلا في حالة أُعطيت قيمة أخرى.

`percentage()‎`

تحوّل الدالة percentage()‎ عددًا غير ذي وحدةٍ إلى نسبة مئوية.

`quote()‎`

تُضيف الدالة quote()‎ علامات الاقتباس إلى سلسلة نصية إن لم تكن مٌقتبسة. إن كانت السلسلة مُقتبسة فستُعيدها الدالة دون تغيير.

`random()‎`

تُعيد الدالة random()‎ عددًا عشوائيًا.

`red()‎`

تعيد الدالة ()red المركّب الأحمر للون معيّن، وقد تُحسب من الصيغة HSL عند الضرورة عبر هذه الخوارزمية.

`rgb()‎`

تُنشئ الدالة ()rgb لونًا انطلاقًا من المركبات الثلاث: الأحمر والأخضر والأزرق.

`rgba()‎`

تضبط الدالة ()rgba شفافية لون معيّن، أو تُنشئ لونًا انطلاقا من المركبات: الأحمر والأخضر والأزرق والشفافية.

`round()‎`

تعيد الدالة round()‎ العدد الصحيح الأقرب للعدد ‎$number.

`saturate()‎`

تجعل الدالة ()saturate اللون أكثر تشبُّعًا. وتأخذ لونا وعددا بين ‎0% و ‎100%، وتعيد لونًا بعد زيادة التشبع.

`saturation()‎`

تُعيدُ الدالة ()saturation مُكوّن التشبع (saturation) الخاص باللون.

`scale_color()‎`

تقوم الدالة ()scale_color بالتعديل السائل (Fluidly scales) لخاصية واحدةٍ أو أكثر للّون. على عكس الدالة adjust_color()‎، التي تُغير خاصيات اللون بمقادير ثابتة، فإن ()scale_color تُغيرها بناءً على مدى ارتفاعها أو انخفاضها. هذا يعني أن إضاءة لون ساطعٍ بالفعل بواسطة()scale_colorلن يغير من السطوع كثيرًا ، ولكن إضاءة لون داكن بنفس المقدار سيغيرها بشكل أكثر حدة. هذا سيجعل للدالة scale-color($color, ...)‎ نفس التأثير بغض النظر عن اللون.

`selector_append()‎`

تعيد الدالة selector_append()‎ محدّدًا جديدًا مع إضافة جميع المحددات الموجودة في ‎$selectors إلى بعضها بعضًا كما لو كانت متشعّبة في ملف الأنماط هكذا ‎$selector1 { &$selector2 { ... } }‎.

`selector_extend()‎`

تعيد الدالة selector_extend()‎ نسخة جديدةً من المحدد ‎$selector مع توسعة ‎$extendee بواسطة ‎$extender. النتيجة تشبه الكود البرمجي التالي:

`selector_nest()‎`

تعيد الدالة selector_nest()‎ محدّدًا جديدًا مع تشعيب جميع المحددات الموجودة في ‎$selectors في بعضها البعض كما لو كانت متشعّبة في ملف الأنماط هكذا ‎$selector1 {$selector2 {...}}‎.

`selector_parse()‎`

تُحلّل (Parses) الدالة selector_parse()‎ محدّدًا من إنتاج المُستخدم إلى قائمة من قوائم السلاسل النصية كما تُعاد من قبل &.

`selector_replace()‎`

تستبدل الدالة selector_replace()‎ كل مطابقات (instances) الوسيط‎$original بواسطة ‎$replacement في ‎$selector.

`selector_unify()‎`

توحد الدالة selector_unify()‎ اثنين من المحددات في محدد واحد يطابق فقط العناصر المتطابقة في كلا المُحدّدين. تعيد الدالة القيمة المعدومةnull إن لم يكن هناك محدد من هذا القبيل.

`set()‎`

تعيد الدالة ()set_nth قائمة جديدة، بناءً على القائمة المقدمة، ولكن مع استبدال العنصر رقم ‎$n بالقيمة المعطاة. لاحظ أنه على عكس بعض اللغات، فإنّ رقم العنصر الأول في Sass هو 1، والثاني رقمه 2، وهكذا. ستعالََج قيم الفهرس ‎$n السالبة بترتيب عكسي، أي بدءًا من آخر عنصر في القائمة.

`simple_selectors()‎`

تعيد الدالة simple_selectors()‎ المحدّدات البسيطة التي يتركّب منها المحدّد المركّب ‎$selector.

`str_index()‎`

تُعيد الدالة str_index()‎ مُؤشر أول ظهور للسلسة النصية ‎$substring داخل ‎$string. إن لم تكن موجودةً فستٌعيد القيمة المعدومة null.

`str_insert()‎`

تُدرج الدالة str_insert()‎ سلسلةً نصيةً داخل أخرى. لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول هو 1، والثاني رقمه 2، وهكذا.

`str_length()‎`

تُعيد الدالة str_length()‎ عدد حروف السلسلة النصية.

`str_slice()‎`

تستخرج الدالة str_slice()‎ سلسلةً نصيةً من ‎$string، ستبدأ السلسلة المُستخرجة من المؤشر رقم ‎$start-atوتنتهي عند ‎$end-at. لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في لغة Sass هو 1، والثاني رقمه 2، وهكذا.

`to_lower_case()‎`

تحوّل الدالة to_lower_case()‎ سلسة نصيةً إلى الحروف الصغيرة.

`to_upper_case()‎`

تحوّل الدالة to_upper_case()‎ لسلسة نصيةً إلى الحروف الكبيرة.

`transparentize()‎`

تجعل الدالة ()transparentize (تُسمى ايضًا fade_out) اللون أكثر شفافيةً. تأخذ لونًا وعددًا بين 0 و 1، وتعيد لونًا مع تخفيض عتامته (opacity) بذلك المقدار.

`type_of()‎`

تعيد الدالة type_of()‎ نوع قيمة معينة.

`unique_id()‎`

تعيد الدالة ()unique_id معرفًا فريدًا للغة CSS. يعاد المُعرّف على شكل سلسلة نصية غير مقتبسة. فَرادَةُ (وحدانية) المُعرف ليست مضمونة إلا في نطاق التشغيل الراهن (single run) لـ Sass.

`unit()‎`

تعيد الدالة unit()‎ الوحدة (الوحدات) المرتبطة بعدد معين. تُرتّب الوحدات المعقدة بالترتيب الأبجدي بحسب البسط والمقام.

`zip()‎`

تجمع الدالة zip()‎ قائمتين في قائمة واحدة.