Sass/declare

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

التصريح بالإمضاء ليس ضروريًا. ولكن بدونه لن تدعم الدالةُ الوسائط المُسمّاة.

يمكن أن يكون لدالةٍ واحدةٍ أكثر من إمضاء واحدٍ طالما أنّ كل إمضاءٍ يأخذ عددًا مختلفًا من الوسائط. ومن الممكن أيضًا أن تُصرّح بعدة إمضاءات بحيث تقبل جميعُها نفس العدد من الوسائط، ولكن في تلك الحالة لن يُستخدم إلا الإمضاء الأول، إلّا إذا استعمل المُستخدم الوسائط المُسمّاة.

البنية العامة

declare(method_name, args, options = {})

المُعامِلات

method_name

اسم الدالة التي يُصرَّح بإمضاءها.

args

مصفوفة تضم أسماء الوسائط الموجودة في إمضاء الدالة.

option

قيمتها الافتراضية هي {}، وهي قاموس يتضمن مجموعة من الخيارات القابلة للتخصيص

قاموس الخيارات (options)

‎:var_args

من النوع Boolean، قيمتها الافتراضية: false، تُحدّد ما إذا كانت الدالة ستقبل عددًا متغيرًا من الوسائط (غير المسماة) إضافةً إلى الوسائط المسماة.

‎:‎var_kwargs‎

من النوع Boolean، قيمتها الافتراضية: false، تُحدّد ما إذا كانت الدالة ستقبل وسائط مُسمّاةٍ أخرى إضافةً إلى تلك الموجودة في ‏‏‎: args. إذا كانت قيمتها true، فسيُمرّر لدالة Ruby قاموسٌ يربط بين سلاسل نصّية و قيم كوسيطٍ أخيرٍ. أمّا إن كانت قيمتها true وقيمةُ ‎:var_args تساوي false، فستحرص Sass على أن يكون الوسيط الأخير قاموسًا.

أمثلة

declare :rgba, [:hex, :alpha]
declare :rgba, [:red, :green, :blue, :alpha]
declare :accepts_anything, [], :var_args => true, :var_kwargs => true
declare :some_func, [:foo, :bar, :baz], :var_kwargs => true

مصادر

• قسم الدالة declare في صفحة الدوال في توثيق Sass الرسمي.