Files
TREK/client/src/components/shared/ContextMenu.tsx
T
Maurice e958a9a2bb feat(ui): icon footer button, and a button menu at the foot opens above its button
DialogIconButton is the square footer button DeleteButton already was, for
any action named by its tooltip. A "…" menu near the bottom of the window
used to be pushed up over its own button; it now opens above it.
2026-11-13 10:49:17 +01:00

194 lines
8.1 KiB
TypeScript

import React, { useState, useEffect, useLayoutEffect, useRef, type ComponentType, type CSSProperties } from 'react'
import { createPortal } from 'react-dom'
import { LucideIcon } from 'lucide-react'
import { useLastOpen, usePresence } from './usePresence'
interface MenuItem {
label?: string
/** A lucide icon, or any icon drawn the same way (TREK's own glyphs). */
icon?: LucideIcon | ComponentType<{ size?: number; style?: CSSProperties }>
onClick?: () => void
disabled?: boolean
danger?: boolean
divider?: boolean
/** A second, quieter line under the label: what an item does, or why it is greyed out. */
hint?: string
/** A row that only names what the items below it act on, such as the day picked a step before. */
heading?: boolean
}
interface MenuState {
x: number
y: number
items: MenuItem[]
alignEnd?: boolean
/** The top of the button it hangs from: with no room below, the menu opens above it, not over it. */
anchorTop?: number
}
export function useContextMenu() {
const [menu, setMenu] = useState<MenuState | null>(null)
const open = (e: React.MouseEvent, items: MenuItem[], alignEnd = false) => {
e.preventDefault()
e.stopPropagation()
if (!alignEnd) {
setMenu({ x: e.clientX, y: e.clientY, items, alignEnd })
return
}
const anchor = e.currentTarget.getBoundingClientRect()
setMenu({ x: anchor.right, y: anchor.bottom + 6, items, alignEnd, anchorTop: anchor.top })
}
/** Opens the menu under an element, its end on the element's end: the next step of a menu opened there. */
const openAt = (anchor: Element, items: MenuItem[]) => {
const rect = anchor.getBoundingClientRect()
setMenu({ x: rect.right, y: rect.bottom + 6, items, alignEnd: true, anchorTop: rect.top })
}
const close = () => setMenu(null)
return { menu, open, openAt, close }
}
interface ContextMenuProps {
menu: MenuState | null
onClose: () => void
}
export function ContextMenu({ menu, onClose }: ContextMenuProps) {
const { mounted, closing } = usePresence(menu != null, 130)
// The items stay on screen while the menu fades, after its owner set it to null.
const shown = useLastOpen(menu, menu != null)
return mounted && shown ? <ContextMenuFrame menu={shown} onClose={onClose} closing={closing} /> : null
}
function ContextMenuFrame({ menu, onClose, closing }: { menu: MenuState; onClose: () => void; closing: boolean }) {
const ref = useRef<HTMLDivElement>(null)
useEffect(() => {
if (!menu) return
const handler = () => onClose()
// A fixed menu stays where it opened, so it closes when the page under it
// moves or the window changes size. Escape closes it in the capture phase
// and goes no further, so a dialog, the assistant column or Studio under
// it does not act on the same key.
const onKey = (e: KeyboardEvent) => {
if (e.key !== 'Escape') return
e.stopPropagation()
onClose()
}
document.addEventListener('click', handler)
document.addEventListener('contextmenu', handler)
document.addEventListener('keydown', onKey, true)
window.addEventListener('scroll', handler, true)
window.addEventListener('resize', handler)
return () => {
document.removeEventListener('click', handler)
document.removeEventListener('contextmenu', handler)
document.removeEventListener('keydown', onKey, true)
window.removeEventListener('scroll', handler, true)
window.removeEventListener('resize', handler)
}
}, [menu, onClose])
// Keyboard users land on the first item and move with the arrow keys.
useEffect(() => {
if (!menu) return
ref.current?.querySelector<HTMLButtonElement>('button:not(:disabled)')?.focus({ preventScroll: true })
}, [menu])
const moveFocus = (e: React.KeyboardEvent<HTMLDivElement>) => {
if (e.key !== 'ArrowDown' && e.key !== 'ArrowUp') return
e.preventDefault()
const items = [...(ref.current?.querySelectorAll<HTMLButtonElement>('button:not(:disabled)') ?? [])]
if (items.length === 0) return
const at = items.indexOf(document.activeElement as HTMLButtonElement)
const next = e.key === 'ArrowDown' ? (at + 1) % items.length : (at - 1 + items.length) % items.length
items[next]?.focus()
}
useLayoutEffect(() => {
if (!menu || !ref.current) return
const el = ref.current
// The layout size, not getBoundingClientRect: the menu is still mid enter
// animation (scaled down) here, and the smaller box let a menu opened near an
// edge end up partly off screen.
const width = el.offsetWidth
const viewW = window.innerWidth
const viewH = window.innerHeight
// Taller than the screen (a long list on a phone): cap it and let it scroll.
if (el.offsetHeight > viewH - 16) {
el.style.maxHeight = `${viewH - 16}px`
el.style.overflowY = 'auto'
}
const height = Math.min(el.offsetHeight, viewH - 16)
let { x, y } = menu
if (menu.alignEnd) x = x - width
// A menu hanging from a button near the foot of the screen opens above it.
if (menu.anchorTop !== undefined && y + height > viewH - 8 && menu.anchorTop - 6 - height >= 8) y = menu.anchorTop - 6 - height
// Kept inside all four edges with 8px to spare.
x = Math.min(Math.max(8, x), viewW - width - 8)
y = Math.min(Math.max(8, y), viewH - height - 8)
if (x !== menu.x || y !== menu.y) {
el.style.left = `${Math.max(8, x)}px`
el.style.top = `${Math.max(8, y)}px`
}
}, [menu])
return createPortal(
<div ref={ref} role="menu" tabIndex={-1} onKeyDown={moveFocus} className={`trek-popover-enter ${closing ? 'trek-popover-exit pointer-events-none' : ''}`} style={{
position: 'fixed', left: menu.x, top: menu.y, zIndex: 999999,
background: 'var(--bg-card)', borderRadius: 10, padding: '4px',
border: '1px solid var(--border-primary)',
boxShadow: '0 8px 30px rgba(0,0,0,0.15)',
backdropFilter: 'blur(20px)', WebkitBackdropFilter: 'blur(20px)',
minWidth: 160,
width: menu.alignEnd ? 'max-content' : undefined,
whiteSpace: menu.alignEnd ? 'nowrap' : undefined,
fontFamily: "var(--font-system)",
transformOrigin: menu.alignEnd ? 'top right' : 'top left',
}}>
{menu.items.filter(Boolean).map((item, i) => {
if (item.divider) return <div key={i} style={{ height: 1, background: 'var(--border-faint)', margin: '3px 6px' }} />
if (item.heading) return (
<div key={i} style={{
padding: '6px 10px 4px', fontSize: 'calc(11px * var(--fs-scale-caption, 1))', fontWeight: 600,
color: 'var(--text-faint)',
}}>
{item.label}
</div>
)
const Icon = item.icon
return (
<button type="button" key={i} disabled={item.disabled} onClick={() => { if (item.disabled) return; item.onClick?.(); onClose() }} style={{
display: 'flex', alignItems: 'center', gap: 8, width: '100%',
padding: '7px 10px', borderRadius: 7, border: 'none',
background: 'none', cursor: item.disabled ? 'default' : 'pointer', fontFamily: 'inherit',
fontSize: 'calc(12px * var(--fs-scale-body, 1))', fontWeight: 500, textAlign: 'start',
color: item.danger ? '#ef4444' : 'var(--text-primary)', opacity: item.disabled ? 0.45 : 1,
transition: 'background 0.1s',
}}
onMouseEnter={e => { if (!item.disabled) e.currentTarget.style.background = item.danger ? 'rgba(239,68,68,0.08)' : 'var(--bg-hover)' }}
onMouseLeave={e => e.currentTarget.style.background = 'none'}
>
{Icon && <Icon size={13} style={{ flexShrink: 0, color: item.danger ? '#ef4444' : 'var(--text-faint)' }} />}
{item.hint ? (
<span style={{ display: 'flex', flexDirection: 'column', gap: 1, minWidth: 0 }}>
<span>{item.label}</span>
<span style={{
maxWidth: 240, whiteSpace: 'normal', fontWeight: 400, color: 'var(--text-muted)',
fontSize: 'calc(11px * var(--fs-scale-caption, 1))',
}}>
{item.hint}
</span>
</span>
) : <span>{item.label}</span>}
</button>
)
})}
</div>,
document.body
)
}