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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()ontent_exists</code> في Sass}}</noinclude> تحدّد الدالة <code>ontent_exists()‎</code> ما إذا كان...')
 
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}')
 
(7 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE: الدالة <code>()ontent_exists</code> في Sass}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>()content_exists</code> في Sass}}</noinclude>
−
تحدّد الدالة <code>ontent_exists()‎</code>  ما إذا كان [[Sass/mixins|مخلوطٌ]] (mixin) ما موجودًا.
+
تتحقَّق الدالة <code>content_exists()‎</code>  ما إذا مُرِّرت كتلةٌ من المحتوى إلى [[Sass/mixins|المخلوط]] (mixin).
 +
 
 +
إن لم تُستدعَ الدالة <code>content_exists()‎</code> مباشرةً من [[Sass/mixins|مخلوطٍ]] ما، فسيُطلَق خطأ. لاحظ أنَّ هذه الدالة أضيفت في الإصدار 3.5 من Sass، ولن تعمل على الإصدارات القديمة من مفسّر اللغة.
  
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="sass">
 
<syntaxhighlight lang="sass">
−
ontent_exists($name)
+
content_exists()
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
== المعاملات ==
+
== القيم المعادة ==
 +
تُعاد القيمة المنطقيَّة <code>TRUE</code> إذا مُرِّرت كتلة من المحتوى إلى <nowiki/>[[Sass/mixins|المخلوط]]. خلا ذلك، تُعاد القيمة <code>FALSE</code>.
  
−
=== <code>‎$name</code> ===
+
== أمثلة ==
−
اسم [[Sass/mixins|المخلوط]] الذي نتحقق من وجوده.
+
مثال عن استخدام الدالة <code>content_exists()‎</code> لمعرفة إذا مُرَّرت كتلة من المحتوى إلى المخلوط <code>needs_content</code>. لاحظ استخدام التعليمة ‎<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/control directives#.E2.80.8E.40if|‎@if]]</code> لإرسالة تحذير إلى المستخدم إن لم يُمرِّر كتلةً من المحتوى:<syntaxhighlight lang="sass">
 +
@mixin needs-content {
 +
  @if not content_exists() {
 +
    @warn "You must pass a content block!";
 +
  }
 +
  @else {
 +
    padding: 1em;
 +
    @content;
 +
  }
 +
}
  
−
== القيم المعادة ==
+
.selector {
−
قيمة منطقية تحدد ما إذا كان [[Sass/mixins|المخلوط]] مُعرّفًا.
+
  @include needs-content;
 +
}
  
−
==  أمثلة ==
+
.selector {
−
مثال عن استخدام الدالة <code>ontent_exists()‎</code>:<syntaxhighlight lang="sass">
+
  @include needs-content {
−
mixin-exists(nonexistent) // false
+
    margin: 1em;
 +
  }
 +
}
 +
</syntaxhighlight>سيظهر الناتج الآتي عند محاولة تصريف المثال السابق:<syntaxhighlight lang="css">
 +
WARNING: You must pass a content block!
 +
        on line 3 of style.scss, in `needs-content'
 +
        from line 12 of style.scss
  
−
@mixin red-text { color: red; }
+
.selector {
−
mixin-exists(red-text) // true
+
  padding: 1em;
 +
  margin: 1em; }
 
</syntaxhighlight>
 
</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/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]].
  
 
== مصادر ==
 
== مصادر ==
−
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#ontent_exists-instance_method قسم الدالة ontent_exists في صفحة الدوال في توثيق Sass الرسمي.]
+
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#content_exists-instance_method قسم الدالة content_exists في صفحة الدوال في توثيق Sass الرسمي].
−
[[تصنيف:Sass]]
+
[[تصنيف:Sass|{{SUBPAGENAME}}]]
−
[[تصنيف: Sass Function]]
+
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

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

تتحقَّق الدالة 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.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Sass/content_exists&oldid=8774"