source: Klonkt/src/assets/js/mod/read.js@ 0490abe

main
Last change on this file since 0490abe was 0490abe, checked in by Robin <roboburr@…>, 3 weeks ago

Reader: inertia scales with the gesture — more on a nudge, less on a flick

Lenis reads lerp, touchInertiaExponent and syncTouchLerp at event time
(checked in the vendor file), so they can be set per gesture. A small
gesture now gets the softer brake and the higher exponent, a fast one
the firmer brake and a lower exponent.

The inversion is deliberate: with distance = |velocity| exponent, a
high exponent carries a hard flick far but shrinks a gentle one — which
is exactly backwards from what a nudge should feel like. Six numbers up
top do the tuning; the thresholds next to them define small and fast.

Co-Authored-By: Claude Fable 5 <noreply@…>

  • Property mode set to 100644
File size: 29.7 KB
Line 
1/**
2 * De leesweergave: tikken op een bericht opent dat bericht, en een knop om terug
3 * naar boven te gaan.
4 *
5 * Dit was een heel scherm met een eigen route, dat zijn buren zelf ophaalde, de
6 * scrollpositie corrigeerde bij invoegen en de balken wegschoof. Dat is allemaal
7 * weg, en dat is winst: Lezen is nu een WEERGAVE van de feed
8 * (body[data-feed-view="reader"]), naast Tijdlijn en Grid. De feed levert de
9 * berichten al, "meer laden" vult al aan, en het snappen naar berichtgrenzen
10 * doet CSS.
11 *
12 * HET SNAPPEN STAAT HIER MET OPZET NIET IN. Ik heb dat een ronde lang wel
13 * geprobeerd -- richting bijhouden, een vangzone uitrekenen, per scroll-event
14 * het snappunt verzetten -- en dat is de verkeerde laag. Robins bezwaar (20-8):
15 * "scroll-snap op het element is iets anders dan touch events,
16 * requestAnimationFrame etc. dan gaan we te veel van de view doen." Klopt, en
17 * het vocht ook met de browser: de scroll-events bevatten OOK de bewegingen van
18 * zijn eigen snap-animatie, dus de richting die je eruit afleidt is niet die van
19 * de gebruiker.
20 *
21 * Wat er nodig was, was een regel minder in de CSS en niet honderd erbij hier:
22 * zie style.css bij .feed-reader .read-post.
23 *
24 * De titel en de voetlink in read-article.ejs zijn echte <a>'s en doen het werk
25 * voor toetsenbord en schermlezer; de tik hieronder is er voor een duim.
26 *
27 * Vier uitzonderingen op die tik, want een tik die je niet bedoelde is erger dan
28 * geen tik: iets dat zelf al een doel heeft (link, knop, veld) houdt zijn eigen
29 * werking, een geselecteerde tekst is geen tik, een verschoven vinger is
30 * scrollen, en cmd/ctrl-klik hoort de browser zelf af te handelen.
31 */
32
33// ── Paginamodus ─────────────────────────────────────────────────────────────
34/**
35 * Elk bericht een paneel dat zelf scrollt; tussen berichten ga je met knoppen.
36 *
37 * Robins voorstel (20-8) nadat het namaken van iOS-momentum niet lukte, en dat
38 * is de winst: in dit model DOET het scrollgevoel er niet toe. Er is geen
39 * momentum om na te bouwen en geen snap die vangt.
40 *
41 * Hoe het werkt:
42 * - lenis.stop() zet het scrollen van de STROOM stil. Lenis vangt dan wiel en
43 * vinger af (hij preventDefault't in onVirtualScroll), dus je kunt niet meer
44 * tussen berichten door scrollen.
45 * - data-lenis-prevent op elk paneel houdt de scroll BINNEN een bericht
46 * ongemoeid. Dat werkt ook terwijl Lenis gestopt is, want die controle staat
47 * in zijn bron vóór de gestopt-controle. Nagekeken in de dist, niet gehoopt.
48 * - Bewegen tussen panelen gaat met lenis.scrollTo(..., { force: true }), want
49 * force is precies de uitzondering die een gestopte Lenis toch laat scrollen.
50 *
51 * Geldt waar een bericht een eigen scherm heeft: op mobiel altijd, op desktop
52 * als de site dat instelt (reader_full_page). Buiten die modus verandert er
53 * niets -- dan is Lenis gewoon aan en scrol je vrij.
54 */
55/**
56 * PAGINAMODUS STAAT UIT -- maar de code blijft staan (Robin, 20-8: "weghalen
57 * maar bewaren, voor als ik het later weer wil").
58 *
59 * Wat het is: elk bericht een paneel van een scherm dat zelf scrolt, met twee
60 * balken om ertussen te navigeren en de stroomscroll vastgezet. Gebouwd omdat
61 * het namaken van iOS-momentum niet lukte; in dit model doet het scrollgevoel er
62 * namelijk niet toe. Mobiel is nu terug op systeemscroll met snap, en dat is wat
63 * er ook stond voordat we dit probeerden.
64 *
65 * Aanzetten: deze constante op true. Dan komen de balken terug (CSS hangt aan
66 * body.is-paged), stopt Lenis de stroomscroll en scrollen de panelen zelf.
67 */
68const PAGINAMODUS = false;
69
70function paginaModus() {
71 return PAGINAMODUS && OP_TOUCH.matches && document.body.dataset.feedView === 'reader';
72}
73
74function panelen() {
75 return [...document.querySelectorAll('.feed-reader .read-post')];
76}
77
78/** Welk paneel vult nu het scherm? Het eerste waarvan de bovenkant niet voorbij is. */
79function huidigIndex() {
80 const P = panelen();
81 for (let i = 0; i < P.length; i++) {
82 if (P[i].getBoundingClientRect().top > 8) return Math.max(0, i - 1);
83 }
84 return Math.max(0, P.length - 1);
85}
86
87function gaNaar(i) {
88 const P = panelen();
89 const doel = P[Math.max(0, Math.min(P.length - 1, i))];
90 if (!doel) return;
91 if (lenis) lenis.scrollTo(doel, { force: true });
92 else doel.scrollIntoView({ behavior: 'smooth', block: 'start' });
93 setTimeout(zetBalken, 80);
94}
95
96/**
97 * Omhoog vanaf het EERSTE bericht brengt je naar de header.
98 *
99 * In paginamodus staat Lenis stil, dus de pagina scrolt niet meer met je vinger
100 * -- en dan is alles boven het eerste bericht onbereikbaar. Robin liep daar
101 * tegenaan (20-8): "ik kan niet meer terug scrollen naar de header". De
102 * omhoog-knop is daar de enige weg naartoe, dus die krijgt er een trede bij.
103 */
104function gaOmhoog() {
105 const i = huidigIndex();
106 if (i > 0) { gaNaar(i - 1); return; }
107 if (lenis) lenis.scrollTo(0, { force: true });
108 else window.scrollTo({ top: 0, behavior: 'smooth' });
109}
110
111/**
112 * Welke balk hoort er te staan? Bovenaan de pagina is er niets boven je, dus dan
113 * geen bovenbalk. Buiten paginamodus staan ze allebei niet -- de CSS verbergt ze
114 * daar al, maar hidden houdt ze ook uit de toetsenbordvolgorde.
115 */
116function zetBalken() {
117 const boven = document.getElementById('read-prev');
118 const onder = document.getElementById('read-next-nav');
119 const aan = paginaModus();
120 // De bovenbalk hoort NOOIT over de header te liggen. Hij verscheen al zodra je
121 // een paar pixels scrolde, en dekte dan de avatar, de omschrijving en de
122 // weergaveknoppen af (Robins schermafbeelding, 20-8). Nu komt hij pas als het
123 // eerste bericht de bovenrand van het scherm heeft bereikt -- dan is de header
124 // voorbij en is er ook echt iets om naar terug te gaan.
125 const eerste = panelen()[0];
126 const headerNogInBeeld = eerste ? eerste.getBoundingClientRect().top > 4 : true;
127 if (boven) boven.hidden = !aan || headerNogInBeeld;
128 if (onder) onder.hidden = !aan;
129 if (onder && aan) onder.style.bottom = onderChroom() + 'px';
130}
131
132/**
133 * Hoe hoog staat de onderrand van het scherm werkelijk vol?
134 *
135 * De onderbalk stond op een geraden 4.75rem boven de onderkant, en dan zweeft
136 * hij: soms een kier boven de speler, soms er half achter. De tabbalk en de
137 * mini-speler hebben allebei een eigen hoogte, ze stapelen op mobiel, en de
138 * speler komt en gaat. Dus meten in plaats van gokken: hoe ver ligt de BOVENKANT
139 * van het hoogste vaste element boven de onderrand van het venster?
140 */
141function onderChroom() {
142 // .bottom-tab-fab staat erbij omdat de Write-knop BOVEN de tabbalk uitsteekt:
143 // meet je alleen de balk, dan legt onze balk zich over die knop heen (Robins
144 // schermafbeelding, 20-8).
145 const kandidaten = ['.bottom-tab', '.bottom-tab-fab', '#pcms-audio-player'];
146 let hoogste = 0;
147 kandidaten.forEach((sel) => {
148 const el = document.querySelector(sel);
149 if (!el) return;
150 const st = getComputedStyle(el);
151 if (st.display === 'none' || st.visibility === 'hidden') return;
152 const r = el.getBoundingClientRect();
153 if (r.height <= 0) return;
154 hoogste = Math.max(hoogste, window.innerHeight - r.top);
155 });
156 return Math.round(hoogste);
157}
158
159function pasPaginaModusToe() {
160 const aan = paginaModus();
161 document.body.classList.toggle('is-paged', aan);
162 panelen().forEach((a) => {
163 if (aan) a.setAttribute('data-lenis-prevent', '');
164 else a.removeAttribute('data-lenis-prevent');
165 });
166 if (lenis) { if (aan) lenis.stop(); else lenis.start(); }
167 zetBalken();
168}
169
170/**
171 * Terug naar boven, en bewust NIET window.scrollTo(0).
172 *
173 * In een stroom wil je terug naar het BEGIN VAN DIT BERICHT als je halverwege een
174 * lang stuk zit, en pas daarna naar de kop van de pagina. Twee keer drukken doet
175 * dus twee verschillende dingen -- dat scheelt op mobiel een hoop vegen.
176 */
177function naarBoven() {
178 const zacht = !window.matchMedia('(prefers-reduced-motion: reduce)').matches;
179 const gedrag = zacht ? 'smooth' : 'auto';
180 const posts = [...document.querySelectorAll('.feed-reader .read-post')];
181 const huidig = posts.find((a) => {
182 const r = a.getBoundingClientRect();
183 return r.top <= 8 && r.bottom > 8;
184 });
185 // Sta je al bovenaan dit bericht (of bij het eerste), dan naar de paginakop.
186 if (huidig && huidig.getBoundingClientRect().top < -8) {
187 huidig.scrollIntoView({ behavior: gedrag, block: 'start' });
188 return;
189 }
190 window.scrollTo({ top: 0, behavior: gedrag });
191}
192
193/** De knop verschijnt pas als er iets ONDER je ligt om naar terug te keren. */
194function toonKnop(knop) {
195 knop.classList.toggle('is-zichtbaar', window.scrollY > window.innerHeight * 0.6);
196}
197
198let tapX = 0, tapY = 0;
199function onPointerDown(e) { tapX = e.clientX; tapY = e.clientY; }
200
201function onTap(e) {
202 if (e.defaultPrevented || e.button !== 0) return;
203 if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
204 const t = e.target;
205 if (!t || typeof t.closest !== 'function') return;
206 const art = t.closest('.read-post');
207 if (!art) return;
208 if (t.closest('a, button, input, textarea, select, label, summary, [role="button"]')) return;
209 if (Math.abs(e.clientX - tapX) > 10 || Math.abs(e.clientY - tapY) > 10) return;
210 const sel = window.getSelection && window.getSelection();
211 if (sel && String(sel).trim()) return;
212
213 const slug = art.dataset.slug;
214 if (!slug) return;
215 location.href = (art.dataset.base || '') + '/' + encodeURIComponent(slug);
216}
217
218/**
219 * Omhoog scrollen blijft VRIJ (Robin, 20-8).
220 *
221 * Snappen hoort bij doorlezen; ga je terug, dan zoek je iets en bepaal je zelf
222 * waar je stopt. CSS kent geen richtingsgevoelig snappen, dus dat ene stukje
223 * moet hier -- maar dan ook niet meer dan dat: we zetten de CSS-functie aan of
224 * uit op de scroller. Geen vangzones, geen snappunten per bericht, geen
225 * scrollpositie-boekhouding.
226 *
227 * DE RICHTING KOMT UIT DE INVOER, niet uit scroll-events. Gemeten op dev: die
228 * events bevatten ook de bewegingen van de browser zelf -- zijn snap-animatie en
229 * de rubber-band -- en die gaan soms omhoog. Wie daaruit de richting afleidt,
230 * leest de browser en niet de gebruiker.
231 *
232 * EN ER WORDT ALLEEN GESCHAKELD BIJ STILSTAND. Dat is de tweede les, en die
233 * kostte een ronde. Eerst zette dit de schakelaar om bij ELK wiel-event en ELKE
234 * vingerbeweging, dus binnen een veeg klapte hij meerdere keren heen en weer.
235 * De browser raadpleegt scroll-snap-type alleen aan het eind van een gebaar of
236 * van de uitloop, en of je daar net vóór of net ná zit bepaalt dan of er
237 * gesnapt wordt. Gemeten (Robins melding "soms triggert het terwijl we nog aan
238 * het doorscrollen zijn"):
239 *
240 * snappen UIT, beweging naar 1459 loopt
241 * -> halverwege snappen AAN gezet
242 * -> eindigt op 1459, NIET op een berichtgrens
243 *
244 * Bij stilstand omzetten is wel onschuldig: dezelfde proef gaf 0px sprong.
245 * Vandaar: richting bepalen bij het BEGIN van een gebaar, en daarna niets meer
246 * aanraken tot de scroll echt stil is.
247 *
248 * Wat je daarvoor inlevert: binnen een veeg ligt de stand vast. Draai je
249 * halverwege om zonder los te laten, dan geldt de stand van dat gebaar nog. Een
250 * besluit per gebaar is voorspelbaar; het omklappen halverwege was het probleem.
251 */
252const RUST_MS = 120;
253
254let bezig = false; // loopt er een gebaar of een uitloop?
255let ooitGescrold = false; // snappen begint UIT, zie zetSnappen()
256let rustTimer = null;
257
258/**
259 * LENIS, en alleen op desktop.
260 *
261 * Op touch doet Lenis van zichzelf niets (syncTouch staat standaard uit) en is
262 * het systeem-scrollen al soepel -- daar blijft de native CSS-snap staan die
263 * hierboven beschreven is. Robins keuze (20-8): "enkel voor desktop, dat is
264 * prima, logisch dat het niet op mobiel kan".
265 *
266 * WAAROM LENIS HIER STAAT, en dat is niet het vloeiende scrollen: de DUUR van
267 * een snap is met native scroll-snap niet in te stellen -- die zit in de browser.
268 * Lenis' snap-pakket wel: duration, easing, distanceThreshold en debounce zijn
269 * allemaal van ons. Dat was de aanleiding.
270 *
271 * Het vloeiende scrollen (smoothWheel) kwam er daarna bij, en dat is de kant die
272 * OPPASSEN vraagt. Een Mac-trackpad heeft zijn EIGEN momentum, en Lenis'
273 * demping komt daar bovenop -- dubbel gedempt voelt drijverig. Vandaar lerp 0.2
274 * in plaats van de standaard 0.1. Robin vond dat op 20-8 nog steeds te zweverig,
275 * dus dat getal is nog niet uit; zie de opmerking bij de instellingen.
276 *
277 * De stand met `smoothWheel: false` werkte ook, en dan doet Lenis alleen de
278 * snap. Dat is de terugvalpositie als het vloeiende scrollen niet bevalt.
279 *
280 * lenis/snap haakt alleen in op lenis.on('scroll') en roept lenis.scrollTo aan
281 * (nagekeken in de dist), dus die opzet werkt.
282 */
283const OP_DESKTOP = window.matchMedia('(hover: hover) and (pointer: fine)');
284// PROEF (20-8): Lenis ook op touch. Robin meldde op mobiel drie dingen -- de
285// header niet zichtbaar bij laden, snappen dat soms te ver gaat, en horizontaal
286// kunnen scrollen. De eerste twee komen van de NATIVE snap: die vangt al bij het
287// laden, en zijn uitloop vliegt bij een flick over een grens heen. Lenis zet de
288// native snap uit en doet het zelf, dus die twee kunnen ermee verdwijnen.
289//
290// De prijs is echt: syncTouch betekent dat Lenis het VINGERSCROLLEN overneemt
291// van iOS -- momentum, rubber-band en het wegschuiven van de adresbalk worden
292// dan een benadering in JavaScript. De makers waarschuwen daar zelf voor op
293// iOS < 16. Dit staat er dus als proef, niet als besluit: voelt het niet goed,
294// dan is OP_TOUCH weer false zetten de hele terugweg.
295const OP_TOUCH = window.matchMedia('(hover: none) and (pointer: coarse)');
296const VENDOR_V = 1; // ophogen als de bestanden in /assets/js/vendor wijzigen
297
298let lenis = null;
299let snap = null;
300
301async function startLenis() {
302 // DESKTOP EN TOUCH ALLEBEI. Er heeft hier een tijd gestaan dat mobiel terug was
303 // op de systeemscroll; dat klopte niet meer met de regel hieronder, die
304 // syncTouch juist AANzet op touch. Reden dat Lenis ook op de telefoon meedraait:
305 // zijn snap heeft zijn scroll-gebeurtenissen nodig om te kunnen timen.
306 if (lenis || !(OP_DESKTOP.matches || OP_TOUCH.matches)) return;
307 const [L, S] = await Promise.all([
308 import(`/assets/vendor/lenis.mjs?v=${VENDOR_V}`),
309 import(`/assets/vendor/lenis-snap.mjs?v=${VENDOR_V}`),
310 ]);
311 lenis = new L.default({
312 /**
313 * Wat Lenis MET RUST LAAT.
314 *
315 * In paginamodus staat Lenis stil en scrolt alleen het paneel van het
316 * bericht zelf. Dat regelde ik eerst met een data-lenis-prevent-attribuut
317 * dat de module op elk paneel zette -- maar dan hangt het scrollen af van of
318 * dat attribuut op tijd en op elk (ook later bijgeladen) paneel staat, en
319 * Robin kon binnen een lang bericht niet scrollen.
320 *
321 * Deze functie stelt dezelfde vraag zonder die afhankelijkheid: is dit een
322 * bericht-paneel? Dan bemoeit Lenis zich er niet mee en scrolt de browser
323 * het zelf -- wat op een telefoon precies is wat je wilt, want dat is de
324 * systeemscroll.
325 */
326 prevent: (node) => !!(node && node.classList
327 && node.classList.contains('read-post')
328 && document.body.classList.contains('is-paged')),
329 // Lenis tekent de scrollbeweging zelf, maar STEVIG GEDEMPT (lerp 0.2 in
330 // plaats van de standaard 0.1). Reden: een muiswiel scrollt in schokken en
331 // heeft die demping nodig; een Mac-trackpad heeft zijn EIGEN momentum en
332 // krijgt er dan een tweede overheen -- dat is precies het drijverige gevoel
333 // waar Robin voor waarschuwde. Hoger betekent korter naijlen, dus dit is de
334 // middenweg: de schokjes weg, de nasleep kort.
335 // Staat het toch te zweven, dan is lerp omhoog (richting 1) of terug naar
336 // smoothWheel:false de knop -- die stand werkte ook, met alleen de snap.
337 smoothWheel: true,
338 lerp: 0.2,
339 // Alleen op touch overneemt hij het vingerscrollen; op desktop hoeft dat niet.
340 syncTouch: OP_TOUCH.matches,
341 // Twee touch-knoppen, en ze doen echt iets anders. Lenis rekent bij het
342 // LOSLATEN eenmalig een doel uit -- afstand = snelheid^touchInertiaExponent
343 // -- en kruipt daar dan naartoe met syncTouchLerp.
344 //
345 // touchInertiaExponent hoe VER de flick draagt (standaard 1.7)
346 // syncTouchLerp hoe hard hij REMT (standaard 0.075)
347 //
348 // Let op: `touchInertiaMultiplier` bestaat NIET in 1.3.26. Lenis slikt
349 // onbekende opties zonder fout, dus zo'n regel lijkt te werken en doet niets.
350 // Controleer een optienaam in src/assets/vendor/lenis.mjs voor je hem zet.
351 //
352 // DIT ZIJN NU STARTWAARDEN, geen vaste stand meer: stemTraagheidAf()
353 // verderop verzet ze bij elk gebaar, klein gebaar meer naijlen dan groot
354 // (Robin, 21-8). Wat hier staat geldt dus alleen tot de eerste veeg.
355 ...(OP_TOUCH.matches ? { syncTouchLerp: 0.09, touchInertiaExponent: 2.2 } : {}),
356 autoRaf: true,
357 });
358 snap = new S.default(lenis, {
359 type: 'proximity',
360 // DE VANGZONE, en dit is HET getal om aan te draaien. Ooit 12%, toen 55%
361 // (20-8: eerder vangen, boven de reacties), en 21-8 terug naar 12% -- want
362 // sinds het snappen alleen nog vooruit werkt, voelde die brede zone als
363 // trekken tijdens het lezen. 12% is ~110 pixels op een venster van 910: hij
364 // vangt pas vlak vóór de lijn.
365 // Houd dit gelijk aan vangZone() hieronder: deze drempel bepaalt of
366 // lenis/snap überhaupt aanklopt, die andere of wij het doorlaten. Zet je
367 // deze lager dan die, dan komt onze regel nooit aan bod.
368 distanceThreshold: '12%',
369 // Hoe lang na de laatste scrollbeweging hij mag vangen. De standaard is 500
370 // en dat voelt als te laat. Op touch nog korter dan op desktop, want daar
371 // eindigt een veeg in een lange, trage staart -- en juist dan wil je dat de
372 // snap er snel bij is in plaats van te wachten tot de laatste pixel stil ligt.
373 //
374 // LET OP DE SPANNING: een vloeiendere uitloop (lagere syncTouchLerp) maakt
375 // die staart langer, en stelt de snap dus uit. Deze twee getallen houden
376 // elkaar in evenwicht; draai je aan de een, kijk dan ook naar de ander.
377 // OP TOUCH JUIST LANG, en dat is het omgekeerde van wat ik vorige ronde deed.
378 // Tussen je vinger loslaten en het op gang komen van de uitloop zit een korte
379 // stilte in de scrollbeweging. Met 25ms viel de snap precies in dat gat: hij
380 // greep op het moment van loslaten en knipte de veeg af -- wat aanvoelt als
381 // "stroef bij het loslaten", en het werd er dan ook erger van. 200ms laat de
382 // uitloop eerst zijn werk doen.
383 // Met een iOS-achtige uitloop duurt de staart lang; te kort wachten laat de
384 // snap midden in de vlucht ingrijpen. 150ms laat hem uitrollen en vangt dan.
385 debounce: OP_TOUCH.matches ? 150 : 60,
386 // Op touch korter: een telefoon vraagt om directer antwoord dan een muis, en
387 // de snap komt daar aan het eind van een lange uitloop -- dan mag hij kort.
388 duration: OP_TOUCH.matches ? 0.18 : 0.4,
389 // Vlot weg, dan steeds langzamer aankomen (Robin, 20-8). easeOutQuart: op de
390 // helft van de tijd is 94% van de weg af, en de rest dempt zacht uit.
391 // Bewust NIET Lenis' standaard easeOutExpo -- die schiet weg en kruipt dan
392 // zo lang na dat het lijkt of hij niet afmaakt.
393 easing: (t) => 1 - Math.pow(1 - t, 4),
394 });
395 // Het snappunt is de bovenkant van elk bericht -- ook van het laatste. Dat
396 // deed eerder niet mee omdat zijn bovenkant onbereikbaar was; sinds het
397 // laatste bericht in CSS een volle schermhoogte krijgt, kan hij wel.
398 const berichten = [...document.querySelectorAll('.feed-reader .read-post')];
399 berichten.forEach((a) => snap.addElement(a, { align: 'start' }));
400
401 // ALLEEN VOORUIT VANGEN. Dit hoort bij de ruime zone hierboven en is niet
402 // optioneel: lenis/snap kiest het DICHTSTBIJZIJNDE punt en zijn drempel geldt
403 // naar twee kanten. Scroll je een lang bericht in en stop je 300 pixels onder
404 // de bovenkant, dan is die bovenkant het dichtstbij -- en met een zone van 400
405 // wordt je teruggetrokken. Dat is precies de klacht "ik kan niet scrollen
406 // binnen een lang bericht", en met de oude zone van 86 pixels viel het alleen
407 // niet op.
408 //
409 // Dus: een doel ACHTER je slaan we over. Ligt er een punt voor je binnen de
410 // zone, dan gaan we daarheen; anders gebeurt er niets en scrol je vrij door.
411 // Zo verruimt de zone alleen de kant waar hij bedoeld is.
412 //
413 // Waarom niet gewoon de drempel? Omdat lenis/snap alleen de dichtstbijzijnde
414 // kandidaat beoordeelt: zonder deze omleiding houdt de zone vooruit op bij de
415 // helft van de afstand tussen twee berichten, hoe groot je de drempel ook zet.
416 //
417 // DE REGEL, in Robins woorden (21-8): "enkel bij downscrollen, aan de
418 // onderkant van elke post, snappen naar de lijn tussen de posts" -- en geen
419 // snap op een bericht dat al voorbij is gescrold. Drie voorwaarden dus:
420 // 1. de laatste echte beweging ging omlaag,
421 // 2. het doel ligt VOOR je (een punt achter je slaan we over),
422 // 3. het ligt binnen de vangzone -- die begint rond de voet van het bericht.
423 // Het doel zelf blijft de bovenkant van het volgende bericht: dat IS de lijn
424 // ertussen, en dat is het essentiële.
425 //
426 // DE ZONE IS EEN GETAL, geen '55%'. Die string kwam ongewijzigd uit de opties
427 // en werd hier met een getal vergeleken -- altijd onwaar, dus deze terugval
428 // heeft nooit gewerkt en alleen het doel dat lenis zelf koos kwam erdoor.
429 const vangZone = () => 0.12 * window.innerHeight; // gelijk aan distanceThreshold hierboven
430 // Lenis' eigen `direction` is het teken van de snelheid, en die is bij het
431 // afvuren van de (gedebouncede) snap alweer nul. Daarom onthouden we de
432 // laatste richting die er echt was.
433 let laatsteRichtingOmlaag = true;
434 lenis.on('scroll', () => {
435 if (Math.abs(lenis.velocity) > 0.05) laatsteRichtingOmlaag = lenis.velocity > 0;
436 });
437 const echtGaNaar = snap.goTo.bind(snap);
438 snap.goTo = (index) => {
439 if (!laatsteRichtingOmlaag) return; // omhoog: nooit vangen
440 const punten = snap.computeSnaps(); // zelfde volgorde als goTo intern gebruikt
441 const nu = lenis.scroll;
442 let vooruit = -1;
443 punten.forEach((punt, i) => {
444 if (punt.value > nu + 2 && (vooruit < 0 || punt.value < punten[vooruit].value)) vooruit = i;
445 });
446 if (vooruit < 0) return; // niets meer voor je: vrij uitscrollen
447 if (punten[vooruit].value - nu <= vangZone()) echtGaNaar(vooruit);
448 };
449 // Native snappen uit: twee mechanismen op dezelfde scroller vechten.
450 document.documentElement.style.scrollSnapType = 'none';
451}
452
453function stopLenis() {
454 if (snap) { snap.destroy(); snap = null; }
455 if (lenis) { lenis.destroy(); lenis = null; }
456 document.documentElement.style.scrollSnapType = '';
457}
458
459/**
460 * Omhoog niet snappen. Met Lenis is dat snap.stop()/start(); zonder Lenis (dus
461 * op touch) zetten we de CSS-eigenschap om, precies zoals hiervoor.
462 */
463function zetSnappen(aan) {
464 if (snap) { if (aan) snap.start(); else snap.stop(); return; }
465 // Zonder Lenis (mobiel) zetten we de CSS-eigenschap om. Hij staat bij het
466 // laden UIT -- dat is de standaardstand van deze variabele -- zodat de browser
467 // niet meteen naar het eerste bericht springt en de header wegvalt. Pas je
468 // eerste gebaar naar beneden zet hem aan.
469 const el = document.documentElement;
470 const wil = aan ? '' : 'none';
471 if (el.style.scrollSnapType !== wil) el.style.scrollSnapType = wil;
472}
473
474/** Een richting geldt alleen als er NIETS beweegt. Anders negeren we hem. */
475function nieuwGebaar(naarBeneden) {
476 if (bezig) return;
477 bezig = true;
478 zetSnappen(naarBeneden);
479}
480
481/**
482 * Het gebaar is pas voorbij als de SCROLL stil is, niet als de vinger loslaat:
483 * op iOS loopt de uitloop daarna nog door. `scrollend` zegt dat precies, maar
484 * bestaat niet overal (Chrome 114+, Safari 17+) -- vandaar ook de timer.
485 */
486function rustNu() { bezig = false; }
487function planRust() {
488 clearTimeout(rustTimer);
489 rustTimer = setTimeout(rustNu, RUST_MS);
490}
491
492/**
493 * TRAAGHEID NAAR DE MAAT VAN HET GEBAAR (Robin, 21-8: "bij een korte scroll wat
494 * meer inertia, bij een snelle juist wat minder").
495 *
496 * Dit kan omdat Lenis deze drie opties op het moment van de GEBEURTENIS leest,
497 * niet bij het opstarten (gecontroleerd in vendor/lenis.mjs):
498 * options.lerp bij een wiel -- lager = langer naijlen
499 * options.touchInertiaExponent bij touchend -- afstand = |snelheid| ** exponent
500 * options.syncTouchLerp bij touchend -- hoe hard hij daarna remt
501 * Ze zijn dus per gebaar te verzetten, en dat is precies wat hier gebeurt.
502 *
503 * De omkering zit in de exponent. Bij een snelheid boven de 1 draagt een HOGERE
504 * exponent veel verder: met 2.2 vliegt een harde veeg er ruim vanuit, terwijl
505 * een zachte veeg er juist door verschrompelt. Vandaar dat een klein gebaar nu
506 * de hoge exponent en de zachte rem krijgt, en een groot gebaar de lage
507 * exponent en een stevigere rem.
508 *
509 * Draaien doe je aan deze zes getallen; de grenzen eronder zeggen wat "klein"
510 * en "groot" is.
511 */
512const WIEL_KLEIN = 40, WIEL_GROOT = 240; // |deltaY| van een wielstap
513const RAAK_KLEIN = 4, RAAK_GROOT = 26; // |snelheid| van Lenis bij een veeg
514const WIEL_LERP_KLEIN = 0.12, WIEL_LERP_GROOT = 0.30;
515const RAAK_LERP_KLEIN = 0.06, RAAK_LERP_GROOT = 0.13;
516const RAAK_EXP_KLEIN = 2.4, RAAK_EXP_GROOT = 1.4;
517
518const meng = (a, b, t) => a + (b - a) * Math.min(1, Math.max(0, t));
519
520function stemTraagheidAf(sterkte, klein, groot, opTouch) {
521 if (!lenis) return;
522 const t = (sterkte - klein) / (groot - klein);
523 if (opTouch) {
524 lenis.options.syncTouchLerp = meng(RAAK_LERP_KLEIN, RAAK_LERP_GROOT, t);
525 lenis.options.touchInertiaExponent = meng(RAAK_EXP_KLEIN, RAAK_EXP_GROOT, t);
526 } else {
527 lenis.options.lerp = meng(WIEL_LERP_KLEIN, WIEL_LERP_GROOT, t);
528 }
529}
530
531function opWiel(e) {
532 if (Math.abs(e.deltaY) <= 1) return;
533 stemTraagheidAf(Math.abs(e.deltaY), WIEL_KLEIN, WIEL_GROOT, false);
534 nieuwGebaar(e.deltaY > 0);
535}
536let raakY = 0;
537function opRaakStart(e) { if (e.touches && e.touches[0]) raakY = e.touches[0].clientY; }
538function opRaakBeweeg(e) {
539 if (!e.touches || !e.touches[0]) return;
540 const y = e.touches[0].clientY;
541 // Vinger omhoog = inhoud omlaag. Drie pixels speling tegen de trilling van een
542 // duim die stilstaat.
543 if (Math.abs(y - raakY) > 3) { nieuwGebaar(y < raakY); raakY = y; }
544 // De snelheid van NU is die van het laatste stukje veeg, en dat is de
545 // snelheid waarmee de vinger straks loslaat. Lenis leest de exponent pas bij
546 // touchend, dus wat we hier zetten geldt voor precies deze flick.
547 if (lenis) stemTraagheidAf(Math.abs(lenis.velocity), RAAK_KLEIN, RAAK_GROOT, true);
548}
549function opToets(e) {
550 if (['ArrowDown', 'PageDown', 'End', ' ', 'Spacebar'].indexOf(e.key) >= 0) nieuwGebaar(true);
551 else if (['ArrowUp', 'PageUp', 'Home'].indexOf(e.key) >= 0) nieuwGebaar(false);
552}
553
554let knop = null;
555let opScroll = null;
556
557export function init() {
558 // EERST OPRUIMEN, en pas daarna terugvallen als er geen leesstroom is.
559 //
560 // Dit stond andersom, en dat brak het scrollen op de HELE site: navigeerde je
561 // van Lezen naar het beheer, dan viel init() bij de ontbrekende leesstroom
562 // meteen terug -- en bleef Lenis leven EN gestopt (lenis.stop() vangt wiel en
563 // vinger af). Daarna scrolde niets meer, ook niet op pagina's die met Lezen
564 // niets te maken hebben. Robins melding (20-8): "scrollen werkt nu nergens ook
565 // niet in admin panels".
566 //
567 // Opruimen hoort dus bij het VERLATEN van de weergave, niet bij het opzetten
568 // ervan. init() draait bij elke paginawissel, dus dit is de plek.
569 stopLenis();
570 document.body.classList.remove('is-paged');
571 document.querySelectorAll('[data-lenis-prevent].read-post')
572 .forEach((a) => a.removeAttribute('data-lenis-prevent'));
573
574 const s = document.getElementById('read-stream');
575 if (!s) return;
576 // Op de stroom, niet per artikel: wat "meer laden" erbij zet doet vanzelf mee.
577 // init() draait bij ELKE paginawissel, dus eerst losmaken -- anders stapelt
578 // dezelfde afhandelaar zich op en vuurt hij twee keer.
579 s.removeEventListener('pointerdown', onPointerDown);
580 s.removeEventListener('click', onTap);
581 s.addEventListener('pointerdown', onPointerDown, { passive: true });
582 s.addEventListener('click', onTap);
583
584 // De knop staat in de HTML, zodat hij er ook is zonder deze module -- dan doet
585 // hij niets, maar hij springt niet in beeld bij het laden.
586 // De terug-naar-boven-knop staat er tijdelijk uit (Robin, 20-8) -- in
587 // paginamodus doet de bovenbalk dat werk al. De code blijft staan zodat hij
588 // met een regel terug is.
589 knop = null;
590 const oudeKnop = document.getElementById('read-top');
591 if (oudeKnop) oudeKnop.hidden = true;
592
593 if (opScroll) {
594 window.removeEventListener('scroll', opScroll);
595 window.removeEventListener('scrollend', rustNu);
596 window.removeEventListener('resize', opScroll);
597 window.removeEventListener('wheel', opWiel);
598 window.removeEventListener('touchstart', opRaakStart);
599 window.removeEventListener('touchmove', opRaakBeweeg);
600 window.removeEventListener('keydown', opToets);
601 }
602 // Elke scroll -- van een vinger of van de browser zelf -- houdt het gebaar
603 // levend; pas als het stil blijft mag een nieuwe richting gelden.
604 opScroll = () => {
605 if (knop) toonKnop(knop);
606 planRust();
607 if (document.body.classList.contains('is-paged')) zetBalken();
608 };
609 window.addEventListener('scroll', opScroll, { passive: true });
610 window.addEventListener('scrollend', rustNu);
611 window.addEventListener('resize', opScroll, { passive: true });
612 window.addEventListener('wheel', opWiel, { passive: true });
613 window.addEventListener('touchstart', opRaakStart, { passive: true });
614 window.addEventListener('touchmove', opRaakBeweeg, { passive: true });
615 window.addEventListener('keydown', opToets);
616
617 const balkBoven = document.getElementById('read-prev');
618 const balkOnder = document.getElementById('read-next-nav');
619 if (balkBoven) balkBoven.onclick = gaOmhoog;
620 if (balkOnder) balkOnder.onclick = () => gaNaar(huidigIndex() + 1);
621
622 // Alleen in de leesweergave, en alleen op desktop. Bij elke init() opnieuw
623 // beoordelen: van Grid naar Lezen schakelen hoort hem aan te zetten, en
624 // wegnavigeren hoort hem op te ruimen.
625 if (document.body.dataset.feedView === 'reader') startLenis().then(pasPaginaModusToe);
626 else pasPaginaModusToe();
627
628
629}
630
631export default { init };
Note: See TracBrowser for help on using the repository browser.