background-attachment

  • Revision slug: CSS/background-attachment
  • Revision title: background-attachment
  • Revision id: 320613
  • Created:
  • Creator: diamond5555
  • Is current revision? No
  • Comment

Revision Content

{{ CSSRef() }}

Summary

If a {{ Cssxref("background-image") }} is specified, the background-attachment CSS property determines whether that image's position is fixed within the viewport, or scrolls along with its containing block.

  • {{ Xref_cssinitial() }} scroll
  • Applies to all elements
  • {{ Xref_cssinherited() }} no
  • Media {{ Xref_cssvisual() }}
  • {{ Xref_csscomputed() }} as specified

Syntax

background-attachment:  http://i9.glitter-graphics.org/pub/48/48169s2581xo4hz.gif[, attachment]*

where:

attachment
Is a keyword that can have one of the following values:
  • scroll, meaning that the background image will scroll within the viewport along with the block the image is contained within.
  • fixed, meaning that the background image will not scroll with its containing element, instead remaining stationary within the viewport.
  • local, meaning that the background image will not scroll with its containing element, but will scroll when the element's content scrolls: it is fixed regarding the element's content.

Examples

{{ CSSLiveSample('background-attachment.html') }}

body {
  background-image: url("images/cartooncat.png");
  background-attachment: fixed;
}

Multiple background image support

This property supports multiple background images. You can specify a different <attachment> for each background, separated by commas:

body {
  background-image: url("img1.png"), url("img2.png");
  background-attachment: scroll, fixed;
} 

Each image is matched with the corresponding attachment type, from first specified to last.

Specifications

Specification Status Comment
{{ SpecName('CSS3 Backgrounds', '#the-background-attachment', 'background-attachment') }} {{ Spec2('CSS3 Backgrounds') }} The shorthand property has been extended to support multiple backgrounds and the local value.
{{ SpecName('CSS2.1', 'colors.html#propdef-background-attachment', 'background-attachment') }} {{ Spec2('CSS2.1') }} No significant change.
{{ SpecName('CSS1', '#background-attachment', 'background-attachment') }} {{ Spec2('CSS1') }}  

Browser Compatibility

{{ CompatibilityTable() }}

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 {{ CompatGeckoDesktop("1.0") }} 4.0 3.5 1.0
Multiple backgrounds 1.0 {{ CompatGeckoDesktop("1.9.2") }} 9.0 10.5 1.3
local 4.0 {{ CompatNo() }} 9.0 10.5 5.0
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 {{ CompatGeckoMobile("1.9.2") }} {{ CompatUnknown() }} 10.0 3.2
Multiple backgrounds 2.1 {{ CompatGeckoMobile("1.9.2") }} {{ CompatUnknown() }} 10.0 3.2
local {{ CompatUnknown() }} {{ CompatNo() }} {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }}

See also

Revision Source

<p>{{ CSSRef() }}</p>
<h2 id="Summary">Summary</h2>
<p>If a {{ Cssxref("background-image") }} is specified, the <code>background-attachment</code> <a href="/en-US/docs/CSS" title="CSS">CSS</a> property determines whether that image's position is fixed within the viewport, or scrolls along with its containing block.</p>
<ul class="cssprop">
  <li><dfn>{{ Xref_cssinitial() }}</dfn> <code>scroll</code></li>
  <li><dfn>Applies to</dfn> all elements</li>
  <li><dfn>{{ Xref_cssinherited() }}</dfn> no</li>
  <li><dfn>Media</dfn> {{ Xref_cssvisual() }}</li>
  <li><dfn>{{ Xref_csscomputed() }}</dfn> as specified</li>
</ul>
<h2 id="Syntax">Syntax</h2>
<pre class="syntaxbox">
background-attachment:  http://i9.glitter-graphics.org/pub/48/48169s2581xo4hz.gif[, <em>attachment</em>]*
</pre>
<p>where:</p>
<dl>
  <dt>
    <em>attachment</em></dt>
  <dd>
    Is a <em>keyword</em> that can have one of the following values:
    <ul>
      <li><code>scroll</code>, meaning that the background image will scroll within the viewport along with the block the image is contained within.</li>
      <li><code>fixed</code>, meaning that the background image will not scroll with its containing element, instead remaining stationary within the viewport.</li>
      <li><code>local</code>, meaning that the background image will not scroll with its containing element, but will scroll when the element's content scrolls: it is fixed regarding the element's content.</li>
    </ul>
  </dd>
</dl>
<h2 id="Examples">Examples</h2>
<p>{{ CSSLiveSample('background-attachment.html') }}</p>
<pre class="brush:css; highlight:[3];">
body {
  background-image: url("images/cartooncat.png");
  background-attachment: fixed;
}
</pre>
<h3 id="Multiple_background_image_support">Multiple background image support</h3>
<p>This property supports multiple background images. You can specify a different <code>&lt;attachment&gt;</code> for each background, separated by commas:</p>
<pre class="brush:css; highlight:[3];">
body {
  background-image: url("img1.png"), url("img2.png");
  background-attachment: scroll, fixed;
} 
</pre>
<p>Each image is matched with the corresponding attachment type, from first specified to last.</p>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
  <thead>
    <tr>
      <th scope="col">Specification</th>
      <th scope="col">Status</th>
      <th scope="col">Comment</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>{{ SpecName('CSS3 Backgrounds', '#the-background-attachment', 'background-attachment') }}</td>
      <td>{{ Spec2('CSS3 Backgrounds') }}</td>
      <td>The shorthand property has been extended to support multiple backgrounds and the <code>local</code> value.</td>
    </tr>
    <tr>
      <td>{{ SpecName('CSS2.1', 'colors.html#propdef-background-attachment', 'background-attachment') }}</td>
      <td>{{ Spec2('CSS2.1') }}</td>
      <td>No significant change.</td>
    </tr>
    <tr>
      <td>{{ SpecName('CSS1', '#background-attachment', 'background-attachment') }}</td>
      <td>{{ Spec2('CSS1') }}</td>
      <td>&nbsp;</td>
    </tr>
  </tbody>
</table>
<h2 id="Browser_Compatibility" 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</th>
      </tr>
      <tr>
        <td>Basic support</td>
        <td>1.0</td>
        <td>{{ CompatGeckoDesktop("1.0") }}</td>
        <td>4.0</td>
        <td>3.5</td>
        <td>1.0</td>
      </tr>
      <tr>
        <td>Multiple backgrounds</td>
        <td>1.0</td>
        <td>{{ CompatGeckoDesktop("1.9.2") }}</td>
        <td>9.0</td>
        <td>10.5</td>
        <td>1.3</td>
      </tr>
      <tr>
        <td><code>local</code></td>
        <td>4.0</td>
        <td>{{ CompatNo() }}</td>
        <td>9.0</td>
        <td>10.5</td>
        <td>5.0</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>2.1</td>
        <td>{{ CompatGeckoMobile("1.9.2") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>10.0</td>
        <td>3.2</td>
      </tr>
      <tr>
        <td>Multiple backgrounds</td>
        <td>2.1</td>
        <td>{{ CompatGeckoMobile("1.9.2") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>10.0</td>
        <td>3.2</td>
      </tr>
      <tr>
        <td><code>local</code></td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatNo() }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
      </tr>
    </tbody>
  </table>
</div>
<h2 id="See_also">See also</h2>
<ul>
  <li>{{ CSS_Reference:Background() }}</li>
  <li><a href="/en-US/docs/CSS/Multiple_backgrounds" title="en-US/docs/CSS/Multiple backgrounds">Multiple backgrounds<img alt="" src="http://i9.glitter-graphics.org/pub/48/48169s2581xo4hz.gif" style="width: 300px; height: 422px;" /></a></li>
</ul>
Revert to this revision