الفرق بين المراجعتين ل"Sass/content exists"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة الصفحة وتدقيقها.) |
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
||
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 2: | سطر 2: | ||
تتحقَّق الدالة <code>content_exists()</code> ما إذا مُرِّرت كتلةٌ من المحتوى إلى [[Sass/mixins|المخلوط]] (mixin). | تتحقَّق الدالة <code>content_exists()</code> ما إذا مُرِّرت كتلةٌ من المحتوى إلى [[Sass/mixins|المخلوط]] (mixin). | ||
− | إن لم تُستدعَ الدالة <code>content_exists()</code> مباشرةً من [[Sass/mixins|مخلوطٍ]] ما، فسيُطلَق خطأ. | + | إن لم تُستدعَ الدالة <code>content_exists()</code> مباشرةً من [[Sass/mixins|مخلوطٍ]] ما، فسيُطلَق خطأ. لاحظ أنَّ هذه الدالة أضيفت في الإصدار 3.5 من Sass، ولن تعمل على الإصدارات القديمة من مفسّر اللغة. |
== البنية العامة == | == البنية العامة == | ||
سطر 13: | سطر 13: | ||
== أمثلة == | == أمثلة == | ||
− | + | مثال عن استخدام الدالة <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 { | @mixin needs-content { | ||
− | @if not | + | @if not content_exists() { |
− | @ | + | @warn "You must pass a content block!"; |
} | } | ||
− | @content; | + | @else { |
+ | padding: 1em; | ||
+ | @content; | ||
+ | } | ||
+ | } | ||
+ | |||
+ | .selector { | ||
+ | @include needs-content; | ||
} | } | ||
+ | |||
+ | .selector { | ||
+ | @include needs-content { | ||
+ | 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 | ||
+ | |||
+ | .selector { | ||
+ | padding: 1em; | ||
+ | margin: 1em; } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 28: | سطر 49: | ||
== مصادر == | == مصادر == | ||
− | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#content_exists-instance_method قسم الدالة content_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.