@xihan-ui/styles 1.0.0 → 2.0.0

package/css/message-feed.css

@@ -0,0 +1,197 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 message feed 样式。 */
+
+/* 独立皮肤同时传递引入回底钮的动作控件配方，full bundle 递归去重。 */
+@import '../family/action-control.css';
+
+@layer xihan.motion {
+  /* 关键帧写在本文件里：动画名的查找只认「文档里有没有这个名字」，
+     引用别处文件里的名字时那份文件不一定在场，动画会静默地整个不跑。
+     幅度与缩放走令牌，减弱动效时由令牌层归零 */
+  @keyframes xh-message-feed-item-in {
+    from {
+      opacity: 0;
+      translate: 0 var(--xh-motion-distance-md);
+    }
+
+    to {
+      opacity: 1;
+      translate: 0 0;
+    }
+  }
+
+  @keyframes xh-message-feed-button-in {
+    from {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
+    }
+
+    to {
+      opacity: 1;
+      scale: 1;
+    }
+  }
+}
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='message-feed'] {
+    --xh-message-feed-skin: 1;
+  }
+
+  /* 根是定位基准：回到底部按钮贴在它的右下角。高度由使用者的版面给，这里不定高 */
+  [data-scope='message-feed'][data-part='root'] {
+    /* 尺寸缺省档：不写 data-size 时的取值。三档都只写这两个私有槽，
+       公开槽留在读处当首选，作者在祖先上设的覆盖才赢得过档位声明 */
+    --xh-_message-feed-gap: var(--xh-space-4);
+    --xh-_message-feed-p: var(--xh-space-4);
+
+    position: relative;
+    display: flex;
+    min-block-size: 0;
+    flex-direction: column;
+  }
+
+  [data-scope='message-feed'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* 滚动容器：粘底视口，走 reset 层的原生细条。overscroll-behavior 挡住滚到头之后把整页一起带走 */
+  [data-scope='message-feed'][data-part='viewport'] {
+    overflow-y: auto;
+    flex: 1 1 auto;
+    min-block-size: 0;
+    overscroll-behavior: contain;
+  }
+
+  /* 流式视口的内容高度一直在变，还在用原生滚动条的视口留一条空道，滚动条出现与消失时不推动文字（§6.6）。
+     带 data-xh-scrollbar 的容器已经把原生条藏成零宽，这条空道对它没有布局作用，排除掉 */
+  [data-scope='message-feed'][data-part='viewport']:not([data-xh-scrollbar]) {
+    scrollbar-gutter: stable;
+  }
+
+  [data-scope='message-feed'][data-part='list'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-message-feed-gap, var(--xh-_message-feed-gap));
+    padding: var(--xh-message-feed-p, var(--xh-_message-feed-p));
+  }
+
+  [data-scope='message-feed'][data-part='list'][hidden] {
+    display: none;
+  }
+
+  /* 一条消息。默认整行铺开，左右分侧由使用者按 data-role 自己写。
+     进场只动 opacity 与 translate：改高度会扰动粘底补偿量到的 scrollHeight */
+  [data-scope='message-feed'][data-part='item'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-message-feed-item-gap, var(--xh-space-1));
+    border-radius: var(--xh-message-feed-item-radius, var(--xh-shape-surface));
+    animation: xh-message-feed-item-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  [data-scope='message-feed'][data-part='item'][hidden] {
+    display: none;
+  }
+
+  [data-scope='message-feed'][data-part='item-label'] {
+    display: block;
+    color: var(--xh-message-feed-label-fg, var(--xh-fg-muted));
+    font-size: var(--xh-message-feed-label-font-size, var(--xh-text-caption-size));
+    line-height: var(--xh-leading-tight);
+  }
+
+  [data-scope='message-feed'][data-part='item-label'][hidden] {
+    display: none;
+  }
+
+  /* 回到底部：浮在滚动区右下角，收起时不卸载只隐藏。盒型、悬停 / 按下面与缩放由 Action Control 的
+     floating 档给（circle 正方盒、ghost 形态：白底承载 hover 100 → pressed 200）；材质随角落浮钮族走
+     frosted 四件套（底 + 边 + 影 + 磨砂，§8），这里只把使用者槽映射到桥接槽：
+     字形按 xs 档取 --xh-_action-profile-glyph-size（16px），与 log / back-top 同一把尺 */
+  [data-scope='message-feed'][data-part='scroll-to-end-trigger'] {
+    --xh-_message-feed-scroll-to-end-trigger-shadow: var(--xh-message-feed-scroll-to-end-trigger-shadow, var(--xh-material-frosted-shadow));
+    --xh-action-visual-size: var(--xh-message-feed-scroll-to-end-trigger-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-message-feed-scroll-to-end-trigger-radius, var(--xh-shape-circle));
+    --xh-action-bg-rest: var(--xh-message-feed-scroll-to-end-trigger-bg, var(--xh-material-frosted-bg));
+    --xh-action-bg-hover: var(--xh-message-feed-scroll-to-end-trigger-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-border-rest: var(--xh-message-feed-scroll-to-end-trigger-border, var(--xh-material-frosted-border));
+    --xh-action-border-hover: var(--xh-message-feed-scroll-to-end-trigger-border, var(--xh-material-frosted-border));
+    --xh-action-border-pressed: var(--xh-message-feed-scroll-to-end-trigger-border, var(--xh-material-frosted-border));
+    --xh-action-border-focus-visible: var(--xh-message-feed-scroll-to-end-trigger-border, var(--xh-material-frosted-border));
+    --xh-action-shadow-rest: var(--xh-_message-feed-scroll-to-end-trigger-shadow);
+    --xh-action-shadow-hover: var(--xh-_message-feed-scroll-to-end-trigger-shadow);
+    --xh-action-shadow-pressed: var(--xh-_message-feed-scroll-to-end-trigger-shadow);
+    --xh-action-fg-rest: var(--xh-message-feed-scroll-to-end-trigger-fg, var(--xh-material-frosted-fg));
+    --xh-icon-size: var(--xh-message-feed-icon-size, var(--xh-_action-profile-glyph-size));
+
+    position: absolute;
+    inset-block-end: var(--xh-message-feed-scroll-to-end-trigger-inset, var(--xh-space-4));
+    inset-inline-end: var(--xh-message-feed-scroll-to-end-trigger-inset, var(--xh-space-4));
+    -webkit-backdrop-filter: var(--xh-material-frosted-backdrop);
+    backdrop-filter: var(--xh-material-frosted-backdrop);
+  }
+
+  /* 连接层收起按钮时写 hidden 属性，家族那条 display 会盖掉 UA 规则，这里补回 */
+  [data-scope='message-feed'][data-part='scroll-to-end-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 收起不卸载，冒出来时靠这条进场动画；不写 display，可见性归上面那条 [hidden] 管 */
+  [data-scope='message-feed'][data-part='scroll-to-end-trigger'][data-state='visible'] {
+    animation: xh-message-feed-button-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 没写内容就由皮肤画一枚向下的字形；作者往按钮里塞了自己的图形，这条规则即不命中 */
+  [data-scope='message-feed'][data-part='scroll-to-end-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+  }
+
+  /* 尺寸档只改消息之间的距离与内边距；宽松档把消息之间再放开一级，内边距不跟 */
+  [data-scope='message-feed'][data-part='root'][data-size='sm'] {
+    --xh-_message-feed-gap: var(--xh-space-2);
+    --xh-_message-feed-p: var(--xh-space-2);
+  }
+
+  [data-scope='message-feed'][data-part='root'][data-size='md'] {
+    --xh-_message-feed-gap: var(--xh-space-4);
+    --xh-_message-feed-p: var(--xh-space-4);
+  }
+
+  [data-scope='message-feed'][data-part='root'][data-size='lg'] {
+    --xh-_message-feed-gap: var(--xh-space-8);
+    --xh-_message-feed-p: var(--xh-space-6);
+  }
+
+  /* 视觉隐藏的原子播报区：不能 display:none，那样读屏就取不到它了 */
+  [data-scope='message-feed'][data-part='live-region'] {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    margin: -1px;
+    border: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+
+  @media print {
+    /* 打印：回到底部这颗钮只有在能滚的地方才成立，落到纸上是一颗按不动的按钮。 */
+    [data-scope='message-feed'][data-part='scroll-to-end-trigger'] {
+      display: none;
+    }
+  }
+}

package/css/navigation-menu.css

@@ -1,29 +1,14 @@
-@layer xihan.motion {
-  /* 面板往下探一小截再落位：纯淡入看不出它是从哪条 trigger 长出来的 */
-  @keyframes xh-pop-in {
-    from {
-      opacity: 0;
-      scale: var(--xh-motion-scale-enter);
-    }
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
 
-    to {
-      opacity: 1;
-      scale: 1;
-    }
-  }
+/* 定义 navigation menu 样式。 */
 
-  @keyframes xh-pop-out {
-    from {
-      opacity: 1;
-      scale: 1;
-    }
-
-    to {
-      opacity: 0;
-      scale: var(--xh-motion-scale-enter);
-    }
-  }
-}
+/* 共享关键帧由 family/motion.css 提供，入口与面板里的链接都走 Collection Item 家族的 nav 语境；本皮肤 @import 它们，单独引入仍成立。
+   2px 指示线由本皮肤画两种：list 上的滑动 indicator 部件指的是「哪张面板开着」，指向当前页面的链接自画一条静态线 */
+@import '../family/collection-item.css';
+@import '../family/motion.css';
 
 @layer xihan.components {
   /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
@@ -36,7 +21,11 @@
   [data-scope='navigation-menu'][data-part='root'] {
     /* 尺寸档只换这五个私有槽，trigger 与面板里的链接都从 root 继承它们，
        换档不必给每个部件各写一条选择器。面板与共享外壳都是 root 的后代，一并继承。
-       trigger 写的是 font: inherit，字号跟着 root 这一档走，不另立槽 */
+       trigger 的字号经家族桥接槽接回 root 这一档，不另立私有槽 */
+    /* 入口里的方向标记按档取尺，缺省 md，随 data-size 换档；面板里链接内的字形由家族随
+       data-xh-collection-size 下发（§6.5） */
+    --xh-icon-size: var(--xh-navigation-menu-icon-size, var(--xh-glyph-size-md));
+
     --xh-_navigation-menu-font-size: var(--xh-control-font-md);
     --xh-_navigation-menu-trigger-h: var(--xh-control-h-md);
     --xh-_navigation-menu-trigger-px: var(--xh-control-px-md);
@@ -45,14 +34,11 @@
     --xh-_navigation-menu-link-px: var(--xh-control-px-md);
     --xh-_navigation-menu-link-font-size: var(--xh-control-font-md);
 
-    /* 悬停与键盘锚点恒中性灰轻档、不接语气槽——两档同色相的话打开路径就认不出来了 */
+    /* 悬停、键盘锚点与展开着的入口同走中性灰轻档、不接语气槽：打开中不是选中，不用品牌色（§7.3） */
     --xh-_navigation-menu-highlight-bg: var(--xh-bg-subtle);
 
-    /* 语气落在三处：展开着的 trigger 的底色、当前链接的文字色、指示条。
-       没写 data-tone 时这几个 --xh-_tone-* 都没被声明，各自退回品牌色。
-       聚焦环不在其列，它恒是 --xh-ring-focus */
-    --xh-_navigation-menu-active-bg: var(--xh-_tone-subtle, var(--xh-bg-brand-subtle));
-    --xh-_navigation-menu-current-fg: var(--xh-_tone-fg, var(--xh-fg-brand));
+    /* 语气只落在指示条上；没写 data-tone 时 --xh-_tone 没被声明，退回品牌色。
+       当前链接的字色不随语气：导航当前页恒取 --xh-fg-brand-strong。聚焦环恒是 --xh-ring-focus */
     --xh-_navigation-menu-accent: var(--xh-_tone, var(--xh-fg-brand));
 
     position: relative;
@@ -64,6 +50,7 @@
   /* 缺省档写在上面的基础规则里。链接的内边距不在控件内边距那把尺上（它比控件矮一档），
      三档一律取空间尺，缺省档的取值原样保留 */
   [data-scope='navigation-menu'][data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-navigation-menu-icon-size, var(--xh-glyph-size-sm));
     --xh-_navigation-menu-font-size: var(--xh-control-font-sm);
     --xh-_navigation-menu-trigger-h: var(--xh-control-h-sm);
     --xh-_navigation-menu-trigger-px: var(--xh-control-px-sm);
@@ -74,6 +61,7 @@
   }
 
   [data-scope='navigation-menu'][data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-navigation-menu-icon-size, var(--xh-glyph-size-lg));
     --xh-_navigation-menu-font-size: var(--xh-control-font-lg);
     --xh-_navigation-menu-trigger-h: var(--xh-control-h-lg);
     --xh-_navigation-menu-trigger-px: var(--xh-control-px-lg);
@@ -84,10 +72,13 @@
   }
 
   /* 指示条的定位参照系（它是 absolute，量出来的偏移就是相对这里的）。
-     ul 的项目符号与内外边距是 UA 给的，库里没有全局 preflight，只能在这儿自己抹平 */
+     ul 的项目符号与内外边距是 UA 给的，库里没有全局 preflight，只能在这儿自己抹平。
+     一行排不下就折行：入口宽度由文字决定，硬撑一行会把整条导航顶出容器；
+     这里不改成横向滚动——面板是绝对定位在各自那一项里的，列表一旦成为滚动容器就把面板裁掉了 */
   [data-scope='navigation-menu'][data-part='list'] {
     position: relative;
     display: flex;
+    flex-wrap: wrap;
     align-items: center;
     gap: var(--xh-navigation-menu-gap, var(--xh-space-1));
     margin: 0;
@@ -102,6 +93,7 @@
   [data-scope='navigation-menu'][data-part='list'][data-orientation='vertical'] {
     flex-direction: column;
     align-items: stretch;
+    flex-wrap: nowrap;
   }
 
   /* 一项一个 li，面板就住在里面：给 relative 让面板贴着自己这一项落位 */
@@ -116,51 +108,37 @@
     display: none;
   }
 
+  /* 入口归 Collection Item 展开路径 / 打开中（nav 语境）：几何、字号、面与字重全经家族桥接槽。静息 muted /
+     regular，悬停走白底承载 hover 100 + default 字；展开着的那一张由连接层投影 data-in-path，家族给与悬停同档的
+     中性面——打开中不是选中，不用品牌色、不加粗（横排的栏加粗会推挤相邻触发器），哪一张开着由指示条与转向的
+     箭头说明；按下 pressed 200 只换面不缩放（§9.2）；禁用走 aria-disabled，家族给禁用字色与 not-allowed。
+     高度由 block-size 定，块向内边距归零。本条 (0,2,0) 压过家族基础块 (0,1,0)，不能再写 background / color /
+     font-weight / cursor；也不写 font: inherit（reset.css 已抹平按钮 UA 字体，再写会把家族给的字号字重一并盖掉） */
   [data-scope='navigation-menu'][data-part='trigger'] {
+    --xh-collection-block-padding: var(--xh-space-0);
+    --xh-collection-inline-padding: var(--xh-navigation-menu-trigger-px, var(--xh-_navigation-menu-trigger-px));
+    --xh-collection-radius: var(--xh-navigation-menu-trigger-radius, var(--xh-shape-control));
+    --xh-collection-font-size: var(--xh-navigation-menu-font-size, var(--xh-_navigation-menu-font-size));
+    --xh-collection-fg-rest: var(--xh-navigation-menu-trigger-fg, var(--xh-fg-muted));
+    --xh-collection-font-weight-rest: var(--xh-navigation-menu-trigger-font-weight, var(--xh-font-weight-regular));
+    --xh-collection-bg-hover: var(--xh-navigation-menu-trigger-bg-hover, var(--xh-_navigation-menu-highlight-bg));
+    --xh-collection-bg-open-path: var(--xh-navigation-menu-trigger-bg-active, var(--xh-_navigation-menu-highlight-bg));
+    --xh-collection-bg-pressed: var(--xh-navigation-menu-trigger-bg-pressed, var(--xh-bg-subtle-hover));
+
     display: inline-flex;
     align-items: center;
     gap: var(--xh-navigation-menu-trigger-gap, var(--xh-_navigation-menu-trigger-gap));
     block-size: var(--xh-navigation-menu-trigger-h, var(--xh-_navigation-menu-trigger-h));
-    padding-inline: var(--xh-navigation-menu-trigger-px, var(--xh-_navigation-menu-trigger-px));
     border: 0;
-    border-radius: var(--xh-navigation-menu-trigger-radius, var(--xh-shape-control));
-    background: transparent;
-    color: var(--xh-navigation-menu-trigger-fg, var(--xh-fg-muted));
-    font: inherit;
-    font-weight: var(--xh-navigation-menu-trigger-font-weight, var(--xh-text-label-weight));
+    /* 行高压回 none：家族基础块给条目写了 leading-normal，入口的高度只由 block-size 定 */
     line-height: var(--xh-leading-none);
     white-space: nowrap;
-    cursor: pointer;
-    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
   [data-scope='navigation-menu'][data-part='trigger'][hidden] {
     display: none;
   }
 
-  [data-scope='navigation-menu'][data-part='trigger']:hover {
-    background: var(--xh-navigation-menu-trigger-bg-hover, var(--xh-_navigation-menu-highlight-bg));
-  }
-
-  [data-scope='navigation-menu'][data-part='trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
-    outline-offset: var(--xh-ring-offset);
-  }
-
-  /* 展开着的那一张是打开路径，走品牌淡底强档：哪一张开着必须一眼看得出来。
-     不加粗：横排的栏加粗会推挤相邻触发器。
-     必须排在轻档之后：指针回到它身上时同特指度靠书写顺序压过轻档 */
-  [data-scope='navigation-menu'][data-part='trigger'][data-state='open'] {
-    background: var(--xh-navigation-menu-trigger-bg-active, var(--xh-_navigation-menu-active-bg));
-  }
-
-  /* 集合条目用 data-disabled，不用 :disabled：它带的是 aria-disabled，
-     仍可聚焦、仍是方向键的起点 */
-  [data-scope='navigation-menu'][data-part='trigger'][data-disabled] {
-    color: var(--xh-fg-disabled);
-    cursor: not-allowed;
-  }
-
   /* 竖排：入口占满整项的宽度，面板才从入口右缘长出来 */
   [data-scope='navigation-menu'][data-part='trigger'][data-orientation='vertical'] {
     flex: 1;
@@ -169,16 +147,16 @@
   /* 面板贴着自己那一项落位：横排从 trigger 底下长出来 */
   [data-scope='navigation-menu'][data-part='content'] {
     position: absolute;
-    z-index: var(--xh-navigation-menu-layer, var(--xh-layer-popover));
+    z-index: var(--xh-navigation-menu-layer, var(--xh-_layer, var(--xh-layer-popover)));
     inset-block-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
     inset-inline-start: 0;
     display: flex;
     flex-direction: column;
     gap: var(--xh-navigation-menu-content-gap, var(--xh-space-1));
     min-inline-size: var(--xh-navigation-menu-content-min-w, var(--xh-overlay-menu-min-w));
-    padding: var(--xh-navigation-menu-content-p, var(--xh-space-1));
+    padding: var(--xh-navigation-menu-content-p, var(--xh-surface-pad-xs));
     border: var(--xh-stroke-thin) solid var(--xh-navigation-menu-content-border, var(--xh-border-default));
-    border-radius: var(--xh-navigation-menu-content-radius, var(--xh-shape-surface));
+    border-radius: var(--xh-navigation-menu-content-radius, var(--xh-shape-overlay));
     background: var(--xh-navigation-menu-content-bg, var(--xh-bg-surface));
     box-shadow: var(--xh-navigation-menu-content-shadow, var(--xh-elevation-floating));
   }
@@ -194,8 +172,10 @@
     inset-inline-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
   }
 
+  /* 在场那一档才提前备好合成层：属性随 data-state 一起消失，收起后不长期占着 */
   [data-scope='navigation-menu'][data-part='content'][data-state='open'] {
-    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    will-change: opacity, scale;
+    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来 */
@@ -213,14 +193,29 @@
     box-shadow: none;
   }
 
+  /* 面板里的链接归 Collection Item 导航当前（nav 语境）：悬停 / 键盘高亮（白底承载 100）与按下（200）面由家族
+     按 :hover / :focus-visible / :active 给出，指向当前页面的那一条（data-current）取 strong 档品牌字色 +
+     medium 字重（§7.3），字色不随语气、不加下划线（下划线是"可点"的信号，它已经在这儿了）；这里只把公开槽
+     映射到桥接槽。面板是实色 floating 面，常态字色取 --xh-fg-default 而非 nav 缺省的 muted。
+     布局保持 flex：链接是一行文字，不用家族网格。position: relative 是当前链接静态线的定位参照 */
   [data-scope='navigation-menu'][data-part='link'] {
+    --xh-collection-block-padding: var(--xh-navigation-menu-link-py, var(--xh-_navigation-menu-link-py));
+    --xh-collection-inline-padding: var(--xh-navigation-menu-link-px, var(--xh-_navigation-menu-link-px));
+    --xh-collection-radius: var(--xh-navigation-menu-link-radius, var(--xh-shape-control));
+    --xh-collection-font-size: var(--xh-navigation-menu-link-font-size, var(--xh-_navigation-menu-link-font-size));
+    --xh-collection-fg-rest: var(--xh-navigation-menu-link-fg, var(--xh-fg-default));
+    --xh-collection-fg-hover: var(--xh-navigation-menu-link-fg, var(--xh-fg-default));
+    --xh-collection-fg-keyboard-highlight: var(--xh-navigation-menu-link-fg, var(--xh-fg-default));
+    --xh-collection-fg-pressed: var(--xh-navigation-menu-link-fg, var(--xh-fg-default));
+    --xh-collection-bg-hover: var(--xh-navigation-menu-link-bg-hover, var(--xh-_navigation-menu-highlight-bg));
+    --xh-collection-bg-keyboard-highlight: var(--xh-navigation-menu-link-bg-hover, var(--xh-_navigation-menu-highlight-bg));
+    --xh-collection-bg-pressed: var(--xh-navigation-menu-link-bg-pressed, var(--xh-bg-subtle-hover));
+    --xh-collection-fg-current: var(--xh-navigation-menu-link-fg-current, var(--xh-fg-brand-strong));
+    --xh-collection-font-weight-current: var(--xh-navigation-menu-link-font-weight-current, var(--xh-font-weight-medium));
+
+    position: relative;
     display: flex;
     align-items: center;
-    padding-block: var(--xh-navigation-menu-link-py, var(--xh-_navigation-menu-link-py));
-    padding-inline: var(--xh-navigation-menu-link-px, var(--xh-_navigation-menu-link-px));
-    border-radius: var(--xh-navigation-menu-link-radius, var(--xh-shape-control));
-    color: var(--xh-navigation-menu-link-fg, var(--xh-fg-default));
-    font-size: var(--xh-navigation-menu-link-font-size, var(--xh-_navigation-menu-link-font-size));
     text-decoration: none;
   }
 
@@ -228,23 +223,71 @@
     display: none;
   }
 
-  [data-scope='navigation-menu'][data-part='link']:hover {
-    background: var(--xh-navigation-menu-link-bg-hover, var(--xh-_navigation-menu-highlight-bg));
+  /* 入口里表示"底下还有一张面板"的标记，排在入口文字之后，展开时转向 */
+  [data-scope='navigation-menu'][data-part='trigger-indicator'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    line-height: var(--xh-leading-none);
+    transition: rotate var(--xh-motion-duration-micro) var(--xh-motion-ease-enter-strong);
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger-indicator'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这条规则即不命中 */
+  [data-scope='navigation-menu'][data-part='trigger-indicator']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger-indicator'][data-state='open'] {
+    rotate: 180deg;
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger-indicator'][data-disabled] {
+    color: var(--xh-fg-disabled);
   }
 
-  [data-scope='navigation-menu'][data-part='link']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
-    outline-offset: var(--xh-ring-offset);
+  /* 指向当前页面的链接自画一条静态指示线（§7.3 导航当前页）：与 Tabs line / Anchor 同一取法，作者不必为了
+     这条线多放一个部件。下面的 indicator 部件表达的是「哪张面板开着」而不是当前页，所以这条线不随部件收起，
+     两者各说各的：部件亮着时开着的入口下有一条、当前页链接上另有一条。
+     线画在当前链接的 ::after 上，以链接盒为定位参照（上面已给 position: relative），
+     厚度 / 颜色 / 圆角与 indicator 部件读同一组槽与缺省——作者改一处，部件与静态线一起改。不做动画。
+     缺省贴链接的行向起始缘（竖排的直达链接、面板里的链接都是一列，rtl 随逻辑属性镜像），主轴两端各退一格
+     --xh-space-1 避开链接的圆角，与家族 page 语境的起始侧指示条同一取法；横排 list 里的直达链接改贴底边 */
+  [data-scope='navigation-menu'][data-part='link'][data-current]::after {
+    content: '';
+    position: absolute;
+    inset-inline-start: 0;
+    inset-block: var(--xh-space-1);
+    inline-size: var(--xh-navigation-menu-indicator-thickness, var(--xh-stroke-thick));
+    border-radius: var(--xh-navigation-menu-indicator-radius, var(--xh-shape-pill));
+    background: var(--xh-navigation-menu-indicator-color, var(--xh-_navigation-menu-accent));
+    pointer-events: none;
   }
 
-  /* 指向当前页面的那一条：颜色与字重都变，不加下划线（下划线是"可点"的信号，它已经在这儿了） */
-  [data-scope='navigation-menu'][data-part='link'][data-current] {
-    color: var(--xh-navigation-menu-link-fg-current, var(--xh-_navigation-menu-current-fg));
-    font-weight: var(--xh-navigation-menu-link-font-weight-current, var(--xh-font-weight-medium));
+  /* 横排 list 里的直达链接：贴链接的块向末端（底边），与部件同一侧 */
+  [data-scope='navigation-menu'][data-part='list'][data-orientation='horizontal']
+    > [data-scope='navigation-menu'][data-part='item']
+    > [data-scope='navigation-menu'][data-part='link'][data-current]::after {
+    inset-inline: var(--xh-space-1);
+    inset-block: auto 0;
+    inline-size: auto;
+    block-size: var(--xh-navigation-menu-indicator-thickness, var(--xh-stroke-thick));
   }
 
   /* 主轴上的位置与长度由连接层写成内联样式（它量得到，样式表量不到）；
-     这里只管交叉轴的贴边与粗细，以及长什么样 */
+     这里只管交叉轴的贴边与粗细，以及长什么样。它指的是开着的面板：无面板开着时隐藏，
+     当前页由上面链接自画的静态线表达 */
   [data-scope='navigation-menu'][data-part='indicator'] {
     position: absolute;
     display: block;
@@ -255,8 +298,8 @@
     border-radius: var(--xh-navigation-menu-indicator-radius, var(--xh-shape-pill));
     background: var(--xh-navigation-menu-indicator-color, var(--xh-_navigation-menu-accent));
     transition:
-      inset-inline-start var(--xh-motion-duration-enter) var(--xh-motion-ease-enter),
-      inline-size var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+      inset-inline-start var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous),
+      inline-size var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous);
   }
 
   [data-scope='navigation-menu'][data-part='indicator'][hidden] {
@@ -270,20 +313,22 @@
     inline-size: var(--xh-navigation-menu-indicator-thickness, var(--xh-stroke-thick));
     block-size: auto;
     transition:
-      inset-block-start var(--xh-motion-duration-enter) var(--xh-motion-ease-enter),
-      block-size var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+      inset-block-start var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous),
+      block-size var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous);
   }
 
-  /* 共享面板外壳：只管落位与统一的面板外观，里面装哪一份内容归 content */
+  /* 共享面板外壳：只管落位与统一的面板外观，里面装哪一份内容归 content。
+     内衬自成一个槽：外壳装的是整份面板，缺省比 content 宽一档，
+     两处共用一个槽的话调了一处另一处跟着走，差值就再也调不开 */
   [data-scope='navigation-menu'][data-part='viewport'] {
     position: absolute;
-    z-index: var(--xh-navigation-menu-layer, var(--xh-layer-popover));
+    z-index: var(--xh-navigation-menu-layer, var(--xh-_layer, var(--xh-layer-popover)));
     inset-block-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
     inset-inline-start: 0;
     display: block;
-    padding: var(--xh-navigation-menu-content-p, var(--xh-space-2));
+    padding: var(--xh-navigation-menu-viewport-p, var(--xh-space-2));
     border: var(--xh-stroke-thin) solid var(--xh-navigation-menu-content-border, var(--xh-border-default));
-    border-radius: var(--xh-navigation-menu-content-radius, var(--xh-shape-surface));
+    border-radius: var(--xh-navigation-menu-content-radius, var(--xh-shape-overlay));
     background: var(--xh-navigation-menu-content-bg, var(--xh-bg-surface));
     box-shadow: var(--xh-navigation-menu-content-shadow, var(--xh-elevation-floating));
   }
@@ -297,4 +342,13 @@
     inset-block-start: 0;
     inset-inline-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
   }
+
+  @media (forced-colors: active) {
+    /* 两条指示线画的都是一块纯底色，这一档里底色被统一换成 Canvas，线整根消失：
+       开着的入口只剩转向的箭头、当前页只剩字重。换成系统高亮色画回来 */
+    [data-scope='navigation-menu'][data-part='indicator'],
+    [data-scope='navigation-menu'][data-part='link'][data-current]::after {
+      background: Highlight;
+    }
+  }
 }