Skip to content

Commit d8267ba

Browse files
committed
[css-backgrounds-4] Added background-layer shorthand property
1 parent 12a9fb4 commit d8267ba

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed

css-backgrounds-4/Overview.bs

+49
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,54 @@ Painting Area: the 'background-clip' property</h3>
185185
</dd>
186186
</dl>
187187

188+
<h3 id='background-layers'>
189+
Background Image Layers: the 'background-layer' shorthand property</h3>
190+
191+
<pre class="propdef">
192+
Name: background-layer
193+
Value: <<bg-layer>>#
194+
Initial: see individual properties
195+
Applies to: all elements
196+
Inherited: no
197+
Percentages: see individual properties
198+
Computed value: see individual properties
199+
Animation type: see individual properties
200+
</pre>
201+
202+
<p>The 'background-layer' property is a
203+
shorthand property for setting most background properties at the same
204+
place in the style sheet. It covers basically the same as 'background',
205+
i.e. it allows to define all the background layers. The only difference
206+
is that it doesn't set the 'background-color'.
207+
208+
<div class="example" id="background-layer-example">
209+
This example sets three background layers,
210+
the first one including the image, position and repetition,
211+
the second including the image, position, and size,
212+
and the third one only consisting of the image.
213+
214+
<pre class="lang-css">
215+
p {
216+
background-layer:
217+
url(a.png) top left no-repeat,
218+
url(b.png) center / 100% 100% no-repeat,
219+
url(c.png);
220+
}
221+
</pre>
222+
</div>
223+
224+
<div class="invalid example" id="invalid-background-layer-example">
225+
This example tries to set the background color in addition to
226+
the background image. For that to work, 'background' needs
227+
to be used instead of 'background-layer'.
228+
229+
<pre class="lang-css">
230+
p {
231+
background-layer: url(c.png) white;
232+
}
233+
</pre>
234+
</div>
235+
188236
<h2 id="changes">
189237
Changes</h2>
190238

@@ -196,6 +244,7 @@ Additions Since [[CSS3BG]]</h3>
196244
<ul>
197245
<li>logical 'background-position' values (''background-position/start'', ''background-position/end'')
198246
<li>the ''extend'' keyword of 'background-repeat'
247+
<li>Added 'background-layer' property
199248
</ul>
200249

201250
<h2 id="acknowledgments">Acknowledgments</h2>

0 commit comments

Comments
 (0)