AGENT SKILL
18-ui-popup-dim
暂无简介
适用职业设计师
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
18-ui-popup-dim — UIPopupDim
Status: ACTIVE AppliesTo: v1
Purpose
popup shared dim / blocker / dim click 처리를 UIPopupPanel에서 분리한다.
Code Path
framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Popup/UIPopupDim.cs
Responsibilities
DimchildGameObject에 붙는다- Awake에서 prefab
Image의 원본 color를 캐시한다 (스크립트에서 색상을 덮어쓰지 않음) - show 시 캐시된 원본 color를 적용, hide 시 alpha=0으로 설정한다
- 같은
GameObject의CanvasGroup으로 raycast blocking 상태를 제어한다 IPointerClickHandler로 dim click을 받는다UIPopupManager.HandleDimClicked()로 dim click을 위임한다
Rules
UIPopupDim은PopupRoot와 분리된 sibling이어야 한다RequireComponent(typeof(Image)),RequireComponent(typeof(CanvasGroup))를 사용한다Button나EventTrigger를 쓰지 않는다- dim click 허용 여부는 top popup frame policy 기준이다
- dim 표시 여부와 blocker 여부도 top popup frame policy 기준이다
API
public void ApplyState(bool showDim, bool blockBehind, bool closeOnDimClick)
dimColor/dimAlpha파라미터 없음 — prefab Image의 원본 color를 SSOT로 사용
Notes
UIPopupPanel은UIPopupDim과PopupRoot만 관리한다- dim의 실제 visual / click 동작은
UIPopupDim이 담당한다 - dim color/alpha 변경은 prefab의 Image 컴포넌트에서 직접 설정한다 (UISettings가 아님)