feat: add spell and rune tooltips

This commit is contained in:
dahyeon committed 2026-06-26 23:29:47 -07:00
1 parent 4906f665fd
commit 292e37aaac
8 files changed
+404 -161

No files matched your search

+226 -24
View File
@@ -1,4 +1,4 @@
import type { CSSProperties, RefObject } from "react";
import type { CSSProperties, ReactNode, RefObject } from "react";
import { useEffect, useId, useRef, useState } from "react";
import { createPortal } from "react-dom";
import type { DdragonManifest } from "../api/types";
@@ -6,7 +6,13 @@ import {
itemDetails,
itemDisplayName,
itemIconUrl,
runeDetails,
runeIconUrl,
runeStyleDetails,
runeStyleIconUrl,
safeDdragonDescriptionHtml,
summonerSpellDetails,
summonerSpellIconUrl,
} from "../lib/ddragon";
type TooltipPosition = {
@@ -24,6 +30,24 @@ type ItemIconProps = {
trinket?: boolean;
};
type TooltipIconProps = {
active: boolean;
label: string;
emptyLabel: string;
icon: string | null;
className: string;
imageClassName: string;
slotClassName: string;
children: ReactNode;
};
type ManifestIconProps = {
manifest: DdragonManifest | null | undefined;
className?: string;
imageClassName?: string;
slotClassName?: string;
};
const VIEWPORT_MARGIN = 8;
const TOOLTIP_GAP = 8;
const TOOLTIP_WIDTH = 320;
@@ -35,9 +59,6 @@ export function ItemIcon({
imageClassName = "scale-[1.18]",
trinket = false,
}: ItemIconProps) {
const anchorRef = useRef<HTMLSpanElement>(null);
const tooltipId = useId();
const [open, setOpen] = useState(false);
const icon = itemIconUrl(manifest, itemId);
const hasItem = itemId > 0;
const itemName = itemDisplayName(manifest, itemId) ?? `아이템 ${itemId}`;
@@ -45,21 +66,125 @@ export function ItemIcon({
? "border-primary/25 bg-base-content/[0.04]"
: "border-base-content/5 bg-base-content/8";
return (
<TooltipIcon
active={hasItem}
label={itemName}
emptyLabel="빈 아이템 슬롯"
icon={icon}
className={className}
imageClassName={imageClassName}
slotClassName={`border ${slotTone}`}
>
<ItemTooltipContent itemId={itemId} manifest={manifest} />
</TooltipIcon>
);
}
export function SummonerSpellIcon({
spellId,
manifest,
className = "h-5 w-5",
imageClassName = "",
slotClassName = "border border-base-content/5 bg-base-content/10",
}: ManifestIconProps & { spellId: number }) {
const spell = summonerSpellDetails(manifest, spellId);
const spellName = spell?.name ?? `스펠 ${spellId}`;
return (
<TooltipIcon
active={spellId > 0}
label={spellName}
emptyLabel="빈 스펠 슬롯"
icon={summonerSpellIconUrl(manifest, spellId)}
className={className}
imageClassName={imageClassName}
slotClassName={slotClassName}
>
<SummonerSpellTooltipContent spellId={spellId} manifest={manifest} />
</TooltipIcon>
);
}
export function RuneIcon({
runeId,
manifest,
className = "h-5 w-5",
imageClassName = "",
slotClassName = "border border-base-content/5 bg-base-content/10",
}: ManifestIconProps & { runeId: number | undefined }) {
const rune = runeDetails(manifest, runeId);
const runeName = rune?.name ?? (runeId ? `룬 ${runeId}` : "룬");
return (
<TooltipIcon
active={Boolean(runeId)}
label={runeName}
emptyLabel="빈 룬 슬롯"
icon={runeIconUrl(manifest, runeId)}
className={className}
imageClassName={imageClassName}
slotClassName={slotClassName}
>
<RuneTooltipContent runeId={runeId} manifest={manifest} />
</TooltipIcon>
);
}
export function RuneStyleIcon({
styleId,
manifest,
className = "h-5 w-5",
imageClassName = "",
slotClassName = "border border-base-content/5 bg-base-content/10",
}: ManifestIconProps & { styleId: number | undefined }) {
const style = runeStyleDetails(manifest, styleId);
const styleName = style?.name ?? (styleId ? `룬 ${styleId}` : "룬");
return (
<TooltipIcon
active={Boolean(styleId)}
label={styleName}
emptyLabel="빈 룬 슬롯"
icon={runeStyleIconUrl(manifest, styleId)}
className={className}
imageClassName={imageClassName}
slotClassName={slotClassName}
>
<RuneStyleTooltipContent styleId={styleId} manifest={manifest} />
</TooltipIcon>
);
}
function TooltipIcon({
active,
label,
emptyLabel,
icon,
className,
imageClassName,
slotClassName,
children,
}: TooltipIconProps) {
const anchorRef = useRef<HTMLSpanElement>(null);
const tooltipId = useId();
const [open, setOpen] = useState(false);
return (
<span
ref={anchorRef}
className={`relative inline-flex shrink-0 ${className}`}
role={hasItem ? "img" : undefined}
tabIndex={hasItem ? 0 : undefined}
aria-label={hasItem ? itemName : "빈 아이템 슬롯"}
aria-describedby={hasItem && open ? tooltipId : undefined}
role={active ? "img" : undefined}
tabIndex={active ? 0 : undefined}
aria-label={active ? label : emptyLabel}
aria-describedby={active && open ? tooltipId : undefined}
onBlur={() => setOpen(false)}
onFocus={() => hasItem && setOpen(true)}
onMouseEnter={() => hasItem && setOpen(true)}
onFocus={() => active && setOpen(true)}
onMouseEnter={() => active && setOpen(true)}
onMouseLeave={() => setOpen(false)}
>
<span
className={`block h-full w-full overflow-hidden border ${slotTone}`}
className={`block h-full w-full overflow-hidden ${slotClassName}`}
aria-hidden="true"
>
{icon ? (
@@ -71,28 +196,23 @@ export function ItemIcon({
/>
) : null}
</span>
{hasItem && open ? (
<ItemTooltipPortal
id={tooltipId}
anchorRef={anchorRef}
itemId={itemId}
manifest={manifest}
/>
{active && open ? (
<TooltipPortal id={tooltipId} anchorRef={anchorRef}>
{children}
</TooltipPortal>
) : null}
</span>
);
}
function ItemTooltipPortal({
function TooltipPortal({
id,
anchorRef,
itemId,
manifest,
children,
}: {
id: string;
anchorRef: RefObject<HTMLElement | null>;
itemId: number;
manifest: DdragonManifest | null | undefined;
children: ReactNode;
}) {
const [position, setPosition] = useState<TooltipPosition | null>(null);
@@ -149,12 +269,94 @@ function ItemTooltipPortal({
style={style}
className="pointer-events-none fixed z-[1000] border border-base-content/20 bg-black px-3 py-3 text-xs leading-relaxed text-white shadow-2xl"
>
<ItemTooltipContent itemId={itemId} manifest={manifest} />
{children}
</div>,
document.body,
);
}
function SummonerSpellTooltipContent({
spellId,
manifest,
}: {
spellId: number;
manifest: DdragonManifest | null | undefined;
}) {
const spell = summonerSpellDetails(manifest, spellId);
const descriptionHtml = spell?.description
? safeDdragonDescriptionHtml(spell.description)
: "";
return (
<div className="space-y-2">
<div className="font-black text-[#f0d878]">
{spell?.name ?? `스펠 ${spellId}`}
</div>
{descriptionHtml ? (
<div
className="text-white/80 [&_br]:block [&_br]:content-['']"
dangerouslySetInnerHTML={{ __html: descriptionHtml }}
/>
) : (
<div className="text-white/55">
스펠 상세 정보를 불러오는 중입니다.
</div>
)}
</div>
);
}
function RuneTooltipContent({
runeId,
manifest,
}: {
runeId: number | undefined;
manifest: DdragonManifest | null | undefined;
}) {
const rune = runeDetails(manifest, runeId);
const descriptionHtml = rune?.longDesc
? safeDdragonDescriptionHtml(rune.longDesc)
: "";
return (
<div className="space-y-2">
<div className="font-black text-[#f0d878]">
{rune?.name ?? (runeId ? `룬 ${runeId}` : "룬")}
</div>
{rune?.shortDesc ? (
<div className="font-bold text-white">{rune.shortDesc}</div>
) : null}
{descriptionHtml ? (
<div
className="text-white/80 [&_br]:block [&_br]:content-['']"
dangerouslySetInnerHTML={{ __html: descriptionHtml }}
/>
) : (
<div className="text-white/55">룬 상세 정보를 불러오는 중입니다.</div>
)}
</div>
);
}
function RuneStyleTooltipContent({
styleId,
manifest,
}: {
styleId: number | undefined;
manifest: DdragonManifest | null | undefined;
}) {
const style = runeStyleDetails(manifest, styleId);
return (
<div className="space-y-2">
<div className="font-black text-[#f0d878]">
{style?.name ?? (styleId ? `룬 ${styleId}` : "룬")}
</div>
<div className="text-white/55">룬 스타일</div>
</div>
);
}
function ItemTooltipContent({
itemId,
manifest,