CSS - object-position
The object-position
property determines the alignment of the replaced element inside its box.
Example
HTML Content
<img id="object-position-1" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"/> <img id="object-position-2" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"/>
CSS Content
img { width: 150px; height: 100px; border: 1px solid #000; background-color: yellow; margin-right: 1em; } #object-position-1 { object-position: 10px; } #object-position-2 { object-position: 20% 10%; }
Output
Syntax
/* <position> values */ object-position: 100px 50px; /* Global values */ object-position: inherit; object-position: initial; object-position: unset;
Values
<position>
- Is a
<position>
, that is one to four values representing a 2D position regarding the edges of the element's box. Relative or absolute offsets can be given. Note that the position can be set outside of the element's box.
Formal syntax
<position>where
<position> = [[ left | center | right | top | bottom | <length-percentage> ] | [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ] | [ center | [ left | right ] <length-percentage>? ] && [ center | [ top | bottom ] <length-percentage>? ]]
where
<length-percentage> = <length> | <percentage>
Description
The object-position
property determines the alignment of the replaced element inside its box.
Initial value | 50% 50% |
---|---|
Applies to | replaced elements |
Inherited | yes |
Percentages | refer to width and height of element itself |
Media | visual |
Computed value | as specified |
Animation type | a repeatable list of , a simple list of , a length, percentage or calc(); |
Canonical order | the unique non-ambiguous order defined by the formal grammar |
Browser Compatibility
See Also
- Other image-related CSS properties:
object-fit
,image-orientation
,image-rendering
,image-resolution
.
Specifications
Specification | Status | Comment |
---|---|---|
CSS Image Values and Replaced Content Module Level 4 The definition of 'object-position' in that specification. |
Working Draft | The from-image and flip keywords have been added. |
CSS Image Values and Replaced Content Module Level 3 The definition of 'object-position' in that specification. |
Candidate Recommendation | Initial definition |
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/css/object-position