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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()‎signature</code> في Sass}}</noinclude> الدالة <code>()signature</code> مرجعًا إلى دالة من أج...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()‎signature</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()‎signature</code> في Sass}}</noinclude>
الدالة <code>()signature</code> مرجعًا إلى دالة من أجل استدعائها لاحقًا باستخدام الدالة <code>[[Sass/call|()call]]</code>.
تحدد الدالة <code>()signature</code> الإمضاء (signature) الصحيح لعدد الوسائط المُمرّرة إلى دالة معينة. في حالة عدم التطابق مع أيٍّ من الإمضاءات، فسيُعاد الإمضاء الأول في رسالة الخطأ.
 
إن كانت قيمة <code>‎$args</code> تساوي <code>false</code>، فقد يُشير مرجع الدالة إلى دالةٍ معرّفة في ملف الأنماط أو مضمنة في بيئة المضيف. وإن كانت قيمتها <code>false</code> سيشير إلى دالة خاصة بلغة <code>[[CSS]]</code>.


== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="sass">
<syntaxhighlight lang="sass">
signature($name, $css: false)
.signature(method_name, arg_arity, kwarg_arity)
</syntaxhighlight>
</syntaxhighlight>


== المعاملات ==
== المعاملات ==


=== <code>‎$name</code> ===
=== <code>‎$method_name</code> ===
اسم الدالة التي سيُعاد مرجعها.
اسم دالة Ruby التي ستُستدعى.


=== <code>‎$css</code> ===
=== <code>‎$arg_arity</code> ===
تحدد ما إذا كانت ستُعاد دالة للغة <code>[[CSS]]</code>.  
عدد الوسائط غير المسماة (unnamed arguments) التي مُمرِّت إلى الدالة.
 
=== <code>‎$kwarg_arity</code> ===
عدد الوسائط المسماة (keyword arguments) التي مُمرِّت إلى الدالة.  


== القيم المعادة ==
== القيم المعادة ==
مرجع دالة.
خيارات الإمضاء للإمضاء المطابق، أو القيمة <code>nil</code> إن لم يُصرّح بأي إمضاءات لهذه الدالة.
 
== أمثلة ==
مثال عن استخدام الدالة <code>get_function()‎</code>:<syntaxhighlight lang="sass">
get-function("rgb")
 
@function myfunc { @return "something"; }
get-function("myfunc")
</syntaxhighlight>


== انظر أيضًا ==
== انظر أيضًا ==
* الدالة <code>[[Sass/call|call()]]</code>‎: تستدعي دالة بشكل ديناميكي..
* الدالة <code>[[Sass/declare|declare()]]</code>‎: تصرّح بإمضاء خاص بلغة <nowiki/>[[Sass]] لأجل دوال Ruby


== مصادر ==
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#signature-instance_method قسم الدالة signature في صفحة الدوال في توثيق Sass الرسمي.]
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#signature-class_method قسم الدالة signature في صفحة الدوال في توثيق Sass الرسمي.]
[[تصنيف:Sass]]
[[تصنيف:Sass]]
[[تصنيف: Sass Function]]
[[تصنيف: Sass Function]]

مراجعة 16:47، 22 أبريل 2018

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

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

.signature(method_name, arg_arity, kwarg_arity)

المعاملات

‎$method_name

اسم دالة Ruby التي ستُستدعى.

‎$arg_arity

عدد الوسائط غير المسماة (unnamed arguments) التي مُمرِّت إلى الدالة.

‎$kwarg_arity

عدد الوسائط المسماة (keyword arguments) التي مُمرِّت إلى الدالة.

القيم المعادة

خيارات الإمضاء للإمضاء المطابق، أو القيمة nil إن لم يُصرّح بأي إمضاءات لهذه الدالة.

انظر أيضًا

  • الدالة declare()‎: تصرّح بإمضاء خاص بلغة Sass لأجل دوال Ruby

مصادر