Template:Linear-gradient/doc
Template:Strong for Template:Terminate sentence It may contain usage information, categories and other content that is not part of the original template page. |
This template creates a gradient background. This currently works in Firefox (3.6 and up), Opera (11.10 and up), Safari (5.1 and up), Google Chrome (10 and up) and Internet Explorer (10 and up).
Usage
badloUse within a CSS style tag. The template uses the background-image
property.
<div style="{{linear-gradient | start position | #color [stop], #color [stop][, #color [stop], ...] }}">Lorem ipsum...</div>
start position
– Mandatory. Specify a start point:left
,top
,right
orbottom
, or a combination of two of each, e.g.top left
. This provides eight starting points.color
– The first two colors are mandatory. You can define any number of additional colors, separated with commas.stop
– Optional. You can specify a stop position for each color using a percentage (e.g. 45%) or pixels (e.g. 60px).
Technical notes
badloUnlike {{gradient}}, this template does not assign a default background-color, and therefor does not provide an automatic fallback for browsers that do not support gradients. To provide a fallback, always specify a background color in front of the template. This allows for much more flexibility in design and fallback handling in unsupported browsers.
This template uses the new CSS3 properties for linear gradients: -moz-linear-gradient
, -o-linear-gradient
, -webkit-linear-gradient
and linear-gradient
It does not use the legacy -webkit-gradient
property due to its deviating parameter format. This means that this template does not work in Safari versions below 5.1 and Google Chrome versions below 10.
Examples
badloLua error in Module:See_also at line 43: attempt to call field 'formatPageTables' (a nil value).
<div style="{{linear-gradient|left|#ffdddd, #ddddff}}">Lorem ipsum...</div>
will produce
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">Lorem ipsum...</div>
will produce
<div style="{{linear-gradient|top|#ffdddd, #ddddff}}">Lorem ipsum...</div>
will produce
Considerations
badloAbove examples use contrasting colors to show the effect more clearly. It is best to use subtle differences in color to enhance the appearance, rather than radically change it. This also minimizes the effects between browsers that do and do not support gradients.
Compatibility
badlo- See linear-gradient on the Mozilla Developer Network for all broswer compatibility details.
See also
badlo- {{radial-gradient}}
- {{border-radius}}
- {{box-shadow}}