الدالة ()content_exists في Sass

من موسوعة حسوب

تتحقَّق الدالة content_exists()‎ ما إذا مُرِّرت كتلةٌ من المحتوى إلى المخلوط (mixin).

إن لم تُستدعَ الدالة content_exists()‎ مباشرةً من مخلوطٍ ما، فسيُطلَق خطأ. لاحظ أنَّ هذه الدالة أضيفت في الإصدار 3.5 من Sass، ولن تعمل على الإصدارات القديمة من مفسّر اللغة.

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

content_exists()

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

تُعاد القيمة المنطقيَّة TRUE إذا مُرِّرت كتلة من المحتوى إلى المخلوط. خلا ذلك، تُعاد القيمة FALSE.

أمثلة

مثال عن استخدام الدالة content_exists()‎ لمعرفة إذا مُرَّرت كتلة من المحتوى إلى المخلوط needs_content. لاحظ استخدام التعليمة ‎@warn داخل ‎@if لإرسالة تحذير إلى المستخدم إن لم يُمرِّر كتلةً من المحتوى:

@mixin needs-content {
  @if not content_exists() {
    @warn "You must pass a content block!";
  }
  @else {
    padding: 1em;
    @content;
  }
}

.selector {
  @include needs-content;
}

.selector {
  @include needs-content {
    margin: 1em;
  }
}

سيظهر الناتج الآتي عند محاولة تصريف المثال السابق:

WARNING: You must pass a content block!
         on line 3 of style.scss, in `needs-content'
         from line 12 of style.scss

.selector {
  padding: 1em;
  margin: 1em; }

انظر أيضًا

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

مصادر