@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/popover.css

@@ -0,0 +1,285 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 popover 样式。 */
+
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立。 */
+@import '../family/motion.css';
+@import '../family/action-control.css';
+@import '../family/material.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-popover {
+    --xh-popover-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  .xh-scope-popover[data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，内容层继承它限高；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时不额外限高 */
+    --xh-_popover-available-h: 100vh;
+    /* 落定那一侧的可用宽度，同样由定位引擎经内联自定义属性写进来，行内轴据此夹取；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时退到视口宽 */
+    --xh-_popover-available-w: 100vw;
+
+    /* 面板内容的自绘条浮在内容之上：轨道不上底色，实色轨道会在面板右缘糊一条竖灰带 */
+    --xh-scrollbar-track-bg: transparent;
+
+    position: fixed;
+    z-index: var(--xh-popover-layer, var(--xh-_layer, var(--xh-layer-popover)));
+    /* 空壳不吃指针，交互只发生在 content 上 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  .xh-scope-popover[data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 缩放原点与进场位移按落定的那一侧给：面板从贴着锚点的那条边涨开、沿主轴退让一小段。
+     两个槽由 content 继承。placement 是物理方向（引擎按 top / right / bottom / left 出值），
+     origin 与 translate 也是物理量，两边同轴，不随书写方向翻 */
+  .xh-scope-popover[data-part='positioner'][data-placement^='top'] {
+    --xh-_overlay-origin-y: 100%;
+    --xh-_overlay-enter-down: 1;
+  }
+
+  .xh-scope-popover[data-part='positioner'][data-placement^='bottom'] {
+    --xh-_overlay-origin-y: 0;
+    --xh-_overlay-enter-up: 1;
+  }
+
+  .xh-scope-popover[data-part='positioner'][data-placement^='left'] {
+    --xh-_overlay-origin-x: 100%;
+    --xh-_overlay-enter-right: 1;
+  }
+
+  .xh-scope-popover[data-part='positioner'][data-placement^='right'] {
+    --xh-_overlay-origin-x: 0;
+    --xh-_overlay-enter-left: 1;
+  }
+
+  /* 交叉轴原点按对齐取：start / end 对齐时面板与锚点在那一端齐平，缩放从那一端涨开，贴着小触发器的面板
+     才像是从触发器里长出来；居中对齐留在中线。上下两侧的 start / end 是行内轴上的逻辑对齐，RTL 下起始缘在右；
+     左右两侧的 start / end 落在块轴上，不随书写方向翻 */
+  /* 起始缘与末尾缘按就近的书写方向取：LTR 起始在左，RTL 起始在右 */
+  .xh-scope-popover[data-part='positioner']:is([data-placement='top-start'], [data-placement='bottom-start']) {
+    --xh-_overlay-origin-x: var(--xh-direction-start);
+  }
+
+  .xh-scope-popover[data-part='positioner']:is([data-placement='top-end'], [data-placement='bottom-end']) {
+    --xh-_overlay-origin-x: var(--xh-direction-end);
+  }
+
+  .xh-scope-popover[data-part='positioner']:is([data-placement='left-start'], [data-placement='right-start']) {
+    --xh-_overlay-origin-y: 0;
+  }
+
+  .xh-scope-popover[data-part='positioner']:is([data-placement='left-end'], [data-placement='right-end']) {
+    --xh-_overlay-origin-y: 100%;
+  }
+
+  /*
+   * 触发器是页面上的独立文字按钮：盒型、md 档几何、outline 四态面、0.97 按压并换底与粗指针命中区
+   * 由家族配方按连接层投影的 data-xh-action-variant / -size 给出。皮肤没有自己的外观规则，
+   * 只把作者塞进按钮的图标接到随档字形尺（md = 20px）。
+   */
+  .xh-scope-popover[data-part='trigger'] {
+    --xh-icon-size: var(--xh-popover-icon-size, var(--xh-_action-profile-glyph-size));
+  }
+
+  /* 家族配方给了 display，作者手写 hidden 时得把 UA 的 [hidden]{display:none} 还回去 */
+  .xh-scope-popover[data-part='trigger'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-popover[data-part='content'] {
+    /* 材质由家族配方画（family/material.css 的 frosted 面：描边、底、1px 顶光、前景、投影与背景滤镜），
+       这里只把使用者槽接进来 */
+    --xh-frosted-bg: var(--xh-popover-bg, var(--xh-_material-bg));
+    --xh-frosted-border: var(--xh-popover-border, var(--xh-_material-border));
+    --xh-frosted-fg: var(--xh-popover-fg, var(--xh-_material-fg));
+    --xh-frosted-shadow: var(--xh-popover-shadow, var(--xh-_material-shadow));
+    --xh-frosted-backdrop: var(--xh-popover-backdrop, var(--xh-_material-backdrop));
+
+    /* 作者塞进面板里的图标按控件档取；关闭钮另由家族配方按 sm 档下发字形尺 */
+    --xh-icon-size: var(--xh-popover-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸档只换这三个私有槽。popover 没有 root 部件，size 落在浮层树最外层的 content 上。
+       横向内衬比纵向高一档（缺省纵 12 横 16）。语气不接：面板是内容容器，语气该由里面的内容表达 */
+    --xh-_popover-py: var(--xh-surface-pad-md);
+    --xh-_popover-px: var(--xh-surface-pad-lg);
+    --xh-_popover-max-w: var(--xh-overlay-max-w);
+
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    /* 标题与正文贴着排：两行之间只留 4px */
+    gap: var(--xh-popover-gap, var(--xh-space-1));
+    inline-size: max-content;
+    /* 静态档与落位后的可用宽度取小：窄视口下面板伸出去，最右侧的内容就点不到了 */
+    max-inline-size: min(var(--xh-popover-max-w, var(--xh-_popover-max-w)), var(--xh-_popover-available-w));
+    /* 内容由作者给，长度不可预知：不限高就整块伸出视口且滚不到 */
+    max-block-size: min(var(--xh-popover-max-h, var(--xh-overlay-max-h)), var(--xh-_popover-available-h));
+    overflow-y: auto;
+    /* 浮在页面之上的 Overlay 滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
+    padding-block: var(--xh-popover-py, var(--xh-_popover-py));
+    padding-inline: var(--xh-popover-px, var(--xh-_popover-px));
+    border-radius: var(--xh-popover-radius, var(--xh-shape-overlay));
+    pointer-events: auto;
+    /* 进退场的缩放锚在贴着锚点的那条边上；两个分量由 positioner 按 placement 写进私有槽 */
+    transform-origin: var(--xh-_overlay-origin-x, 50%) var(--xh-_overlay-origin-y, 50%);
+  }
+
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 dialog 一致：
+     收起态连接层会给 content 打 hidden，而上面那条 display 正是要盖掉 UA 的
+     [hidden]{display:none}——退场动画得先能播。presence 读的是 content 的 animationName，
+     真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
+     其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
+
+  .xh-scope-popover[data-part='content']:focus-visible {
+    outline: none;
+  }
+
+  /* 挂载时就开着的那一段（data-instant）属于首帧，直接呈现 */
+  .xh-scope-popover[data-part='content'][data-state='open']:not([data-instant]) {
+    animation: xh-overlay-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 退场:收起那一帧 hidden 由退场闸门押后,这里才播得出来。forwards 把末态钉住,
+     免得动画结束到 hidden 落下来之间闪一下原样 */
+  .xh-scope-popover[data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在 content 的基础规则里；内衬三档取 surface-pad 那把尺，横向始终比纵向高一档 */
+  .xh-scope-popover[data-part='content'][data-size='sm'] {
+    --xh-_popover-py: var(--xh-surface-pad-sm);
+    --xh-_popover-px: var(--xh-surface-pad-md);
+    --xh-_popover-max-w: var(--xh-overlay-max-w-sm);
+  }
+
+  .xh-scope-popover[data-part='content'][data-size='lg'] {
+    --xh-_popover-py: var(--xh-surface-pad-lg);
+    --xh-_popover-px: var(--xh-surface-pad-xl);
+    --xh-_popover-max-w: var(--xh-overlay-max-w-lg);
+  }
+
+  /* 气泡标题：14px / medium / 正文色 */
+  .xh-scope-popover[data-part='title'] {
+    margin: 0;
+    font-size: var(--xh-popover-title-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-popover-title-font-weight, var(--xh-font-weight-medium));
+    color: var(--xh-popover-title-fg, var(--xh-material-frosted-fg));
+  }
+
+  /* 说明就是气泡的正文：14px 正文字号 + fg-muted 次级色 */
+  .xh-scope-popover[data-part='description'] {
+    margin: 0;
+    font-size: var(--xh-popover-description-font-size, var(--xh-text-body-size));
+    line-height: var(--xh-leading-normal);
+    color: var(--xh-popover-description-fg, var(--xh-fg-muted));
+  }
+
+  /* 关闭按钮是绝对定位的，不占流内宽度：标题得自己让出右上角那块，
+     否则长标题会直接钻到按钮底下。只在真有关闭按钮时让位。 */
+  .xh-scope-popover[data-part='content']:has(.xh-scope-popover[data-part='close-trigger'])
+    .xh-scope-popover[data-part='title'] {
+    padding-inline-end: calc(var(--xh-popover-close-size, var(--xh-control-h-sm)) + var(--xh-space-2));
+  }
+
+  /*
+   * 关闭钮是浮层角落的单图标钮：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
+   * 由家族配方给出——磨砂白面上走画布承载阶梯悬停 --xh-bg-subtle（100）→ 按下 --xh-bg-subtle-hover（200），
+   * 焦点面透明吃库环。这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与摆放，
+   * 聚焦档的 -bg-focus / -fg-focus 两槽同样桥到配方的 focus-visible 面，缺省仍是透明底与悬停字色：
+   * 贴边比 dialog 一族的面板档（--xh-surface-action-inset）小一档：气泡的面板内衬是 12px，
+   * 28px 的钮按 12px 贴边会伸出面板自己的盒子，被 content 的 overflow 裁掉。
+   * 静息前景取磨砂面的 muted 字色，悬停 / 按下回到 fg-default。
+   */
+  .xh-scope-popover[data-part='close-trigger'] {
+    --xh-action-visual-size: var(--xh-popover-close-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-popover-close-radius, var(--xh-shape-control));
+    --xh-action-bg-hover: var(--xh-popover-close-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-popover-close-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-bg-focus-visible: var(--xh-popover-close-bg-focus, var(--xh-_action-variant-bg-focus-visible));
+    --xh-action-fg-rest: var(--xh-popover-close-fg, var(--xh-material-frosted-fg-muted));
+    --xh-action-fg-hover: var(--xh-popover-close-fg-hover, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-popover-close-fg-hover, var(--xh-_action-variant-fg-pressed));
+    --xh-action-fg-focus-visible: var(--xh-popover-close-fg-focus, var(--xh-popover-close-fg-hover, var(--xh-_action-variant-fg-focus-visible)));
+    /* 作者塞进按钮的图标随档取字形尺（sm = 16px），与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-popover-icon-size, var(--xh-_action-profile-glyph-size));
+
+    position: absolute;
+    inset-block-start: var(--xh-space-2);
+    inset-inline-end: var(--xh-space-2);
+  }
+
+  .xh-scope-popover[data-part='close-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 箭头的底色与描边色，几何在 overlay-arrow.css。
+     交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中 */
+  .xh-scope-popover[data-part='arrow'] {
+    --xh-_popover-arrow-x: 50%;
+    --xh-_popover-arrow-y: 50%;
+    --xh-_overlay-arrow-size: var(--xh-popover-arrow-size, var(--xh-overlay-arrow-size));
+    --xh-_overlay-arrow-x: var(--xh-_popover-arrow-x);
+    --xh-_overlay-arrow-y: var(--xh-_popover-arrow-y);
+
+    background: var(--xh-popover-bg, var(--xh-material-frosted-bg));
+    border: var(--xh-stroke-thin) solid var(--xh-popover-border, var(--xh-material-frosted-border));
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  .xh-scope-popover[data-part='close-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-close) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+  }
+
+  @media (forced-colors: active) {
+    /* 系统色接管边界与正文；装饰顶光在这一档没有信息价值，明确撤掉背景图层。 */
+    .xh-scope-popover[data-part='content'] {
+      background-image: none;
+    }
+  }
+
+  @media print {
+    /* 打印：定位层与遮罩是交互期才存在的东西，落到纸上只会盖住底下的正文。
+       收起写在这份皮肤里而不是 reset：reset 层排在组件层之前，组件层里任何一条 display 都压得住它。 */
+    .xh-scope-popover[data-part='positioner'] {
+      display: none;
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-popover[data-part='close-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-popover[data-part='close-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-popover[data-part='close-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}