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

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

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

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

global_variable_exists($name)

المعاملات

`‎$name`

اسم المتغير المراد التحقُّق منه. لا ينبغي أن يتضمن اسم المتغير البادئةَ $.

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

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

أمثلة

مثال عن استخدام الدالة global_variable_exists()‎ للتحقق من وجود متغير في النطاق العام باسم global-var وآخر باسم local-var:

$global-var: "value";

.selector {
  $local-var: "value";
  @if global_variable_exists(global-var) { @debug "$global-var exists"; }
  @if global_variable_exists(local-var) { @debug "$local-value exists"; }
}

ستخرج الشيفرة السابقة عند تصريفها الناتج الآتي:

style.scss:5 DEBUG: $global-var exists

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>()variable_exists</code> في Sass}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>()global_variable_exists</code> في Sass}}</noinclude>
-تحدّد الدالة <code>variable_exists()‎</code>  ما إذا كان متغير ما موجودًا في النطاق الحالي ( current scope) أو في النطاق العام (global scope).
+تتحقَّق الدالة <code>global_variable_exists()‎</code> ما إذا كان متغيِّر ما موجودًا في النطاق العام (global scope)، أي في المستوى الأعلى من الملف.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-variable_exists($name)
+global_variable_exists($name)
 </syntaxhighlight>
@@ سطر 10: / سطر 10: @@
 === <code>‎$name</code> ===
-اسم المتغير الذي نتحقق منه. لا ينبغي أن يتضمن الإسمُ  البادئةَ <code>$</code>.
+اسم المتغير المراد التحقُّق منه. لا ينبغي أن يتضمن اسم المتغير البادئةَ <code>$</code>.
 == القيم المعادة ==
-قيمة منطقية تحدد ما إذا كان المتغير مُعرّفًا في النطاق الحالي.
+تُعاد القيمة المنطقيَّة <code>TRUE</code> إذا كان المتغير مُعرّفًا في النطاق العام. خلا ذلك، تُعاد القيمة <code>FALSE</code>.
 ==  أمثلة ==
-مثال عن استخدام الدالة <code>variable_exists()‎</code>:<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>global_variable_exists()‎</code> للتحقق من وجود متغير في النطاق العام باسم <code>global-var</code> وآخر باسم <code>local-var</code>:<syntaxhighlight lang="sass">
-$a-false-value: false;
+$global-var: "value";
-variable-exists(a-false-value) // true
-variable-exists(a-null-value) // true
-variable-exists(nonexistent) // false
+.selector {
+  $local-var: "value";
+  @if global_variable_exists(global-var) { @debug "$global-var exists"; }
+  @if global_variable_exists(local-var) { @debug "$local-value exists"; }
+}
+</syntaxhighlight>ستخرج الشيفرة السابقة عند تصريفها الناتج الآتي:<syntaxhighlight lang="text">
+style.scss:5 DEBUG: $global-var exists
 </syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/function exists|function_exists()]]</code>‎: تحدد ما إذا كانت دالة ما موجودة.
+* الدالة <code>[[Sass/function exists|function_exists()]]</code>‎: تتحقَّق ما إذا كانت دالة ما موجودة.
-* الدالة <code>[[Sass/global variable exists|global_variable_exists()]]</code>‎: تحدد ما إذا كان متغير ما موجود في النطاق العام.
+* الدالة <code>[[Sass/variable exists|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#variable_exists-instance_method قسم الدالة variable_exists في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#global_variable_exists-instance_method قسم الدالة global_variable_exists في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]