CSS Anchor Positioning과 Popover API: 외부 라이브러리 없이 툴팁과 드롭다운 구현하기
안녕하세요 Lovefield입니다.
프론트엔드에서 툴팁(Tooltip), 드롭다운 메뉴(Dropdown), 컨텍스트 메뉴 같은 부유형 UI(Floating UI)를 직접 구현해 보신 분들이라면 한 번쯤 골치 아픈 문제들을 겪어보셨을 것입니다.
부모 요소에 overflow: hidden이 걸려 있어 툴팁이 잘리거나, 화면의 다른 모달들과 z-index 경쟁을 벌이고, 스크롤하거나 창 크기를 줄였을 때 툴팁이 화면 밖으로 삐져나가는 현상들입니다. 이 때문에 그동안 우리는 Floating UI(Popper.js) 같은 외부 자바스크립트 라이브러리에 의존하거나 Vue의 <Teleport to="body">를 사용해 DOM 트리를 강제로 옮긴 뒤 좌표를 일일이 계산해야 했습니다.
하지만 이제는 순수 웹 표준만으로 이 모든 문제를 깔끔하게 해결할 수 있습니다. 바로 HTML Popover API와 CSS Anchor Positioning API의 조합입니다. 이번 글에서는 JS 위치 연산 코드 없이도 완벽한 부유형 UI를 구축하는 방법을 정리해 보려 합니다.
HTML Popover API: z-index 전쟁의 종식
Popover API는 요소를 브라우저의 최상단 레이어(Top Layer)로 즉시 띄워주는 네이티브 HTML 표준 속성입니다. <dialog> 요소가 동작하는 레이어와 동일한 공간을 사용하므로, 문서 내 어떤 요소가 z-index: 99999를 가지고 있더라도 항상 그 위에 렌더링됩니다.
자바스크립트 0줄로 동작하는 기본 구조
버튼의 popovertarget 속성과 팝오버 요소의 id를 연결하기만 하면 클릭 시 열리고 닫히는 동작이 자동으로 완성됩니다.
HTML, XML
1
2
3
4
5
6
7
8
9
10
11
<button popovertarget="user-menu" class="trigger-btn">
프로필 메뉴 열기
</button>
<div id="user-menu" popover="auto" class="dropdown-panel">
<ul>
<li>내 정보 수정</li>
<li>설정</li>
<li>로그아웃</li>
</ul>
</div>popover 속성 모드 차이
popover="auto" (기본값): 팝오버 바깥 영역을 클릭(Light Dismiss)하거나 ESC 키를 누르면 자동으로 닫힙니다. 또한 화면에 다른 auto 팝오버가 열리면 기존 팝오버는 자동으로 닫혀 드롭다운이나 메뉴에 적합합니다.
popover="manual": 외부 클릭이나 ESC 키로 닫히지 않으며, 명시적인 닫기 버튼(popovertargetaction="hide")이나 JS의 .hidePopover() 호출로만 닫힙니다. 토스트 알림(Toast)이나 고정형 배너에 적합합니다.
> Tip: Popover API는 키보드 포커스 관리와 스크린 리더 접근성(ARIA 상태 동기화)까지 브라우저 수준에서 기본으로 처리해 줍니다.
CSS Anchor Positioning: 특정 요소 옆에 정확히 고정하기
Popover API가 요소를 최상단 레이어로 띄워준다면, CSS Anchor Positioning은 그 요소를 기준점이 되는 버튼(Anchor)의 상하좌우 원하는 위치에 정확히 부착해 주는 역할을 합니다.
anchor-name과 position-anchor 연결
먼저 기준이 될 버튼에 --로 시작하는 고유한 anchor-name을 부여하고, 띄울 요소에 position-anchor로 연결합니다.
CSS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
.trigger-btn {
anchor-name: --menu-anchor;
}
.dropdown-panel {
/* 기본 popover 스타일 초기화 */
margin: 0;
border: 1px solid #e2e8f0;
border-radius: 8px;
padding: 8px;
background: #ffffff;
box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
/* 앵커 연결 및 위치 지정 */
position: fixed;
position-anchor: --menu-anchor;
/* 패널의 상단(top)을 앵커의 하단(bottom)에 8px 간격을 두고 부착 */
top: calc(anchor(bottom) + 8px);
/* 패널의 왼쪽(left)을 앵커의 왼쪽(left)과 정렬 */
left: anchor(left);
}이 코드만으로 페이지를 스크롤하거나 브라우저 창 크기를 조절해도 브라우저는 컴포지터 스레드 수준에서 지연 없이 툴팁을 버튼 아래에 완벽하게 따라다니도록 유지합니다.
화면 끝단 자동 회피: position-try-fallbacks
실무에서 부유형 UI를 다룰 때 가장 까다로운 부분은 "버튼이 화면 맨 아래에 있을 때 드롭다운이 아래로 열리면 화면 밖으로 잘린다"는 점입니다. 기존에는 getBoundingClientRect()로 뷰포트 여백을 매 프레임 계산해야 했습니다.
CSS Anchor Positioning에서는 position-try-fallbacks 속성 한 줄로 자동 방향 전환을 선언할 수 있습니다.
flip-block과 flip-inline 활용
CSS
1
2
3
4
5
6
7
8
9
10
11
.dropdown-panel {
position: fixed;
position-anchor: --menu-anchor;
/* 기본 위치: 버튼의 아래쪽, 왼쪽 정렬 */
position-area: bottom span-right;
margin-top: 8px;
/* 공간이 부족할 경우 상하(flip-block) 또는 좌우(flip-inline)로 자동 반전 */
position-try-fallbacks: flip-block, flip-inline, flip-block flip-inline;
}position-area: 복잡한 top/left 계산 대신 3x3 그리드 개념(top, bottom, left, right, span-right 등)으로 기준 요소 주변의 배치를 직관적으로 선언할 수 있는 최신 단축 속성입니다.
flip-block: 아래쪽 공간이 부족하면 자동으로 버튼의 위쪽(top)으로 뒤집어 배치합니다.
flip-inline: 오른쪽 공간이 부족하면 왼쪽 방향으로 정렬을 반전시킵니다.
Vue 3에서 다중 동적 리스트의 앵커 처리하기
실무에서는 단일 버튼이 아니라 v-for로 렌더링되는 테이블 행(Row)마다 각각의 액션 메뉴가 붙는 경우가 많습니다. 이때 모든 버튼에 같은 anchor-name을 주면 위치가 충돌하므로, 동적 인라인 스타일로 고유 이름을 바인딩해 주면 깔끔하게 해결됩니다.
Vue
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<script setup lang="ts">
interface Item {
id: number;
name: string;
}
const items: Item[] = [
{ id: 1, name: '프로젝트 A' },
{ id: 2, name: '프로젝트 B' },
{ id: 3, name: '프로젝트 C' },
];
</script>
<template>
<ul>
<li v-for="item in items" :key="item.id" class="list-row">
<span>{{ item.name }}</span>
<!-- 각 아이템 ID별로 고유한 anchor-name 및 popovertarget 부여 -->
<button
:popovertarget="`action-menu-${item.id}`"
:style="{ anchorName: `--anchor-${item.id}` }"
>
더보기
</button>
<div
:id="`action-menu-${item.id}`"
popover="auto"
class="action-popover"
:style="{ positionAnchor: `--anchor-${item.id}` }"
>
<button>수정하기</button>
<button>삭제하기</button>
</div>
</li>
</ul>
</template>
<style scoped>
.action-popover {
margin: 0;
position: fixed;
position-area: bottom span-left;
position-try-fallbacks: flip-block, flip-inline;
}
</style><Teleport>로 DOM 구조를 분리할 필요도 없고, 어떤 메뉴가 현재 열려 있는지 추적하기 위한 activeMenuId 같은 반응형 상태 변수조차 필요하지 않습니다.
브라우저 지원 현황 및 폴백(Fallback) 전략
2026년 현재 기준으로 Popover API는 모든 주요 브라우저(Chrome, Edge, Safari, Firefox)에서 완벽하게 지원됩니다. CSS Anchor Positioning 역시 Chromium 계열(Chrome, Edge)과 최신 Safari에서 정식 지원되며 표준화가 완료되었습니다.
구형 브라우저 환경까지 폭넓게 대응해야 하는 서비스라면 @supports 규칙을 활용해 안전하게 점진적 향상(Progressive Enhancement)을 적용할 수 있습니다.
CSS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
.dropdown-panel {
/* 폴백: 미지원 브라우저에서는 화면 중앙 모달 형태로 안전하게 노출 */
position: fixed;
inset: 0;
margin: auto;
width: fit-content;
height: fit-content;
}
@supports (anchor-name: --test) {
.dropdown-panel {
inset: auto;
margin: 0;
position-anchor: --menu-anchor;
position-area: bottom span-right;
position-try-fallbacks: flip-block;
}
}정리하며
그동안 프론트엔드 생태계에서는 레이아웃 배치와 팝업 제어를 위해 무거운 자바스크립트 런타임 연산에 의존해 왔습니다. HTML Popover API와 CSS Anchor Positioning은 이러한UI 패턴을 브라우저의 네이티브 렌더링 엔진 영역으로 되돌려 놓았습니다.
번들 크기를 줄이고 스크롤 성능을 극대화하고 싶다면, 다음 UI 컴포넌트를 설계할 때 외부 라이브러리를 설치하기 전에 순수 HTML/CSS 표준 API 도입을 먼저 검토해 보시는 것을 추천합니다.
해당 글은 AI를 통해 제작되었습니다.

Vitest 입문 가이드: 처음 시작하는 프론트엔드 테스트 환경 구축과 기본 문법
테스트 코드를 처음 작성하는 개발자를 위해 Vitest의 설치부터 기본 테스트 문법(describe, it, expect), 모킹(Mocking), 그리고 Vue 3 컴포넌트 및 Composable 기초 테스트까지 단계별로 정리합니다.
Java Script
