드롭다운 메뉴
항목에 사용할 작업 메뉴를 표시해요.
권장 API
| 속성·요소 | 형식 | 예제 초기값 | 설명 |
|---|---|---|---|
popovertarget | Matching element ID | Per instance | 버튼을 네이티브 팝오버에 연결해요. |
role="menuitem" | ARIA role | Edit, Duplicate, Archive | 메뉴 안에서 실행할 항목을 지정해요. |
상태
| 상태 | 조건·조작 | 결과 |
|---|---|---|
open | Actions 버튼을 눌러요. | 버튼 옆에 메뉴가 열리고 첫 항목으로 포커스가 가요. |
navigating | 위·아래 방향키나 Home·End를 눌러요. | 동작 항목 사이에서 포커스가 이동해요. |
dismissed | 동작을 고르거나 Escape를 누르거나 바깥을 눌러요. | 메뉴가 닫혀요. 동작을 선택하면 결과도 알려요. |
Svelte 구현 지침
트리거로 메뉴를 열고 위아래 방향키와 Home/End로 포커스를 이동합니다. 항목을 선택하면 메뉴가 닫히고 트리거로 포커스가 돌아갑니다. Escape와 바깥 클릭으로도 닫습니다.
Use the included svelte source as the example. Keep IDs unique per instance and use the framework's normal lifecycle for any added listeners. Prefer a compatible existing accessible primitive when the project requires behavior beyond the example. Test the native Popover API and CSS anchor positioning in the target browsers.
CSS 변수
| 변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
--q-text | color | #28302a | 제목과 기본 텍스트의 색이에요. |
--q-muted | color | #70776f | 설명이나 보조 텍스트의 색이에요. |
--q-font-size | length | 13px | 컴포넌트의 기준 글자 크기예요. |
--q-accent | color | #344e41 | 활성 상태, 표시 막대, 포커스에 쓰는 강조색이에요. |
--q-surface | color | #ffffff | 컨트롤과 카드의 배경색이에요. |
--q-border | color | #dce0d8 | 테두리와 구분선의 색이에요. |
--q-radius | length | 10px | 모서리를 둥글게 하는 기준값이에요. |
--q-space | length | 4px | 간격과 여백을 계산하는 기준값이에요. |
--q-shadow | shadow | 0 4px 16px rgb(0 0 0 / 8%) | 바닥에서 떠 보이는 요소의 그림자예요. |