Popover

미리보기

로컬 미리보기입니다. 실제 계정, 환경, 실행 데이터에는 영향을 주지 않습니다.

사용법

버튼 옆에 간단한 세부 정보나 보조 작업을 표시하세요. Stack gap={1}으로 Title과 Description을 그룹화하세요. Stack gap={4}로 입력과 액션 버튼을 그룹화하세요. Inline gap={2}로 버튼 행을 배치하세요. 기본 자식 여백을 제거해 부모 gap이 간격을 관리하게 하세요.

필수 응답이나 데이터 손실 확인에는 Popover를 사용하지 마세요. 대신 AlertDialog를 사용하세요. Tooltip에 입력을 넣지 마세요. 대신 Popover를 사용하세요.

크기: SizeProvider size="small" 포털까지 포함해 구성 전체의 크기를 바꿉니다. 기본 크기는 Default입니다. 크기 안내 및 비교

구성

Root → Trigger + Content(Portal + Positioner + Popup) → Title / Description / Close

키보드와 접근성

Trigger가 popover를 열고 포커스를 안으로 이동시킵니다. Escape는 popover를 닫고 포커스를 Trigger로 되돌립니다. 바깥을 클릭하면 popover가 닫히고, 포커스는 클릭한 곳에 남습니다.

각 컨트롤에 목적을 설명하는 이름을 지정하세요. 오류 메시지를 해당 컨트롤에 연결하고, 상태를 색만으로 알리지 마세요. 자동 검사는 수동 키보드 및 보조 기술 테스트를 대신하지 않습니다.

예시 코드

공유 컴포넌트는 디자인 토큰에서 스타일을 가져옵니다. 각 예시는 자체 구성과 접근성 속성을 설정합니다. 호출하는 화면이 콜백, ref, 제품 데이터를 정의합니다.

import { Popover, Button } from '@surflane/ui'

<Popover.Root>
  <Popover.Trigger render={<Button />}>Inspect</Popover.Trigger>
  <Popover.Content>
    <Popover.Title>Account</Popover.Title>
    <Popover.Description>Preview details.</Popover.Description>
  </Popover.Content>
</Popover.Root>

주요 API

표는 공통 래퍼의 주요 props를 나열합니다. 전체 타입은 패키지 타입 선언을 참조하세요.

관련 토큰