Files
Gnuboard7/templates/_bundled/sirsoft-admin_basic/src/components/modals/ConfirmModal.tsx
T
HeuJung 0bcd42ac04 fix(admin_basic,core,ecommerce,plugins,basic): stale dist 전수 재빌드 + 소스맵 게이트 audit 룰 신설
공개 — admin_basic 1.0.4 가 이전 소스로 빌드된 stale dist 를 릴리즈에
실어 주문 상세 합계행에 표현식 원문이 노출되던 회귀를 1.0.5 재빌드로 재수록.

- admin_basic 1.0.5: --production 재빌드 + 서빙 번들 회귀 E2E(red→green) + 시나리오 매니페스트
- 전수 점검: sourcemap 잔존 9확장+코어 3번들 --production 재빌드, untracked .map 3개 삭제
 (+1 bump: gdpr 1.0.3 / tosspayments 1.0.2 / verification_kginicis 1.0.3 /
 verification_nhnkcp 1.0.1 / basic 1.1.1 — 미공개 워킹 5건은 CHANGELOG 누적)
- 리터럴 대조 전수: 기능 drift 는 admin_basic 단독 확정(타 대상 차집합 0), 릴리즈 패리티 7/7 일치
- board/page 사문 build 스크립트 제거 (vite.config 부재 — module:build --all 실패 요인)
- audit 룰 신설: extension-dist-sourcemap-reference(error),
 extension-dist-source-literal-sync(warn) + coverage/룰 테스트/규정 문서 정정
2026-08-12 14:31:26 +09:00

368 lines
12 KiB
TypeScript

// audit:allow extension-dist-source-literal-sync 미등록(components.json 부재)·미참조 컴포넌트 — 배럴(modals/index.ts)만 재수출할 뿐 소비처가 없어 tree-shake 된다
import React, { useEffect, useRef } from 'react';
import { Div } from '../basic/Div';
import { Button } from '../basic/Button';
import { P } from '../basic/P';
import { Span } from '../basic/Span';
import { Icon } from '../basic/Icon';
import { IconName } from '../basic/IconTypes';
// G7Core.t() 번역 함수 참조
const t = (key: string, params?: Record<string, string | number>) =>
(window as any).G7Core?.t?.(key, params) ?? key;
/** Alert 박스 타입 */
export type ConfirmModalAlertType = 'warning' | 'danger' | 'info';
/** Alert 박스 설정 */
export interface ConfirmModalAlert {
/** Alert 타입 (warning, danger, info) - 기본값: warning */
type?: ConfirmModalAlertType;
/** Alert 제목 (예: "경고") */
title?: string;
/** Alert 내용 (문자열 배열은 리스트로, ReactNode는 그대로 렌더링) */
content: string[] | React.ReactNode;
}
export interface ConfirmModalProps {
/** 모달 열림 상태 */
isOpen: boolean;
/** 모달 닫기 핸들러 */
onClose: () => void;
/** 모달 제목 (기본값: common.confirm) */
title?: string;
/** 확인 메시지 */
message: string | React.ReactNode;
/** 확인 버튼 텍스트 (기본값: common.confirm) */
confirmText?: string;
/** 취소 버튼 텍스트 (기본값: common.cancel) */
cancelText?: string;
/** 확인 버튼 클릭 핸들러 */
onConfirm: () => void;
/** 취소 버튼 클릭 핸들러 */
onCancel?: () => void;
/** 확인 버튼 variant */
confirmButtonVariant?: 'primary' | 'secondary' | 'danger' | 'ghost';
/** 로딩 중 여부 (확인 버튼 비활성화 및 텍스트 변경) */
isLoading?: boolean;
/** 로딩 중 확인 버튼에 표시할 텍스트 */
loadingText?: string;
/** 모달 너비 (기본값: 400px) */
width?: string;
/** 경고/추가 정보 영역 (Alert 박스) */
alert?: ConfirmModalAlert;
/** 추가 경고 메시지 (빨간색 텍스트로 표시) */
warningText?: string;
}
/**
* ConfirmModal 컴포넌트
*
* 사용자에게 확인을 요청하는 모달 다이얼로그 컴포넌트.
* 확인/취소 버튼을 제공하며, 로딩 상태를 지원합니다.
*
* @example
* // 레이아웃 JSON 사용 예시
* {
* "name": "ConfirmModal",
* "props": {
* "isOpen": "{{modals.saveConfirm}}",
* "title": "확인",
* "message": "변경사항을 저장하시겠습니까?",
* "confirmText": "$t:common.confirm",
* "cancelText": "$t:common.cancel"
* }
* }
*/
export const ConfirmModal: React.FC<ConfirmModalProps> = ({
isOpen,
onClose,
title,
message,
confirmText,
cancelText,
onConfirm,
onCancel,
confirmButtonVariant = 'primary',
isLoading = false,
loadingText,
width = '400px',
alert,
warningText,
}) => {
const modalRef = useRef<HTMLDivElement>(null);
const previousFocusRef = useRef<HTMLElement | null>(null);
// props로 전달된 값이 없으면 다국어 키 사용
const resolvedTitle = title ?? t('common.confirm');
const resolvedConfirmText = confirmText ?? t('common.confirm');
const resolvedCancelText = cancelText ?? t('common.cancel');
const resolvedLoadingText = loadingText ?? t('common.loading');
// ESC 키로 모달 닫기
useEffect(() => {
const handleEscape = (event: KeyboardEvent) => {
if (event.key === 'Escape' && isOpen && !isLoading) {
onClose();
}
};
if (isOpen) {
document.addEventListener('keydown', handleEscape);
return () => document.removeEventListener('keydown', handleEscape);
}
}, [isOpen, isLoading, onClose]);
// 포커스 트랩
useEffect(() => {
if (isOpen && modalRef.current) {
// 모달 열릴 때 현재 포커스 저장
previousFocusRef.current = document.activeElement as HTMLElement;
// 모달 내부 포커스 가능한 요소들
const focusableElements = modalRef.current.querySelectorAll(
'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
);
const firstElement = focusableElements[0] as HTMLElement;
const lastElement = focusableElements[focusableElements.length - 1] as HTMLElement;
// 첫 번째 요소에 포커스
firstElement?.focus();
// Tab 키 핸들러 (포커스 트랩)
const handleTab = (event: KeyboardEvent) => {
if (event.key !== 'Tab') return;
if (event.shiftKey) {
// Shift + Tab
if (document.activeElement === firstElement) {
event.preventDefault();
lastElement?.focus();
}
} else {
// Tab
if (document.activeElement === lastElement) {
event.preventDefault();
firstElement?.focus();
}
}
};
document.addEventListener('keydown', handleTab);
return () => {
document.removeEventListener('keydown', handleTab);
// 모달 닫힐 때 이전 포커스 복원
previousFocusRef.current?.focus();
};
}
}, [isOpen]);
// body 스크롤 방지
useEffect(() => {
if (isOpen) {
document.body.style.overflow = 'hidden';
return () => {
document.body.style.overflow = '';
};
}
}, [isOpen]);
const handleConfirm = () => {
onConfirm();
};
const handleCancel = () => {
// 로딩 중에는 취소 불가
if (isLoading) return;
onCancel?.();
onClose();
};
const handleClose = () => {
// 로딩 중에는 닫기 불가
if (isLoading) return;
onClose();
};
const handleOverlayClick = () => {
// 로딩 중에는 오버레이 클릭으로 닫기 불가
if (isLoading) return;
onClose();
};
// 버튼 variant별 스타일 매핑 (스크린샷 기준: 어두운 확인 버튼)
const confirmVariantClassMap: Record<'primary' | 'secondary' | 'danger' | 'ghost', string> = {
primary: 'bg-gray-900 dark:bg-gray-700 text-white hover:bg-gray-800 dark:hover:bg-gray-600',
secondary: 'bg-gray-200 dark:bg-gray-700 text-gray-800 dark:text-gray-200 hover:bg-gray-300 dark:hover:bg-gray-600',
danger: 'bg-red-600 text-white hover:bg-red-700',
ghost: 'bg-transparent text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700',
};
// Alert 타입별 스타일 매핑
const alertStyleMap: Record<ConfirmModalAlertType, { container: string; icon: string; title: string; text: string }> = {
warning: {
container: 'bg-yellow-50 dark:bg-yellow-900/20 border-l-4 border-yellow-400 dark:border-yellow-500',
icon: 'text-yellow-600 dark:text-yellow-400',
title: 'text-yellow-800 dark:text-yellow-300',
text: 'text-yellow-700 dark:text-yellow-300',
},
danger: {
container: 'bg-red-50 dark:bg-red-900/20 border-l-4 border-red-400 dark:border-red-500',
icon: 'text-red-600 dark:text-red-400',
title: 'text-red-800 dark:text-red-300',
text: 'text-red-700 dark:text-red-300',
},
info: {
container: 'bg-blue-50 dark:bg-blue-900/20 border-l-4 border-blue-400 dark:border-blue-500',
icon: 'text-blue-600 dark:text-blue-400',
title: 'text-blue-800 dark:text-blue-300',
text: 'text-blue-700 dark:text-blue-300',
},
};
// Alert 렌더링 함수
const renderAlert = () => {
if (!alert) return null;
const alertType = alert.type ?? 'warning';
const styles = alertStyleMap[alertType];
return (
<Div className={`mt-4 p-3 rounded ${styles.container}`}>
{/* Alert 헤더 (아이콘 + 제목) */}
{alert.title && (
<Div className="flex items-center gap-2 mb-2">
<svg
className={`w-5 h-5 ${styles.icon}`}
fill="none"
stroke="currentColor"
viewBox="0 0 24 24"
>
<path
strokeLinecap="round"
strokeLinejoin="round"
strokeWidth={2}
d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"
/>
</svg>
<Span className={`font-medium ${styles.title}`}>{alert.title}</Span>
</Div>
)}
{/* Alert 내용 */}
<Div className={styles.text}>
{Array.isArray(alert.content) ? (
<ul className="list-disc list-inside space-y-1 text-sm">
{alert.content.map((item, index) => (
<li key={index}>{item}</li>
))}
</ul>
) : (
alert.content
)}
</Div>
</Div>
);
};
if (!isOpen) return null;
return (
<Div
className="fixed inset-0 flex items-center justify-center"
style={{ zIndex: 50 }}
onClick={handleOverlayClick}
>
{/* Overlay */}
<Div
className="absolute inset-0 bg-black/50"
aria-hidden="true"
/>
{/* Modal Content */}
<Div
ref={modalRef}
className="relative bg-white dark:bg-gray-800 rounded-lg shadow-xl"
style={{ width }}
onClick={(e) => e.stopPropagation()}
role="dialog"
aria-modal="true"
aria-labelledby="confirm-modal-title"
>
{/* Header */}
<Div className="flex items-center justify-between p-4 pb-2">
<Div
id="confirm-modal-title"
className="text-lg font-semibold text-gray-900 dark:text-white"
>
{resolvedTitle}
</Div>
<Button
onClick={handleClose}
disabled={isLoading}
className="text-gray-400 dark:text-gray-500 hover:text-gray-600 dark:hover:text-gray-300 focus:outline-none disabled:opacity-50 disabled:cursor-not-allowed"
aria-label={t('common.close_modal')}
>
<svg
className="w-5 h-5"
fill="none"
stroke="currentColor"
viewBox="0 0 24 24"
>
<path
strokeLinecap="round"
strokeLinejoin="round"
strokeWidth={2}
d="M6 18L18 6M6 6l12 12"
/>
</svg>
</Button>
</Div>
{/* Body */}
<Div className="px-4 py-4">
{/* 메시지 */}
{typeof message === 'string' ? (
<P className="text-gray-700 dark:text-gray-300">{message}</P>
) : (
message
)}
{/* Alert 영역 */}
{renderAlert()}
{/* 추가 경고 텍스트 */}
{warningText && (
<P className="mt-4 text-sm text-red-600 dark:text-red-400">{warningText}</P>
)}
</Div>
{/* Footer (버튼 영역) */}
<Div className="flex justify-end gap-3 p-4 pt-2">
{/* 취소 버튼 */}
<Button
onClick={handleCancel}
disabled={isLoading}
className="px-4 py-2 bg-white dark:bg-gray-800 text-gray-700 dark:text-gray-300 border border-gray-300 dark:border-gray-600 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-700 disabled:opacity-50 disabled:cursor-not-allowed"
>
<Span>{resolvedCancelText}</Span>
</Button>
{/* 확인 버튼 */}
<Button
onClick={handleConfirm}
disabled={isLoading}
className={`flex items-center gap-2 px-4 py-2 rounded-lg disabled:opacity-50 disabled:cursor-not-allowed ${confirmVariantClassMap[confirmButtonVariant]}`}
>
{isLoading && (
<Icon name={IconName.Spinner} className="w-4 h-4 animate-spin" />
)}
<Span>{isLoading ? resolvedLoadingText : resolvedConfirmText}</Span>
</Button>
</Div>
</Div>
</Div>
);
};