عرض مصدر CSS/repeating-radial-gradient

<noinclude>{{DISPLAYTITLE:الدالة <code>repeating-radial-gradient()‎</code>}}</noinclude>
الدالة <code>repeating-radial-gradient()‎</code> في CSS  تُنشِئ صورةً تحتوي على تدرجات لونية مكررة على شكل أشعة تبدأ من المبدأ، وهي شبيهة بالدالة <code>[[CSS/radial-gradient|radial-gradient()‎]]</code> وتأخذ نفس الوسائط، لكنها تُكرِّر محطات التوقف اللوني في جميع الجهات إلى ما لا نهاية، والنتيجة هي كائن من نوع البيانات <code>[[CSS/gradient|<gradient>]]</code> الذي هو نوعٌ خاصٌ من <code>[[CSS/image|<image>]]</code>.<syntaxhighlight lang="css">
/* تدرج لوني مُكرَّر يبدأ من مركز العنصر
   يبدأ باللون الأحمر ثم يتحول إلى أزرق ثم ينتهي بالأخضر */
repeating-radial-gradient(circle at center, red 0, blue, green 30px);

</syntaxhighlight>لا تملك التدرجات اللونية في CSS أبعادًا فعليةً، أي ليس لها قياس مُحدَّد ولا نسبة أبعاد، وستُعرَض حسب أبعاد العنصر المحتواة فيه.

عند كل تكرر، ستتحرك مواضع التوقف اللوني بأضعاف طول التدرج اللوني الأساسي (أي المسافة بين أوّل وآخر محطة توقف لوني)، وبالتالي سيكون موضع آخر محطة توقف لوني متوافقة مع أوّل محطة توقف لوني، وإذا كان لون البداية ولون النهاية مختلفَين، فسينتج انتقال غير تدريجي (حاد) بين اللونين.

لمّا كانت التدرجات اللونية تنتمي إلى نوع البيانات <code>[[CSS/image|<image>]]</code>، فيمكن استخدامها حيث يمكن استخدام نوع البيانات <code>[[CSS/image|<image>]]</code>، ولهذا السبب لا يمكن استخدام الدالة <code>repeating-radial-gradient()‎</code> مع الخاصية <code>[[CSS/background-color|background-color]]</code> وغيرها من الخاصيات التي تستعمل نوع البيانات <code>[[CSS/color value|<color>]]</code>.

== أمثلة ==
مثال عن تدرج لوني شعاعي يكرر اللونين الأبيض والأسود:<syntaxhighlight lang="css">
body {
  background: repeating-radial-gradient(black, black 5px, white 5px, white 10px);
}
</syntaxhighlight>مثالٌ آخر يكون الشكل النهائي للتدرج اللوني هو قطع ناقص:<syntaxhighlight lang="css">
body {
  background: repeating-radial-gradient(ellipse farthest-corner,
      red, black 5%, blue 5%, green 10%);
}
</syntaxhighlight>

==دعم المتصفحات==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|10.0 (مع السابقة <code>-webkit-</code>)
26.0
|3.6 (مع السابقة <code>-moz-</code>)
16.0
|10.0
|12.1
|5.1 (مع السابقة <code>-webkit-</code>)
6.0
|}

== البنية العامة ==
=== القيمة <code><position></code> ===
موضع التدرج اللوني، وتُحدَّد هذه القيمة كما في الخاصية <code>[[CSS/background-position|background-position]]</code> أو <code>[[CSS/transform-origin|transform-origin]]</code>، وإذا لم تُحدَّد فالقيمة الافتراضية هي <code>center</code>.

=== القيمة <code><shape></code> ===
الشكل النهائي للتدرج الوني، ويمكن أن تكون مساويةً إلى <code>circle</code> (وهذا يعني أنَّ شكل التدرج النهائي هو دائرة نصف قطرها ثابت)، أو <code>ellipse</code> (وهذا يعني أنَّ الشكل النهائي هو قطع ناقص)، وإذا لم تُحدَّد فالقيمة الافتراضية هي <code>ellipse</code>.

=== القيمة <code><extent-keyword></code> ===
هذه الكلمة المحجوزة تصف حجم الشكل النهائي للتدرج اللوني، ويُسمَح باستخدام الكلمات المحجوزة الآتية:
{| class="wikitable"
!الكلمة المحجوزة
!الشرح
|-
|<code>closest-side</code>
|يجب أن يلمس الشكل النهائي للتدرج اللوني الجانب الأقرب للمركز (للدوائر) أو كلا الجانبين الرأسي والأفقي الأقرب للمركز (للقطوع الناقصة).
|-
|<code>closest-corner</code>
|يجب أن يلمس الشكل النهائي للتدرج اللوني أقرب ركن من المركز.
|-
|<code>farthest-side</code>
|يجب أن يلمس الشكل النهائي للتدرج اللوني الجانب الأبعد للمركز (للدوائر) أو كلا الجانبين الرأسي والأفقي الأبعد للمركز (للقطوع الناقصة).
|-
|<code>farthest-side</code>
|يجب أن يلمس الشكل النهائي للتدرج اللوني أبعد ركن من المركز.
|}
ملاحظة: في الإصدارات القديمة من هذه الدالة كانت هنالك كلمات محجوزة مثل <code>cover</code> و <code>contain</code> التي تكافئ الكلمات المحجوزة المعيارية <code>farthest-corner</code> و <code>closest-side</code> على التوالي وبالترتيب، لكن لا تستعمل إلا الكلمات المعيارية، وإنما ذكرناها لتعرف بوجودها.

=== القيمة <code><color-stop></code> ===
قيمة لونيّة <code>[[CSS/color value|<color>]]</code> يتبعها -اختياريًا- موضع التوقف، ويمكن أن يكون الموضع نسبةً مئويةً <code>[[CSS/percentage|<percentage>]]</code> أو طولًا مطلقًا <code>[[CSS/length|<length>]]</code>.

=== البنية الرسمية ===
<syntaxhighlight lang="css">
repeating-radial-gradient(
  [ [ circle || <length> ][ at <position> ]? , |
    [ ellipse || [ <length> | <percentage> ]{2} ] [ at <position> ]? , |
    [ [ circle | ellipse ] || <extent-keyword> ] [ at <position> ]? , |
    at <position> ,
  ]?
  <color-stop> [ , <color-stop> ]+)
</syntaxhighlight>حيث:<syntaxhighlight lang="css">
<extent-keyword> = closest-corner | closest-side | farthest-corner | farthest-side
<color-stop> = <color> [ <percentage> | <length> ]? 
</syntaxhighlight>

== مصادر ومواصفات ==
* مواصفة [https://drafts.csswg.org/css-images-3/#repeating-gradients CSS Image Values and Replaced Content Module Level 3].
[[تصنيف:CSS]]
[[تصنيف:CSS Data Type]]