실무에 바로 적용할 수 있는 웹 제작 꿀팁 및 유용한 자료실 공간입니다.
나눔웹이 제공하는 핵심 노하우와 마케팅 인사이트를 자유롭게 활용해 보십시오.

나눔웹 모바일 꿀팁

모바일 키보드가 입력창을 가릴 때, visualViewport로 화면 맞추는 법

모바일에서 키보드가 올라오면서 입력창이나 하단 고정 버튼을 가린다면, viewport 메타의 interactive-widget 값과 visualViewport API로 키보드 높이만큼 화면을 맞춰 주면 대부분 해결됩니다.
특히 화면 아래에 붙여 둔 상담 신청 폼이나 채팅형 입력창에서 자주 생기는 문제입니다.

💡 키보드가 왜 화면을 덮을까요?

모바일 브라우저에는 레이아웃 기준이 되는 화면(layout viewport)과 실제로 눈에 보이는 영역(visual viewport)이 따로 있습니다. 키보드가 올라오면 보이는 영역만 줄어들고 레이아웃 화면은 그대로인 경우가 많아서, position: fixed; bottom: 0으로 붙인 요소가 키보드 뒤에 숨어 버립니다. 안드로이드 크롬도 108 버전부터 이 방식이 기본값이 됐습니다.

1. 안드로이드는 interactive-widget으로 동작 고르기

viewport 메타에 interactive-widget 값을 넣으면 키보드가 올라올 때 페이지를 어떻게 다룰지 정할 수 있습니다. resizes-content로 두면 레이아웃 화면 자체가 키보드만큼 줄어들어, 하단 고정 버튼이 키보드 바로 위로 올라옵니다.

<meta name="viewport"
  content="width=device-width, initial-scale=1,
  interactive-widget=resizes-content">
값키보드가 올라올 때
resizes-visual보이는 영역만 줄어듦 (크롬 기본값)
resizes-content레이아웃 화면까지 줄어듦
overlays-content아무것도 줄지 않고 키보드가 위에 덮음

다만 이 값은 아이폰 사파리에서는 아직 무시됩니다. 그래서 아이폰까지 맞추려면 다음 방법을 같이 씁니다.

2. 아이폰까지 맞추려면 visualViewport로 높이 계산

window.visualViewport는 지금 눈에 보이는 영역의 높이와 위치를 알려 줍니다. 전체 창 높이에서 이 값을 빼면 대략 키보드가 차지한 높이가 나오고, 이걸 CSS 변수로 넘겨 하단 버튼을 그만큼 올리면 됩니다.

// 키보드 높이를 CSS 변수로 전달
const vv = window.visualViewport;
function syncKeyboard() {
  const gap = window.innerHeight
    - vv.height - vv.offsetTop;
  document.documentElement.style
    .setProperty('--kb', Math.max(0, gap) + 'px');
}
if (vv) {
  vv.addEventListener('resize', syncKeyboard);
  vv.addEventListener('scroll', syncKeyboard);
}
/* 하단 고정 버튼 */
.fixed-cta {
  position: fixed;
  bottom: 0;
  transform: translateY(calc(var(--kb, 0px) * -1));
}

1번 설정으로 레이아웃 화면이 이미 줄어든 안드로이드에서는 계산값이 0 근처로 나오기 때문에 두 방법을 같이 써도 버튼이 두 번 올라가지 않습니다.

3. 적용 후 꼭 확인할 것

  • 실제 아이폰과 안드로이드 기기에서 입력창을 눌러 확인하기 (PC 개발자 도구의 모바일 모드에는 키보드가 없습니다)
  • 입력창이 키보드 바로 위에 보이는지, 하단 버튼이 입력창을 다시 가리지 않는지
  • 키보드를 내린 뒤 버튼이 원래 자리로 돌아오는지
  • 카카오톡·네이버 앱 안에서 열었을 때도 같은지

광고나 카톡 공유로 들어오는 방문자는 앱 안 브라우저로 보는 경우가 많으니 마지막 항목도 꼭 확인해 보세요.

"입력창이 가려지는 순간, 문의 한 건이 그대로 사라집니다."

나눔웹은 문의 폼을 만들 때 실제 휴대폰에서 키보드를 올려 보며
입력부터 전송 버튼까지 막힘없이 이어지는지 확인합니다.


List of Articles
번호 분류 제목 글쓴이
86 UI/UX 링크 밑줄이 글자에 붙어 답답할 때, text-underline-offset으로 다듬는 법 new 나눔웹
» 모바일 모바일 키보드가 입력창을 가릴 때, visualViewport로 화면 맞추는 법 new 나눔웹
84 웹 성능 사용하지 않는 CSS 줄이기, 크롬 Coverage 탭으로 안 쓰는 코드 찾는 법 나눔웹
83 마케팅 GA4 문의 전환 설정법, 감사 페이지 도달로 실제 문의 수 세는 순서 나눔웹
82 UI/UX 고정 헤더에 제목이 가려질 때, scroll-margin-top으로 앵커 맞추는 법 나눔웹
81 퍼블리싱 CSS 컨테이너 쿼리 쓰는 법, 화면이 아니라 카드 폭에 맞춰 반응하기 나눔웹
80 UI/UX 폼 에러가 입력 전에 뜨는 문제, :user-invalid로 고치는 법 나눔웹
79 모바일 모바일 브라우저 상단바 색 맞추기, theme-color 메타 태그 쓰는 법 나눔웹
78 마케팅 문의 완료 페이지 noindex 설정법, 검색에 잡히지 않게 막는 순서 나눔웹
77 UI/UX 문의란이 내용만큼 늘어나게, CSS field-sizing으로 맞추는 법 나눔웹
76 웹 성능 긴 페이지 스크롤이 무거울 때, content-visibility로 렌더링 줄이는 법 나눔웹
75 모바일 모바일 100vh 잘림, dvh·svh로 주소창 높이까지 맞추는 법 나눔웹
74 마케팅 구글 서치 콘솔 등록 방법, 새 홈페이지 소유권 확인부터 색인 요청까지 나눔웹
73 퍼블리싱 CSS :has() 선택자 활용법, 자식 상태에 따라 부모 박스 스타일 바꾸기 나눔웹
72 웹 성능 반응형 이미지 srcset 쓰는 법, 모바일에 PC용 큰 사진을 보내지 않으려면 나눔웹
71 퍼블리싱 제목 줄바꿈이 어색할 때, text-wrap: balance로 한 단어만 남는 문제 정리 나눔웹
70 마케팅 robots.txt 작성법, 검색에 안 보여야 할 페이지와 사이트맵 위치 알려주는 순서 나눔웹
69 UI/UX 스켈레톤 로딩 화면 만들기, 빈 화면 대신 회색 자리 표시로 기다림 줄이는 법 나눔웹
68 퍼블리싱 모바일에서 표(table)가 깨질 때, 가로 스크롤로 감싸거나 카드형으로 바꾸는 법 나눔웹
67 웹 성능 gzip 압축 설정법, 홈페이지 HTML·CSS 파일을 작게 보내 로딩 줄이는 순서 나눔웹
Board Pagination Prev 1 2 3 4 5 Next
/ 5
rhwlsghkcocndgus XE2.1.39 STAGE1.5.4