Template:Radial-gradient/doc: Difference between revisions
Jump to navigation
Jump to search
m (→Usage: grammar) |
No edit summary |
||
| (14 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
This template creates a radial gradient background. This currently works in Firefox (3.6 and up), Opera (12.0 and up), Safari (5.1 and up), Google Chrome (10 and up) and Internet Explorer 10. | |||
This template creates a radial gradient background. This currently works in Firefox (3.6 and up), Safari (5.1 and up), Google Chrome (10 and up) and Internet Explorer 10 | |||
== Usage == | == Usage == | ||
Use within a CSS style tag. The template uses the < | Use within a CSS style tag. The template uses the <code>background-image</code> property. | ||
< | <code><nowiki><div style="{{radial-gradient | position | shape [size] | #color [stop], #color [stop][, #color [stop], ...] }}">Lorem ipsum...</div></nowiki></code> | ||
#< | #<code>position</code> – Mandatrory. Specify the X and Y position of the center of the gradient. This can be any valid CSS position value. | ||
#< | #<code>shape</code> – Mandatory. Specify the shape of the gradient using keywords or CSS size values. Valid keywords are: | ||
#*< | #*<code>ellipse</code> | ||
#*< | #*<code>circle</code> | ||
#< | #<code>size</code> – Optional. Specify the size of the radial using keywords or CSS size values.<ref>Firefox does ''not'' yet support explicit size values, only keywords.</ref> Valid keywords are: | ||
#*< | #*<code>farthest-corner</code> (or <code>cover</code>); Extends the radial to the farthest element corner, ensuring the gradient covers the entire element. This is the default. | ||
#*< | #*<code>closest-corner</code>; Extends the radial to the closest corner. | ||
#*< | #*<code>farthest-side</code>; Extends the radial to the farthest edge. | ||
#*< | #*<code>closest-side</code> (or <code>contain</code>); Extends the radial to the closest edge, ensuring the gradient does not extend beyond the element's borders. | ||
#< | #<code>color</code> – The first two colors are mandatory. You can define any number of additional colors, separated with commas. | ||
#< | #<code>stop</code> – Optional. You can specify a stop position for each color using a percentage (e.g. 45%) or pixels (e.g. 60px). | ||
===Notes=== | |||
<references /> | |||
== Technical notes == | == Technical notes == | ||
| Line 29: | Line 27: | ||
The 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. | The 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 template uses the new CSS3 properties for radial gradients: < | This template uses the new CSS3 properties for radial gradients: <code>-moz-radial-gradient</code>, <code>-ms-radial-gradient</code>, <code>-o-radial-gradient</code>, <code>-webkit-radial-gradient</code> and <code>radial-gradient</code>. | ||
== Examples == | == Examples == | ||
* < | * <code><nowiki><div style="{{radial-gradient|100px center|ellipse cover|#ffdddd, #ddddff}}">Lorem ipsum...</div></nowiki></code> will produce | ||
<div style="{{radial-gradient|100px center|ellipse cover|#ffdddd, #ddddff}}">Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</div> | <div style="width: 480px; {{radial-gradient|100px center|ellipse cover|#ffdddd, #ddddff}}">Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</div> | ||
* < | * <code><nowiki><div style="{{radial-gradient|center|ellipse contain|#ffdddd, #ddffdd 50%, #ddddff}}">Lorem ipsum...</div></nowiki></code> will produce | ||
<div style="{{radial-gradient|center| | <div style="width: 480px; {{radial-gradient|center|ellipse contain|#ffdddd, #ddffdd 50%, #ddddff}}">Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</div> | ||
* < | * <code><nowiki><div style="{{radial-gradient|top|circle|#ffdddd, #ddddff}}">Lorem ipsum...</div></nowiki></code> will produce | ||
<div style="{{radial-gradient|top| | <div style="width: 480px; {{radial-gradient|top|circle|#ffdddd, #ddddff}}">Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</div> | ||
== Considerations == | == Considerations == | ||
Above 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. | Above 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 == | |||
* See [https://developer.mozilla.org/en-US/docs/CSS/radial-gradient#Browser_compatibility radial-gradient] on the Mozilla Developer Network for all broswer compatibility details. | |||
== See also == | == See also == | ||
| Line 56: | Line 57: | ||
<includeonly> | <includeonly> | ||
[[Category:Formatting templates]] | |||
[[Category: | |||
</includeonly> | </includeonly> | ||
Latest revision as of 09:17, 5 June 2013
This template creates a radial gradient background. This currently works in Firefox (3.6 and up), Opera (12.0 and up), Safari (5.1 and up), Google Chrome (10 and up) and Internet Explorer 10.
Usage
Use within a CSS style tag. The template uses the background-image property.
<div style="{{radial-gradient | position | shape [size] | #color [stop], #color [stop][, #color [stop], ...] }}">Lorem ipsum...</div>
position– Mandatrory. Specify the X and Y position of the center of the gradient. This can be any valid CSS position value.shape– Mandatory. Specify the shape of the gradient using keywords or CSS size values. Valid keywords are:ellipsecircle
size– Optional. Specify the size of the radial using keywords or CSS size values.[1] Valid keywords are:farthest-corner(orcover); Extends the radial to the farthest element corner, ensuring the gradient covers the entire element. This is the default.closest-corner; Extends the radial to the closest corner.farthest-side; Extends the radial to the farthest edge.closest-side(orcontain); Extends the radial to the closest edge, ensuring the gradient does not extend beyond the element's borders.
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).
Notes
- ↑ Firefox does not yet support explicit size values, only keywords.
Technical notes
The 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 template uses the new CSS3 properties for radial gradients: -moz-radial-gradient, -ms-radial-gradient, -o-radial-gradient, -webkit-radial-gradient and radial-gradient.
Examples
<div style="{{radial-gradient|100px center|ellipse cover|#ffdddd, #ddddff}}">Lorem ipsum...</div>will produce
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
<div style="{{radial-gradient|center|ellipse contain|#ffdddd, #ddffdd 50%, #ddddff}}">Lorem ipsum...</div>will produce
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
<div style="{{radial-gradient|top|circle|#ffdddd, #ddddff}}">Lorem ipsum...</div>will produce
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Considerations
Above 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
- See radial-gradient on the Mozilla Developer Network for all broswer compatibility details.
See also
- {{linear-gradient}}
- {{border-radius}}
- {{box-shadow}}