@skerbis/nativecss 1.1.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,35 @@
2
2
 
3
3
  Alle nennenswerten Änderungen an NativeCSS. Versionierung nach [Semantic Versioning](https://semver.org/lang/de/).
4
4
 
5
+ ## [1.2.1] - 2026-11-20
6
+
7
+ ### Behoben
8
+
9
+ - Automatischer Kompakt-Modus: eine Nav-Liste mit `justify-content: flex-end` (oder `center`, RTL) lief zum Zeilenanfang über die Marke, ohne dass `js/nav.js` das erkannte - `scrollWidth` misst nur Überlauf zum Zeilenende. Jetzt werden die äußeren Kanten der Punkte geprüft.
10
+
11
+ ## [1.2.0] - 2026-11-20
12
+
13
+ ### Geändert (Verhalten)
14
+
15
+ - **Navigation ohne festen Breakpoint:** `.ncss-nav` klappt jetzt automatisch genau dann zur Menü-Schaltfläche (Off-Canvas) zusammen, wenn die Liste nicht mehr in **eine** Zeile neben Marke und Aktionen passt - bei jeder Breite. `js/nav.js` misst per `ResizeObserver` (Zeile, Marke, Aktionen und Nav-Punkte, also auch bei größerer Schrift, Zoom und Textabständen) und setzt `data-ncss-nav-auto="inline"` bzw. `"compact"`. Die Liste bricht dabei nie mehr in eine zweite Zeile um. Ohne JavaScript bleibt die bisherige Umschaltung bei 64rem als Rückfall.
16
+
17
+ ### Neu
18
+
19
+ - `.ncss-nav--compact`: immer Menü-Schaltfläche, bei jeder Breite.
20
+ - `data-ncss-nav-auto="off"`: Automatik aus, feste Umschaltung bei 64rem (für Seiten, deren eigenes CSS an derselben Schwelle hängt - so die Kopfleiste der Website).
21
+ - Event `ncss-nav-change` (`event.detail.compact`) bei jedem Wechsel.
22
+ - Barrierefreiheit: `js/nav.js` setzt `aria-controls` und hält `aria-expanded` der Menü-Schaltfläche passend zum Panel. Klappt die Liste zusammen, während der Fokus darin liegt, wandert er auf die Schaltfläche; wird es wieder breit, schließt ein offenes Panel und der Fokus bleibt auf dem Link.
23
+ - Handbuch: Live-Beispiel mit Breiten-Regler und Tabelle der Schalter (Navigation → Off-Canvas und automatischer Kompakt-Modus).
24
+
25
+ ### Behoben
26
+
27
+ - `.ncss-nav--tree` bekam unter 64rem fälschlich den oberen Panel-Abstand der Off-Canvas-Liste.
28
+
29
+ ### Hinweis zum Umstieg
30
+
31
+ - Seiten mit eigenem CSS, das an der 64rem-Schwelle der Nav hängt, entweder auf den Zustand umstellen (`.ncss-nav:is(.ncss-nav--compact, [data-ncss-nav-auto="compact"])`, dazu dieselben Regeln in `@media (max-width: 63.99rem)` für Seiten ohne JS) oder `data-ncss-nav-auto="off"` setzen.
32
+ - `js/nav.js` am besten im `<head>` mit `defer` laden - dann steht der Zustand vor dem ersten Zeichnen fest.
33
+
5
34
  ## [1.1.0] - 2026-11-20
6
35
 
7
36
  ### Neu
package/README.md CHANGED
@@ -61,7 +61,8 @@ Barrierefreiheitserklärung.
61
61
  - **Inhalt:** Karten (Overlay, Auswahl-Karten, Raster mit Subgrid, Skelett), Listen,
62
62
  Leader-Linien, Tabellen (sortierbar, Scroll-Schatten), Zeitleiste, Stepper, Kommentare,
63
63
  Hinweise, Badges.
64
- - **Navigation:** Kopfleiste, Off-Canvas, Priority-Nav, Drilldown, Breadcrumb, Tabs (mit
64
+ - **Navigation:** Kopfleiste, die ohne festen Breakpoint genau dann zur Menü-Schaltfläche wird,
65
+ wenn die Punkte nicht mehr in eine Zeile passen, Off-Canvas, Priority-Nav, Drilldown, Breadcrumb, Tabs (mit
65
66
  Animationen), Pagination, Abschnitts-Navigation, Befehlspalette, Dropdown/Aktionsmenü,
66
67
  Pillen-Gruppe, Toolbar mit Split-Button.
67
68
  - **Formulare:** alle Feldtypen, Validierung, Floating Labels, Segmented (auch als
@@ -1,8 +1,9 @@
1
1
  /**
2
2
  * ncss - Navigation-Komponente (Layer "components"). Zwei Varianten:
3
3
  *
4
- * 1. .ncss-nav (horizontal, Desktop) - kollabiert unterhalb der Breakpoint-Konvention
5
- * "nav-collapse" (64rem, siehe tokens.css) zu einem Hamburger-Button, der DASSELBE
4
+ * 1. .ncss-nav (horizontal) - kollabiert zu einem Hamburger-Button, sobald die Liste nicht
5
+ * mehr in EINE Zeile passt (automatisch per js/nav.js, siehe "Kompakt-Modus" unten;
6
+ * ohne JS fest unterhalb der Konvention "nav-collapse", 64rem, siehe tokens.css), der DASSELBE
6
7
  * Markup als Off-Canvas-Sidebar öffnet (components/off-canvas.css wird direkt
7
8
  * mitgenutzt, nicht dupliziert - .ncss-nav-panel trägt zusätzlich die off-canvas-
8
9
  * Klassen). "display: contents" lässt den Dialog-Wrapper auf Desktop optisch
@@ -93,11 +94,10 @@
93
94
  display: none;
94
95
  }
95
96
 
96
- /* Breakpointless: KEIN fester Punkt, an dem die horizontale Liste "umschaltet" - sie
97
- versucht immer zuerst, in einer Zeile zu bleiben; passt sie nicht, umbricht sie
98
- organisch in eine zweite Zeile (wie Fließtext), statt den Viewport zu sprengen.
99
- Reagiert stufenlos auf JEDE Breite, nicht nur auf die eine dokumentierte
100
- nav-collapse-Schwelle.
97
+ /* Ohne JavaScript (Rückfall): passt die Liste oberhalb von 64rem nicht in eine Zeile,
98
+ umbricht sie organisch in eine zweite Zeile (wie Fließtext), statt den Viewport zu
99
+ sprengen. Mit js/nav.js bricht sie nie um - dann schaltet der Kompakt-Modus (unten)
100
+ auf die Menü-Schaltfläche.
101
101
  NICHT overflow-x:auto (frühere Version dieser Datei, per echtem Nutzertest verworfen):
102
102
  overflow-x auf irgendeinem Nicht-"visible"-Wert zwingt laut Spec AUCH overflow-y auf
103
103
  einen berechneten Wert ungleich "visible" (nicht mehr "sichtbar über den Rand hinaus")
@@ -333,75 +333,6 @@
333
333
  inset-block-start: 0;
334
334
  }
335
335
 
336
- /* -- ncss breakpoint: nav-collapse (64rem) -- */
337
- @media (max-width: 63.99rem) {
338
- .ncss-nav-toggle {
339
- display: inline-flex;
340
- }
341
- /* display:contents zurücknehmen - jetzt greift die native <dialog>-Logik normal
342
- (position:fixed, Slide-in-Animation, Backdrop aus components/off-canvas.css).
343
- EXPLIZITE [open]/:not([open])-Werte statt `revert`/`revert-layer`: robuster/direkter,
344
- keine Kaskaden-Auflösung über Layer-Grenzen und das UA-Stylesheet zur Laufzeit nötig. */
345
- .ncss-nav-panel:not([open]) {
346
- display: none;
347
- }
348
- .ncss-nav-panel[open] {
349
- display: block;
350
- }
351
- /* .ncss-offcanvas (off-canvas.css) animiert "display"/"overlay" selbst per
352
- allow-discrete (fürs sanfte Ausblenden beim Schließen, siehe dortiger Kommentar).
353
- Für .ncss-nav-panel hier bewusst OHNE die beiden - display:contents (Desktop-Regel
354
- oben) verträgt sich nicht mit einer späteren allow-discrete-Transition auf "display"
355
- (siehe dortiger Kommentar für die vollständige Ursachenanalyse: display bleibt sonst
356
- dauerhaft auf "contents" hängen, sobald der Mobile-Breakpoint erreicht wird - genau
357
- der gemeldete Nav-Flash-Bug). translate/opacity bleiben animiert (sanftes Einschieben
358
- beim Öffnen), das Schließen verschwindet dafür sofort statt auszublenden - der
359
- sichere Kompromiss ohne das Hängenbleiben. */
360
- .ncss-nav-panel {
361
- transition:
362
- translate var(--ncss-motion-duration-slow) var(--ncss-motion-easing),
363
- opacity var(--ncss-motion-duration) var(--ncss-motion-easing);
364
- }
365
- .ncss-nav-panel .ncss-dialog-close {
366
- display: block;
367
- }
368
- .ncss-nav-list {
369
- flex-direction: column;
370
- align-items: stretch;
371
- gap: var(--ncss-space-2xs);
372
- margin-block-start: var(--ncss-space-lg);
373
- }
374
- .ncss-nav > .ncss-nav-panel .ncss-nav-dropdown > .ncss-nav-submenu {
375
- position: static;
376
- box-shadow: none;
377
- border: none;
378
- background: none;
379
- padding-inline-start: var(--ncss-space-md);
380
- }
381
-
382
- /* Trenner zwischen den festen Hauptbereichen (Handbuch/Demo) und den seitenspezifischen
383
- Punkten (siehe helpers/layout.css' .ncss-divider--vertical, hier per Markup als
384
- <li><hr class="ncss-divider--vertical" ...></li> eingesetzt) - dessen Grundform
385
- (border-inline-start) ist für eine FLEX-ZEILE gedacht. Sobald .ncss-nav-list oben auf
386
- flex-direction:column umschaltet (schmaler Viewport, off-canvas-Panel), würde
387
- dieselbe vertikale Linie nur noch als kaum sichtbarer, seitlich hängender Strich
388
- zwischen zwei gestapelten Zeilen wirken - hier deshalb auf eine normale HORIZONTALE
389
- Trennlinie zurückgesetzt, passend zur gestapelten Liste. Dieselbe currentColor-
390
- Begründung wie bei der Desktop-Variante weiter oben in dieser Datei (Größen-/
391
- Farblogik-Kommentar bei `.ncss-nav-item > .ncss-divider--vertical`) gilt hier
392
- unverändert mit. */
393
- .ncss-nav-list .ncss-divider--vertical {
394
- align-self: stretch;
395
- width: auto;
396
- height: 0;
397
- border-inline-start: none;
398
- border-block-start: var(--ncss-border-width) solid
399
- color-mix(in oklch, currentColor 30%, transparent);
400
- margin-inline: 0;
401
- margin-block: var(--ncss-space-3xs);
402
- }
403
- }
404
-
405
336
  /* --- Variante: Mega-Menü -----------------------------------------------------------------
406
337
  Dieselbe <details>/<summary>-Mechanik wie ein normales Dropdown oben - nur der Inhalt ist
407
338
  ein mehrspaltiges Grid statt einer einzelnen Liste. .ncss-nav-submenu bleibt die äußere
@@ -445,9 +376,75 @@
445
376
  color: var(--ncss-color-text-muted);
446
377
  margin-block-end: var(--ncss-space-2xs);
447
378
  }
448
- /* -- ncss breakpoint: md (768px) -- */
449
- @media (max-width: 63.99rem) {
450
- .ncss-nav > .ncss-nav-panel .ncss-nav-submenu--mega {
379
+ /* --- Kompakt-Modus: Menü-Button + Off-Canvas statt Zeile --------------------------------
380
+ Drei Wege in denselben Zustand, die Regeln stehen deshalb zweimal (identisch halten):
381
+
382
+ 1. Automatisch (Standard, js/nav.js): das Skript misst per ResizeObserver, ob die
383
+ Liste wirklich in EINE Zeile neben Marke/Aktionen passt, und setzt
384
+ data-ncss-nav-auto="inline" bzw. "compact" an .ncss-nav - unabhängig von der
385
+ Viewport-Breite (eine kurze Nav bleibt auch am Handy in der Zeile, eine lange
386
+ klappt auch am Desktop zusammen). Die Liste bricht dabei nie in eine zweite Zeile um.
387
+ 2. Fest: .ncss-nav--compact - immer Menü-Button, bei jeder Breite.
388
+ 3. Ohne JavaScript bzw. mit data-ncss-nav-auto="off": die feste Media Query
389
+ nav-collapse (64rem, siehe tokens.css) wie bisher.
390
+
391
+ .ncss-nav--tree ist ausgenommen (immer vertikal, kein Panel - früher bekam ihre Liste
392
+ unter 64rem fälschlich den Panel-Abstand oben).
393
+ Alle Bereichs-Selektoren in :where() - die Spezifität der einzelnen Regeln bleibt
394
+ dadurch dieselbe wie ohne Bereich, Varianten wie .ncss-nav--scroll oder
395
+ <ncss-nav-priority> setzen sich weiterhin per eigener Regel durch. */
396
+ :where(.ncss-nav--compact, .ncss-nav[data-ncss-nav-auto="compact"]) {
397
+ & .ncss-nav-toggle {
398
+ display: inline-flex;
399
+ }
400
+ /* display:contents zurücknehmen - jetzt greift die native <dialog>-Logik normal
401
+ (position:fixed, Slide-in-Animation, Backdrop aus components/off-canvas.css).
402
+ EXPLIZITE [open]/:not([open])-Werte statt `revert`/`revert-layer`: robuster/direkter,
403
+ keine Kaskaden-Auflösung über Layer-Grenzen und das UA-Stylesheet zur Laufzeit nötig. */
404
+ & .ncss-nav-panel:not([open]) {
405
+ display: none;
406
+ }
407
+ & .ncss-nav-panel[open] {
408
+ display: block;
409
+ }
410
+ /* OHNE "display"/"overlay" in der Transition - siehe Kommentar an .ncss-nav-panel oben
411
+ (display:contents verträgt keine spätere allow-discrete-Transition auf display). */
412
+ & .ncss-nav-panel {
413
+ transition:
414
+ translate var(--ncss-motion-duration-slow) var(--ncss-motion-easing),
415
+ opacity var(--ncss-motion-duration) var(--ncss-motion-easing);
416
+ }
417
+ & .ncss-nav-panel .ncss-dialog-close {
418
+ display: block;
419
+ }
420
+ & .ncss-nav-list {
421
+ flex-direction: column;
422
+ align-items: stretch;
423
+ gap: var(--ncss-space-2xs);
424
+ margin-block-start: var(--ncss-space-lg);
425
+ }
426
+ &.ncss-nav > .ncss-nav-panel .ncss-nav-dropdown > .ncss-nav-submenu {
427
+ position: static;
428
+ box-shadow: none;
429
+ border: none;
430
+ background: none;
431
+ padding-inline-start: var(--ncss-space-md);
432
+ }
433
+ /* Trenner (<li><hr class="ncss-divider--vertical"></li>) in der gestapelten Liste als
434
+ HORIZONTALE Linie - die vertikale Grundform ist für eine Flex-Zeile gedacht.
435
+ currentColor-Begründung wie bei `.ncss-nav-item > .ncss-divider--vertical` oben. */
436
+ & .ncss-nav-list .ncss-divider--vertical {
437
+ align-self: stretch;
438
+ width: auto;
439
+ height: 0;
440
+ border-inline-start: none;
441
+ border-block-start: var(--ncss-border-width) solid
442
+ color-mix(in oklch, currentColor 30%, transparent);
443
+ margin-inline: 0;
444
+ margin-block: var(--ncss-space-3xs);
445
+ }
446
+ /* Mega-Menü gestapelt statt mehrspaltig. */
447
+ &.ncss-nav > .ncss-nav-panel .ncss-nav-submenu--mega {
451
448
  display: flex;
452
449
  flex-direction: column;
453
450
  gap: var(--ncss-space-sm);
@@ -458,6 +455,81 @@
458
455
  }
459
456
  }
460
457
 
458
+ /* -- ncss breakpoint: nav-collapse (64rem) - nur ohne JS-Messung (siehe oben) -- */
459
+ @media (max-width: 63.99rem) {
460
+ :where(.ncss-nav:not(.ncss-nav--tree, [data-ncss-nav-auto="inline"])) {
461
+ & .ncss-nav-toggle {
462
+ display: inline-flex;
463
+ }
464
+ /* display:contents zurücknehmen - jetzt greift die native <dialog>-Logik normal
465
+ (position:fixed, Slide-in-Animation, Backdrop aus components/off-canvas.css).
466
+ EXPLIZITE [open]/:not([open])-Werte statt `revert`/`revert-layer`: robuster/direkter,
467
+ keine Kaskaden-Auflösung über Layer-Grenzen und das UA-Stylesheet zur Laufzeit nötig. */
468
+ & .ncss-nav-panel:not([open]) {
469
+ display: none;
470
+ }
471
+ & .ncss-nav-panel[open] {
472
+ display: block;
473
+ }
474
+ /* OHNE "display"/"overlay" in der Transition - siehe Kommentar an .ncss-nav-panel oben
475
+ (display:contents verträgt keine spätere allow-discrete-Transition auf display). */
476
+ & .ncss-nav-panel {
477
+ transition:
478
+ translate var(--ncss-motion-duration-slow) var(--ncss-motion-easing),
479
+ opacity var(--ncss-motion-duration) var(--ncss-motion-easing);
480
+ }
481
+ & .ncss-nav-panel .ncss-dialog-close {
482
+ display: block;
483
+ }
484
+ & .ncss-nav-list {
485
+ flex-direction: column;
486
+ align-items: stretch;
487
+ gap: var(--ncss-space-2xs);
488
+ margin-block-start: var(--ncss-space-lg);
489
+ }
490
+ &.ncss-nav > .ncss-nav-panel .ncss-nav-dropdown > .ncss-nav-submenu {
491
+ position: static;
492
+ box-shadow: none;
493
+ border: none;
494
+ background: none;
495
+ padding-inline-start: var(--ncss-space-md);
496
+ }
497
+ /* Trenner (<li><hr class="ncss-divider--vertical"></li>) in der gestapelten Liste als
498
+ HORIZONTALE Linie - die vertikale Grundform ist für eine Flex-Zeile gedacht.
499
+ currentColor-Begründung wie bei `.ncss-nav-item > .ncss-divider--vertical` oben. */
500
+ & .ncss-nav-list .ncss-divider--vertical {
501
+ align-self: stretch;
502
+ width: auto;
503
+ height: 0;
504
+ border-inline-start: none;
505
+ border-block-start: var(--ncss-border-width) solid
506
+ color-mix(in oklch, currentColor 30%, transparent);
507
+ margin-inline: 0;
508
+ margin-block: var(--ncss-space-3xs);
509
+ }
510
+ /* Mega-Menü gestapelt statt mehrspaltig. */
511
+ &.ncss-nav > .ncss-nav-panel .ncss-nav-submenu--mega {
512
+ display: flex;
513
+ flex-direction: column;
514
+ gap: var(--ncss-space-sm);
515
+ width: auto;
516
+ min-width: 0;
517
+ max-width: none;
518
+ padding: 0;
519
+ }
520
+ }
521
+ }
522
+
523
+ /* Automatik aktiv und Liste passt: nie umbrechen - weder die Liste noch ein Punkt in
524
+ sich ("Über" / "uns"). Passt sie nicht mehr, schaltet js/nav.js auf "compact". */
525
+ :where(.ncss-nav[data-ncss-nav-auto="inline"]) > .ncss-nav-panel > .ncss-nav-list {
526
+ flex-wrap: nowrap;
527
+ }
528
+ :where(.ncss-nav[data-ncss-nav-auto="inline"]) > .ncss-nav-panel > .ncss-nav-list > .ncss-nav-item > a,
529
+ :where(.ncss-nav[data-ncss-nav-auto="inline"]) > .ncss-nav-panel > .ncss-nav-list > .ncss-nav-item > .ncss-nav-dropdown > summary {
530
+ white-space: nowrap;
531
+ }
532
+
461
533
  /* --- Variante: vertikale Tree-Navigation (z.B. Docs-Sidebar) ---------------------------
462
534
  Kein Kollabieren nötig (schon vertikal/schmal-freundlich), beliebig tief verschachtelbar
463
535
  - einfach .ncss-nav-dropdown/.ncss-nav-submenu ineinander verschachteln.
@@ -104,14 +104,32 @@
104
104
  /* -- ncss container-query: float-wrap (28rem) -- */
105
105
  @container ncss-container (min-width: 28rem) {
106
106
  /* Ab hier übernimmt (bei .ncss-float-start/-end) wieder der Float die Breite/
107
- Ausrichtung - die beiden Modifier oben gelten bewusst nur unterhalb der Schwelle.
108
- Gefloatete Elemente bleiben ausgenommen: dieselbe Spezifität, aber später in der Datei -
109
- das Zurücksetzen löschte sonst den Abstand zum Text (margin-inline-end/-start oben). */
110
- .ncss-center-narrow:not(.ncss-float-start, .ncss-float-end, .ncss-float-bleed-start, .ncss-float-bleed-end) {
107
+ Ausrichtung - die beiden Modifier oben gelten bewusst nur unterhalb der Schwelle. */
108
+ .ncss-center-narrow {
111
109
  margin-inline: 0;
112
110
  }
113
111
  .ncss-full-narrow {
114
112
  width: auto;
115
113
  max-width: var(--ncss-float-max-width);
116
114
  }
115
+ /* Zusammen mit einem Float: .ncss-center-narrow (margin-inline:auto bzw. 0) und
116
+ .ncss-full-narrow (width) stehen weiter unten in der Datei als die Float-Regeln und
117
+ würden deren Abstand zum Text bzw. die Bleed-Breite überschreiben (Bild klebte ohne
118
+ Abstand am Text) - ab der Schwelle gelten deshalb wieder die Float-Werte. */
119
+ .ncss-center-narrow:is(.ncss-float-start, .ncss-float-bleed-start) {
120
+ margin-inline-end: var(--ncss-space-md);
121
+ }
122
+ .ncss-center-narrow:is(.ncss-float-end, .ncss-float-bleed-end) {
123
+ margin-inline-start: var(--ncss-space-md);
124
+ }
125
+ .ncss-center-narrow.ncss-float-bleed-start {
126
+ margin-inline-start: calc(50% - 50vw);
127
+ }
128
+ .ncss-center-narrow.ncss-float-bleed-end {
129
+ margin-inline-end: calc(50% - 50vw);
130
+ }
131
+ .ncss-full-narrow:is(.ncss-float-bleed-start, .ncss-float-bleed-end) {
132
+ width: var(--ncss-float-max-width);
133
+ max-width: none;
134
+ }
117
135
  }
package/dist/js/nav.js CHANGED
@@ -1,10 +1,25 @@
1
1
  /**
2
2
  * ncss - Nav: kleines Enhancement, kein Ersatz für die native Funktionalität (Menü
3
3
  * öffnen/schließen funktioniert auch ohne dieses Script vollständig über command/
4
- * commandfor bzw. <details>). Schließt nur zwei Dinge, für die es keinen reinen CSS-Weg
5
- * gibt: das offene Dropdown nach Klick auf einen Untermenü-Link (natives <details> bleibt
6
- * sonst offen stehen), und das mobile Off-Canvas-Panel nach Klick auf IRGENDEINen Nav-
7
- * Link (sonst bleibt das Menü nach der Navigation sichtbar offen).
4
+ * commandfor bzw. <details>, die Umschaltung dann per Media Query bei 64rem).
5
+ *
6
+ * 1. Automatischer Kompakt-Modus (Standard für jede .ncss-nav mit Menü-Button und
7
+ * Panel): misst per ResizeObserver, ob die Liste in EINE Zeile neben Marke/Aktionen
8
+ * passt, und setzt data-ncss-nav-auto="inline" bzw. "compact" (Regeln siehe
9
+ * components/nav.css). Kein fester Breakpoint. Hysterese: nach dem Zusammenklappen
10
+ * wird erst wieder probiert, wenn der Platz um mehr als 24px gewachsen ist - der
11
+ * Test selbst läuft synchron vor dem nächsten Bild, es flackert nichts.
12
+ * Ausnahmen: data-ncss-nav-auto="off" (bleibt bei der Media Query), .ncss-nav--compact
13
+ * (immer kompakt), Navs mit <ncss-nav-priority>/<ncss-nav-drilldown> (eigene Logik).
14
+ * Event bei jedem Wechsel: "ncss-nav-change" mit detail.compact (true/false).
15
+ * Barrierefreiheit: aria-controls/aria-expanded an der Menü-Schaltfläche; beim
16
+ * Wechsel in den Kompakt-Modus wandert ein Fokus aus der Liste auf die Schaltfläche,
17
+ * beim Zurückwechseln schließt ein offenes Panel und der Fokus bleibt in der Liste.
18
+ * Reagiert auch auf Schriftgröße/Textabstände (beobachtet den Inhalt, nicht nur die
19
+ * Fensterbreite). Für einen Anfangszustand ohne Springen im <head> mit defer laden.
20
+ * 2. Schließt das offene Dropdown nach Klick auf einen Untermenü-Link (natives <details>
21
+ * bleibt sonst offen stehen) und das Off-Canvas-Panel nach Klick auf IRGENDEINen
22
+ * Nav-Link (sonst bleibt das Menü nach der Navigation sichtbar offen).
8
23
  */
9
24
  (function () {
10
25
  "use strict";
@@ -25,4 +40,213 @@
25
40
  panel.close();
26
41
  }
27
42
  });
43
+
44
+ var HYSTERESIS = 24;
45
+
46
+ /* Passt die Zeile? Drei Symptome: Liste läuft in sich über (nowrap), die Nav ragt aus
47
+ ihrer Zeile, oder die Zeile (z.B. .ncss-topbar-inner mit flex-wrap) hat die Nav bzw.
48
+ ein Geschwister in eine zweite Reihe geschoben. */
49
+ function fits(nav, list) {
50
+ var row = nav.parentElement;
51
+ if (list.scrollWidth > list.clientWidth + 1 || nav.scrollWidth > nav.clientWidth + 1) {
52
+ return false;
53
+ }
54
+ /* scrollWidth erfasst nur Überlauf zum Zeilenende - bei justify-content:flex-end/center
55
+ (oder RTL) ragen die Punkte zum Anfang hinaus, über die Marke. Deshalb zusätzlich die
56
+ äußeren Kanten der Punkte gegen die Liste prüfen. */
57
+ var lb = list.getBoundingClientRect();
58
+ for (var j = 0; j < list.children.length; j++) {
59
+ var ib = list.children[j].getBoundingClientRect();
60
+ if (ib.width && (ib.left < lb.left - 1 || ib.right > lb.right + 1)) {
61
+ return false;
62
+ }
63
+ }
64
+ if (row.scrollWidth > row.clientWidth + 1) {
65
+ return false;
66
+ }
67
+ var box = nav.getBoundingClientRect();
68
+ for (var i = 0; i < row.children.length; i++) {
69
+ var el = row.children[i];
70
+ if (el === nav) {
71
+ continue;
72
+ }
73
+ var r = el.getBoundingClientRect();
74
+ if (r.width === 0 && r.height === 0) {
75
+ continue;
76
+ }
77
+ if (r.top >= box.bottom - 1 || r.bottom <= box.top + 1) {
78
+ return false;
79
+ }
80
+ }
81
+ return true;
82
+ }
83
+
84
+ /* Menü-Schaltfläche: Zustand für Screenreader (command/commandfor allein meldet bei
85
+ show-modal keinen aufgeklappt/zugeklappt-Zustand) - für JEDE .ncss-nav mit Panel,
86
+ auch mit data-ncss-nav-auto="off". */
87
+ function wireToggle(nav) {
88
+ var toggle = nav.querySelector(":scope > .ncss-nav-toggle");
89
+ var panel = nav.querySelector(":scope > .ncss-nav-panel");
90
+ if (!toggle || !panel || typeof panel.close !== "function") {
91
+ return;
92
+ }
93
+ if (panel.id) {
94
+ toggle.setAttribute("aria-controls", panel.id);
95
+ }
96
+ function syncExpanded() {
97
+ toggle.setAttribute("aria-expanded", panel.open ? "true" : "false");
98
+ }
99
+ syncExpanded();
100
+ panel.addEventListener("toggle", syncExpanded);
101
+ panel.addEventListener("close", syncExpanded);
102
+ }
103
+
104
+ function setup(nav) {
105
+ var toggle = nav.querySelector(":scope > .ncss-nav-toggle");
106
+ var panel = nav.querySelector(":scope > .ncss-nav-panel");
107
+ var list = panel && panel.querySelector(":scope > .ncss-nav-list");
108
+ var row = nav.parentElement;
109
+ if (!list || !toggle || !row) {
110
+ return;
111
+ }
112
+ var failedAt = 0;
113
+ var listWidth = 0;
114
+
115
+ function set(compact) {
116
+ var value = compact ? "compact" : "inline";
117
+ if (nav.getAttribute("data-ncss-nav-auto") === value) {
118
+ return;
119
+ }
120
+ nav.setAttribute("data-ncss-nav-auto", value);
121
+ nav.dispatchEvent(new CustomEvent("ncss-nav-change", { bubbles: true, detail: { compact: compact } }));
122
+ }
123
+
124
+ function rowSpace() {
125
+ var cs = getComputedStyle(row);
126
+ return row.clientWidth - (parseFloat(cs.paddingInlineStart) || 0) - (parseFloat(cs.paddingInlineEnd) || 0);
127
+ }
128
+ function needed() {
129
+ var gap = parseFloat(getComputedStyle(row).columnGap) || 0;
130
+ var sum = listWidth;
131
+ var n = 1;
132
+ Array.prototype.forEach.call(row.children, function (el) {
133
+ var r = el.getBoundingClientRect();
134
+ if (el !== nav && (r.width || r.height)) {
135
+ sum += r.width;
136
+ n++;
137
+ }
138
+ });
139
+ return sum + gap * (n - 1);
140
+ }
141
+
142
+ function check() {
143
+ var width = row.clientWidth;
144
+ var focused = document.activeElement;
145
+ if (nav.getAttribute("data-ncss-nav-auto") === "compact") {
146
+ if (width <= failedAt + HYSTERESIS) {
147
+ return;
148
+ }
149
+ /* Offenes Panel liegt im Top Layer, die Liste lässt sich darin nicht als Zeile
150
+ messen - dann schätzen: zuletzt gemessene Listenbreite + Marke/Aktionen jetzt. */
151
+ var wasOpen = panel.open;
152
+ if (wasOpen && !(listWidth && rowSpace() >= needed())) {
153
+ return;
154
+ }
155
+ var inPanel = wasOpen && list.contains(focused);
156
+ if (wasOpen) {
157
+ panel.close();
158
+ }
159
+ nav.setAttribute("data-ncss-nav-auto", "inline");
160
+ var ok = fits(nav, list);
161
+ nav.setAttribute("data-ncss-nav-auto", "compact");
162
+ if (!ok) {
163
+ failedAt = width;
164
+ if (wasOpen) {
165
+ toggle.focus();
166
+ }
167
+ return;
168
+ }
169
+ /* Zurück in die Zeile: das Panel ist zu. Lag der Fokus darin, bleibt er auf
170
+ demselben Link (der jetzt in der Zeile steht), sonst auf dem ersten Punkt -
171
+ nie auf der gleich unsichtbaren Menü-Schaltfläche. */
172
+ listWidth = list.scrollWidth;
173
+ set(false);
174
+ if (wasOpen) {
175
+ var target = inPanel ? focused : list.querySelector("a[href], summary, button");
176
+ if (target) {
177
+ target.focus();
178
+ }
179
+ }
180
+ return;
181
+ }
182
+ listWidth = list.scrollWidth;
183
+ if (fits(nav, list)) {
184
+ return;
185
+ }
186
+ failedAt = width;
187
+ nav.querySelectorAll(".ncss-nav-dropdown[open]").forEach(function (d) {
188
+ d.open = false;
189
+ });
190
+ set(true);
191
+ /* Fokus lag in der Liste, die jetzt im geschlossenen Panel verschwindet. */
192
+ if (focused && list.contains(focused)) {
193
+ toggle.focus();
194
+ }
195
+ }
196
+
197
+ /* Beobachtet die Zeile (Fensterbreite) UND ihren Inhalt - Marke, Aktionen und die
198
+ Nav-Punkte selbst: größere Schrift, Textabstände (WCAG 1.4.12) oder nachgeladene
199
+ Schriften ändern deren Größe auch bei gleicher Fensterbreite. Ändert sich der
200
+ Inhalt, gilt die Hysterese nicht (sofort neu prüfen). */
201
+ var ro = new ResizeObserver(function (entries) {
202
+ var compact = nav.getAttribute("data-ncss-nav-auto") === "compact";
203
+ for (var i = 0; i < entries.length; i++) {
204
+ var t = entries[i].target;
205
+ /* Punkte im (geschlossenen oder offenen) Panel sagen nichts über die Zeile. */
206
+ if (t !== row && !(compact && t.parentElement === list)) {
207
+ failedAt = 0;
208
+ break;
209
+ }
210
+ }
211
+ check();
212
+ });
213
+ nav.setAttribute("data-ncss-nav-auto", "inline");
214
+ check();
215
+ ro.observe(row);
216
+ Array.prototype.forEach.call(row.children, function (el) {
217
+ if (el !== nav) {
218
+ ro.observe(el);
219
+ }
220
+ });
221
+ Array.prototype.forEach.call(list.children, function (el) {
222
+ ro.observe(el);
223
+ });
224
+ if (document.fonts && document.fonts.ready) {
225
+ document.fonts.ready.then(function () {
226
+ failedAt = 0;
227
+ check();
228
+ });
229
+ }
230
+ }
231
+
232
+ function init() {
233
+ document.querySelectorAll(".ncss-nav").forEach(function (nav) {
234
+ wireToggle(nav);
235
+ if (
236
+ typeof ResizeObserver === "undefined" ||
237
+ nav.hasAttribute("data-ncss-nav-auto") ||
238
+ nav.classList.contains("ncss-nav--compact") ||
239
+ nav.querySelector("ncss-nav-priority, ncss-nav-drilldown")
240
+ ) {
241
+ return;
242
+ }
243
+ setup(nav);
244
+ });
245
+ }
246
+
247
+ if (document.readyState === "loading") {
248
+ document.addEventListener("DOMContentLoaded", init);
249
+ } else {
250
+ init();
251
+ }
28
252
  })();
package/dist/tokens.css CHANGED
@@ -226,7 +226,7 @@
226
226
  * card-horizontal: 24rem - .ncss-card--horizontal (components/card.css)
227
227
  * card-row: 32rem - .ncss-grid--card-row (helpers/layout.css)
228
228
  * table-stacked: 36rem - .ncss-table-stacked (helpers/tables.css)
229
- * nav-collapse: 64rem - .ncss-nav (components/nav.css)
229
+ * nav-collapse: 64rem - .ncss-nav ohne JS bzw. mit data-ncss-nav-auto="off" (components/nav.css)
230
230
  * float-wrap: 28rem - .ncss-float-start/-end (helpers/float.css)
231
231
  * drop-cap-large: 40rem - .ncss-drop-cap (helpers/typography.css)
232
232
  * grid-cols-2: 24rem - .ncss-grid--cols-2 (helpers/layout.css)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@skerbis/nativecss",
3
- "version": "1.1.0",
3
+ "version": "1.2.1",
4
4
  "description": "Natives CSS-Designsystem ohne Build-Schritt: Cascade Layers, Container Queries, light-dark(), native Elemente und Light-DOM-Web-Components. Einzeln einbindbar.",
5
5
  "keywords": [
6
6
  "css",