HTML DOM Style objectPosition 속성 – 이미지·비디오 위치 제어 방법

HTML DOM의 Style objectPosition 속성은 HTML 문서에서 이미지(img) 또는 비디오(video) 요소가 자신의 콘텐츠 박스(content box) 내에서 어떻게 배치될지를 가져오거나 설정하는 데 사용됩니다.

이 속성은 CSS의 object-position 속성과 동일한 역할을 하며, 특히 object-fit 속성과 함께 사용하면 이미지나 영상이 잘리는 방식과 표시되는 위치를 세밀하게 조정할 수 있습니다.

문법(Syntax)

objectPosition 속성의 기본 문법은 다음과 같습니다.

1. 값 가져오기(Return)

object.objectPosition

2. 값 설정하기(Set)

object.objectPosition = "value"

여기서 사용할 수 있는 값(value)은 아래와 같습니다.

값	설명
initial	이 속성값을 기본값(default)으로 되돌립니다.
inherit	부모 요소로부터 이 속성값을 상속받습니다.
position	콘텐츠 박스 안에서 이미지 또는 비디오 요소의 위치를 지정합니다. 예: "50% 50%", "left top", "100% 100%" 등

position 값은 키워드(left, center, right, top, bottom) 또는 백분율(%)과 픽셀(px) 단위로 지정할 수 있으며, 첫 번째 값은 수평 위치, 두 번째 값은 수직 위치를 나타냅니다.

예제 코드

HTML DOM Style objectPosition 속성의 실제 동작 예제를 살펴보겠습니다.

<!DOCTYPE html>
<html>
<style>
    body {
        color: #000;
        height: 100vh;
        background-color: #8BC6EC;
        background-image: linear-gradient(135deg, #8BC6EC 0%, #9599E2 100%);
        text-align: center;
    }
    .btn {
        background: #db133a;
        border: none;
        height: 2rem;
        border-radius: 2px;
        width: 40%;
        display: block;
        color: #fff;
        outline: none;
        cursor: pointer;
        margin: 1rem auto;
    }
    .img-class {
        width: 200px;
        height: 250px;
        object-fit: cover;
    }
</style>
<body>
<h1 style="text-align:center">DOM Style objectPosition Property Demo</h1>
<img alt="Learn Java Swing" src="https://www.tutorialspoint.com/swing/images/swing-mini-logo.jpg" class="img-class" width='300' height='200'>
<button class="btn" onclick="set()">Set objectPosition</button>
<script>
    function set() {
        document.querySelector('.img-class').style.objectPosition = "100% 100%";
    }
</script>
</body>
</html>

실행 결과(Output)

페이지를 실행하면 초기 상태에서는 이미지가 기본 위치(중앙)에 표시됩니다.

HTML DOM Style objectPosition 속성 – 이미지·비디오 위치 제어 방법

이제 “Set objectPosition” 버튼을 클릭해 보세요. 버튼 클릭 시 JavaScript의 set() 함수가 실행되어 이미지 요소의 objectPosition 속성이 "100% 100%"(우측 하단)으로 변경됩니다.

HTML DOM Style objectPosition 속성 – 이미지·비디오 위치 제어 방법

결과적으로 이미지가 콘텐츠 박스의 우측 하단 기준으로 재배치되어 표시되는 것을 확인할 수 있습니다. 이처럼 objectPosition 속성을 활용하면 object-fit: cover로 인해 잘린 이미지의 초점 위치를 자유롭게 조절할 수 있습니다.