الفرق بين المراجعتين ل"Sass/function exists"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].')
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()function_exists</code> في Sass}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()function_exists</code> في Sass}}</noinclude>
تحدّد الدالة <code>function_exists()‎</code> ما إذا كانت دالة ما موجودةً.
+
تتحقَّق الدالة <code>function_exists()‎</code> إذا كانت دالةٌ ما موجودةً أم لا.
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 10: سطر 10:
  
 
=== <code>‎$name</code> ===
 
=== <code>‎$name</code> ===
اسم أو مرجع الدالة التي نتحقق من وجودها.
+
اسم أو مرجع الدالة المراد التحقُّق من وجودها.
  
 
== القيم المعادة ==
 
== القيم المعادة ==
قيمة منطقية تحدد ما إذا كانت الدالة مُعرّفةً.
+
تُعاد القيمة المنطقيَّة <code>TRUE</code> إذا كانت الدالة مُعرّفةً. خلا ذلك، تُعاد القيمة <code>FALSE</code>.
  
 
==  أمثلة ==
 
==  أمثلة ==
مثال عن استخدام الدالة <code>function_exists()‎</code>:<syntaxhighlight lang="sass">
+
مثال عن استخدام الدالة <code>function_exists()‎</code> لمعرفة إن كانت [[Sass/function directives|الدالة <code>myfunc</code> التي عرّفها المستخدم]] موجودةً أم لا:<syntaxhighlight lang="sass">
function-exists(lighten) // true
+
// تعريف الدالة myfunc
 +
@function myfunc() { @return "something"; }
  
@function myfunc { @return "something"; }
+
@if function_exists(myfunc) {
function-exists(myfunc) // true
+
  @debug "myfunc exists!";
 +
}  
 +
</syntaxhighlight>يمكن أيضًا استخدام الدالة <code>function_exists()‎</code>. لمعرفة إن كانت الدالة <code>[[Sass/content exists|content_exists()‎]]</code> متوافرةً أم لا (أضيفت هذه الدالة في الإصدار 3.5 من Sass). لاحظ استخدام التعليمة ‎<code>[[Sass/@ rules#.D8.A7.D9.84.D8.AA.D8.B9.D9.84.D9.8A.D9.85.D8.A9 .E2.80.8E.40warn|@warn]]</code> و <code>‎[[Sass/@ rules#.D8.A7.D9.84.D8.AA.D8.B9.D9.84.D9.8A.D9.85.D8.A9 .E2.80.8E.40debug|@debug]]</code>:<syntaxhighlight lang="sass">
 +
@if function_exists(content_exists) {
 +
  @debug "You can use content_exists()";
 +
} @else {
 +
  @warn "Upgrade Sass compiler";
 +
}
 +
</syntaxhighlight>ستخرج الشيفرة السابقة الناتج الآتي عند تصريفها بمصرّف Sass ذي إصدارٍ أقل من 3.5 (الإصدار الذي أُضيفتَ فيه الدالة <code>[[Sass/content exists|content_exists()‎]]</code>):<syntaxhighlight lang="text">
 +
WARNING: Upgrade Sass compiler
 +
        on line 4 of style.scss
 +
 
 +
</syntaxhighlight>وستخرج الناتج الآتي عند تصريفها بمصرِّف Sass حديث:<syntaxhighlight lang="text">
 +
style.scss:2 DEBUG: You can use content_exists()
 
</syntaxhighlight>
 
</syntaxhighlight>
  
== انظر أيضًا ==
+
== <span> </span>انظر أيضًا ==
* الدالة <code>[[Sass/global variable exists|global_variable_exists()]]</code>‎: تحدد ما إذا كان متغير ما موجود في النطاق العام.
+
* الدالة <code>[[Sass/global variable exists|global_variable_exists()]]</code>‎: تتحقَّق ما إذا كان متغير ما موجود في النطاق العام.
* الدالة <code>[[Sass/feature exists|feature_exists()]]</code>‎: تحدد ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل <code>[[Sass]]</code>.
+
* الدالة <code>[[Sass/feature exists|feature_exists()]]</code>‎: تتحقَّق ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل <nowiki/>[[Sass]].
* الدالة <code>[[Sass/mixin exists|mixin_exists()]]</code>‎: تحدد ما إذا كان مخلوط ما موجودًا.
+
* الدالة <code>[[Sass/mixin exists|mixin_exists()]]</code>‎: تتحقَّق ما إذا كان مخلوط ما موجودًا.
  
 
== مصادر ==
 
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#function_exists-instance_method قسم الدالة function_exists في صفحة الدوال في توثيق Sass الرسمي.]
+
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#function_exists-instance_method قسم الدالة function_exists في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
+
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
+
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

المراجعة الحالية بتاريخ 07:01، 20 مايو 2018

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

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

function_exists($name)

المعاملات

‎$name

اسم أو مرجع الدالة المراد التحقُّق من وجودها.

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

تُعاد القيمة المنطقيَّة TRUE إذا كانت الدالة مُعرّفةً. خلا ذلك، تُعاد القيمة FALSE.

أمثلة

مثال عن استخدام الدالة function_exists()‎ لمعرفة إن كانت الدالة myfunc التي عرّفها المستخدم موجودةً أم لا:

// تعريف الدالة myfunc
@function myfunc() { @return "something"; }

@if function_exists(myfunc) {
  @debug "myfunc exists!";
}

يمكن أيضًا استخدام الدالة function_exists()‎. لمعرفة إن كانت الدالة content_exists()‎ متوافرةً أم لا (أضيفت هذه الدالة في الإصدار 3.5 من Sass). لاحظ استخدام التعليمة ‎@warn و ‎@debug:

@if function_exists(content_exists) {
  @debug "You can use content_exists()";
} @else {
  @warn "Upgrade Sass compiler";
}

ستخرج الشيفرة السابقة الناتج الآتي عند تصريفها بمصرّف Sass ذي إصدارٍ أقل من 3.5 (الإصدار الذي أُضيفتَ فيه الدالة content_exists()‎):

WARNING: Upgrade Sass compiler
         on line 4 of style.scss

وستخرج الناتج الآتي عند تصريفها بمصرِّف Sass حديث:

style.scss:2 DEBUG: You can use content_exists()

انظر أيضًا

  • الدالة global_variable_exists()‎: تتحقَّق ما إذا كان متغير ما موجود في النطاق العام.
  • الدالة feature_exists()‎: تتحقَّق ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل Sass.
  • الدالة mixin_exists()‎: تتحقَّق ما إذا كان مخلوط ما موجودًا.

مصادر