الدالة ()declare في Sass
تُصرّح بإمضاء (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