Fehlerbehebung
Tipp
Die folgenden Konsolenwarnungen erscheinen nur in Entwicklungs-Builds. Produktions-Builds und der CDN-Build lassen sie weg, um Bytes zu sparen.
Die Sidebar klebt überhaupt nicht
- Sie ist gestreckt. In Grid/Flex nimmt die Sidebar standardmäßig die volle Zeilenhöhe ein. Füge
align-items: startam Elternelement oderalign-self: startan der Sidebar hinzu. Siehe Layout. - Ein Vorfahre hat
overflowgesetzt.overflow: hidden | auto | scrollmacht jeden Vorfahren zum Sticky-Container. Verwendeoverflow: clip, oder übergib das Element alsscroller, falls es der eigentliche Scroll-Container ist. mediatrifft nicht zu. Solange die Media Query false ist, ist die Instanz inaktiv.- Sie ist anfangs versteckt. Hat die Sidebar beim Start keine Höhe (
display: none, in einem geschlossenen Tab), wartet die Instanz. EinResizeObservergreift, sobald sie sichtbar wird – alternativ rufst duupdate()auf.
Fehler „element not found“
stickySidebar('#sidebar') wirft einen Fehler, wenn der Selektor nichts findet. Erstelle die Instanz erst, wenn das Element im DOM ist: nach DOMContentLoaded, in onMounted / useEffect – oder nutze die Framework-Adapter, die das für dich erledigen.
Header-Selektor findet nichts
[dynamic-sticky-sidebar] header selector ".site-header" matched no elements
Der header-Selektor hat beim Start der Instanz nichts gefunden. Die Sidebar wird daher am oberen Viewport-Rand fixiert und rutscht womöglich unter deinen Header. Prüfe den Selektor oder rufe refresh() auf, sobald der Header gerendert ist.
Scroller nicht gefunden
[dynamic-sticky-sidebar] scroller "#app" not found, using the window
Die Option scroller ließ sich keinem Element zuordnen. Prüfe den Selektor oder übergib direkt das Element.
Konsolenwarnung zu Grid / Zeilen-Flex
[dynamic-sticky-sidebar] parent is not grid / row-flex, so scrolling up uses a JS fallback …
Das direkte Elternelement der Sidebar ist ein Block. Es funktioniert trotzdem, aber beim Hochscrollen kann die Sidebar einen Frame hinterherhinken. Gib dem Elternelement display: grid; align-items: start. Siehe Block-Layout.
Die Sidebar überlappt den Header oder lässt eine Lücke darunter
- Stelle sicher, dass jede Header-Zeile in
headerübergeben wird. Bei einem Selektor werden alle Treffer verwendet. - Bewegt sich der Header wegen einer Klasse an einem Vorfahren, sieht die Bibliothek das nicht. Rufe
update()auf oder verwendesubscribe. - Header, die nach dem Start im DOM ersetzt werden, brauchen
refresh(). - Mehr Abstand gewünscht? Erhöhe
gap(Standard16) oder fügeoffsetTophinzu.
Der Inhalt der Sidebar ändert seine Höhe
Du musst nichts tun. Ein ResizeObserver beobachtet die Sidebar und ihr Elternelement. Ändert sich die Höhe der Sidebar, während sie freigegeben ist, wird sie an ihrer aktuellen Bildschirmposition neu verankert, und die fixierten Positionen werden neu berechnet.
Serverseitiges Rendering
Der Kern greift erst auf document und window zu, wenn stickySidebar() aufgerufen wird. Der React-Hook läuft in einem Ref-Callback, und der React-Einstiegspunkt ist mit "use client" markiert. Das Vue-Composable und die Direktive laufen nach dem Mounten. Alle lassen sich gefahrlos in SSR-Apps importieren (Next.js, Nuxt, VuePress, …).