# @embedpdf/react — ./scrollbar Scrollbar [FunctionDeclaration]: export function Scrollbar({ axis, token: explicitToken, autoHide = 1200, minThumbSize = 24, trackPress = 'page', className, style, thumbClassName, thumbStyle, } : ScrollbarProps){ const token = useStageToken(explicitToken); const stage = useCapability(asHost(token)); const metrics = useScrollMetrics(token); const vertical = axis === 'y'; const scrollable = vertical ? metrics.scrollableY : metrics.scrollableX; const trackRef = useRef(null); const [trackPx, setTrackPx] = useState(0); const [dragging, setDragging] = useState(false); const [hovered, setHovered] = useState(false); const [active, setActive] = useState(true); const layout = geometry(metrics, vertical, trackPx, minThumbSize); const hideAfter = autoHide === false ? 0 : autoHide; useEffect(() =>{ if (!hideAfter) return; setActive(true); const timer = setTimeout(() => setActive(false), hideAfter); return () => clearTimeout(timer); } , [metrics, hideAfter]); const shown = !hideAfter || active || hovered || dragging; useEffect(() =>{ const element = trackRef.current; if (!element) return; const measure = () => setTrackPx(vertical ? element.clientHeight : element.clientWidth); const ro = new ResizeObserver(measure); ro.observe(element); measure(); return () => ro.disconnect(); } , [vertical, scrollable]); const dragRef = useRef<{ grab: number; applied: number; max: number; travel: number} | null>( null, ); const pageRef = useRef<{ dir: 1 | -1; timer: number} | null>(null); const lastPtr = useRef(0); const ptrPos = (event: React.PointerEvent) =>{ const rect = trackRef.current!.getBoundingClientRect(); return vertical ? event.clientY - rect.top : event.clientX - rect.left; } ; const liveGeometry = () => geometry(stage.getScrollMetrics(), vertical, trackPx, minThumbSize); const stopPaging = () =>{ if (pageRef.current){ clearTimeout(pageRef.current.timer); clearInterval(pageRef.current.timer); pageRef.current = null; } } ; const endDrag = () =>{ dragRef.current = null; stopPaging(); setDragging(false); } ; const beginDrag = (grab: number, applied: number) =>{ dragRef.current ={ grab, applied, max: layout.maxOffset, travel: layout.travel} ; setDragging(true); } ; const onThumbDown = (event: React.PointerEvent) =>{ if (event.button !== 0) return; event.preventDefault(); event.stopPropagation(); capturePointer(event.target as Element, event.pointerId); beginDrag(ptrPos(event) - layout.thumbPos, layout.offset); } ; const onTrackDown = (event: React.PointerEvent) =>{ if (event.button !== 0 || event.target !== event.currentTarget) return; event.preventDefault(); capturePointer(event.currentTarget as Element, event.pointerId); const position = (lastPtr.current = ptrPos(event)); if (trackPress === 'jump'){ const want = layout.travel > 0 ? clamp01((position - layout.thumbLen / 2) / layout.travel) * layout.maxOffset : 0; stage.scrollTo(vertical ?{ top: want} :{ left: want} ); beginDrag(layout.thumbLen / 2, want); return; } const dir: 1 | -1 = position < layout.thumbPos ? -1 : 1; const step = () =>{ const live = liveGeometry(); const reached = dir === 1 ? lastPtr.current <= live.thumbPos + live.thumbLen : lastPtr.current >= live.thumbPos; if (reached) return stopPaging(); stage.scrollBy( vertical ?{ top: dir * live.client * 0.9} :{ left: dir * live.client * 0.9} , ); } ; step(); const timer = window.setTimeout(() =>{ if (!pageRef.current) return; pageRef.current.timer = window.setInterval(step, 80); } , 350); pageRef.current ={ dir, timer} ; } ; const onMove = (event: React.PointerEvent) =>{ const drag = dragRef.current; if (drag){ if (drag.travel <= 0) return; const want = clamp01((ptrPos(event) - drag.grab) / drag.travel) * drag.max; const delta = want - drag.applied; if (delta){ stage.panBy(vertical ? 0 : -delta, vertical ? -delta : 0); drag.applied = want; } } else if (pageRef.current){ lastPtr.current = ptrPos(event); } } ; useEffect(() => endDrag, []); if (!scrollable) return null; const trackDefaults: React.CSSProperties = vertical ?{ position: 'absolute', top: 0, right: 0, bottom: 0, width: 12} :{ position: 'absolute', left: 0, right: 0, bottom: 0, height: 12} ; const thumbDefaults: React.CSSProperties = vertical ?{ position: 'absolute', left: 2, right: 2, top: layout.thumbPos, height: layout.thumbLen} :{ position: 'absolute', top: 2, bottom: 2, left: layout.thumbPos, width: layout.thumbLen} ; return (
setHovered(true)} onPointerLeave={ () => setHovered(false)} >
); } ScrollbarAxis [TypeAliasDeclaration]: export type ScrollbarAxis = 'x' | 'y'; ScrollbarProps [InterfaceDeclaration]: export interface ScrollbarProps{ axis: ScrollbarAxis; token?: CapabilityToken; autoHide?: number | false; minThumbSize?: number; trackPress?: 'page' | 'jump'; className?: string; style?: React.CSSProperties; thumbClassName?: string; thumbStyle?: React.CSSProperties; } useScrollMetrics [FunctionDeclaration]: export function useScrollMetrics(token?: CapabilityToken): ScrollMetrics{ return useSelector(asHost(useStageToken(token)), (stage) => stage.getScrollMetrics()); }