| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237 |
- import { onMount, splitProps, type ComponentProps, Show, mergeProps } from "solid-js"
- import { createResizeObserver } from "@solid-primitives/resize-observer"
- import { createStore } from "solid-js/store"
- import { useI18n } from "../context/i18n"
- export interface ScrollViewProps extends ComponentProps<"div"> {
- viewportRef?: (el: HTMLDivElement) => void
- orientation?: "vertical" | "horizontal" // currently only vertical is fully implemented for thumb
- }
- export const scrollKey = (event: Pick<KeyboardEvent, "key" | "altKey" | "ctrlKey" | "metaKey" | "shiftKey">) => {
- if (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey) return
- switch (event.key) {
- case "PageDown":
- return "page-down"
- case "PageUp":
- return "page-up"
- case "Home":
- return "home"
- case "End":
- return "end"
- case "ArrowUp":
- return "up"
- case "ArrowDown":
- return "down"
- }
- }
- export function ScrollView(props: ScrollViewProps) {
- const i18n = useI18n()
- const merged = mergeProps({ orientation: "vertical" }, props)
- const [local, events, rest] = splitProps(
- merged,
- ["class", "children", "viewportRef", "orientation", "style"],
- [
- "onScroll",
- "onWheel",
- "onTouchStart",
- "onTouchMove",
- "onTouchEnd",
- "onTouchCancel",
- "onPointerDown",
- "onClick",
- "onKeyDown",
- ],
- )
- let rootRef!: HTMLDivElement
- let viewportRef!: HTMLDivElement
- let thumbRef!: HTMLDivElement
- const [state, setState] = createStore({
- isHovered: false,
- isDragging: false,
- thumbHeight: 0,
- thumbTop: 0,
- showThumb: false,
- })
- const isHovered = () => state.isHovered
- const isDragging = () => state.isDragging
- const thumbHeight = () => state.thumbHeight
- const thumbTop = () => state.thumbTop
- const showThumb = () => state.showThumb
- const updateThumb = () => {
- if (!viewportRef) return
- const { scrollTop, scrollHeight, clientHeight } = viewportRef
- if (scrollHeight <= clientHeight || scrollHeight === 0) {
- setState("showThumb", false)
- return
- }
- setState("showThumb", true)
- const trackPadding = 8
- const trackHeight = clientHeight - trackPadding * 2
- const minThumbHeight = 32
- // Calculate raw thumb height based on ratio
- let height = (clientHeight / scrollHeight) * trackHeight
- height = Math.max(height, minThumbHeight)
- const maxScrollTop = scrollHeight - clientHeight
- const maxThumbTop = trackHeight - height
- const top = maxScrollTop > 0 ? (scrollTop / maxScrollTop) * maxThumbTop : 0
- // Ensure thumb stays within bounds (shouldn't be necessary due to math above, but good for safety)
- const boundedTop = trackPadding + Math.max(0, Math.min(top, maxThumbTop))
- setState("thumbHeight", height)
- setState("thumbTop", boundedTop)
- }
- onMount(() => {
- if (local.viewportRef) {
- local.viewportRef(viewportRef)
- }
- createResizeObserver([viewportRef, viewportRef.firstElementChild], updateThumb)
- updateThumb()
- })
- let startY = 0
- let startScrollTop = 0
- const onThumbPointerDown = (e: PointerEvent) => {
- e.preventDefault()
- e.stopPropagation()
- setState("isDragging", true)
- startY = e.clientY
- startScrollTop = viewportRef.scrollTop
- thumbRef.setPointerCapture(e.pointerId)
- const onPointerMove = (e: PointerEvent) => {
- const deltaY = e.clientY - startY
- const { scrollHeight, clientHeight } = viewportRef
- const maxScrollTop = scrollHeight - clientHeight
- const maxThumbTop = clientHeight - thumbHeight()
- if (maxThumbTop > 0) {
- const scrollDelta = deltaY * (maxScrollTop / maxThumbTop)
- viewportRef.scrollTop = startScrollTop + scrollDelta
- }
- }
- const onPointerUp = (e: PointerEvent) => {
- setState("isDragging", false)
- thumbRef.releasePointerCapture(e.pointerId)
- thumbRef.removeEventListener("pointermove", onPointerMove)
- thumbRef.removeEventListener("pointerup", onPointerUp)
- }
- thumbRef.addEventListener("pointermove", onPointerMove)
- thumbRef.addEventListener("pointerup", onPointerUp)
- }
- // Keybinds implementation
- // We ensure the viewport has a tabindex so it can receive focus
- // We can also explicitly catch PageUp/Down if we want smooth scroll or specific behavior,
- // but native usually handles this perfectly. Let's explicitly ensure it behaves well.
- const onKeyDown = (e: KeyboardEvent) => {
- // If user is focused on an input inside the scroll view, don't hijack keys
- if (document.activeElement && ["INPUT", "TEXTAREA", "SELECT"].includes(document.activeElement.tagName)) {
- return
- }
- const next = scrollKey(e)
- if (!next) return
- const scrollAmount = viewportRef.clientHeight * 0.8
- const lineAmount = 40
- switch (next) {
- case "page-down":
- e.preventDefault()
- viewportRef.scrollBy({ top: scrollAmount, behavior: "smooth" })
- break
- case "page-up":
- e.preventDefault()
- viewportRef.scrollBy({ top: -scrollAmount, behavior: "smooth" })
- break
- case "home":
- e.preventDefault()
- viewportRef.scrollTo({ top: 0, behavior: "smooth" })
- break
- case "end":
- e.preventDefault()
- viewportRef.scrollTo({ top: viewportRef.scrollHeight, behavior: "smooth" })
- break
- case "up":
- e.preventDefault()
- viewportRef.scrollBy({ top: -lineAmount, behavior: "smooth" })
- break
- case "down":
- e.preventDefault()
- viewportRef.scrollBy({ top: lineAmount, behavior: "smooth" })
- break
- }
- }
- return (
- <div
- ref={rootRef}
- class={`scroll-view ${local.class || ""}`}
- style={local.style}
- onPointerEnter={() => setState("isHovered", true)}
- onPointerLeave={() => setState("isHovered", false)}
- {...rest}
- >
- {/* Viewport */}
- <div
- ref={viewportRef}
- class="scroll-view__viewport"
- onScroll={(e) => {
- updateThumb()
- if (typeof events.onScroll === "function") events.onScroll(e as any)
- }}
- onWheel={events.onWheel as any}
- onTouchStart={events.onTouchStart as any}
- onTouchMove={events.onTouchMove as any}
- onTouchEnd={events.onTouchEnd as any}
- onTouchCancel={events.onTouchCancel as any}
- onPointerDown={events.onPointerDown as any}
- onClick={events.onClick as any}
- tabIndex={0}
- role="region"
- aria-label={i18n.t("ui.scrollView.ariaLabel")}
- onKeyDown={(e) => {
- onKeyDown(e)
- if (typeof events.onKeyDown === "function") events.onKeyDown(e as any)
- }}
- >
- {local.children}
- </div>
- {/* Thumb Overlay */}
- <Show when={showThumb()}>
- <div
- ref={thumbRef}
- onPointerDown={onThumbPointerDown}
- class="scroll-view__thumb"
- data-visible={isHovered() || isDragging()}
- data-dragging={isDragging()}
- style={{
- height: `${thumbHeight()}px`,
- transform: `translateY(${thumbTop()}px)`,
- "z-index": 100, // ensure it displays over content
- }}
- />
- </Show>
- </div>
- )
- }
|