@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/carousel.css

@@ -0,0 +1,726 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 carousel 样式。 */
+
+@import '../family/action-control.css';
+@import '../family/material.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-carousel {
+    --xh-carousel-skin: 1;
+  }
+
+  /* 根节点建立自己的覆盖层：视口占满容器，导航与分页压在内容之上，
+     isolation 把内部层号关在本组件内，不参与页面级层序。 */
+  .xh-scope-carousel[data-part='root'] {
+    /* 自动播放开启时由 Headless 写入真实间隔；0ms 只用于未接入运行时的静态标记。 */
+    --xh-_carousel-autoplay-duration: 0ms;
+    /* 进度条起步时裁掉的四边（inset 的上 右 下 左）：横轨从行尾那一侧整条裁掉。
+       clip-path 只认物理方向，行内轴两侧取书写方向的位置，rtl 下改从左往右收 */
+    --xh-_carousel-progress-cut: 0 var(--xh-direction-end) 0 var(--xh-direction-start);
+
+    position: relative;
+    display: block;
+    isolation: isolate;
+    inline-size: 100%;
+  }
+
+  .xh-scope-carousel[data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* 纵轨：从下沿整条裁掉，进度条从上往下长 */
+  .xh-scope-carousel[data-part='root'][data-orientation='vertical'] {
+    --xh-_carousel-progress-cut: 0 0 100% 0;
+  }
+
+  /* 视口是裁切窗口：轨道比它宽（高），露在外面的那些张全靠它切掉。
+     min-inline-size: 0 是关键——弹性子项的默认最小尺寸是内容尺寸，
+     不压成 0 的话视口会被整条轨道撑开，什么都切不掉 */
+  .xh-scope-carousel[data-part='viewport'] {
+    inline-size: 100%;
+    min-inline-size: 0;
+    overflow: hidden;
+    border-radius: var(--xh-carousel-viewport-radius, var(--xh-shape-surface));
+  }
+
+  .xh-scope-carousel[data-part='viewport'][hidden] {
+    display: none;
+  }
+
+  /* 被位移的那条轨道。
+     translate 归连接层：整页位移与拖拽中的像素偏移都写在它的内联 style 上，
+     样式层再碰这条轴就会把两个位移互相覆盖，画面当场错位。
+     这里只负责排布与过渡 */
+  .xh-scope-carousel[data-part='list'] {
+    display: flex;
+    flex-direction: row;
+    block-size: 100%;
+    transition: translate var(--xh-carousel-duration, var(--xh-motion-duration-slide))
+      var(--xh-carousel-ease, var(--xh-motion-ease-slide));
+  }
+
+  .xh-scope-carousel[data-part='list'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-carousel[data-part='list'][data-orientation='vertical'] {
+    flex-direction: column;
+  }
+
+  /* 拖拽期间关掉过渡：留着的话画面会拖着手指慢半拍，像在拉一根皮筋。
+     整条轨道的位移这一档每帧都在改，合成层只在这一档备好，松手随 data-dragging 一起撤掉 */
+  .xh-scope-carousel[data-part='list'][data-dragging] {
+    transition: none;
+    will-change: translate;
+  }
+
+  /* 松手后由弹簧带着松手速度逐帧把轨道收到落定位置，同样不能再叠一层过渡；落定即撤 */
+  /* 回绕落定后轨道已无动画地归位：下一次翻页撤掉这个标记，过渡照常 */
+  .xh-scope-carousel[data-part='list'][data-snapped] {
+    transition: none;
+  }
+
+  .xh-scope-carousel[data-part='list'][data-animating] {
+    transition: none;
+    will-change: translate;
+  }
+
+  /* 淡变换页：条目叠进同一格，轨道不位移（连接层不写页位移）。
+     当前一张压在上面淡入，离开的那一张同一段淡出、淡完才藏起——visibility 在两端之间插值时取 visible，
+     过渡走到末端才落成 hidden。时长与曲线跟平移同一档：减弱动效下 slide 为 1ms，直接换 */
+  .xh-scope-carousel[data-part='list'][data-effect='fade']:not([hidden]) {
+    display: grid;
+    grid-template: minmax(0, 1fr) / minmax(0, 1fr);
+    transition: none;
+  }
+
+  .xh-scope-carousel[data-part='list'][data-effect='fade'] > .xh-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));
+  }
+
+  .xh-scope-carousel[data-part='list'][data-effect='fade'] > .xh-scope-carousel[data-part='item'][data-inview] {
+    z-index: 1;
+    opacity: 1;
+    visibility: visible;
+  }
+
+  /* 一张幻灯片。
+     尺寸（flex-basis）与间距（padding）同样归连接层：一屏放几张只有它知道，
+     CSS 拿不到那个数（属性值参与不了计算）。这里只补三件配套的事：
+     · box-sizing —— 内联的 padding 不得把这张撑出格子（reset 层已有同款兜底）；
+     · flex-grow/shrink 归零 —— 弹性布局默认会把不满一屏的那几张拉伸，位移就对不上了；
+     · min-inline-size: 0 —— 同视口，防止长内容把这张顶宽 */
+  .xh-scope-carousel[data-part='item'] {
+    box-sizing: border-box;
+    flex-grow: 0;
+    flex-shrink: 0;
+    min-inline-size: 0;
+  }
+
+  .xh-scope-carousel[data-part='item'][hidden] {
+    display: none;
+  }
+
+  /* 两端按钮与播放开关：浮在媒体之上的单图标圆钮，接 Action Control floating 档：
+     圆形、四态面、按压与 44px 命中区由家族配方给出；视觉盒比 floating 档小，不压画面：
+     sm / md / lg 取 24 / 24 / 28px、字形 12 / 16 / 20px（sm 不低于 24px 的最小目标，只把字形收小）。
+     sm / md 直接取细指针最小目标 --xh-control-target-min，不随密度收：floating 档在细指针下不外扩命中区，
+     视觉盒就是命中区，紧凑档再收到 20px 就够不着 24px。
+     连接层不投影 variant：面由这里桥接到磨砂缺省（使用者槽 → 磨砂面），悬停 / 按下的底走画布承载的阶梯
+     （100 → 200，取不透明档：钮压在图上，半透明的墨色盖不住画面），边缘与投影不动；这里只留定位、桥接槽与图标尺 */
+  .xh-scope-carousel[data-part='prev-trigger'],
+  .xh-scope-carousel[data-part='next-trigger'],
+  .xh-scope-carousel[data-part='autoplay-trigger'] {
+    /* 面走材质家族配方（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-radius: var(--xh-carousel-trigger-radius, var(--xh-_action-profile-radius));
+    --xh-_carousel-trigger-size: var(--xh-control-target-min);
+    --xh-_carousel-trigger-glyph: var(--xh-glyph-size-sm);
+    --xh-action-visual-size: var(--xh-carousel-trigger-size, var(--xh-_carousel-trigger-size));
+    --xh-action-min-inline-size: var(--xh-carousel-trigger-size, var(--xh-_carousel-trigger-size));
+    /* 作者塞进来的图标与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-carousel-icon-size, var(--xh-_carousel-trigger-glyph));
+
+    position: absolute;
+    z-index: 1;
+  }
+
+  .xh-scope-carousel:is([data-part='prev-trigger'], [data-part='next-trigger'], [data-part='autoplay-trigger'])[data-xh-action-size='sm'] {
+    --xh-_carousel-trigger-glyph: var(--xh-control-indicator-sm);
+  }
+
+  .xh-scope-carousel:is([data-part='prev-trigger'], [data-part='next-trigger'], [data-part='autoplay-trigger'])[data-xh-action-size='lg'] {
+    --xh-_carousel-trigger-size: var(--xh-control-h-sm);
+    --xh-_carousel-trigger-glyph: var(--xh-glyph-size-md);
+  }
+
+  .xh-scope-carousel[data-part='prev-trigger'],
+  .xh-scope-carousel[data-part='next-trigger'] {
+    inset-block-start: 50%;
+    translate: 0 -50%;
+  }
+
+  .xh-scope-carousel[data-part='prev-trigger'] {
+    inset-inline-start: var(--xh-carousel-control-inset, var(--xh-space-3));
+  }
+
+  .xh-scope-carousel[data-part='next-trigger'] {
+    inset-inline-end: var(--xh-carousel-control-inset, var(--xh-space-3));
+  }
+
+  .xh-scope-carousel[data-part='autoplay-trigger'] {
+    inset-block-start: auto;
+    inset-block-end: var(--xh-carousel-control-inset, var(--xh-space-3));
+    inset-inline-end: var(--xh-carousel-control-inset, var(--xh-space-3));
+  }
+
+  .xh-scope-carousel[data-part='prev-trigger'][hidden],
+  .xh-scope-carousel[data-part='next-trigger'][hidden],
+  .xh-scope-carousel[data-part='autoplay-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 两端到头 / 没配自动播放时按钮是原生 disabled（不可聚焦、进不了 Tab 序列），连接层同时给 data-disabled：
+     到头即隐藏是刻意行为，配方 disabled 列给的面被 opacity 0 盖住，两者不冲突 */
+  .xh-scope-carousel[data-part='prev-trigger'][data-disabled],
+  .xh-scope-carousel[data-part='next-trigger'][data-disabled],
+  .xh-scope-carousel[data-part='autoplay-trigger'][data-disabled] {
+    opacity: 0;
+    pointer-events: none;
+  }
+
+  /* 视口与指示点都不是可聚焦节点，落焦只会是浏览器兜底行为，别画焦点环 */
+  .xh-scope-carousel[data-part='viewport']:focus-visible,
+  .xh-scope-carousel[data-part='list']:focus-visible,
+  .xh-scope-carousel[data-part='indicator-group']:focus-visible {
+    outline: none;
+  }
+
+  .xh-scope-carousel[data-part='indicator-group'] {
+    position: absolute;
+    z-index: 1;
+    display: flex;
+    flex-wrap: nowrap;
+    align-items: center;
+    justify-content: center;
+    gap: var(--xh-carousel-indicator-gap, var(--xh-space-2));
+  }
+
+  .xh-scope-carousel[data-part='indicator-group'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical'] {
+    flex-direction: column;
+    inset-block-start: 50%;
+    inset-inline-end: var(--xh-carousel-control-inset, var(--xh-space-3));
+    translate: 0 -50%;
+  }
+
+  /* 横轨分页覆盖在内容下沿居中。 */
+  .xh-scope-carousel[data-part='indicator-group'][data-orientation='horizontal'] {
+    inset-block-end: var(--xh-carousel-indicator-inset, var(--xh-space-3));
+    inset-inline-start: 50%;
+    translate: -50% 0;
+  }
+
+  /* 起点是逻辑属性、平移是物理通道：rtl 下行内分量掉头，分页条才落回中线 */
+  .xh-scope-carousel[data-part='indicator-group'][data-orientation='horizontal']:dir(rtl) {
+    translate: 50% 0;
+  }
+
+  /* liquid 档：分页点托在一条液态胶囊上（不贴边的一维栏取 pill），压在任何媒体上都看得清。
+     胶囊是墨色域，点的中性色随之取墨色；胶囊本身不可按，不挂按住形变 */
+  :where([data-material='liquid']) .xh-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 的步骤点同一种语言：圆点（压在媒体上的这一排 6px、点距 8px），当前页拉长成 20px 胶囊并换品牌色。
+     本体就是那颗点：没有文字（页码交给作者，默认不显示），底色即标记。
+     悬停 / 按下的回执落在点的颜色上：中性标记按前景阶梯加深一档、再加深一档；当前页按品牌阶梯压一档。
+     沿轨道的长度取 indicator-size（当前页 indicator-size-current），垂直于轨道的粗细取 indicator-thickness，
+     缺省与长度同值、仍是圆点；粗细单独调小就成细横条（横条不是正方盒，圆角另把 indicator-radius 换成胶囊） */
+  .xh-scope-carousel[data-part='indicator'] {
+    position: relative;
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-carousel-indicator-size, var(--xh-space-1_5));
+    block-size: var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5)));
+    padding: 0;
+    border: 0;
+    border-radius: var(--xh-carousel-indicator-radius, var(--xh-shape-circle));
+    background: var(--xh-carousel-indicator-bg, var(--xh-bg-subtle-hover-opaque));
+    font-size: 0;
+    /* 不裁切：细指针下 ::after 把命中区外扩到点外，overflow 一裁命中区就缩回 6px 的点里；
+       自动播放的进度条自己带圆角、由 clip-path 裁出来，不靠点来裁 */
+    cursor: pointer;
+    transition:
+      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);
+  }
+
+  .xh-scope-carousel[data-part='indicator'][hidden] {
+    display: none;
+  }
+
+  /* 细指针的命中区外扩到不低于 24×24：两向都取「外扩 8px」与「补足到最小目标 --xh-control-target-min」
+     中大的一头（6px 点四面各扩 9px）；粗指针下这颗伪元素改画点，盒子自己承担命中。点调细了，垂直于轨道那一向照样补足。
+     相邻两点节距 14px，命中区沿轨道互相叠一截：后一颗画在上层，叠住的那段归它，每颗点自己的盒子仍只命中自己 */
+  .xh-scope-carousel[data-part='indicator']::after {
+    content: '';
+    position: absolute;
+    inset-inline: min(
+      calc(-1 * var(--xh-space-2)),
+      calc((var(--xh-carousel-indicator-size, var(--xh-space-1_5)) - var(--xh-control-target-min)) / 2)
+    );
+    inset-block: min(
+      calc(-1 * var(--xh-space-2)),
+      calc((var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5))) - var(--xh-control-target-min)) / 2)
+    );
+  }
+
+  .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical']
+    > .xh-scope-carousel[data-part='indicator']::after {
+    inset-inline: min(
+      calc(-1 * var(--xh-space-2)),
+      calc((var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5))) - var(--xh-control-target-min)) / 2)
+    );
+    inset-block: min(
+      calc(-1 * var(--xh-space-2)),
+      calc((var(--xh-carousel-indicator-size, var(--xh-space-1_5)) - var(--xh-control-target-min)) / 2)
+    );
+  }
+
+  .xh-scope-carousel[data-part='indicator']:hover:not([data-current]) {
+    background: var(--xh-carousel-indicator-bg-hover, var(--xh-fg-muted));
+  }
+
+  /* 按下：点的颜色再压一档，同时缩一下（同时换底）；指针按住由 :active 表出，
+     Space / Enter 与触屏按住由 Headless 投影 data-pressed，三种输入同一副面 */
+  .xh-scope-carousel[data-part='indicator']:is(:active, [data-pressed]):not([data-current]) {
+    background: var(--xh-carousel-indicator-bg-active, var(--xh-fg-default));
+    scale: var(--xh-motion-scale-press);
+    transition-duration: var(--xh-motion-duration-press);
+    transition-timing-function: var(--xh-motion-ease-press);
+  }
+
+  /* 悬停 / 按下的点是前景色阶梯上的两档（fg-muted → fg-default），落着焦点时默认环压在这块前景色的点上
+     没有对比（浅色档悬停面 neutral-500 与环 brand-600 同一明度，深色档按下面就是白点）；
+     环取这块面配对的那支——前景色的配对面是画布色，与实心面取配对前景同一口径 */
+  .xh-scope-carousel[data-part='indicator']:not([data-current]):is(:hover, :active, [data-pressed]):focus-visible {
+    --xh-_ring-color: var(--xh-bg-canvas);
+  }
+
+  /* 当前页：data-current 与 aria-current='true' 由连接层成对给出，
+     样式挂在 data 钩子上，无障碍语义留给 aria，两边各司其职。
+     拉长成胶囊并换品牌色（格状当前 = 实心品牌） */
+  .xh-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));
+  }
+
+  /* 没开自动播放：整颗品牌胶囊。面是品牌实心，环色与面同族画在面里看不出来：
+     环取面配对的前景色（聚焦规则灌 currentColor）。两条都带「没开自动播放」的祖先条件，
+     与下面自动播放那一档互斥，环色只灌给实心那一档 */
+  .xh-scope-carousel[data-part='root']:not([data-autoplay], [data-paused])
+    .xh-scope-carousel[data-part='indicator'][data-current] {
+    background: var(--xh-carousel-indicator-bg-selected, var(--xh-bg-brand));
+    color: var(--xh-carousel-indicator-fg-selected, var(--xh-fg-on-brand));
+  }
+
+  .xh-scope-carousel[data-part='root']:not([data-autoplay], [data-paused])
+    .xh-scope-carousel[data-part='indicator'][data-current]:focus-visible {
+    --xh-_ring-color: currentColor;
+  }
+
+  .xh-scope-carousel[data-part='indicator'][data-current]:is(:active, [data-pressed]) {
+    background: var(--xh-carousel-indicator-bg-selected-active, var(--xh-bg-brand-active));
+    scale: var(--xh-motion-scale-press);
+    transition-duration: var(--xh-motion-duration-press);
+    transition-timing-function: var(--xh-motion-ease-press);
+  }
+
+  /* 自动播放的进度：胶囊是品牌淡底当轨道（仍是「当前」语义；淡底上公共环够对比，不灌环色），
+     品牌填充条从起点沿轨道方向长满这一页的时长。计时器每次恢复都重计一整个间隔，
+     进度条跟它同一口径：暂停时回到起点，恢复时从头走。
+     填充条铺满胶囊、自己带同一副圆角，未走的那一截由 clip-path 从行尾（纵轨从下沿）裁掉，裁口也取圆角：
+     不缩放就不会把圆头压扁，也不用点的盒子来裁——盒子一裁，细指针外扩的命中区跟着被裁掉 */
+  .xh-scope-carousel[data-part='root'][data-autoplay]
+    .xh-scope-carousel[data-part='indicator'][data-current],
+  .xh-scope-carousel[data-part='root'][data-paused]
+    .xh-scope-carousel[data-part='indicator'][data-current] {
+    background: var(--xh-carousel-indicator-bg-track, var(--xh-bg-brand-subtle));
+  }
+
+  .xh-scope-carousel[data-part='root'][data-autoplay]
+    .xh-scope-carousel[data-part='indicator'][data-current]::before,
+  .xh-scope-carousel[data-part='root'][data-paused]
+    .xh-scope-carousel[data-part='indicator'][data-current]::before {
+    --xh-_carousel-progress-radius: var(--xh-carousel-indicator-radius-current, var(--xh-shape-pill));
+
+    content: '';
+    position: absolute;
+    inset: 0;
+    border-radius: var(--xh-_carousel-progress-radius);
+    background: var(--xh-carousel-indicator-bg-selected, var(--xh-bg-brand));
+    animation: xh-carousel-indicator-progress var(--xh-_carousel-autoplay-duration) var(--xh-motion-ease-loop) both;
+  }
+
+  .xh-scope-carousel[data-part='root'][data-paused]
+    .xh-scope-carousel[data-part='indicator'][data-current]::before {
+    animation: none;
+    clip-path: inset(var(--xh-_carousel-progress-cut) round var(--xh-_carousel-progress-radius));
+  }
+
+  /* 纵轨：胶囊沿块轴拉长，进度条从上往下长 */
+  .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical']
+    > .xh-scope-carousel[data-part='indicator'] {
+    inline-size: var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5)));
+    block-size: var(--xh-carousel-indicator-size, var(--xh-space-1_5));
+  }
+
+  .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical']
+    > .xh-scope-carousel[data-part='indicator'][data-current] {
+    inline-size: var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5)));
+    block-size: var(--xh-carousel-indicator-size-current, var(--xh-space-5));
+  }
+
+  .xh-scope-carousel[data-part='root'][data-orientation='vertical']
+    > :is([data-part='prev-trigger'], [data-part='next-trigger']):where(.xh-scope-carousel) {
+    inset-inline-start: 50%;
+    inset-inline-end: auto;
+    translate: -50% 0;
+    rotate: 90deg;
+  }
+
+  .xh-scope-carousel[data-part='root'][data-orientation='vertical']
+    > :is([data-part='prev-trigger'], [data-part='next-trigger']):where(.xh-scope-carousel):dir(rtl) {
+    translate: 50% 0;
+  }
+
+  /* 纵轨的翻页钮整颗转了 90°，形变会跟着转到错的方向，这一档不挂 */
+  :where([data-material='liquid']) .xh-scope-carousel[data-part='root'][data-orientation='vertical']
+    > :is([data-part='prev-trigger'], [data-part='next-trigger']):where(.xh-scope-carousel)[data-xh-liquid] {
+    transform: none;
+  }
+
+  .xh-scope-carousel[data-part='root'][data-orientation='vertical']
+    > [data-part='prev-trigger']:where(.xh-scope-carousel) {
+    inset-block-start: var(--xh-carousel-control-inset, var(--xh-space-3));
+  }
+
+  .xh-scope-carousel[data-part='root'][data-orientation='vertical']
+    > [data-part='next-trigger']:where(.xh-scope-carousel) {
+    inset-block-start: auto;
+    inset-block-end: var(--xh-carousel-control-inset, var(--xh-space-3));
+  }
+
+  /* 减少动效：位移立刻到位。翻页本身照常发生，只是不再有滑动的过程。
+     两条规则是同一件事的两个触发条件：系统偏好与作者打的 data-motion */
+  @media (prefers-reduced-motion: reduce) {
+    .xh-scope-carousel[data-part='list'] {
+      transition: none;
+    }
+
+    .xh-scope-carousel[data-part='indicator'][data-current]::before {
+      animation: none;
+      clip-path: none;
+    }
+  }
+
+  :where([data-motion='reduce']) .xh-scope-carousel[data-part='list'] {
+    transition: none;
+  }
+
+  :where([data-motion='reduce']) .xh-scope-carousel[data-part='indicator'][data-current]::before {
+    animation: none;
+    clip-path: none;
+  }
+
+  @media (forced-colors: active) {
+    .xh-scope-carousel[data-part='indicator'],
+    .xh-scope-carousel[data-part='indicator']::after {
+      background: GrayText;
+      forced-color-adjust: none;
+    }
+
+    .xh-scope-carousel[data-part='indicator'][data-current],
+    .xh-scope-carousel[data-part='indicator'][data-current]::after,
+    .xh-scope-carousel[data-part='indicator'][data-current]::before {
+      background: Highlight;
+      forced-color-adjust: none;
+    }
+
+    /* 自动播放时轨道退回画布色、描一圈 Highlight 边，进度条仍是 Highlight：走没走在动由描边与填充的差表出 */
+    .xh-scope-carousel[data-part='root'][data-autoplay]
+      .xh-scope-carousel[data-part='indicator'][data-current],
+    .xh-scope-carousel[data-part='root'][data-paused]
+      .xh-scope-carousel[data-part='indicator'][data-current],
+    .xh-scope-carousel[data-part='root'][data-autoplay]
+      .xh-scope-carousel[data-part='indicator'][data-current]::after,
+    .xh-scope-carousel[data-part='root'][data-paused]
+      .xh-scope-carousel[data-part='indicator'][data-current]::after {
+      border: var(--xh-stroke-thin) solid Highlight;
+      background: Canvas;
+    }
+
+    /* 按下：常态靠底色再压一档并缩一下表出，这一档里底色被钉成系统色、缩放又看不出来；
+       描一圈系统前景色把按住那一下画回来，粗指针下点画在 ::after 上，同一圈描到它身上 */
+    .xh-scope-carousel[data-part='indicator']:is(:active, [data-pressed]),
+    .xh-scope-carousel[data-part='indicator']:is(:active, [data-pressed])::after {
+      border: var(--xh-stroke-thin) solid CanvasText;
+    }
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  .xh-scope-carousel[data-part='prev-trigger']: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-left) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-left) center / contain no-repeat;
+  }
+
+  .xh-scope-carousel[data-part='next-trigger']: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-right) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
+  }
+
+  /* 播放开关的字形随状态换：正在播画暂停、停着画播放，与按钮名字指的是同一个动作 */
+  .xh-scope-carousel[data-part='autoplay-trigger'][data-state='running']: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-pause) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-pause) center / contain no-repeat;
+  }
+
+  .xh-scope-carousel[data-part='autoplay-trigger'][data-state='paused']: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-play) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-play) center / contain no-repeat;
+  }
+
+  /* 手指落点：三颗钮的 44px 命中区由配方的 ::after 给（floating 档）。
+     分页点的视觉仍是 6 / 20px，按钮盒改成首尾相接的 44px 分区：直接用负 inset 外扩会让相邻页的命中区重叠，
+     落点归属取决于绘制顺序；这里让真实按钮盒承担命中，点与进度条改由伪元素画在盒子中央 */
+  @media (pointer: coarse) {
+    .xh-scope-carousel[data-part='indicator-group'] {
+      gap: 0;
+    }
+
+    /* 盒子只管命中：四个状态的底色都从盒子上撤下来，落到 ::after 画的点上 */
+    .xh-scope-carousel[data-part='indicator'],
+    .xh-scope-carousel[data-part='indicator']:hover:not([data-current]),
+    .xh-scope-carousel[data-part='indicator']:is(:active, [data-pressed]):not([data-current]),
+    .xh-scope-carousel[data-part='indicator'][data-current],
+    .xh-scope-carousel[data-part='indicator'][data-current]:is(:active, [data-pressed]),
+    .xh-scope-carousel[data-part='root']:not([data-autoplay], [data-paused])
+      .xh-scope-carousel[data-part='indicator'][data-current],
+    .xh-scope-carousel[data-part='root'][data-autoplay]
+      .xh-scope-carousel[data-part='indicator'][data-current],
+    .xh-scope-carousel[data-part='root'][data-paused]
+      .xh-scope-carousel[data-part='indicator'][data-current] {
+      min-inline-size: var(--xh-carousel-indicator-target-size, 44px);
+      min-block-size: var(--xh-carousel-indicator-target-size, 44px);
+      border-radius: 0;
+      background: transparent;
+    }
+
+    .xh-scope-carousel[data-part='indicator']::after {
+      inset: auto;
+      inset-block-start: 50%;
+      inset-inline-start: 50%;
+      inline-size: var(--xh-carousel-indicator-size, var(--xh-space-1_5));
+      block-size: var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5)));
+      border-radius: var(--xh-carousel-indicator-radius, var(--xh-shape-circle));
+      background: var(--xh-carousel-indicator-bg, var(--xh-bg-subtle-hover-opaque));
+      translate: -50% -50%;
+      /* 当前点伸长是跨尺寸的换位（move），与细指针下盒子本身的伸长同一档 */
+      transition:
+        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);
+    }
+
+    .xh-scope-carousel[data-part='indicator']:dir(rtl)::after {
+      translate: 50% -50%;
+    }
+
+    .xh-scope-carousel[data-part='indicator']:is(:active, [data-pressed]):not([data-current])::after {
+      background: var(--xh-carousel-indicator-bg-active, var(--xh-fg-default));
+    }
+
+    .xh-scope-carousel[data-part='indicator'][data-current]::after {
+      inline-size: var(--xh-carousel-indicator-size-current, var(--xh-space-5));
+      border-radius: var(--xh-carousel-indicator-radius-current, var(--xh-shape-pill));
+    }
+
+    .xh-scope-carousel[data-part='root']:not([data-autoplay], [data-paused])
+      .xh-scope-carousel[data-part='indicator'][data-current]::after {
+      background: var(--xh-carousel-indicator-bg-selected, var(--xh-bg-brand));
+    }
+
+    .xh-scope-carousel[data-part='indicator'][data-current]:is(:active, [data-pressed])::after {
+      background: var(--xh-carousel-indicator-bg-selected-active, var(--xh-bg-brand-active));
+    }
+
+    .xh-scope-carousel[data-part='root'][data-autoplay]
+      .xh-scope-carousel[data-part='indicator'][data-current]::after,
+    .xh-scope-carousel[data-part='root'][data-paused]
+      .xh-scope-carousel[data-part='indicator'][data-current]::after {
+      background: var(--xh-carousel-indicator-bg-track, var(--xh-bg-brand-subtle));
+    }
+
+    /* 进度条落到点的那块盒上，跟 ::after 画的胶囊同位同形 */
+    .xh-scope-carousel[data-part='root'][data-autoplay]
+      .xh-scope-carousel[data-part='indicator'][data-current]::before,
+    .xh-scope-carousel[data-part='root'][data-paused]
+      .xh-scope-carousel[data-part='indicator'][data-current]::before {
+      inset: auto;
+      inset-block-start: 50%;
+      inset-inline-start: 50%;
+      z-index: 1;
+      inline-size: var(--xh-carousel-indicator-size-current, var(--xh-space-5));
+      block-size: var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5)));
+      border-radius: var(--xh-carousel-indicator-radius-current, var(--xh-shape-pill));
+      translate: -50% -50%;
+    }
+
+    .xh-scope-carousel[data-part='root'][data-autoplay]
+      .xh-scope-carousel[data-part='indicator'][data-current]:dir(rtl)::before,
+    .xh-scope-carousel[data-part='root'][data-paused]
+      .xh-scope-carousel[data-part='indicator'][data-current]:dir(rtl)::before {
+      translate: 50% -50%;
+    }
+
+    /* 纵轨：细指针那条按轨道方向外扩命中区的规则更具体，这里把点的定位一并收回到居中 */
+    .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical']
+      > .xh-scope-carousel[data-part='indicator']::after {
+      inset: auto;
+      inset-block-start: 50%;
+      inset-inline-start: 50%;
+      inline-size: var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5)));
+      block-size: var(--xh-carousel-indicator-size, var(--xh-space-1_5));
+    }
+
+    .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical']
+      > .xh-scope-carousel[data-part='indicator'][data-current]::after,
+    .xh-scope-carousel[data-part='root'][data-autoplay]
+      .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical']
+      > .xh-scope-carousel[data-part='indicator'][data-current]::before,
+    .xh-scope-carousel[data-part='root'][data-paused]
+      .xh-scope-carousel[data-part='indicator-group'][data-orientation='vertical']
+      > .xh-scope-carousel[data-part='indicator'][data-current]::before {
+      inline-size: var(--xh-carousel-indicator-thickness, var(--xh-carousel-indicator-size, var(--xh-space-1_5)));
+      block-size: var(--xh-carousel-indicator-size-current, var(--xh-space-5));
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-carousel:is([data-part='prev-trigger'], [data-part='next-trigger']):empty::before,
+    .xh-scope-carousel[data-part='autoplay-trigger'][data-state='running']:empty::before,
+    .xh-scope-carousel[data-part='autoplay-trigger'][data-state='paused']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-carousel:is([data-part='prev-trigger'], [data-part='next-trigger']):not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before,
+    .xh-scope-carousel[data-part='autoplay-trigger'][data-state='running']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before,
+    .xh-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;
+    }
+
+    .xh-scope-carousel:is([data-part='prev-trigger'], [data-part='next-trigger'])[data-disabled]:empty::before,
+    .xh-scope-carousel[data-part='autoplay-trigger'][data-state='running'][data-disabled]:empty::before,
+    .xh-scope-carousel[data-part='autoplay-trigger'][data-state='paused'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}
+
+@layer xihan.motion {
+  /* 进度条从整条裁掉长到整条露出：只重绘、不重排，裁口取填充条自己的圆角 */
+  @keyframes xh-carousel-indicator-progress {
+    from {
+      clip-path: inset(var(--xh-_carousel-progress-cut) round var(--xh-_carousel-progress-radius));
+    }
+
+    to {
+      clip-path: inset(0 round var(--xh-_carousel-progress-radius));
+    }
+  }
+}