AGENT SKILL

18-ui-popup-dim

暂无简介

适用职业设计师
License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
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

  • Dim child GameObject에 붙는다
  • 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가 아님)

04 同仓库更多 Skills