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

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

إذا أردتَ إنشاء تدرج لوني خطي يُكرِّر نفسه حتى يملأ العنصر الحاوي له، فاستخدم الدالة الدالة <code>[[CSS/repeating-radial-gradient|repeating-radial-gradient()]]‎</code>.

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

== أمثلة ==
مثال عن تدرج لوني شعاعي بسيط:<syntaxhighlight lang="css">
body {
  background-image: radial-gradient(cyan 0%, transparent 20%, blue 40%);
}
</syntaxhighlight>تدرج لوني شعاعي لا يقع في مركز العنصر:<syntaxhighlight lang="css">
body {
  background-image: radial-gradient(farthest-corner at 40px 40px, #f35 0%, #43e 100%);
}
</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
|}

== بنية التدرجات اللونية الشعاعية ==
يُعرَّف التدرج الشعاعي بنقطة المركز، والشكل النهائي للتدرج اللوني، ونقطتَي توقف لوني أو أكثر.
[[ملف:Radial-gradient.png|بديل=توضيح بنية وتركيب التدرجات اللونية الشعاعية.|بدون|تصغير|توضيح بنية وتركيب التدرجات اللونية الشعاعية.]]
لإنشاء تدرج لوني سلس فسترسم الدالة <code>radial-gradient()‎</code> مجموعةً من الأشكال متحدة المركز التي تنتشر من المركز إلى الشكل النهائي للتدرج اللوني، (وقد تنتشر إلى ما بعده)، ويمكن أن يكون الشكل النهائي إما دائرةً أو قطعًا ناقصًا.

توضع نقاط التوقف اللوني على شعاع التدرج اللوني الوهمي (virtual gradient ray) الذي يمتد أفقيًا من المركز إلى الجهة اليمنى، وإذا كانت مواضع نقاط التوقف اللوني مُحدَّدةً عبر النسب المئوية فستكون نسبةً إلى الطول بين المركز ونقطة تقاطع شعاع التدرج مع الشكل النهائي للتدرج (الذي يُمثِّل 100%).

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

=== القيمة <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">
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/#radial-gradients CSS Image Values and Replaced Content Module Level 3].
[[تصنيف:CSS|{{SUBPAGENAME}}]]
[[تصنيف:CSS Data Type|{{SUBPAGENAME}}]]