본문으로 이동

iframe 높이 자동 조절, postMessage 없이 frame-sizing으로

geul조회 5추천 0댓글 1
  • 2026년 9월 Chrome 154부터 iframe 높이가 안쪽 페이지 내용에 맞춰 자동으로 늘어남. 바깥 페이지 CSS에 frame-sizing: content-height 한 줄, 안쪽 페이지 <head>에 meta 태그 한 줄이면 됨

  • 높이를 재서 postMessage로 보내고 받아서 고치던 스크립트가 필요 없음

  • 다만 지금은 Chrome과 Edge만 됨. Safari와 Firefox는 아직 지원하지 않아 예전 방식도 남겨 둬야 함

  • 안쪽 페이지를 내가 고칠 수 있어야 함. 처음 뜬 뒤 내용이 바뀌면 안쪽에서 requestResize() 한 줄은 불러야 함

  • 프런트엔드 개발자 sanyam이 11월 15일 X에 소개해 하루 만에 북마크 153개를 받은 팁임

지금까지 iframe 높이를 맞추던 방법

iframe은 안쪽 내용이 길어도 스스로 늘어나지 않음. 높이를 안 주면 기본 150px이고, 넘치는 내용은 안쪽 스크롤바로 들어감.

  • 그래서 안쪽 페이지가 자기 높이를 재서 바깥에 알려 주고, 바깥이 그 값으로 iframe 높이를 고치는 코드를 양쪽에 짰음

  • 결제 폼, 설문, 댓글 위젯, 광고처럼 다른 사이트 화면을 끼워 넣을 때 늘 하던 일임

  • iframe-resizer 같은 라이브러리를 이 용도로 많이 씀

보통 이런 코드였음. 안쪽 페이지:

new ResizeObserver(() => {
  const height = document.documentElement.scrollHeight;
  parent.postMessage({ height }, 'https://shop.example');
}).observe(document.body);

바깥 페이지:

window.addEventListener('message', (event) => {
  if (event.origin !== 'https://widget.example') return;
  document.querySelector('iframe').style.height = `${event.data.height}px`;
});
  • 보내는 쪽과 받는 쪽 주소 확인, 높이를 너무 자주 보내는 문제, 바깥이 늦게 준비되는 문제까지 챙기려면 코드가 더 길어짐

frame-sizing 사용법, 양쪽에 한 줄씩

바깥 페이지와 안쪽 페이지가 둘 다 허락해야 늘어남. 한쪽만 있으면 기본 150px 그대로임.

바깥 페이지(iframe을 넣는 쪽, shop.example):

<iframe src="https://widget.example/address" title="배송지 입력"></iframe>
iframe {
  width: 100%;
  border: 0;
  frame-sizing: content-height;
}

안쪽 페이지(iframe 안에 뜨는 쪽, widget.example)의 <head>:

<meta name="responsive-embedded-sizing" content="allow-origins=https://shop.example">
  • frame-sizing: content-height는 "iframe 높이를 안쪽 페이지 내용 높이로 맞춰 달라"는 뜻임

  • meta 태그는 "이 사이트들에는 내 높이를 알려 줘도 된다"는 허락임. 허락할 사이트가 여럿이면 띄어 써서 이어 적음

  • 안쪽 페이지가 허락해야 하는 이유는 보안 때문임. 아무 사이트나 내 페이지를 iframe에 넣고 높이를 읽으면, 로그인했는지 같은 정보를 높이로 짐작할 수 있음

  • Chrome 157 시험 페이지(폭 600px iframe 하나)에서 해 보니, 처음 뜰 때 안쪽 내용 높이 225px에 딱 맞게 늘어남

내용이 바뀌면 requestResize() 한 줄

브라우저가 안쪽 페이지의 변화를 계속 지켜보지는 않음. 처음 뜰 때 높이를 맞춘 뒤로는 안쪽에서 다시 맞춰 달라고 불러야 함.

  • 댓글 더 보기, 오류 문구 표시, 접힌 칸 펼치기처럼 처음 뜬 뒤 높이가 바뀌는 화면이 해당함

  • Chrome 157에서 해 보니, 문단을 10개 붙이고 아무것도 안 하면 iframe이 225px 그대로였고 requestResize()를 부르자 580px로 늘어남

moreButton.addEventListener('click', async () => {
  await appendComments();
  if ('requestResize' in window) {
    window.requestResize();
  }
});
  • Chrome 팀은 화면을 다 바꾼 다음, 다시 그리기 전에 한 번 부르라고 안내함

  • 'requestResize' in window로 먼저 확인하면 지원하지 않는 브라우저에서 오류가 나지 않음

  • 그래서 "스크립트가 완전히 사라진다"기보다, 높이를 재고 주고받던 코드가 함수 한 번 부르는 걸로 줄어든다고 보면 맞음

브라우저 지원, Safari와 Firefox 대비책

2026년 11월 16일 MDN 호환성 자료 기준으로 Chrome과 Edge 154부터 지원함.

  • Chrome, Edge: 154부터. 안드로이드 Chrome도 같음

  • Safari, iOS Safari, Firefox: 아직 지원 안 함. 두 엔진 모두 작업 항목만 열려 있음

  • MDN은 아직 실험 기능으로 표시함

지원하지 않는 브라우저에는 예전처럼 정해 둔 높이를 주고, 지원하는 브라우저에서만 자동 높이로 바꾸면 됨.

iframe {
  width: 100%;
  height: 500px;
}

@supports (frame-sizing: content-height) {
  iframe {
    height: auto;
    frame-sizing: content-height;
  }
}
  • 아이폰 사용자가 많은 국내 서비스라면, 예전 postMessage 코드를 바로 지우지 말고 지원하지 않는 브라우저에서만 돌게 남겨 두는 게 안전함

  • 안쪽 페이지의 예전 코드를 if (!('requestResize' in window)) 조건 안에 넣으면 됨. 바깥 페이지의 받는 코드도 그대로 둠

놓치기 쉬운 점

  • 안쪽 페이지를 고칠 수 없으면 못 씀

    • 유튜브, 지도, 남의 결제 위젯처럼 다른 회사 화면은 그 회사가 meta 태그를 넣어 줘야 함

    • 내 회사 안에서 다른 도메인끼리 끼워 넣는 경우(관리자 화면, 결제 폼, 공통 위젯)에 바로 쓰기 좋음

  • meta 태그는 처음 받는 HTML에 있어야 함

    • JavaScript로 나중에 넣으면 무시됨. Chrome 157에서도 150px 그대로였음

    • 브라우저에서만 화면을 그리는 React, Vue 앱이라면 index.html 같은 HTML 틀에 직접 적어야 함

  • content에 allow-origins를 꼭 적음

    • MDN 예제 중에는 content 없이 쓴 것도 있지만, Chrome 157에서 그렇게 하니 같은 사이트 안에서도 늘어나지 않았음

  • allow-origins=*는 꼭 필요할 때만 씀

    • 모든 사이트에 높이를 알려 준다는 뜻임. 로그인 여부나 장바구니 수에 따라 높이가 달라지는 화면이면 다른 사이트가 그 차이를 엿볼 수 있음

    • meta 태그는 높이를 알려 줄 사이트만 정함. 내 페이지를 끼워 넣을 수 있는 사이트는 예전처럼 CSP frame-ancestors(끼워 넣기 허용 목록)로 따로 막음

  • iframe이 늘어나면서 아래 내용이 밀림

    • 안쪽 페이지는 바깥보다 늦게 뜨므로, 늘어나는 순간 아래 글과 버튼이 아래로 밀림

    • 첫 화면에 있는 iframe에는 min-height로 대략의 높이를 미리 잡아 두면 덜 출렁임

    • 안쪽 내용이 아주 길 수 있으면 max-height: 80vh처럼 상한을 둠. 넘는 부분은 안쪽 스크롤로 보여 줌

자주 묻는 질문

  • 유튜브 영상 iframe에도 쓸 수 있나?

    • 유튜브가 meta 태그를 넣지 않는 한 안 됨. 영상은 원래 aspect-ratio: 16 / 9로 비율을 맞추는 쪽이 맞음

  • iframe-resizer 같은 라이브러리를 지워도 되나?

    • Chrome, Edge 사용자만 있는 사내 도구라면 지워도 됨. 일반 서비스는 Safari와 Firefox가 지원할 때까지 대비책으로 남겨 둠

  • 폭도 내용에 맞출 수 있나?

    • frame-sizing: content-width로 됨. 다만 보통은 폭을 바깥에서 정하고 높이만 맞춤

추천저장

댓글

댓글을 남겨 보세요
로그인한 뒤에 댓글을 올릴 수 있습니다로그인
댓글 불러오는 중
글쓰기