목차 링크로 이동한 제목이 상단 바에 가려질 때

목차에서 항목을 눌렀더니 주소 끝에 #checklist가 붙고 화면도 움직였는데, 제목만 보이지 않을 수 있습니다. 고정된 상단 바가 제목 위에 겹치는 경우입니다. 링크가 가리키는 요소와 실제로 스크롤한 상자를 찾으면 어느 곳에 여유를 줘야 할지 결정할 수 있습니다.

주소, 대상, 스크롤 위치를 순서대로 확인합니다

관찰한 증상 확인할 곳 수정 방향
주소가 바뀌어도 해당 제목으로 이동하지 않는다 링크의 해시와 대상 id가 일치하고 유일한지 링크와 실제 대상을 먼저 연결한다. 클릭을 가로채는 스크립트가 있으면 URL 직접 열기와 결과를 비교한다.
이동은 됐지만 한두 제목이 상단 바 뒤에 가린다 실제 id 요소의 위쪽 경계와 바의 아래쪽 경계 대상에 scroll-margin-top을 주어 해당 제목에 여유를 확보한다.
같은 상단 바 아래에서 여러 제목이 반복해서 가린다 페이지 자체와 내부 패널 중 실제로 스크롤한 곳 해당 스크롤 상자에 scroll-padding-top을 주어 공통으로 가리는 구간을 뺀다.
마지막 제목이 앞의 제목들과 다른 위치에 멈춘다 스크롤이 바닥에 도달했는지 제목이 읽히는지 먼저 확인한다. 마지막 제목을 같은 높이까지 끌어올려야 하는 설계라면 실제 아래쪽 공간이 필요하다.

scroll-margin-top은 이동 대상의 바깥쪽으로 기준 영역을 넓힙니다. scroll-padding-top은 스크롤 상자에서 목표를 배치할 수 있는 영역의 위쪽을 줄입니다. 둘 다 이 예제에서 일반적인 margin이나 padding처럼 본문 배치를 밀어내지는 않습니다. 스크롤 스냅을 켜지 않아도 해시 링크의 이동 위치에 영향을 줄 수 있습니다.

한 파일에서 대상 여유와 공통 여유를 비교합니다

아래를 anchor-offset.html로 저장해 브라우저에서 열고 배포 점검으로 이동을 누릅니다. 처음에는 상단 바가 제목을 덮습니다. 파일에 있는 두 규칙 중 하나의 주석을 해제한 뒤, 주소 끝의 #checklist를 지우고 다시 엽니다. 이 예제에서 상단 바 높이는 64px이며 제목과 바 사이에는 12px을 남깁니다.

<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<title>목차 링크와 상단 바 겹침 실험</title>
<style>
  :root { --bar: 64px; }
  body { margin: 0; font: 16px/1.5 system-ui; }
  header {
    position: fixed;
    inset: 0 0 auto;
    z-index: 1;
    height: var(--bar);
    display: grid;
    align-items: center;
    padding-inline: 16px;
    color: white;
    background: #24374b;
  }
  main { padding: calc(var(--bar) + 16px) 16px 0; }
  .lead { min-height: 700px; }
  h2 { margin: 0; }
  .tail { min-height: 900px; }

  /* 아래 두 규칙을 한 번에 하나씩 비교합니다. */
  /* #checklist { scroll-margin-top: calc(var(--bar) + 12px); } */
  /* html { scroll-padding-top: calc(var(--bar) + 12px); } */
</style>
<header>운영 안내</header>
<main>
  <nav aria-label="목차"><a href="#checklist">배포 점검으로 이동</a></nav>
  <div class="lead"><p>준비 항목</p></div>
  <h2 id="checklist">배포 점검</h2>
  <div class="tail"><p>서비스 상태와 응답 코드를 확인합니다.</p></div>
</main>
</html>

Chrome에서 링크 이동 직후 제목 높이를 측정했습니다

2026년 11월 10일 Chrome 157.0.8103.38을 헤드리스로 실행했습니다. 900×600px 화면에서 링크를 누르거나 해시 주소를 직접 열고, getBoundingClientRect()로 제목의 위쪽과 바의 아래쪽을 비교했습니다. 수치는 화면 맨 위를 0px으로 두고 측정한 값입니다.

조건 제목 위쪽 바 아래쪽 관찰
보정 없음 0px 64px 제목 전체가 가림
제목에 scroll-margin-top: 76px 76px 64px 바와 제목 사이 12px
html에 scroll-padding-top: 76px 76px 64px 바와 제목 사이 12px
제목과 html에 각각 76px 152px 64px 두 여유가 합쳐짐
body에 scroll-padding-top: 76px 0px 64px 제목 전체가 가림
html에 76px, 제목 아래 공간 축소 468px 64px 스크롤이 최대 위치에서 멈춤
제목에 76px, 해시 주소 직접 열기 76px 64px 바와 제목 사이 12px

기본 상태의 제목은 0~36px에 놓여 상단 바가 전부 덮었습니다. 두 규칙에 각각 76px을 주면 이 예제에서는 여유가 합쳐져 152px에 멈췄습니다. 하나로 원하는 위치가 나오면 같은 높이를 중복으로 적용할 필요가 없습니다. 마지막 제목 아래쪽 공간을 줄인 경우에는 scrollY가 최대값인 352px에 도달해 제목이 468px에 남았습니다.

여기서 확인한 범위는 로컬 HTML의 이동과 위치입니다. 운영 페이지, 모바일 기기, 다른 브라우저 엔진이나 보조 기술은 시험하지 않았습니다.

실제 화면에서 확인할 항목

  1. 페이지가 움직인다면 document.scrollingElement를 확인합니다. 예제에서는 html이 스크롤합니다. body에 준 스크롤 패딩은 이 문서의 뷰포트에 전파되지 않았습니다. 내부 목록이나 사이드 패널이 움직인다면 overflow: auto 등으로 스크롤되는 그 요소에 적용합니다.
  2. 상단 바의 실제 아래쪽 경계를 기준으로 값을 잡습니다. 모바일 메뉴가 두 줄이 되거나 확대 시 상단 바가 높아진다면 같은 픽셀 값을 그대로 쓰면 다시 가릴 수 있습니다. 화면 크기별로 실제 바 높이와 여유값을 맞춥니다.
  3. 첫 제목과 마지막 제목을 각각 눌러 보고, 해시가 포함된 주소를 새 탭에서 직접 엽니다. Tab으로 목차 링크와 제목 주변의 버튼까지 이동해 초점 표시가 상단 바에 가려지지 않는지 확인합니다. 링크 이동 위치와 키보드 초점은 별도로 관찰합니다.

공식 문서와 관련 글