@xihan-ui/styles 2.0.0 → 3.0.0

package/css/carousel.css

@@ -6,6 +6,7 @@
 /* 定义 carousel 样式。 */
 
 @import '../family/action-control.css';
+@import '../family/material.css';
 
 @layer xihan.components {
   /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
@@ -16,11 +17,6 @@
   /* 根节点建立自己的覆盖层：视口占满容器，导航与分页压在内容之上，
      isolation 把内部层号关在本组件内，不参与页面级层序。 */
   [data-scope='carousel'][data-part='root'] {
-    /* 三颗控制钮浮在媒体之上，缺省 M2 磨砂面：背景、边缘、顶光、投影与磨砂从同一份配方取，
-       高对比、减少透明度、打印和强制色便能一起降级。三支写在根上：check-elevation-role 按赋值点认海拔角色 */
-    --xh-_carousel-trigger-bg: var(--xh-material-frosted-bg);
-    --xh-_carousel-trigger-border: var(--xh-material-frosted-border);
-    --xh-_carousel-trigger-shadow: var(--xh-material-frosted-shadow);
     /* 自动播放开启时由 Headless 写入真实间隔；0ms 只用于未接入运行时的静态标记。 */
     --xh-_carousel-autoplay-duration: 0ms;
     --xh-_carousel-progress-from: 0 1;
@@ -56,14 +52,14 @@
   }
 
   /* 被位移的那条轨道。
-     transform 归连接层：整页位移与拖拽中的像素偏移都写在它的内联 style 上，
+     translate 归连接层：整页位移与拖拽中的像素偏移都写在它的内联 style 上，
      样式层再碰这条轴就会把两个位移互相覆盖，画面当场错位。
      这里只负责排布与过渡 */
   [data-scope='carousel'][data-part='list'] {
     display: flex;
     flex-direction: row;
     block-size: 100%;
-    transition: transform var(--xh-carousel-duration, var(--xh-motion-duration-slide))
+    transition: translate var(--xh-carousel-duration, var(--xh-motion-duration-slide))
       var(--xh-carousel-ease, var(--xh-motion-ease-slide));
   }
 
@@ -79,7 +75,42 @@
      整条轨道的位移这一档每帧都在改，合成层只在这一档备好，松手随 data-dragging 一起撤掉 */
   [data-scope='carousel'][data-part='list'][data-dragging] {
     transition: none;
-    will-change: transform;
+    will-change: translate;
+  }
+
+  /* 松手后由弹簧带着松手速度逐帧把轨道收到落定位置，同样不能再叠一层过渡；落定即撤 */
+  /* 回绕落定后轨道已无动画地归位：下一次翻页撤掉这个标记，过渡照常 */
+  [data-scope='carousel'][data-part='list'][data-snapped] {
+    transition: none;
+  }
+
+  [data-scope='carousel'][data-part='list'][data-animating] {
+    transition: none;
+    will-change: translate;
+  }
+
+  /* 淡变换页：条目叠进同一格，轨道不位移（连接层不写页位移）。
+     当前一张压在上面淡入，离开的那一张同一段淡出、淡完才藏起——visibility 在两端之间插值时取 visible，
+     过渡走到末端才落成 hidden。时长与曲线跟平移同一档：减弱动效下 slide 为 1ms，直接换 */
+  [data-scope='carousel'][data-part='list'][data-effect='fade']:not([hidden]) {
+    display: grid;
+    grid-template: minmax(0, 1fr) / minmax(0, 1fr);
+    transition: none;
+  }
+
+  [data-scope='carousel'][data-part='list'][data-effect='fade'] > [data-scope='carousel'][data-part='item'] {
+    grid-area: 1 / 1;
+    opacity: 0;
+    visibility: hidden;
+    transition-property: opacity, visibility;
+    transition-duration: var(--xh-carousel-duration, var(--xh-motion-duration-slide));
+    transition-timing-function: var(--xh-carousel-ease, var(--xh-motion-ease-slide));
+  }
+
+  [data-scope='carousel'][data-part='list'][data-effect='fade'] > [data-scope='carousel'][data-part='item'][data-inview] {
+    z-index: 1;
+    opacity: 1;
+    visibility: visible;
   }
 
   /* 一张幻灯片。
@@ -99,38 +130,42 @@
     display: none;
   }
 
-  /* 两端按钮与播放开关：浮在媒体之上的单图标圆钮，接 Action Control floating 档（§4.1）：
+  /* 两端按钮与播放开关：浮在媒体之上的单图标圆钮，接 Action Control floating 档：
      盒型（md = box-lg 48px，圆形）、四态面、0.97 按压与 44px 命中区由家族配方给出，组件没有 size 轴、固定 md。
      连接层不投影 variant：面由这里桥接到磨砂缺省（使用者槽 → 磨砂面），悬停 / 按下的底走画布承载的阶梯
-     （100 → 200，§7.2 第 3 条），边缘与投影不动；这里只留定位、桥接槽与图标尺 */
+     （100 → 200，取不透明档：钮压在图上，半透明的墨色盖不住画面），边缘与投影不动；这里只留定位、桥接槽与图标尺 */
   [data-scope='carousel'][data-part='prev-trigger'],
   [data-scope='carousel'][data-part='next-trigger'],
   [data-scope='carousel'][data-part='autoplay-trigger'] {
-    --xh-action-bg-rest: var(--xh-carousel-trigger-bg, var(--xh-_carousel-trigger-bg));
-    --xh-action-bg-hover: var(--xh-carousel-trigger-bg-hover, var(--xh-bg-subtle));
-    --xh-action-bg-pressed: var(--xh-carousel-trigger-bg-active, var(--xh-bg-subtle-hover));
-    --xh-action-bg-focus-visible: var(--xh-carousel-trigger-bg, var(--xh-material-frosted-focus-surface));
-    --xh-action-bg-disabled: var(--xh-carousel-trigger-bg, var(--xh-_carousel-trigger-bg));
-    --xh-action-fg-rest: var(--xh-carousel-trigger-fg, var(--xh-material-frosted-fg));
-    --xh-action-fg-hover: var(--xh-carousel-trigger-fg, var(--xh-material-frosted-fg));
-    --xh-action-fg-pressed: var(--xh-carousel-trigger-fg, var(--xh-material-frosted-fg));
-    --xh-action-fg-focus-visible: var(--xh-carousel-trigger-fg, var(--xh-material-frosted-fg));
-    --xh-action-border-rest: var(--xh-carousel-trigger-border, var(--xh-_carousel-trigger-border));
-    --xh-action-border-hover: var(--xh-carousel-trigger-border, var(--xh-_carousel-trigger-border));
-    --xh-action-border-pressed: var(--xh-carousel-trigger-border, var(--xh-_carousel-trigger-border));
-    --xh-action-border-focus-visible: var(--xh-carousel-trigger-border, var(--xh-_carousel-trigger-border));
-    --xh-action-border-disabled: var(--xh-carousel-trigger-border, var(--xh-_carousel-trigger-border));
-    --xh-action-shadow-rest: var(--xh-carousel-trigger-shadow, var(--xh-_carousel-trigger-shadow));
-    --xh-action-shadow-hover: var(--xh-carousel-trigger-shadow-hover, var(--xh-_carousel-trigger-shadow));
-    --xh-action-shadow-pressed: var(--xh-carousel-trigger-shadow, var(--xh-_carousel-trigger-shadow));
-    --xh-action-shadow-focus-visible: var(--xh-carousel-trigger-shadow, var(--xh-_carousel-trigger-shadow));
-    --xh-action-shadow-disabled: var(--xh-carousel-trigger-shadow, var(--xh-_carousel-trigger-shadow));
+    /* 面走材质家族配方（family/material.css）：frosted 档的底、交互阶梯、描边、投影、1px 顶光与背景滤镜，
+       liquid 档由配方换成液态面；这里把使用者槽接到 Action Control 的桥接槽 */
+    --xh-action-bg-rest: var(--xh-carousel-trigger-bg, var(--xh-_material-bg));
+    --xh-action-bg-hover: var(--xh-carousel-trigger-bg-hover, var(--xh-_material-bg-hover));
+    --xh-action-bg-pressed: var(--xh-carousel-trigger-bg-active, var(--xh-_material-bg-pressed));
+    --xh-action-bg-focus-visible: var(--xh-carousel-trigger-bg, var(--xh-_material-bg-focus));
+    --xh-action-bg-disabled: var(--xh-carousel-trigger-bg, var(--xh-_material-bg));
+    --xh-action-fg-rest: var(--xh-carousel-trigger-fg, var(--xh-_material-fg));
+    --xh-action-fg-hover: var(--xh-carousel-trigger-fg, var(--xh-_material-fg));
+    --xh-action-fg-pressed: var(--xh-carousel-trigger-fg, var(--xh-_material-fg));
+    --xh-action-fg-focus-visible: var(--xh-carousel-trigger-fg, var(--xh-_material-fg));
+    --xh-action-border-rest: var(--xh-carousel-trigger-border, var(--xh-_material-border));
+    --xh-action-border-hover: var(--xh-carousel-trigger-border, var(--xh-_material-border));
+    --xh-action-border-pressed: var(--xh-carousel-trigger-border, var(--xh-_material-border));
+    --xh-action-border-focus-visible: var(--xh-carousel-trigger-border, var(--xh-_material-border));
+    --xh-action-border-disabled: var(--xh-carousel-trigger-border, var(--xh-_material-border));
+    --xh-action-shadow-rest: var(--xh-carousel-trigger-shadow, var(--xh-_material-shadow));
+    --xh-action-shadow-hover: var(--xh-carousel-trigger-shadow-hover, var(--xh-_material-shadow));
+    --xh-action-shadow-pressed: var(--xh-carousel-trigger-shadow, var(--xh-_material-shadow));
+    --xh-action-shadow-focus-visible: var(--xh-carousel-trigger-shadow, var(--xh-_material-shadow));
+    --xh-action-shadow-disabled: var(--xh-carousel-trigger-shadow, var(--xh-_material-shadow));
+    --xh-action-highlight-rest: var(--xh-_material-highlight);
+    --xh-action-highlight-hover: var(--xh-_material-highlight);
+    --xh-action-highlight-pressed: var(--xh-_material-highlight);
+    --xh-action-highlight-focus-visible: var(--xh-_material-highlight);
+    --xh-action-highlight-disabled: var(--xh-_material-highlight);
+    --xh-action-bg-hover: var(--xh-carousel-trigger-bg-hover, var(--xh-bg-subtle-opaque));
+    --xh-action-bg-pressed: var(--xh-carousel-trigger-bg-active, var(--xh-bg-subtle-hover-opaque));
     /* M2 顶光走配方的高光通道 */
-    --xh-action-highlight-rest: var(--xh-material-frosted-highlight);
-    --xh-action-highlight-hover: var(--xh-material-frosted-highlight);
-    --xh-action-highlight-pressed: var(--xh-material-frosted-highlight);
-    --xh-action-highlight-focus-visible: var(--xh-material-frosted-highlight);
-    --xh-action-highlight-disabled: var(--xh-material-frosted-highlight);
     --xh-action-radius: var(--xh-carousel-trigger-radius, var(--xh-_action-profile-radius));
     --xh-action-visual-size: var(--xh-carousel-trigger-size, var(--xh-_action-profile-visual-size));
     /* 作者塞进来的图标跟着 floating 档走（md 24px），与皮肤画的兜底字形同一把尺 */
@@ -138,8 +173,6 @@
 
     position: absolute;
     z-index: 1;
-    -webkit-backdrop-filter: var(--xh-material-frosted-backdrop);
-    backdrop-filter: var(--xh-material-frosted-backdrop);
   }
 
   [data-scope='carousel'][data-part='prev-trigger'],
@@ -212,7 +245,29 @@
     translate: -50% 0;
   }
 
-  /* 分页点与 Tour 的步骤点同一种语言（§6.3）：8px 圆点，当前页拉长成 20px 胶囊并换品牌色。
+  /* 起点是逻辑属性、平移是物理通道：rtl 下行内分量掉头，分页条才落回中线 */
+  [data-scope='carousel'][data-part='indicator-group'][data-orientation='horizontal']:dir(rtl) {
+    translate: 50% 0;
+  }
+
+  /* liquid 档：分页点托在一条液态胶囊上（不贴边的一维栏取 pill），压在任何媒体上都看得清。
+     胶囊是墨色域，点的中性色随之取墨色；胶囊本身不可按，不挂按住形变 */
+  :where([data-material='liquid']) [data-scope='carousel'][data-part='indicator-group'][data-xh-liquid] {
+    padding: var(--xh-carousel-indicator-group-p, var(--xh-space-2));
+    border: var(--xh-stroke-thin) solid var(--xh-material-liquid-border);
+    border-radius: var(--xh-carousel-indicator-group-radius, var(--xh-shape-pill));
+    background: var(--xh-_liquid-bg);
+    box-shadow: var(--xh-_liquid-shadow);
+    -webkit-backdrop-filter: var(--xh-material-liquid-backdrop);
+    backdrop-filter: var(--xh-material-liquid-backdrop);
+    /* 翻页换到深浅不同的图上时色调翻转：底色、细线与投影一起淡变 */
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      box-shadow var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 分页点与 Tour 的步骤点同一种语言：8px 圆点，当前页拉长成 20px 胶囊并换品牌色。
      本体就是那颗点：没有文字（页码交给作者，默认不显示），底色即标记。
      悬停 / 按下的回执落在点的颜色上：中性标记按前景阶梯加深一档、再加深一档；当前页按品牌阶梯压一档 */
   [data-scope='carousel'][data-part='indicator'] {
@@ -226,14 +281,14 @@
     padding: 0;
     border: 0;
     border-radius: var(--xh-carousel-indicator-radius, var(--xh-shape-circle));
-    background: var(--xh-carousel-indicator-bg, var(--xh-border-default));
+    background: var(--xh-carousel-indicator-bg, var(--xh-bg-subtle-hover-opaque));
     font-size: 0;
     /* 自动播放的进度条画在点里，超出胶囊的那截裁掉 */
     overflow: hidden;
     cursor: pointer;
     transition:
-      inline-size var(--xh-motion-duration-micro) var(--xh-motion-ease-continuous),
-      block-size var(--xh-motion-duration-micro) var(--xh-motion-ease-continuous),
+      inline-size var(--xh-motion-duration-move) var(--xh-motion-ease-continuous),
+      block-size var(--xh-motion-duration-move) var(--xh-motion-ease-continuous),
       background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
       scale var(--xh-motion-duration-release) var(--xh-motion-ease-release);
   }
@@ -253,7 +308,7 @@
     background: var(--xh-carousel-indicator-bg-hover, var(--xh-fg-muted));
   }
 
-  /* 按下：点的颜色再压一档，同时缩一下（§9.1 同时换底）；指针按住由 :active 表出，
+  /* 按下：点的颜色再压一档，同时缩一下（同时换底）；指针按住由 :active 表出，
      Space / Enter 与触屏按住由 Headless 投影 data-pressed，三种输入同一副面 */
   [data-scope='carousel'][data-part='indicator']:is(:active, [data-pressed]):not([data-current]) {
     background: var(--xh-carousel-indicator-bg-active, var(--xh-fg-default));
@@ -271,7 +326,7 @@
 
   /* 当前页：data-current 与 aria-current='true' 由连接层成对给出，
      样式挂在 data 钩子上，无障碍语义留给 aria，两边各司其职。
-     拉长成胶囊并换品牌色（格状当前 = 实心品牌，§7.3） */
+     拉长成胶囊并换品牌色（格状当前 = 实心品牌） */
   [data-scope='carousel'][data-part='indicator'][data-current] {
     inline-size: var(--xh-carousel-indicator-size-current, var(--xh-space-5));
     border-radius: var(--xh-carousel-indicator-radius-current, var(--xh-shape-pill));
@@ -298,8 +353,9 @@
     transition-timing-function: var(--xh-motion-ease-press);
   }
 
-  /* 自动播放的进度：胶囊是品牌淡底当轨道（仍是「当前」语义，§7.1；淡底上公共环够对比，不灌环色），
-     品牌填充条从起点沿轨道方向长满这一页的时长；暂停时定住 */
+  /* 自动播放的进度：胶囊是品牌淡底当轨道（仍是「当前」语义；淡底上公共环够对比，不灌环色），
+     品牌填充条从起点沿轨道方向长满这一页的时长。计时器每次恢复都重计一整个间隔，
+     进度条跟它同一口径：暂停时回到起点，恢复时从头走 */
   [data-scope='carousel'][data-part='root'][data-autoplay]
     [data-scope='carousel'][data-part='indicator'][data-current],
   [data-scope='carousel'][data-part='root'][data-paused]
@@ -322,7 +378,8 @@
 
   [data-scope='carousel'][data-part='root'][data-paused]
     [data-scope='carousel'][data-part='indicator'][data-current]::before {
-    animation-play-state: paused;
+    animation: none;
+    scale: var(--xh-_carousel-progress-from);
   }
 
   /* 纵轨：胶囊沿块轴拉长，进度条从上往下长 */
@@ -350,6 +407,17 @@
     rotate: 90deg;
   }
 
+  [data-scope='carousel'][data-part='root'][data-orientation='vertical']
+    > :is([data-part='prev-trigger'], [data-part='next-trigger']):dir(rtl) {
+    translate: 50% 0;
+  }
+
+  /* 纵轨的翻页钮整颗转了 90°，形变会跟着转到错的方向，这一档不挂 */
+  :where([data-material='liquid']) [data-scope='carousel'][data-part='root'][data-orientation='vertical']
+    > :is([data-part='prev-trigger'], [data-part='next-trigger'])[data-xh-liquid] {
+    transform: none;
+  }
+
   [data-scope='carousel'][data-part='root'][data-orientation='vertical']
     > [data-part='prev-trigger'] {
     inset-block-start: var(--xh-carousel-control-inset, var(--xh-space-3));
@@ -498,14 +566,19 @@
       inline-size: var(--xh-carousel-indicator-size, var(--xh-space-2));
       block-size: var(--xh-carousel-indicator-size, var(--xh-space-2));
       border-radius: var(--xh-carousel-indicator-radius, var(--xh-shape-circle));
-      background: var(--xh-carousel-indicator-bg, var(--xh-border-default));
+      background: var(--xh-carousel-indicator-bg, var(--xh-bg-subtle-hover-opaque));
       translate: -50% -50%;
+      /* 当前点伸长是跨尺寸的换位（move），与细指针下盒子本身的伸长同一档 */
       transition:
-        inline-size var(--xh-motion-duration-micro) var(--xh-motion-ease-continuous),
-        block-size var(--xh-motion-duration-micro) var(--xh-motion-ease-continuous),
+        inline-size var(--xh-motion-duration-move) var(--xh-motion-ease-continuous),
+        block-size var(--xh-motion-duration-move) var(--xh-motion-ease-continuous),
         background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
     }
 
+    [data-scope='carousel'][data-part='indicator']:dir(rtl)::after {
+      translate: 50% -50%;
+    }
+
     [data-scope='carousel'][data-part='indicator']:is(:active, [data-pressed]):not([data-current])::after {
       background: var(--xh-carousel-indicator-bg-active, var(--xh-fg-default));
     }
@@ -546,6 +619,13 @@
       translate: -50% -50%;
     }
 
+    [data-scope='carousel'][data-part='root'][data-autoplay]
+      [data-scope='carousel'][data-part='indicator'][data-current]:dir(rtl)::before,
+    [data-scope='carousel'][data-part='root'][data-paused]
+      [data-scope='carousel'][data-part='indicator'][data-current]:dir(rtl)::before {
+      translate: 50% -50%;
+    }
+
     [data-scope='carousel'][data-part='indicator-group'][data-orientation='vertical']
       > [data-scope='carousel'][data-part='indicator'][data-current]::after,
     [data-scope='carousel'][data-part='root'][data-autoplay]
@@ -558,6 +638,31 @@
       block-size: var(--xh-carousel-indicator-size-current, var(--xh-space-5));
     }
   }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    [data-scope='carousel']:is([data-part='prev-trigger'], [data-part='next-trigger']):empty::before,
+    [data-scope='carousel'][data-part='autoplay-trigger'][data-state='running']:empty::before,
+    [data-scope='carousel'][data-part='autoplay-trigger'][data-state='paused']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    [data-scope='carousel']:is([data-part='prev-trigger'], [data-part='next-trigger']):not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before,
+    [data-scope='carousel'][data-part='autoplay-trigger'][data-state='running']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before,
+    [data-scope='carousel'][data-part='autoplay-trigger'][data-state='paused']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    [data-scope='carousel']:is([data-part='prev-trigger'], [data-part='next-trigger'])[data-disabled]:empty::before,
+    [data-scope='carousel'][data-part='autoplay-trigger'][data-state='running'][data-disabled]:empty::before,
+    [data-scope='carousel'][data-part='autoplay-trigger'][data-state='paused'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
 }
 
 @layer xihan.motion {