Files
Gnuboard7/templates/_bundled/sirsoft-basic/src/components/composite/TabNavigation.tsx
T
2026-04-20 20:37:49 +09:00

184 lines
6.2 KiB
TypeScript

import React from 'react';
import { Nav } from '../basic/Nav';
import { Button } from '../basic/Button';
import { Icon } from '../basic/Icon';
import { IconName } from '../basic/IconTypes';
import { Div } from '../basic/Div';
import { Span } from '../basic/Span';
import { Select } from '../basic/Select';
export interface Tab {
id: string | number;
label: string;
iconName?: IconName;
disabled?: boolean;
badge?: string | number;
}
export interface TabNavigationProps {
tabs: Tab[];
activeTabId?: string | number;
onTabChange?: (tabId: string | number) => void;
variant?: 'default' | 'pills' | 'underline';
className?: string;
style?: React.CSSProperties;
/** 숨길 탭 ID 목록 (동적 조건부 탭 노출용) */
hiddenTabIds?: (string | number)[];
/** 모바일 전환 임계값 (px). 기본값 768 — G7 ResponsiveContext mobile 프리셋과 동일 */
mobileBreakpoint?: number;
}
/**
* TabNavigation 집합 컴포넌트
*
* 탭 네비게이션을 제공하는 컴포넌트입니다.
* 여러 탭을 전환할 수 있으며, 아이콘과 뱃지를 지원합니다.
*
* 반응형: G7Core.useResponsive() hook으로 화면 너비를 구독하여
* mobileBreakpoint(기본 768px) 미만일 때 Select 드롭다운으로 자동 전환됩니다.
* Tailwind hidden md:flex 분기를 사용하지 않으므로 위지윅 편집기의 디바이스 미리보기와도 호환됩니다.
*
* **주의**: 이 컴포넌트는 순수 네비게이션 UI만 제공하며,
* 실제 탭 컨텐츠는 부모 컴포넌트에서 activeTabId를 기반으로 조건부 렌더링해야 합니다.
*
* 기본 컴포넌트 조합: Nav + Button + Icon + Div + Span + Select
*
* @example
* // 레이아웃 JSON 사용 예시
* {
* "name": "TabNavigation",
* "props": {
* "activeTabId": 1,
* "tabs": [
* {"id": 1, "label": "프로필", "iconName": "user"},
* {"id": 2, "label": "설정", "iconName": "cog", "badge": 3},
* {"id": 3, "label": "문의내역", "iconName": "comment"}
* ],
* "hiddenTabIds": "{{_global.modules?.['sirsoft-ecommerce']?.inquiry?.board_slug ? [] : ['inquiries']}}"
* }
* }
*/
export const TabNavigation: React.FC<TabNavigationProps> = ({
tabs,
activeTabId,
onTabChange,
variant = 'underline',
className = '',
style,
hiddenTabIds = [],
mobileBreakpoint = 768,
}) => {
// G7Core.useResponsive를 통해 반응형 상태 구독 (G7 표준)
const G7Core = (window as any).G7Core;
const useResponsive = G7Core?.useResponsive;
const responsiveValue = useResponsive?.();
const isMobile = responsiveValue
? responsiveValue.width < mobileBreakpoint
: typeof window !== 'undefined' && window.innerWidth < mobileBreakpoint;
const handleTabClick = (tab: Tab) => {
if (!tab.disabled && tab.id !== activeTabId) {
onTabChange?.(tab.id);
}
};
const handleSelectChange = (
e: React.ChangeEvent<HTMLSelectElement> | { target: { value: string | number } }
) => {
const selectedId = e.target.value;
const numericId = Number(selectedId);
const finalId =
typeof selectedId === 'string' && selectedId !== '' && !Number.isNaN(numericId)
? numericId
: selectedId;
const selectedTab = tabs.find((tab) => String(tab.id) === String(finalId));
if (selectedTab) {
handleTabClick(selectedTab);
}
};
const visibleTabs = hiddenTabIds.length > 0
? tabs.filter((tab) => !hiddenTabIds.includes(tab.id))
: tabs;
// 모바일: Select 드롭다운 단일 렌더
if (isMobile) {
return (
<Div className={`relative ${className}`} style={style}>
<Select
value={activeTabId !== undefined ? String(activeTabId) : ''}
onChange={handleSelectChange}
options={visibleTabs.map((tab) => ({
value: String(tab.id),
label: tab.badge !== undefined ? `${tab.label} (${tab.badge})` : tab.label,
disabled: tab.disabled,
}))}
className="w-full"
/>
</Div>
);
}
const getTabClasses = (tab: Tab) => {
const isActive = tab.id === activeTabId;
const baseClasses =
'flex items-center gap-2 px-3 py-2 font-medium text-sm transition-all shrink-0 whitespace-nowrap';
if (tab.disabled) {
return `${baseClasses} opacity-50 cursor-not-allowed text-gray-400 dark:text-gray-600`;
}
switch (variant) {
case 'pills':
return isActive
? `${baseClasses} bg-blue-600 dark:bg-blue-500 text-white rounded-lg`
: `${baseClasses} text-gray-600 dark:text-gray-400 hover:bg-gray-100 dark:hover:bg-gray-700 rounded-lg`;
case 'underline':
return isActive
? `${baseClasses} text-gray-900 dark:text-white border-b-2 border-gray-900 dark:border-white`
: `${baseClasses} text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-200 border-b-2 border-transparent hover:border-gray-300 dark:hover:border-gray-600`;
case 'default':
default:
return isActive
? `${baseClasses} text-blue-600 dark:text-blue-400 bg-blue-50 dark:bg-blue-900/20 border-b-2 border-blue-600 dark:border-blue-400`
: `${baseClasses} text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-200 hover:bg-gray-50 dark:hover:bg-gray-700 border-b-2 border-transparent`;
}
};
const navClasses =
variant === 'underline'
? 'flex gap-0 border-b border-gray-200 dark:border-gray-700'
: 'flex gap-2';
// 데스크톱: 탭 버튼 단일 렌더
return (
<Div className={`relative ${className}`} style={style}>
<Nav className={navClasses}>
{visibleTabs.map((tab) => (
<Button
key={tab.id}
type="button"
onClick={() => handleTabClick(tab)}
disabled={tab.disabled}
className={getTabClasses(tab)}
>
{tab.iconName && (
<Icon name={tab.iconName} size="sm" />
)}
<Span>{tab.label}</Span>
{tab.badge !== undefined && (
<Div className="flex items-center justify-center min-w-5 h-5 px-1.5 bg-red-500 text-white text-xs font-bold rounded-full">
<Span>{tab.badge}</Span>
</Div>
)}
</Button>
))}
</Nav>
</Div>
);
};