الفرق بين المراجعتين لصفحة: «Sass/random»
< Sass
لا ملخص تعديل |
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].' |
||
| (5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()random</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()random</code> في Sass}}</noinclude> | ||
تُعيد الدالة <code>random | تُعيد الدالة <code>random()</code> عددًا عشوائيًا عشريًّا يتراوح مجاله بين 0 و 1 (القيمة 1 غير داخلة في المجال) إن لم يمرَّر إليها أي قيمة. أمَّا إن مرِّر إليها قيمة، فستعيد عددًا عشوائيًّا صحيحًا يتراوح مجاله بين 1 وتلك القيمة. | ||
== البنية العامة | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
random() | random() | ||
random($limit) | random($limit) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== <code>$limit</code> === | === <code>$limit</code> === | ||
أكبر عدد صحيح موجب يمكن أن تعيده الدالة. | |||
== القيم المعادة == | == القيم المعادة == | ||
يُعاد عدد عشوائي عشري يتراوح مجاله بين 0 و 1 (القيمة 1 غير داخلة في المجال) إن لم يمرَّر إلى الدالة <code>random()</code> أي قيمة. أمَّا إن مرِّر المعامل <code>$limit</code> ، فسيُعاد حينئذ عدد صحيح يتراوح مجاله بين 1 و <code>$limit</code> (كلاهما داخل في المجال). | |||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن | سيُرمى الخطأ <code>ArgumentError</code> إن كانت قيمة المعامل <code>$limit</code> أصغر من 1. | ||
== أمثلة == | |||
مثال عن استخدام الدالة <code>random()</code> لتوليد لون عشوائي مع استخدام الدالة <code>[[Sass/rgba|rgba()]]</code>. لاحظ كيف مررنا القيمة 255 إلى الدالة <code>random()</code> لضبط الحد الأقصى لمجال القيم العشوائية إلى 255، ولاحظ كيف لم نمرِّر أيّ قيمة لها عند محاولة ضبط قيمة قناة الشفافية alpha، وبالتالي ستعيد رقمًا عشوائيًا بين 0 و 1:<syntaxhighlight lang="sass"> | |||
$random-color: rgba(random(255), random(255), random(255), random()); | |||
.selector { | |||
color: $random-color; // rgba(31, 54, 169, 0.5677176074); | |||
} | |||
</syntaxhighlight> | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/random seed|random_seed | * الدالة <code>[[Sass/random seed|random_seed()]]</code>: تحدِّد قيمةَ البذرة (seed) التي يستخدمها مولد الأعداد العشوائيَّة الداخلي في <nowiki/>[[Sass]]. | ||
* الدالة <code>[[Sass/random number generator|random_number_generator()]]</code>: | * الدالة <code>[[Sass/random number generator|random_number_generator()]]</code>: تستدعي مولد الأعداد العشوائيَّة الداخلي في <nowiki/>[[Sass]] لتوليد عدد عشوائي. | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html# | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#random-instance_method قسم الدالة random في صفحة الدوال في توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تُعيد الدالة random() عددًا عشوائيًا عشريًّا يتراوح مجاله بين 0 و 1 (القيمة 1 غير داخلة في المجال) إن لم يمرَّر إليها أي قيمة. أمَّا إن مرِّر إليها قيمة، فستعيد عددًا عشوائيًّا صحيحًا يتراوح مجاله بين 1 وتلك القيمة.
البنية العامة
random()
random($limit)
المعاملات
$limit
أكبر عدد صحيح موجب يمكن أن تعيده الدالة.
القيم المعادة
يُعاد عدد عشوائي عشري يتراوح مجاله بين 0 و 1 (القيمة 1 غير داخلة في المجال) إن لم يمرَّر إلى الدالة random() أي قيمة. أمَّا إن مرِّر المعامل $limit ، فسيُعاد حينئذ عدد صحيح يتراوح مجاله بين 1 و $limit (كلاهما داخل في المجال).
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن كانت قيمة المعامل $limit أصغر من 1.
أمثلة
مثال عن استخدام الدالة random() لتوليد لون عشوائي مع استخدام الدالة rgba(). لاحظ كيف مررنا القيمة 255 إلى الدالة random() لضبط الحد الأقصى لمجال القيم العشوائية إلى 255، ولاحظ كيف لم نمرِّر أيّ قيمة لها عند محاولة ضبط قيمة قناة الشفافية alpha، وبالتالي ستعيد رقمًا عشوائيًا بين 0 و 1:
$random-color: rgba(random(255), random(255), random(255), random());
.selector {
color: $random-color; // rgba(31, 54, 169, 0.5677176074);
}
انظر أيضًا
- الدالة
random_seed(): تحدِّد قيمةَ البذرة (seed) التي يستخدمها مولد الأعداد العشوائيَّة الداخلي في Sass.
- الدالة
random_number_generator(): تستدعي مولد الأعداد العشوائيَّة الداخلي في Sass لتوليد عدد عشوائي.