HTML | DOM Style backgroundPosition Property

The HTML DOM Style backgroundPosition : It sets or returns position of the background-image in an element.

Syntax:

  • To get the backgroundPosition property
    object.style.backgroundPosition
  • To set the backgroundPosition property
    object.style.backgroundPosition = value

Property Values:

  • keyword values: this is used to specify the position using keywords. If only one value is specified, the other value would be ‘center’ by default. The possible keyword combinations are:
    • top left
    • top center
    • top right
    • center left
    • center center
    • center right
    • bottom left
    • bottom center
    • bottom right
  • x% y%: this is used to specify the position using percentage. The x% determines the horizontal position and y% determines the vertical position with respect to the initial top-left position.
  • xpos ypos: this is used to specify the position using a pixels or any other CSS measurement. The xpos determines the horizontal position and ypos determines the vertical position with respect to the initial top-left position.
  • initial: this is used to set this property to its default value.
  • inherit: this inherits the property from its parent.

The values are explained using the following examples:

Example-1: Using keyword values. We use the value ‘bottom right’ in this example.

filter_none

edit
close

play_arrow

link
brightness_4
code

<!DOCTYPE html>
<html lang="en">
  
<head>
    <title>
      DOM Style backgroundPosition Property
    </title>
    <style>
        .bg-img {
            height: 300px;
            width: 300px;
            border-style: solid;
            background: 
                        no-repeat center;
        }
    </style>
</head>
  
<body>
    <h1 style="color: green">
      GeeksforGeeks
    </h1>
    <b>
      DOM Style backgroundPosition Property
    </b>
    <p>
      Click on the button to change the 
      position of the background image
    </p>
    <div class="bg-img">
    </div>
  
    <button onclick="changePos()">
        Change position of background image
    </button>
  
    <script>
        function changePos() {
            elem = document.querySelector('.bg-img');
  
            // Setting the position to bottom vertically
            // and right horizontally
            elem.style.backgroundPosition = 'bottom right';
        }
    </script>
</body>
  
</html>

chevron_right


Output:

  • Before pressing the button:
    default output
  • After pressing the button:
    keyword-bottom-right

Example-2: Using percentage to specify the position. We use ‘25% 75%’ to position the image.

filter_none

edit
close

play_arrow

link
brightness_4
code

<!DOCTYPE html>
<html lang="en">
  
<head>
    <meta charset="UTF-8">
    <title>
      DOM Style backgroundPosition Property
    </title>
    <style>
        .bg-img {
            height: 300px;
            width: 300px;
            border-style: solid;
            background: 
                        no-repeat center;
        }
    </style>
</head>
  
<body>
    <h1 style="color: green">
      GeeksforGeeks
    </h1>
    <b>
      DOM Style backgroundPosition Property
    </b>
    <p>
      Click on the button to change the
      position of the background image
    </p>
  
    <div class="bg-img">
    </div>
    <button onclick="changePos()">
        Change position of background image
    </button>
  
    <script>
        function changePos() {
            elem = document.querySelector('.bg-img');
  
            // Setting the position to 25% horizontally
            //and 75% vertically
            elem.style.backgroundPosition = '25% 75%';
        }
    </script>
</body>
  
</html>

chevron_right


Output:

  • Before pressing the button:
    default output
  • After pressing the button:
    percentage

Example-3: Using fixed units to specify the position. We use ’50px 25px’ to position the image.

filter_none

edit
close

play_arrow

link
brightness_4
code

<!DOCTYPE html>
<html lang="en">
  
<head>
    <title>
      DOM Style backgroundPosition Property
    </title>
    <style>
        .bg-img {
            height: 300px;
            width: 300px;
            border-style: solid;
            background: 
                        no-repeat center;
        }
    </style>
</head>
  
<body>
    <h1 style="color: green">
      GeeksforGeeks
    </h1>
    <b>
      DOM Style backgroundPosition Property
    </b>
    <p>
      Click on the button to change the 
      position of the background image</p>
    <div class="bg-img">
    </div>
  
    <button onclick="changePos()">
        Change position of background image
    </button>
  
    <script>
        function changePos() {
            elem = document.querySelector('.bg-img');
  
            // Setting the position to 50px horizontally
           //and 25px horizontally
            elem.style.backgroundPosition = '50px 25px';
        }
    </script>
</body>
  
</html>

chevron_right


Output:

  • Before pressing the button:
    default output
  • After pressing the button:
    fixed-value

Example-4: Using the initial value. This sets the position to its default value.

filter_none

edit
close

play_arrow

link
brightness_4
code

<!DOCTYPE html>
<html lang="en">
  
<head>
    <title>DOM Style backgroundPosition Property</title>
    <style>
        .bg-img {
            height: 300px;
            width: 300px;
            border-style: solid;
            background: 
                        no-repeat center;
        }
    </style>
</head>
  
<body>
    <h1 style="color: green">
      GeeksforGeeks
    </h1>
    <b>
      DOM Style backgroundPosition Property
    </b>
    <p>
      Click on the button to change the 
      position of the background image
    </p>
    <div class="bg-img">
    </div>
  
    <button onclick="changePos()">
        Change position of background image
    </button>
  
    <script>
        function changePos() {
            elem = document.querySelector('.bg-img');
  
            // Setting the position to the default 
            // value with initial
            elem.style.backgroundPosition = 'initial';
        }
    </script>
</body>
  
</html>

chevron_right


Output:

  • Before pressing the button:
    default output
  • After pressing the button:

Example-5: Using the inherit value. This inherits the position from its parent element.

filter_none

edit
close

play_arrow

link
brightness_4
code

<!DOCTYPE html>
<html lang="en">
  
<head>
    <title>
      DOM Style backgroundPosition Property
    </title>
    <style>
        /* Parent element */
          
        #parent {
            height: 300px;
            width: 300px;
            border-style: solid;
            /* Setting the parent's background-position
          //to center left*/
            background-position: center left;
        }
          
        .bg-img {
            height: 300px;
            width: 300px;
            background: 
                        no-repeat center;
        }
    </style>
</head>
  
<body>
    <h1 style="color: green">
      GeeksforGeeks
    </h1>
    <b>
      DOM Style backgroundPosition Property
    </b>
    <p>
      Click on the button to change the 
      position of the background image
    </p>
    <div id="parent">
        <div class="bg-img"></div>
    </div>
  
    <button onclick="changePos()">
        Change position of background image
    </button>
  
    <script>
        function changePos() {
            elem = document.querySelector('.bg-img');
  
            // Setting the position to inherit from its parent
            elem.style.backgroundPosition = 'inherit';
        }
    </script>
</body>
  
</html>

chevron_right


Output:

  • Before pressing the button:
    default output
  • After pressing the button:

Supported Browsers: The browser supported by backgroundPosition Property are listed below:

  • Chrome 1.0
  • Internet Explorer 4.0
  • Firefox 1.0
  • Opera 3.5
  • Safari 1.0


My Personal Notes arrow_drop_up

Technical Writer Lets have an update

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.