الفرق بين المراجعتين ل"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>  ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل <code>[[Sass]]</code>.
+تتحقَّق الدالة <code>global_variable_exists()‎</code> ما إذا كان متغيِّر ما موجودًا في النطاق العام (global scope)، أي في المستوى الأعلى من الملف.
-الميزات التالية مدعومة:
-* <code>global-variable-shadowing</code>: تشير إلى أنّ متغيرًا محليًا سيحجب متغيراً عامًّا ما لم تُستخدم <code>‎!global</code>.
-* <code>extend-selector-pseudoclass</code>: تشير إلى أنّ ‎<code>@extend</code> ستصل إلى أشباه الأصناف (pseudoclasses) مثل <code>‎:not</code>.
-* <code>units-level-3</code>: تشير إلى الدعم الكامل لحسابيات الوحدات (unit arithmetic) باستخدام الوحدات المُعرّفة في مواصفات [[http://www.w3.org/TR/css3-values القيم والوحدات 3]].
-* <code>at-error</code>: تشير إلى أنّ المُوجّه ‎<code>@error</code> مدعوم.
-* <code>custom-property</code>: تشير إلى أن مواصفات [ا[https://www.w3.org/TR/css-variables-1 لخاصيات المُخصّصة المستوى 1]] مدعومة. وهذا يعني أن الخاصيات المُخصّصة تُحلّل بشكل ثابت (parsed statically)، مع معالجة الاستيفاء مثل <code>[[SassScript]]</code>.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-variable_exists($feature)
+global_variable_exists($name)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$feature</code> ===
+=== <code>‎$name</code> ===
-اسم الميزة.
+اسم المتغير المراد التحقُّق منه. لا ينبغي أن يتضمن اسم المتغير البادئةَ <code>$</code>.
 == القيم المعادة ==
-قيمة منطقية تحدد ما إذا كانت الميزة مدعومة في النسخة الحالية للغة <code>[[Sass]]</code>.
+تُعاد القيمة المنطقيَّة <code>TRUE</code> إذا كان المتغير مُعرّفًا في النطاق العام. خلا ذلك، تُعاد القيمة <code>FALSE</code>.
-== الأخطاء والاستثناءات ==
+==  أمثلة ==
-سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$feature</code>سلسلة نصيةً.
+مثال عن استخدام الدالة <code>global_variable_exists()‎</code> للتحقق من وجود متغير في النطاق العام باسم <code>global-var</code> وآخر باسم <code>local-var</code>:<syntaxhighlight lang="sass">
+$global-var: "value";
-==  أمثلة ==
+.selector {
-مثال عن استخدام الدالة <code>variable_exists()‎</code>:<syntaxhighlight lang="sass">
+  $local-var: "value";
-feature-exists(some-feature-that-exists) // true
+  @if global_variable_exists(global-var) { @debug "$global-var exists"; }
-feature-exists(what-is-this-i-dont-know) // false
+  @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/variable exists|variable_exists()]]</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}}]]