mozilla

Revision 14037 of repeating-linear-gradient()

  • Revision slug: CSS/repeating-linear-gradient
  • Revision title: repeating-linear-gradient
  • Revision id: 14037
  • Created:
  • Creator: teoli
  • Is current revision? No
  • Comment 49 words added, 11 words removed

Revision Content

{{ SeeCompatTable() }}

This works similarly to the standard linear gradients as described by {{ cssxref("linear-gradient") }}, but it automatically repeats the color stops infinitely in both directions, with their positions shifted by multiples of the difference between the last color stop's position and the first one's position.

Mozilla currently only supports CSS gradients as values of the {{ Cssxref("background-image") }} property, as well as within the shorthand {{ Cssxref("background") }}. You specify a gradient value instead of an image URL.

Syntax

repeating-linear-gradient( [ [ <angle> | to <side-or-corner> ,]? <color-stop> [, <color-stop>]+ )

Vendor prefixes: See the compatibility table below for detail on the vendor prefixes you'll need to use for gradients.

Where:

<color-stop>

{{ Xref_csscolorvalue() }} [ {{ Xref_csspercentage() }} | {{ Xref_csslength() }} ]

Values

<point>
A position, interpreted in the same way as {{ Cssxref("background-position") }} or {{ Cssxref("-moz-transform-origin") }}. This is used to define the starting point of the gradient.
<angle>
An angle of direction for the gradient. See {{ Xref_cssangle() }}.
<stop>
This value is comprised of a {{ Xref_csscolorvalue() }} value, followed by an optional stop position (either a percentage between 0% and 100% or a {{ Xref_csslength() }} along the gradient axis).
Rendering of color-stops in CSS gradients follows the same rules as color-stops in SVG gradients.

Example

background: repeating-linear-gradient(to bottom right, red, red 5px, white 5px, white 10px);

Browser compatibility

{{ CompatibilityTable() }}

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 10
-webkit-repeating-linear-gradient()
3.6 (1.9.2)
-moz-repeating-linear-gradient()
5.5 (including 8.0)
filter: progid:DXImageTransform.Microsoft.Gradient()
11.10 (Presto 2.8)
-o-repeating-linear-gradient()
Nightly build (534.16)
-webkit-repeating-linear-gradient()
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }}

See also

Revision Source

<p>{{ SeeCompatTable() }}</p>
<p>This works similarly to the standard linear gradients as described by {{ cssxref("linear-gradient") }}, but it automatically repeats the color stops infinitely in both directions, with their positions shifted by multiples of the difference between the last color stop's position and the first one's position.</p>
<p>Mozilla currently only supports CSS gradients as values of the {{ Cssxref("background-image") }} property, as well as within the shorthand {{ Cssxref("background") }}. You specify a gradient value instead of an image URL.</p>
<h2>Syntax</h2>
<pre>repeating-linear-gradient( [ [ <a href="mks://localhost/en/CSS/angle" title="angle"><em>&lt;angle&gt;</em></a> | to <em>&lt;side-or-corner&gt;</em> ,]? <em>&lt;color-stop&gt;</em> [, <em>&lt;color-stop&gt;</em>]+ )
</pre>
<p><strong>Vendor prefixes: </strong>See the compatibility table below for detail on the vendor prefixes you'll need to use for gradients.</p>
<p>Where:</p>
<dl> <dt>&lt;color-stop&gt;</dt> <dd> <p>{{ Xref_csscolorvalue() }} [ {{ Xref_csspercentage() }} | {{ Xref_csslength() }} ]</p> </dd>
</dl><h2>Values</h2>
<dl> <dt>&lt;point&gt;</dt> <dd>A position, interpreted in the same way as {{ Cssxref("background-position") }} or {{ Cssxref("-moz-transform-origin") }}. This is used to define the starting point of the gradient.</dd> <dt>&lt;angle&gt;</dt> <dd>An angle of direction for the gradient. See {{ Xref_cssangle() }}.</dd> <dt>&lt;stop&gt;</dt> <dd>This value is comprised of a {{ Xref_csscolorvalue() }} value, followed by an optional stop position (either a percentage between 0% and 100% or a {{ Xref_csslength() }} along the gradient axis).</dd> <dd>Rendering of color-stops in CSS gradients follows the same rules as color-stops in SVG gradients.</dd>
</dl>
<h2>Example</h2> <pre>background: repeating-linear-gradient(to bottom right, red, red 5px, white 5px, white 10px);
</pre>
<h2 name="Browser_Compatibility">Browser compatibility</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
<table class="compat-table"> <tbody> <tr> <th>Feature</th> <th>Chrome</th> <th>Firefox (Gecko)</th> <th>Internet Explorer</th> <th>Opera</th> <th>Safari (WebKit)</th> </tr> <tr> <td>Basic support</td> <td>10 <br> <code>-webkit-repeating-linear-gradient()</code></td> <td>3.6 (1.9.2) <br> <code>-moz-repeating-linear-gradient()</code></td> <td>5.5 (including 8.0) <br> <code>filter: progid:DXImageTransform.Microsoft.Gradient()</code></td> <td>11.10 (Presto 2.8) <br> <code>-o-repeating-linear-gradient()</code></td> <td>Nightly build (534.16) <br> <code>-webkit-repeating-linear-gradient()</code></td> </tr> </tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table"> <tbody> <tr> <th>Feature</th> <th>Android</th> <th>Firefox Mobile (Gecko)</th> <th>IE Phone</th> <th>Opera Mobile</th> <th>Safari Mobile</th> </tr> <tr> <td>Basic support</td> <td>{{ CompatUnknown() }}</td> <td>{{ CompatUnknown() }}</td> <td>{{ CompatUnknown() }}</td> <td>{{ CompatUnknown() }}</td> <td>{{ CompatUnknown() }}</td> </tr> </tbody>
</table>
</div>
<h2>See also</h2>
<ul> <li><a href="/en/Using_gradients" title="en/Using gradients">Using gradients</a></li> <li>{{ cssxref("-moz-linear-gradient") }}</li> <li>{{ cssxref("repeating-radial-gradient") }}</li> <li>{{ cssxref("background-image") }}</li> <li>{{ Cssxref("background") }}</li> <li>WebKit's original proposal: <a class="external" href="http://webkit.org/blog/175/introducing-css-gradients/" title="http://webkit.org/blog/175/introducing-css-gradients/">http://webkit.org/blog/175/introducing-css-gradients/</a></li> <li>Bug: {{ bug("479220") }}</li> <li>Bug: {{ bug("628480") }} <span id="summary_alias_container"><span id="short_desc_nonedit_display">Inconsistent rendering of -moz-repeating-linear-gradient across different OS's</span></span></li> <li>W3C Proposal for Linear Gradients: <a class="    external" href="http://dev.w3.org/csswg/css3-images/#linear-gradients" title="http://dev.w3.org/csswg/css3-images/#linear-gradients">http://dev.w3.org/csswg/css3-images/#linear-gradients</a></li> <li>W3C Proposal for Background Position: <a class=" external" href="http://www.w3.org/TR/css3-background/#the-background-position" title="http://www.w3.org/TR/css3-background/#the-background-position">http://www.w3.org/TR/css3-background/#the-background-position</a></li> <li><a class="external" href="http://msdn.microsoft.com/en-us/library/ms532997(VS.85,loband).aspx" title="http://msdn.microsoft.com/en-us/library/ms532997(VS.85,loband).aspx">MSDN library, gradient filter</a> (reference doc)</li> <li><a class=" external" href="http://webkit.org/blog/1424/css3-gradients/">Safari: CSS3 Gradients</a> (blog post)</li>
</ul>
Revert to this revision