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

المراجعة الحالية بتاريخ 21:26، 25 مايو 2018

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

`declare()‎`

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

`random_number_generator()‎`

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

`random_seed()‎`

تحدِّد قيمةَ البذرة (seed) التي يستخدمها مولِّد الأعداد العشوائيَّة الداخلي في Sass.

`signature()‎`

تحدِّد التوقيع (signature) الصحيح لعدد الوسائط المُمرّرة إلى دالة معيَّنة.

`abs()‎`

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

`adjust_color()‎`

تزيد أو تقلِّل خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد. يمكنها أن تُغيّر شفافيَّة وتشبّع وقيمة اللون الأحمر والأخضر والأزرق.

`adjust_hue()‎`

تغيِّر قيمة مكوِّن الصبغة (hue) للون الممرَّر إليها.

`alpha()‎`

تعيد قيمة مكوّن قناة الشفافيَّة (alpha) للون الممرَّر إليها.

`append()‎`

تضيف قيمة محدَّدة إلى قائمةٍ ما.

`blue()‎`

تعيد المكوِّن الأزرق للون الممرَّر إليها.

`call()‎`

تستدعي دالة محدَّدة بشكل ديناميكي سواءً كانت هذه الدالة مُعرّفة من قبل المستخدم، أو مُضمّنةً في لغة Sass، أو دالة CSS.

`ceil()‎`

تعيد أقرب عدد صحيحٍ أكبر من العدد المٌمرّر إليها.

`change_color()‎`

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

`comparable()‎`

تتحقَّق ما إذا كان بالإمكان جمع أو طرح أو موازنة العددين الممرَّرين إليها.

`complement()‎`

تعيد مكمّل اللون (complement of a color) الممرَّر إليها.

`content_exists()‎`

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

`counter()‎`

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

`counters()‎`

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

`darken()‎`

تجعل اللون أكثر ظلمة. يمرَّر لها لونًا وعددا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل السطوع بحسب القيمة الأخيرة.

`desaturate()‎`

تجعل اللون أقل تشبُّعًا. يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل قيمة مكوِّن تشبُّعه بحسب القيمة الأخيرة.

`feature_exists()‎`

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

`floor()‎`

تعيد العدد الصحيح الأقرب والأصغر من العدد الممرَّر إليها.

`function_exists()‎`

تتحقَّق إذا كانت دالةٌ ما موجودةً أم لا.

`get_function()‎`

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

`global_variable_exists()‎`

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

`grayscale()‎`

تحوِّل الدالة ()grayscale اللون إلى تدرج الرمادي.

`green()‎`

تعيد قيمة المكوِّن الأخضر للون الممرَّر إليها.

`hsl()‎`

تنشئ لونًا جديدًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness).

`hsla()‎`

تنشئ لونًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness) والشفافيَّة (alpha).

`hue()‎`

تعيد قيمة مُكوّن الصبغة للون الممرَّر إليها.

`ie_hex_str()‎`

تحوّل اللون إلى صيغة تفهمها الخاصِّيَّة filters في المتصفح IE.

`if()‎`

تعيد إحدى القيمتين الممرَّرتين إليها اعتمادًا على تحقُّق شرط معين. تشبه تمامًا التعليمة ‎@if، إذ تُعدّ جميع القيم صحيحةً باستثناء القيمة false والقيمة null.

`index()‎`

تعيد موضع عنصرٍ في القائمة. إن لم يكن العنصر موجودًا فستعيد القيمة العدميَّة (null).

`inspect()‎`

تعيد سلسلة نصّية تحتوي على قيمة تمثِّل القيمة الممرَّرة إليها في Sass.

`invert()‎`

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

`is_bracketed()‎`

تتحقَّق ما إذا كانت القائمة تستخدم الأقواس المربعة أم لا.

`is_superselector()‎`

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

`join()‎`

تجمع قائمتين في قائمة واحدة.

`keywords()‎`

تعيد خريطة (map) تحتوي على الوسائط المسماة المُمرّرة إلى دالة أو مخلوط (mixin)، والذي يتطلب تمرير قائمة متغيرةً من الوسائط.

`length()‎`

تعيد طول القائمة الممرَّرة إليها. يمكن أيضًا لهذه الدالة أن تعيد عدد الأزواج في خريطة (map).

`lighten()‎`

تجعل اللون أكثر سطوعًا (lightness) إذ يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد بعدئذ ذلك اللون بعد زيادة السطوع بحسب القيمة الأخيرة.

`lightness()‎`

تعيد مُكوّن السطوع (lightness) للون الممرَّر إليها.

`list_separator()‎`

تعيد نوع الفاصلة المستعملة في فصل عناصر القائمة الممرَّرة إليها. إن لم تعثر الدالة على فاصلة بسبب احتواء القائمة على أقل من عنصرين، فستعيد القيمةspace.

`map_get()‎`

تعيد القيمة الموجودة في الخريطة (map) والمرتبطة بالمفتاح المُعطى. إن لم تحتوي الخريطة على ذلك المفتاح، فستعيد الدالة القيمة العدميَّة null.

`map_has_key()‎`

تتحقَّق إن كانت الخريطة (map) الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما.

`map_keys()‎`

تعيد قائمة تحتوي على مفاتيح الخريطة (map) الممرَّرة إليها فقط.

`map_merge()‎`

تدمج خريطتين (maps) في خريطة واحدة جديدة.

`map_remove()‎`

تعيد خريطة (map) جديدة بعد حذف مفاتيح معيّنة من الخريطة الممرَّرة إليها.

`map_values()‎`

تعيد قائمة تحتوي على قيم الخريطة (map) الممرَّرة إليها فقط (دون المفاتيح).

`max()‎`

تعيد القيمة الأكبر من بين مجموعة الأعداد الممرَّرة إليها. تقبل هذه الدالة عددًا غير محدَّد من المعاملات.

`min()‎`

تعيد القيمة الأصغر من بين مجموعة من الأعداد الممرَّرة إليها. تقبل هذه الدالة عددًا غير محدَّد من المعاملات.

`mix()‎`

تمزج‎ بين لونين إذ تأخذ تحديدًا متوسط كلِّ مكوِّن من مكونات RGB لكلا اللونين لتعطي اللون الناتج، ويمكن اختياريًّا تحديد نسبة المزج. تؤخذ شفافيَّة اللون بالحسبان عند تعديل ومزج المكونات بحسب نسبتها.

`mixin_exists()‎`

تتحقَّق إذا كان مخلوطٌ (mixin) ما موجودًا أم لا.

`nth()‎`

تعيد العنصر ذا الموضع المحدَّد في القائمة الممرَّرة إليها.

`opacify()‎`

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

`opacity()‎`

تعيد قيمة مكوِّن الشفافيَّة (opacity) للون الممرَّر إليها. قيمتها غالبًا تساوي 1 إلا في حال عدِّلت.

`percentage()‎`

تحوّل عددًا دون وحدة إلى نسبة مئوية.

`quote()‎`

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

`random()‎`

تعيد عددًا عشوائيًا عشريًّا يتراوح مجاله بين 0 و 1 (القيمة 1 غير داخلة في المجال) إن لم يمرَّر إليها أي قيمة. أمَّا إن مرِّر إليها قيمة، فستعيد عددًا عشوائيًّا صحيحًا يتراوح مجاله بين 1 وتلك القيمة.

`red()‎`

تعيد قيمة المكوِّن الأحمر للون الممرَّر إليها.

`rgb()‎`

تنشئ لونًا انطلاقًا من تمرير قيمة المكوِّنات الثلاث: الأحمر والأخضر والأزرق.

`rgba()‎`

تغيّر قيمة شفافيَّة لون معيّن أو تُنشئ لونًا انطلاقا من تمرير قيمة المكوِّنات: الأحمر والأخضر والأزرق وقناة الشفافيَّة (alpha).

`round()‎`

تقرِّب العدد الممرَّر إليها إلى أقرب عدد صحيح.

`saturate()‎`

تزيد من تشبُّع اللون إذ يممرَّر إليها لونًا وعددًا بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد زيادة قيمة التشبع له بحسب القيمة الأخيرة.

`saturation()‎`

تعيد قيمة مُكوّن التشبُّع (saturation) للون الممرَّر إليها.

`scale_color()‎`

تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales). أي تغيِّر الدالة ()scale_color قيمة مكوِّن اللون المحدَّد بناءً على مدى ارتفاع أو انخفاض القيمة الحاليَّة لذلك المكوِّن ضمن مجالها، وهذا مخالف لعمل الدالة adjust_color()‎ التي تستبدل بقيمة مكوَّن اللون الحاليَّة قيمةً ثابتةً معطاة.

`selector_append()‎`

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

`selector_extend()‎`

تعيد نسخةً جديدةً من المحدِّد ‎$selector مع توسعة ‎$extendee بواسطة ‎$extender.

`selector_nest()‎`

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

`selector_parse()‎`

تحلِّل محدّدًا عرّفه المُستخدم (user-provided) إلى قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.

`selector_replace()‎`

تبدِّل المعامل ‎$replacement مكان نُسخ (instances) المعامل ‎$original أينما وجدت في المحدِّد ‎$selector المعطى.

`selector_unify()‎`

توحِّد اثنين من المحدِّدات في محدِّد واحد يطابق فقط العناصر المتطابقة في كلا هذين المحدّدين. تعيد الدالة القيمة العدميَّة null إن لم يكن هناك تطابق بين المحدِّدين.

`set_nth()‎`

تعيد قائمة جديدة، بناءً على القائمة المُمرَّرة، بعد تبديل القيمة المعطاة مكان قيمة العنصر ذي الترتيب ‎$n.

`simple_selectors()‎`

تعيد المحدّدات البسيطة التي يتركّب منها المحدّد المركّب المُمرَّر إليها.

`str_index()‎`

تُعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة.

`str_insert()‎`

تدرج سلسلةً نصيةً داخل أخرى عند موضع محدَّد.

`str_length()‎`

تعيد عدد حروف السلسلة النصيَّة الممرَّرة إليها.

`str_slice()‎`

تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.

`to_lower_case()‎`

تحوِّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة (lowercase).

`to_upper_case()‎`

تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف كبيرة (uppercase).

`transparentize()‎`

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

`type_of()‎`

تعيد نوع القيمة الممرَّرة إليها.

`unique_id()‎`

تعيد معرفًا فريدًا للغة CSS. يعاد المُعرّف على شكل سلسلة نصيَّة غير مقتبسة.

`unit()‎`

تعيد الوحدة (أو الوحدات) المرتبطة بالعدد الممرَّر إليها. تُرتَّب الوحدات المعقَّدة بالترتيب الهجائي بحسب البسط والمقام.

`zip()‎`

تجمع قائمتين في قائمة واحدة.