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

المراجعة الحالية بتاريخ 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 لتوليد عدد عشوائي.

مصادر

قسم الدالة random في صفحة الدوال في توثيق Sass الرسمي.

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