CSS object-fit Property

February 10, 2021 12:37 pm IST

You are Here:

CSS object-fit Property

CSS object-fit property specifies how an <img> or <video> should be resized to fit its container.

Example

HTML Online Editor

<!DOCTYPE html> <html lang="en-US"> <head> <style> img{ width: 250px; height: 150px; border: 1px solid #000; } #myFill img{ object-fit: fill; } #myContain img{ object-fit: contain; } #myCover img{ object-fit: cover; } #myNone img{ object-fit: none; } #myScaleDown img{ object-fit: scale-down; } </style> </head> <body> <h1>CSS object-fit Property</h1> <h2>object-fit: fill;</h2> <div id="myFill"> <img src="devices.jpg"> </div> <h2>object-fit: contain;</h2> <div id="myContain"> <img src="devices.jpg"> </div> <h2>object-fit: cover;</h2> <div id="myCover"> <img src="devices.jpg"> </div> <h2>object-fit: none;</h2> <div id="myNone"> <img src="devices.jpg"> </div> <h2>object-fit: scale-down;</h2> <div id="myScaleDown"> <img src="devices.jpg"> </div> </body> </html>

Run

Syntax

Using CSS

element{ object-fit: cover; }

Using Javascript

object.style.objectFit="cover";

Animatable

No, object-fit property is not animatable. CSS Animatable Properties Reference.

Default Value

Default value for CSS object-fit property is fill.

Property Value

The following table provides a list of values for CSS object-fit property.

Value	Explanation
fill	The replaced content is sized to fill the element’s content box. The entire object will completely fill the box.
contain	The replaced content is scaled to maintain its aspect ratio while fitting within the element's content box.
cover	The replaced content is sized to maintain its aspect ratio while filling the element's entire content box. The object will be clipped to fit.
none	The replaced content is not resized.
scale-down	The content is sized as if none or contain were specified, whichever would result in a smaller concrete object size.

Using JavaScript

In the following example, we will demonstrate how to change the CSS object-fit property of an element using JavaScript.

Example

HTML Online Editor

<!DOCTYPE html> <html lang="en-US"> <head> <style> img{ width: 250px; height: 150px; border: 1px solid #000; object-fit: fill; } </style> </head> <body> <h1>CSS object-fit Property</h1> <div> <img src="devices.jpg"> </div> <button onclick="myFunction()">Click Me</button> <script> var x = document.getElementsByTagName("img")[0]; function myFunction(){ x.style.objectFit = "none"; } </script> </body> </html>

Run