fix: 셀렉트 드롭다운이 다른 컴포넌트에 가려지는 문제 해결

- React Portal 적용하여 드롭다운을 document.body에 렌더링
- Stacking Context 탈출로 z-index 충돌 문제 해결
- 모든 셀렉트 타입(code, autocomplete, dropdown, multiselect)에 적용
This commit is contained in:
SeongHyun Kim 2025-12-01 10:01:10 +09:00
parent 07e0b22309
commit 893cd428a0
1 changed files with 112 additions and 25 deletions

View File

@ -1,4 +1,5 @@
import React, { useState, useEffect, useRef, useMemo } from "react";
import { createPortal } from "react-dom";
import { filterDOMProps } from "@/lib/utils/domPropsFilter";
import { useCodeOptions, useTableCodeCategory } from "@/hooks/queries/useCodes";
import { cn } from "@/lib/registry/components/common/inputStyles";
@ -60,6 +61,8 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
});
const [isOpen, setIsOpen] = useState(false);
// 드롭다운 위치 (Portal 렌더링용)
const [dropdownPosition, setDropdownPosition] = useState({ top: 0, left: 0, width: 0 });
// webTypeConfig 또는 componentConfig 사용 (DynamicWebTypeRenderer 호환성)
const config = (props as any).webTypeConfig || componentConfig || {};
@ -280,9 +283,26 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
}, [selectedValue, codeOptions, config.options]);
// 클릭 이벤트 핸들러 (React Query로 간소화)
// 드롭다운 위치 계산 함수
const updateDropdownPosition = () => {
if (selectRef.current) {
const rect = selectRef.current.getBoundingClientRect();
setDropdownPosition({
top: rect.bottom + window.scrollY,
left: rect.left + window.scrollX,
width: rect.width,
});
}
};
const handleToggle = () => {
if (isDesignMode) return;
// 드롭다운 열기 전에 위치 계산
if (!isOpen) {
updateDropdownPosition();
}
// React Query가 자동으로 캐시 관리하므로 수동 새로고침 불필요
setIsOpen(!isOpen);
};
@ -404,9 +424,13 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
value={searchQuery || selectedLabel}
onChange={(e) => {
setSearchQuery(e.target.value);
updateDropdownPosition();
setIsOpen(true);
}}
onFocus={() => {
updateDropdownPosition();
setIsOpen(true);
}}
onFocus={() => setIsOpen(true)}
placeholder="코드 또는 코드명 입력..."
className={cn(
"h-10 w-full rounded-lg border border-gray-300 bg-white px-3 py-2 transition-all outline-none",
@ -415,8 +439,16 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
)}
readOnly={isDesignMode}
/>
{isOpen && !isDesignMode && filteredOptions.length > 0 && (
<div className="absolute z-[99999] mt-1 max-h-60 w-full overflow-auto rounded-md border border-gray-300 bg-white shadow-lg">
{/* Portal을 사용하여 드롭다운을 document.body에 렌더링 */}
{isOpen && !isDesignMode && filteredOptions.length > 0 && typeof document !== "undefined" && createPortal(
<div
className="fixed z-[99999] max-h-60 overflow-auto rounded-md border border-gray-300 bg-white shadow-lg"
style={{
top: dropdownPosition.top,
left: dropdownPosition.left,
width: dropdownPosition.width,
}}
>
{filteredOptions.map((option, index) => (
<div
key={`${option.value}-${index}`}
@ -432,7 +464,8 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
</div>
</div>
))}
</div>
</div>,
document.body
)}
</div>
);
@ -462,8 +495,16 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 9l-7 7-7-7" />
</svg>
</div>
{isOpen && !isDesignMode && (
<div className="absolute z-[99999] mt-1 max-h-60 w-full overflow-auto rounded-md border border-gray-300 bg-white shadow-lg">
{/* Portal을 사용하여 드롭다운을 document.body에 렌더링 */}
{isOpen && !isDesignMode && typeof document !== "undefined" && createPortal(
<div
className="fixed z-[99999] max-h-60 overflow-auto rounded-md border border-gray-300 bg-white shadow-lg"
style={{
top: dropdownPosition.top,
left: dropdownPosition.left,
width: dropdownPosition.width,
}}
>
{isLoadingCodes ? (
<div className="bg-white px-3 py-2 text-gray-900"> ...</div>
) : allOptions.length > 0 ? (
@ -479,7 +520,8 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
) : (
<div className="bg-white px-3 py-2 text-gray-900"> </div>
)}
</div>
</div>,
document.body
)}
</div>
);
@ -544,9 +586,13 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
value={searchQuery}
onChange={(e) => {
setSearchQuery(e.target.value);
updateDropdownPosition();
setIsOpen(true);
}}
onFocus={() => {
updateDropdownPosition();
setIsOpen(true);
}}
onFocus={() => setIsOpen(true)}
placeholder={placeholder}
className={cn(
"h-10 w-full rounded-lg border border-gray-300 bg-white px-3 py-2 transition-all outline-none",
@ -555,8 +601,16 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
)}
readOnly={isDesignMode}
/>
{isOpen && !isDesignMode && filteredOptions.length > 0 && (
<div className="absolute z-[99999] mt-1 max-h-60 w-full overflow-auto rounded-md border border-gray-300 bg-white shadow-lg">
{/* Portal을 사용하여 드롭다운을 document.body에 렌더링 */}
{isOpen && !isDesignMode && filteredOptions.length > 0 && typeof document !== "undefined" && createPortal(
<div
className="fixed z-[99999] max-h-60 overflow-auto rounded-md border border-gray-300 bg-white shadow-lg"
style={{
top: dropdownPosition.top,
left: dropdownPosition.left,
width: dropdownPosition.width,
}}
>
{filteredOptions.map((option, index) => (
<div
key={`${option.value}-${index}`}
@ -574,7 +628,8 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
{option.label}
</div>
))}
</div>
</div>,
document.body
)}
</div>
);
@ -604,8 +659,16 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 9l-7 7-7-7" />
</svg>
</div>
{isOpen && !isDesignMode && (
<div className="absolute z-[99999] mt-1 w-full rounded-md border border-gray-300 bg-white shadow-lg">
{/* Portal을 사용하여 드롭다운을 document.body에 렌더링 */}
{isOpen && !isDesignMode && typeof document !== "undefined" && createPortal(
<div
className="fixed z-[99999] rounded-md border border-gray-300 bg-white shadow-lg"
style={{
top: dropdownPosition.top,
left: dropdownPosition.left,
width: dropdownPosition.width,
}}
>
<input
type="text"
value={searchQuery}
@ -630,7 +693,8 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
</div>
))}
</div>
</div>
</div>,
document.body
)}
</div>
);
@ -647,7 +711,12 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
!isDesignMode && "hover:border-orange-400",
isSelected && "ring-2 ring-orange-500",
)}
onClick={() => !isDesignMode && setIsOpen(true)}
onClick={() => {
if (!isDesignMode) {
updateDropdownPosition();
setIsOpen(true);
}
}}
style={{
pointerEvents: isDesignMode ? "none" : "auto",
height: "100%"
@ -680,22 +749,30 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
<span className="text-gray-500">{placeholder}</span>
)}
</div>
{isOpen && !isDesignMode && (
<div className="absolute z-[99999] mt-1 max-h-60 w-full overflow-auto rounded-md border border-gray-300 bg-white shadow-lg">
{/* Portal을 사용하여 드롭다운을 document.body에 렌더링 */}
{isOpen && !isDesignMode && typeof document !== "undefined" && createPortal(
<div
className="fixed z-[99999] max-h-60 overflow-auto rounded-md border border-gray-300 bg-white shadow-lg"
style={{
top: dropdownPosition.top,
left: dropdownPosition.left,
width: dropdownPosition.width,
}}
>
{(isLoadingCodes || isLoadingCategories) ? (
<div className="bg-white px-3 py-2 text-gray-900"> ...</div>
) : allOptions.length > 0 ? (
allOptions.map((option, index) => {
const isSelected = selectedValues.includes(option.value);
const isOptionSelected = selectedValues.includes(option.value);
return (
<div
key={`${option.value}-${index}`}
className={cn(
"cursor-pointer px-3 py-2 text-gray-900 hover:bg-gray-100",
isSelected && "bg-blue-50 font-medium"
isOptionSelected && "bg-blue-50 font-medium"
)}
onClick={() => {
const newVals = isSelected
const newVals = isOptionSelected
? selectedValues.filter((v) => v !== option.value)
: [...selectedValues, option.value];
setSelectedValues(newVals);
@ -708,7 +785,7 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
<div className="flex items-center gap-2">
<input
type="checkbox"
checked={isSelected}
checked={isOptionSelected}
onChange={() => {}}
className="h-4 w-4"
/>
@ -720,7 +797,8 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
) : (
<div className="bg-white px-3 py-2 text-gray-900"> </div>
)}
</div>
</div>,
document.body
)}
</div>
);
@ -749,8 +827,16 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 9l-7 7-7-7" />
</svg>
</div>
{isOpen && !isDesignMode && (
<div className="absolute z-[99999] mt-1 max-h-60 w-full overflow-auto rounded-md border border-gray-300 bg-white shadow-lg">
{/* Portal을 사용하여 드롭다운을 document.body에 렌더링 */}
{isOpen && !isDesignMode && typeof document !== "undefined" && createPortal(
<div
className="fixed z-[99999] max-h-60 overflow-auto rounded-md border border-gray-300 bg-white shadow-lg"
style={{
top: dropdownPosition.top,
left: dropdownPosition.left,
width: dropdownPosition.width,
}}
>
{isLoadingCodes ? (
<div className="bg-white px-3 py-2 text-gray-900"> ...</div>
) : allOptions.length > 0 ? (
@ -766,7 +852,8 @@ const SelectBasicComponent: React.FC<SelectBasicComponentProps> = ({
) : (
<div className="bg-white px-3 py-2 text-gray-900"> </div>
)}
</div>
</div>,
document.body
)}
</div>
);