페이지 확인
텍스트 줄바꿈, 기본 버튼, 오른쪽 가장자리까지 닿는 콘텐츠를 확인하세요. 점검할 작업에서 사용하는 메뉴나 대화상자를 여세요.
iPhone 17 모델의 화면은 6.3인치이며 세로 방향의 물리적 해상도는 1206 × 2622픽셀입니다. 웹사이트 레이아웃은 아래의 402 × 874 CSS 픽셀 구성에서 먼저 확인하세요. 화면의 물리적 픽셀과 레이아웃에 쓰는 CSS 픽셀을 구분하고, 아래 점검 방법을 실제 웹사이트에 적용해 보세요.
디스플레이 사양은 제조사 자료를 기준으로 합니다. CSS 치수와 참고 배율은 화면 해상도에 3× 배율을 적용해 계산한 사용자 지정 뷰포트를 나타냅니다. 휴대전화 브라우저에서 실제로 보이는 영역은 상태에 따라 달라집니다.
| 측정 항목 | 값 | 용도 |
|---|---|---|
| 화면 대각선 | 6.3인치 | 실제 화면 크기 비교 |
| 물리적 화면 해상도 | 1206 × 2622픽셀 | 제조사 하드웨어 사양 확인 |
| 세로 방향 뷰포트 | 402 × 874 CSS px | 반응형 레이아웃 확인 |
| 참고 배율 | 3× | CSS 뷰포트 계산에 쓰는 값이며 사용자 지정 패널에서 설정할 수 없습니다. |
| 가로 방향 뷰포트 | 874 × 402 CSS px | 더 넓고 높이가 낮은 레이아웃 점검 |
| Mobile Viewer 설정 | 사용자 지정 구성 | Custom device에서 너비와 높이를 입력하고 Apply를 누릅니다. |
참고 배율은 3×입니다. 각 물리적 치수를 3로 나눈 CSS 치수는 402 × 874입니다. 이 CSS 뷰포트부터 테스트를 시작하세요. 1 CSS 픽셀 너비의 테두리가 여러 물리적 픽셀에 걸쳐 표시될 수 있습니다.
Safari의 조작 요소와 화면 키보드에 따라 실제로 보이는 뷰포트가 달라집니다. 화면 전체 크기와 방문자가 특정 시점에 볼 수 있는 영역은 다를 수 있습니다. 더 낮은 높이에서도 확인하고, Safari에만 해당하는 동작은 실제 iPhone이나 적절한 테스트 서비스에서 검증하세요.
너비 402 CSS 픽셀을 테스트 기준으로 삼고 콘텐츠가 바뀌어야 하는 지점에 중단점을 정하세요. 이 예제의 레이아웃 조건은 iPhone 17 외에도 여러 기기에서 충족될 수 있습니다. 필요한 예제를 펼쳐 코드를 복사하세요.
이미지 파일 이름과 CSS 클래스는 프로젝트에 맞게 바꾸세요. 확대 기능을 유지하고 선택한 너비보다 좁거나 넓은 화면에서도 확인하세요.
브라우저가 기기 너비를 기준으로 레이아웃을 배치하게 합니다. 화면 가장자리까지 사용하는 디자인에서 안전 영역도 처리할 때만 viewport-fit=cover를 추가하세요.
<meta name="viewport" content="width=device-width, initial-scale=1">콘텐츠에 공간이 필요할 때 상품 버튼을 세로로 쌓는 중단점 예제입니다. 다른 기기나 크기를 조절한 데스크톱 창도 같은 조건을 충족할 수 있습니다.
@media (max-width: 402px) {
.product-actions {
display: grid;
grid-template-columns: minmax(0, 1fr);
gap: 0.75rem;
}
}문제를 재현할 때 대상 브라우저에서 이 값을 읽으세요. 브라우저 조작 요소나 키보드 상태가 달라지면 시각적 뷰포트의 높이도 바뀔 수 있습니다.
const viewport = {
layoutWidth: document.documentElement.clientWidth,
layoutHeight: document.documentElement.clientHeight,
visualWidth: window.visualViewport?.width,
visualHeight: window.visualViewport?.height,
devicePixelRatio: window.devicePixelRatio,
};
console.table(viewport);3dppx 이상인 환경에 이 조건이 적용됩니다. 참고 배율을 기준으로 정한 값입니다. 사용자 지정 미리보기의 실제 DPR은 다를 수 있습니다. 사진에는 반응형 이미지를 사용하세요. 밀도 조건만으로는 적절한 크기의 파일이 선택된다고 보장할 수 없습니다.
@media (min-resolution: 3dppx) {
.brand-mark {
/* Use a vector asset or a suitable high-density source. */
background-image: url("/images/brand-mark.svg");
}
}sizes에는 화면에 표시될 이미지 너비를, srcset에는 사용할 수 있는 이미지 파일별 너비를 지정합니다. 실제 구성 요소에 맞게 값과 파일을 바꾸세요.
<img
src="/images/product-480.jpg"
srcset="/images/product-480.jpg 480w,
/images/product-960.jpg 960w,
/images/product-1440.jpg 1440w"
sizes="(max-width: 402px) calc(100vw - 32px), 480px"
width="480" height="600"
alt="Describe the product and relevant visual details">기본 루트 글꼴 크기 16px에서 25.125rem은 402px에 해당합니다. Tailwind의 기본 중단점과 같은 단위인 rem을 사용자 지정 중단점에도 사용하세요. 이 값은 예시입니다. 하나의 중단점을 여러 기기에 적용할 수 있습니다.
@import "tailwindcss";
@theme {
--breakpoint-phone-check: 25.125rem;
}
/* Example markup: */
/* <div class="grid grid-cols-1 phone-check:grid-cols-2">…</div> */이 사용자 지정 구성은 너비와 높이를 지정합니다. 해당 모델의 안전 영역은 브라우저에서 제공하는 변수로 처리하고 대상 기기에서 직접 확인하세요.
화면 가장자리까지 쓰는 페이지에서는 사방의 주요 콘텐츠가 가려지지 않도록 하고 하단 고정 버튼에 별도의 내부 여백을 주세요. 안전 여백이 0이면 기본 여백을 유지하세요. 미리보기 프레임에 노치가 보여도 대상 브라우저에서 env() 값을 직접 확인하세요.
화면 가장자리까지 쓰는 레이아웃에 적용하세요. 페이지 본문에서 고정 버튼의 실제 높이만큼 공간을 확보하세요. 대상 브라우저에서 env() 값과 키보드가 열릴 때의 동작을 확인하세요. 이 예제는 환경 변수를 기준으로 여백을 정합니다.
<meta name="viewport"
content="width=device-width, initial-scale=1, viewport-fit=cover">
<style>
:root { --action-height: 5rem; } /* Match your actual control. */
.page-content {
padding-left: max(1rem, env(safe-area-inset-left, 0px));
padding-right: max(1rem, env(safe-area-inset-right, 0px));
padding-bottom: calc(var(--action-height) + env(safe-area-inset-bottom, 0px));
}
.fixed-action {
position: fixed;
inset-inline: 0;
bottom: 0;
padding: 1rem;
padding-bottom: max(1rem, env(safe-area-inset-bottom, 0px));
}
</style>이 사용자 지정 구성에는 모델별 User-Agent가 내장되어 있지 않습니다. 로그에 참고할 값이 필요하면 대상 브라우저에서 navigator.userAgent를 읽으세요. 화면 치수만으로는 모델별 문자열을 알 수 없습니다.
User-Agent 문자열은 축소되거나 바뀔 수 있으며 iPhone의 정확한 하드웨어 모델을 안정적으로 식별하는 데 적합하지 않습니다. 모바일 User-Agent를 사용해도 렌더링 엔진은 Chrome으로 유지됩니다. 앱 동작에는 기능 감지를 사용하고, 재현 가능한 문제 보고서에 브라우저 이름과 버전을 남기세요.
설정이나 로그를 확인할 때 참고하세요. 정확한 기기 모델은 해당 기기에서 직접 확인하세요.
navigator.userAgent;사용자 지정 크기를 402 × 874로 설정하세요. 긴 탐색 메뉴를 열고 마지막 링크와 닫기 버튼에 계속 접근할 수 있는지 확인합니다. 높이를 줄인 뒤 한 번 더 확인하세요. Safari에서 실제로 보이는 영역은 화면 전체보다 작을 수 있습니다.
모든 미리보기에서 같은 콘텐츠와 페이지 상태를 사용하세요. 한쪽의 제목이 더 길면 기기 차이로 보일 수 있습니다. 선택한 CSS 치수는 그대로 두고 모니터에 맞게 프레임 배율만 조절하세요.
텍스트 줄바꿈, 기본 버튼, 오른쪽 가장자리까지 닿는 콘텐츠를 확인하세요. 점검할 작업에서 사용하는 메뉴나 대화상자를 여세요.
비슷한 너비에서 비교하거나 미리보기 방향을 바꾸세요. 같은 콘텐츠를 유지하면 레이아웃이 어떻게 달라졌는지 알기 쉽습니다.
선택한 기기 화면을 PNG로 저장하거나 짧게 녹화하세요. 너비, 높이, 화면 방향과 같은 결과를 확인하는 데 필요한 순서를 함께 기록하세요.
너비가 402 CSS 픽셀에 가까운 Mobile Viewer 구성입니다. 너비 차이를 먼저, 그다음 높이 차이를 기준으로 골랐습니다. 비슷한 너비를 비교하면 중단점에서 레이아웃이 바뀌는 모습을 확인할 수 있습니다. 너비가 같아도 높이가 다르면 메뉴나 대화상자의 버튼에 접근하기 어려울 수 있습니다.
iPhone 16 Pro 및 iPhone 18 Pro 구성은 이 가이드와 너비, 높이, 참고 배율이 같습니다. 치수 확인을 일부 생략할 수 있습니다. 브라우저 엔진, 콘텐츠, 설정과 실제 기기 동작은 서로 다를 수 있습니다.
CSS 너비는 27 CSS px 차이가 납니다. 두 크기에서 구성 요소의 레이아웃이 달라지는지 확인하세요.
CSS 영역을 1:5로 나타낸 도식입니다. Mobile Viewer에서 데스크톱 페이지 옆에 이 설정을 추가하고 위 테스트를 반복하세요. 기본 프리셋이 없다면 너비와 높이를 직접 입력하세요.
| 프리셋 | 세로 방향 CSS px | DPR | 너비 차이 |
|---|---|---|---|
| iPhone 16 Pro | 402 × 874 | 3 | 0 px |
| iPhone 18 Pro | 402 × 874 | 3 | 0 px |
| Xiaomi 11i | 393 × 873 | 2.75 | -9 px |
| Pixel 5 | 393 × 851 | 2.75 | -9 px |
이 모델은 사용자 지정 크기로 확인하세요. Mobile Viewer를 설치하고 사이트를 연 뒤 Custom device를 선택하세요. 너비 402와 높이 874를 입력해 적용하고, 알아보기 쉬운 이름으로 저장하세요. 이 패널에서 설정할 수 있는 값은 너비와 높이이며 DPR 입력란은 없습니다. 3× 참고 배율은 CSS 치수를 구하는 데 쓰입니다. 미리보기의 DPR과 실제 기기의 동작은 별도로 확인하세요.
위에서 안내한 대로 확인하고 CSS를 수정한 뒤 같은 순서로 다시 테스트하세요. 특정 브라우저에서만 나타나는 문제라면 데스크톱에서 확인한 내용을 바탕으로 대상 브라우저에서 재현하세요.
화면 대각선은 6.3인치이고 세로 방향의 물리적 해상도는 1206 × 2622픽셀입니다. 웹사이트를 점검할 때는 별도로 안내한 402 × 874 CSS 픽셀 구성을 사용하세요.
이 가이드에 나오는 사용자 지정 구성을 사용하세요. 이 치수는 웹사이트 레이아웃을 점검하는 출발점입니다.
페이지는 데스크톱 Chrome에서 렌더링됩니다. 선택한 크기에서 레이아웃과 지원되는 상호작용을 확인하세요. iOS Safari, 브라우저 조작 요소와 키보드 동작을 실제 기기에서 확인하세요.
미디어 쿼리는 너비, 높이, 해상도 같은 조건을 확인합니다. 같은 조건을 여러 모델이 충족할 수 있습니다. 위의 402px 예제로 이 크기와 더 좁은 창을 확인하세요. 중단점은 콘텐츠에 맞춰 정하고 인접한 너비에서도 확인하세요.
DPR은 가로축과 세로축에 적용되는 배율입니다. 여기서 참고 배율은 3입니다. 예를 들어 DPR이 2×이면 정사각형 CSS 픽셀 하나가 가로 2개, 세로 2개의 물리적 픽셀 영역에 해당할 수 있습니다. 소수 DPR, 브라우저 확대, 래스터화에 따라 결과는 달라질 수 있습니다. 물리적 화면 밀도인 인치당 픽셀 수는 별도의 값이며 서로 다른 모델의 DPR이 같을 수 있습니다.
브라우저 도구 모음이 펼쳐지거나 접힐 수 있고 화면 키보드가 시각적 뷰포트에 영향을 줄 수 있습니다. 높이와 관련된 문제라면 레이아웃 뷰포트와 시각적 뷰포트의 크기를 모두 기록하세요. 프리셋 치수는 브라우저 상태 한 가지를 나타냅니다.
네. 데스크톱 Chrome에서 localhost나 127.0.0.1 페이지를 열고 Mobile Viewer를 실행하세요. 로컬이 아닌 사이트에는 HTTPS를 사용하세요. 모든 미리보기에서 같은 콘텐츠를 비교하고 결과에 설정값을 함께 기록하세요.
크기를 402 × 874에 맞춰 페이지를 열고 비슷한 너비와 비교하며 방문자가 자주 이용하는 동작을 확인하세요. 무료 Chrome 확장 프로그램 Mobile Viewer에서 시작할 수 있습니다.
확장 프로그램 설치Chrome Web Store무료무료 브라우저 확장 프로그램 · 계정 없이 사용 · 내 컴퓨터에서 실행