عرض مصدر Sass/feature exists

<noinclude>{{DISPLAYTITLE: الدالة <code>()feature_exists</code> في Sass}}</noinclude>
تتحقَّق الدالة <code>feature_exists()‎</code> ما إذا كانت ميزة معيَّنةٌ موجودةٌ في وقت تشغيل [[Sass]].

الميزات المدعومة هي:
*<code>global-variable-shadowing</code>: تشير إلى أنّ متغيرًا محليًا سيحجب متغيرًا عامًّا ما لم تُستخدم <code>‎!global</code>.

*<code>extend-selector-pseudoclass</code>: تشير إلى أنّ ‎<code>[[Sass/@ rules|@extend]]</code> ستصل إلى محدِّدات الأصناف الزائفة (pseudoclasses) مثل <code>‎[[CSS/:not|:not]]</code>.

*<code>units-level-3</code>: تشير إلى الدعم الكامل للعمليات الحسابيَّة على الواحدات (unit arithmetic) باستخدام الواحدات المُعرّفة في المواصفة [http://www.w3.org/TR/css3-values Values and Units Level 3].

*<code>at-error</code>: تشير إلى أنّ التعليمة ‎<code>[[Sass/@ rules|@error]]</code> مدعومة.

*<code>custom-property</code>: تشير إلى أن مواصفات الخاصِّيَّات المُخصّصة مدعومة. هذا يعني أن الخاصيات المُخصّصة تُحلّل بشكل ثابت (parsed statically) مع معالجة الاستيفاء مثل [[SassScript]].
==البنية العامة==
<syntaxhighlight lang="sass">
feature_exists($feature)
</syntaxhighlight>
==المعاملات==
===<code>‎$feature</code>===
اسم الميزة التي نريد التحقُّق من وجودها.
==القيم المعادة==
تُعاد القيمة المنطقيَّة <code>TRUE</code>  إذا كانت الميزة مدعومة في النسخة الحاليَّة للغة [[Sass]]. خلا ذلك، تُعاد القيمة <code>FALSE</code>.
==الأخطاء والاستثناءات==
سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$feature</code> سلسلة نصيةً.
==أمثلة==
مثال عن استخدام الدالة <code>feature_exists()‎</code>. لمعرفة إن كانت الميزة ‎<code>[[Sass/@ rules#.E2.80.8E.40error|@error]]</code> متوافرةً أم لا؛ لاحظ استخدام ‎<code>[[Sass/control directives#.E2.80.8E.40if|@if]]</code> مع الدالة <code>[[Sass/unitless|unitless()‎]]</code>:<syntaxhighlight lang="sass">
@mixin adjust-location($x, $y) {
  @if unitless($x) and feature-exists(at-error) { // اختبار وجود الميزة
    @error "$x may not be unitless, was #{$x}.";
  }
  @if unitless($y) and feature-exists(at-error) { // اختبار وجود الميزة
    @error "$y may not be unitless, was #{y}.";
  }

  // اختبار أنَّ القيم المُمرَّرة إلى الدالة لها قيمة
  // فعلنا ذلك تجنبًا للمشاكل في حال لم يكن المصرّف يدعم @error
  @if not unitless($x) and not unitless($y) {
    position: relative; left: $x; top: $y;
  }
}

.selector {
  @include adjust-location(1em, 2em); // لن يظهر خطأ
}

.selector_2 {
  @include adjust-location(1, 2em); // سيظهر خطأ إن كان مصرّف اللغة يدعم إظهار الأخطاء من طرف المستخدم
}
</syntaxhighlight>ستخرج الشيفرة السابقة الناتج الآتي عند تصريفها بمصرّف Sass حديث:<syntaxhighlight lang="text">
Error: $x may not be unitless, was 1.
        on line 3 of stlye.scss, in `adjust-location'
        from line 18 of stlye.scss
  Use --trace for backtrace.
</syntaxhighlight>وستخرج الناتج الآتي عند تصريفها بمصرِّف Sass قديم:<syntaxhighlight lang="css">
.selector {
  position: relative;
  left: 1em;
  top: 2em; }
</syntaxhighlight>
==انظر أيضًا==
*الدالة <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/mixin exists|mixin_exists()]]</code>‎: تتحقَّق ما إذا كان مخلوط ما موجودًا.
==مصادر==
*[https://sass-lang.com/documentation/Sass/Script/Functions.html#feature_exists-instance_method قسم الدالة feature_exists في صفحة الدوال في توثيق Sass الرسمي.]
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]