الفرق بين المراجعتين لصفحة: «Sass/unit»

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()unit</code> في Sass}}</noinclude> تعيد الدالة <code>unit()‎</code> نوع قيمة معينة. == الب...'
 
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].'
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()unit</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()unit</code> في Sass}}</noinclude>
تعيد الدالة <code>unit()‎</code> نوع قيمة معينة.
تعيد الدالة <code>unit()‎</code> الوحدة (أو الوحدات) المرتبطة بالعدد الممرَّر إليها. تُرتَّب الوحدات المعقَّدة بالترتيب الهجائي بحسب البسط والمقام.


== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="sass">
<syntaxhighlight lang="sass">
unit($value)
unit($number)
</syntaxhighlight>
</syntaxhighlight>


== المعاملات ==
== المعاملات ==


=== <code>‎$value</code> ===
=== <code>‎$number</code> ===
القيمة التي سيُعاد نوعها.
العدد المراد إعادة وحدته.


== القيم المعادة ==
== القيم المعادة ==
سلسلة نصية غير  مقتبسة تحتوي اسم النوع.
تُعاد سلسلة نصيَّة غير  مقتبسة تحتوي على وحدة العدد <code>‎$number</code>.
 
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إذا لم يكن المعامل <code>‎$number</code> عددًا.


==  أمثلة ==
==  أمثلة ==
مثال عن استخدام الدالة <code>unit()‎</code>:<syntaxhighlight lang="sass">
أمثلة نموذجية عن استخدام الدالة <code>unit()‎</code>:<syntaxhighlight lang="sass">
type-of(100px) // number
unit(100);                      // ""
type-of(asdf)   // string
unit(100px);                    // "px"
type-of("asdf") // string
unit(3em);                      // "em"
type-of(true)   // bool
unit(10px * 5em);              // "em*px"
type-of(#fff)   // color
unit(10px * 5em / 30cm / 1rem); // "em*px/cm*rem"
type-of(blue)  // color
 
type-of(null)   // null
type-of(a b c)  // list
type-of((a: 1, b: 2)) // map
type-of(get-function("foo")) // function
</syntaxhighlight>
</syntaxhighlight>


== انظر أيضًا ==
== انظر أيضًا ==
* الدالة <code>[[Sass/function exists|function_exists()]]</code>: تحدد ما إذا كانت دالة ما موجودة.
* الدالة <code>[[Sass/unitless|unitless()]]</code>: تتحقَّق ما إذا كان العدد الممرَّر إليها يملك وحدة أم لا.
* الدالة <code>[[Sass/inspect|inspect()]]</code>‎: تعيد سلسلة نصّية تحتوي قيمة تمثيلها في <code>[[Sass]]</code>.
* الدالة <code>[[Sass/type of|type_of()]]</code>‎: تعيد نوع القيمة الممرَّرة إليها.
* الدالة <code>[[Sass/global variable exists|global_variable_exists()]]</code>‎: تحدد ما إذا كان متغير ما موجود في النطاق العام.
* الدالة <code>[[Sass/inspect|inspect()]]</code>‎: تعيد سلسلة نصّيَّة تحتوي على قيمة تمثِّل القيمة الممرَّرة إليها في <nowiki/>[[Sass]].
* الدالة <code>[[Sass/feature exists|feature_exists()]]</code>‎: تحدد ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل <code>[[Sass]]</code>.
* <nowiki/>الدالة <code>[[Sass/global variable exists|global_variable_exists()]]</code>‎: تتحقَّق ما إذا كان متغير ما موجود في النطاق العام.
* الدالة <code>[[Sass/feature exists|feature_exists()]]</code>‎: تتحقَّق ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل <nowiki/>[[Sass]].


== مصادر ==
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#unit-instance_method قسم الدالة unit في صفحة الدوال في توثيق Sass الرسمي.]
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#unit-instance_method قسم الدالة unit في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

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

تعيد الدالة unit()‎ الوحدة (أو الوحدات) المرتبطة بالعدد الممرَّر إليها. تُرتَّب الوحدات المعقَّدة بالترتيب الهجائي بحسب البسط والمقام.

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

unit($number)

المعاملات

‎$number

العدد المراد إعادة وحدته.

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

تُعاد سلسلة نصيَّة غير مقتبسة تحتوي على وحدة العدد ‎$number.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إذا لم يكن المعامل ‎$number عددًا.

أمثلة

أمثلة نموذجية عن استخدام الدالة unit()‎:

unit(100);                      // ""
unit(100px);                    // "px"
unit(3em);                      // "em"
unit(10px * 5em);               // "em*px"
unit(10px * 5em / 30cm / 1rem); // "em*px/cm*rem"

انظر أيضًا

  • الدالة unitless()‎: تتحقَّق ما إذا كان العدد الممرَّر إليها يملك وحدة أم لا.
  • الدالة type_of()‎: تعيد نوع القيمة الممرَّرة إليها.
  • الدالة inspect()‎: تعيد سلسلة نصّيَّة تحتوي على قيمة تمثِّل القيمة الممرَّرة إليها في Sass.
  • الدالة global_variable_exists()‎: تتحقَّق ما إذا كان متغير ما موجود في النطاق العام.
  • الدالة feature_exists()‎: تتحقَّق ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل Sass.

مصادر