iframe 높이 자동 조절, postMessage 없이 frame-sizing으로
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로 됨. 다만 보통은 폭을 바깥에서 정하고 높이만 맞춤
댓글