Style backgroundAttachment Property

Example

Set a background-image to be fixed (will not scroll):

document.body.style.backgroundAttachment = "fixed";
Try it Yourself »

More "Try it Yourself" examples below.


Description

The backgroundAttachment property sets or returns whether a background image should scroll with the content, or be fixed.

See Also:

HTML Styles: The background Property

CSS Tutorial: CSS Backgrounds

CSS Reference: The CSS background-attachment Property


Syntax

Return the backgroundAttachment property:

object.style.backgroundAttachment

Set the backgroundAttachment property:

object.style.backgroundAttachment = "scroll|fixed|local|initial|inherit"

Property Values

Value Description
scroll The background scrolls along with the element. This is default
fixed The background is fixed with regard to the viewport
local The background scrolls along with the element's contents
initial Sets this property to its default value. Read about initial
inherit Inherits this property from its parent element. Read about inherit

Technical Details

Default Value: scroll
Return Value: A String, representing how the background image is attached to the object within the document
CSS Version CSS1


Browser Support

backgroundAttachment is a CSS1 (1996) feature.

It is fully supported in all browsers:

Chrome Edge Firefox Safari Opera IE
Yes Yes Yes Yes Yes Yes

More Examples

Example

Choose between scroll and local on a DIV element:

document.getElementById("myDIV").style.backgroundAttachment = "local";
Try it Yourself »

Example

Toggle between scroll and fixed:

let x = document.body.style.backgroundAttachment;
document.body.style.backgroundAttachment = (x == "scroll")? "fixed":"scroll";
Try it Yourself »

Example

Return the value of the background-attachment property:

let back = document.body.style.backgroundAttachment;
Try it Yourself »

Copyright 1999-2023 by Refsnes Data. All Rights Reserved.