ChangelogComponents
0.1.23
Tooltip이 내부에서 합쳐놓은 Portal, Positioner, Popup primitive를 namespace에 추가로 노출합니다.
Tooltip.Content가 내부에서 합쳐놓은 Tooltip.Portal, Tooltip.Positioner, Tooltip.Popup을 namespace에 추가로 노출합니다. 소비자 환경이 z-index를 강제하거나 custom portal container가 필요한 escape hatch 상황에서 primitive를 직접 조합할 수 있습니다. Tooltip.Content의 기존 사용 방식은 동일하게 동작하며 기존 코드 변경은 필요하지 않습니다.
분해 모드 사용
<Tooltip.Portal container={someContainer}>
<Tooltip.Positioner side="top" $css={{ zIndex: 9999 }}>
<Tooltip.Popup>...</Tooltip.Popup>
<Tooltip.Arrow />
</Tooltip.Positioner>
</Tooltip.Portal>분해 모드에서는 Tooltip.Arrow를 Positioner의 자식(= Popup의 형제)으로 직접 배치합니다. 자세한 가이드는 Tooltip 문서의 "수동 조합" 섹션을 참고하세요.
z-index에 대한 주의
디자인 시스템은 z-index 토큰을 노출하지 않습니다. 일반적으로는 Base UI portal의 stacking 기본 동작만으로 충분합니다. $css={{ zIndex: ... }}는 소비자 앱 환경(예: 더 높은 z-index를 가진 외부 portal이나 오버레이)이 강제할 때만 escape hatch로 사용해 주세요.