@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/context-menu.css

@@ -0,0 +1,425 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 context menu 样式。 */
+
+/* 共享关键帧由 family/motion.css 提供，条目走 Collection Item 家族；本皮肤 @import 它们，单独引入仍成立。 */
+@import '../family/collection-item.css';
+@import '../family/menu-choice.css';
+@import '../family/motion.css';
+@import '../family/material.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-context-menu {
+    --xh-context-menu-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  .xh-scope-context-menu[data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，content 继承它限高；
+       引擎没算（尚未落位 / 无引擎）时不额外限高 */
+    --xh-_context-menu-available-h: 100vh;
+    /* 落定那一侧的可用宽度，同样由定位引擎经内联自定义属性写进来，行内轴据此夹取；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时退到视口宽 */
+    --xh-_context-menu-available-w: 100vw;
+    /* WC 子菜单仍在父层 DOM 内；先截断父 positioner 的方向，再按本层 placement 开一侧。 */
+    --xh-_overlay-enter-up: 0;
+    --xh-_overlay-enter-down: 0;
+    --xh-_overlay-enter-left: 0;
+    --xh-_overlay-enter-right: 0;
+
+    /* 条目列表的自绘条浮在内容之上：轨道不上底色，实色轨道会在菜单右缘糊一条竖灰带 */
+    --xh-scrollbar-track-bg: transparent;
+
+    position: fixed;
+    z-index: var(--xh-context-menu-layer, var(--xh-_layer, var(--xh-layer-popover)));
+    /* 空壳不吃指针，交互只发生在 content 上 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  .xh-scope-context-menu[data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 物理 placement 与定位引擎同口径，不随书写方向翻转。 */
+  .xh-scope-context-menu[data-part='positioner'][data-placement^='top'] {
+    --xh-_overlay-enter-down: 1;
+  }
+
+  .xh-scope-context-menu[data-part='positioner'][data-placement^='bottom'] {
+    --xh-_overlay-enter-up: 1;
+  }
+
+  .xh-scope-context-menu[data-part='positioner'][data-placement^='left'] {
+    --xh-_overlay-enter-right: 1;
+  }
+
+  .xh-scope-context-menu[data-part='positioner'][data-placement^='right'] {
+    --xh-_overlay-enter-left: 1;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  .xh-scope-context-menu:is([data-part='root'], [data-part='positioner']) {
+    /* 条目外的字形（分组标题等）按档取尺，缺省 md，随 data-size 换档；同样声明在 positioner 上，被搬走的浮层
+       才拿得到；条目里作者放的图标由家族随 data-xh-collection-size 下发。菜单自绘的状态字形（标记位的盒、
+       盒里兜底的勾、子菜单的展开 chevron）不读这支：它们是指示符，走 --xh-control-indicator-* 一族——标记位在
+       自己身上把 --xh-icon-size 改接到盒的尺，子菜单箭头走 --xh-context-menu-submenu-indicator-size */
+    --xh-icon-size: var(--xh-context-menu-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸档只换这四个私有槽，条目与分组标题都从这两处继承它们，
+       换档不必给每个部件各写一条选择器 */
+    --xh-_context-menu-item-py: var(--xh-list-option-py-md);
+    --xh-_context-menu-item-h: var(--xh-list-option-h-md);
+    --xh-_context-menu-item-px: var(--xh-control-px-md);
+    --xh-_context-menu-item-gap: var(--xh-control-gap-md);
+    --xh-_context-menu-font-size: var(--xh-control-font-md);
+
+  }
+
+  /* 根只是把触发区与浮层圈在一起做作用域，不该在作者布局里多插一层盒子 */
+  .xh-scope-context-menu[data-part='root'] {
+    display: contents;
+  }
+
+  .xh-scope-context-menu[data-part='content'] {
+    /* 材质由家族配方画（family/material.css 的 frosted 面：描边、底、1px 顶光、前景、投影与背景滤镜），
+       这里只把使用者槽接进来 */
+    --xh-frosted-bg: var(--xh-context-menu-content-bg, var(--xh-_material-bg));
+    --xh-frosted-border: var(--xh-context-menu-border, var(--xh-_material-border));
+    --xh-frosted-fg: var(--xh-context-menu-content-fg, var(--xh-_material-fg));
+    --xh-frosted-shadow: var(--xh-context-menu-content-shadow, var(--xh-_material-shadow));
+    --xh-frosted-backdrop: var(--xh-context-menu-backdrop, var(--xh-_material-backdrop));
+    --xh-frosted-highlight: var(--xh-context-menu-highlight, var(--xh-_material-highlight));
+
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-context-menu-content-gap, var(--xh-list-option-gap));
+    min-inline-size: var(--xh-context-menu-min-w, var(--xh-overlay-menu-min-w));
+    /* 静态档与落位后的可用宽度取小：窄视口下面板伸出去，最右侧的内容就点不到了 */
+    max-inline-size: min(var(--xh-context-menu-max-w, var(--xh-overlay-max-w)), var(--xh-_context-menu-available-w));
+    /* 两道上限取更小的那道：自己的高度上限，以及落定那一侧真正剩下的空间。 */
+    max-block-size: min(var(--xh-context-menu-max-h, var(--xh-overlay-menu-max-h)), var(--xh-_context-menu-available-h));
+    padding-block: var(--xh-context-menu-content-py, var(--xh-surface-pad-xs));
+    padding-inline: var(--xh-context-menu-content-px, 0);
+    border-radius: var(--xh-context-menu-content-radius, var(--xh-shape-overlay));
+    /* 条目超过上限就在菜单内部滚；内收焦点环不会被内边距缘裁掉。
+       浮层滚动面：到底后不把滚动链穿透给页面 */
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    pointer-events: auto;
+  }
+
+  .xh-scope-context-menu[data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里。条目高度由 padding 撑出来：
+     纵向走 space 档、行内内缩走 control-px 档（随密度轴），换档各挪一级 */
+  .xh-scope-context-menu:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
+    --xh-icon-size: var(--xh-context-menu-icon-size, var(--xh-glyph-size-sm));
+    --xh-_context-menu-item-py: var(--xh-list-option-py-sm);
+    --xh-_context-menu-item-h: var(--xh-list-option-h-sm);
+    --xh-_context-menu-item-px: var(--xh-control-px-sm);
+    --xh-_context-menu-item-gap: var(--xh-control-gap-sm);
+    --xh-_context-menu-font-size: var(--xh-control-font-sm);
+  }
+
+  .xh-scope-context-menu:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
+    --xh-icon-size: var(--xh-context-menu-icon-size, var(--xh-glyph-size-lg));
+    --xh-_context-menu-item-py: var(--xh-list-option-py-lg);
+    --xh-_context-menu-item-h: var(--xh-list-option-h-lg);
+    --xh-_context-menu-item-px: var(--xh-control-px-lg);
+    --xh-_context-menu-item-gap: var(--xh-control-gap-lg);
+    --xh-_context-menu-font-size: var(--xh-control-font-lg);
+  }
+
+  /* 触发区是作者自己的一块内容，尺寸与排布归他；这里只管交互观感：
+     长按会先选中区域内的文字，长按菜单弹出时手指底下是一片高亮，很难看 */
+  .xh-scope-context-menu[data-part='trigger'] {
+    user-select: none;
+    transition: background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 触屏没有右键，菜单靠长按计时打开。这段等待里若一点变化都没有，用户会当成没按上而提前
+     抬手，计时被抬手事件掐掉，菜单永远打不开。压一档中性轻底当「按住了，接着按」的回执。
+     只换底色不缩放：触发区是作者的整块内容，缩放它会把作者自己的排版一起抖起来 */
+  .xh-scope-context-menu[data-part='trigger'][data-pressing] {
+    background: var(--xh-context-menu-trigger-bg-pressing, var(--xh-bg-subtle));
+  }
+
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 dialog 一致：
+     收起态连接层会给 content 打 hidden，而上面那条 display 正是要盖掉 UA 的
+     [hidden]{display:none}——退场动画得先能播。presence 读的是 content 的 animationName，
+     真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
+     其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
+
+  /* 空菜单自身接收键盘焦点时实际铺实体底，焦点环不依赖背后的图片。 */
+  .xh-scope-context-menu[data-part='content'][tabindex='0']:focus-visible {
+    background: var(--xh-material-frosted-focus-surface);
+  }
+
+  .xh-scope-context-menu[data-part='content'][tabindex='0']:focus-visible .xh-scope-context-menu[data-part='arrow'] {
+    background: var(--xh-material-frosted-focus-surface);
+  }
+
+  .xh-scope-context-menu[data-part='content']:not([tabindex='0']):focus-visible {
+    outline: none;
+  }
+
+  /* 首帧落位后从锚点一侧淡入短移，不缩放整张面。 */
+  /* 挂载时就开着的那一段（data-instant）属于首帧，直接呈现 */
+  .xh-scope-context-menu[data-part='content'][data-state='open']:not([data-instant]) {
+    animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
+     免得动画结束到真收起之间闪一下原样 */
+  .xh-scope-context-menu[data-part='content'][data-state='closed'] {
+    will-change: opacity, translate;
+    animation: xh-overlay-slide-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  }
+
+  .xh-scope-context-menu[data-part='group'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-context-menu-group-gap, var(--xh-list-option-gap));
+  }
+
+  .xh-scope-context-menu[data-part='group'][hidden] {
+    display: none;
+  }
+
+  /* 分组标题不是条目、进不了导航，画成小号常规字重的次要文字，上方让出 8px 与上一组分开；
+     内缩与条目对齐（同一个 padding-inline），标题与条目文字才在一条竖线上 */
+  .xh-scope-context-menu[data-part='group-label'] {
+    display: block;
+    margin-block-start: var(--xh-context-menu-group-label-mt, var(--xh-space-2));
+    padding-block: var(--xh-context-menu-group-label-py, var(--xh-space-1));
+    padding-inline: var(--xh-context-menu-group-label-px, var(--xh-_context-menu-item-px));
+    color: var(--xh-context-menu-group-label-fg, var(--xh-material-frosted-fg-muted));
+    font-size: var(--xh-context-menu-group-label-font-size, var(--xh-text-caption-size));
+    font-weight: var(--xh-context-menu-group-label-font-weight, var(--xh-font-weight-regular));
+    line-height: var(--xh-leading-none);
+    user-select: none;
+  }
+
+  .xh-scope-context-menu[data-part='group-label'][hidden] {
+    display: none;
+  }
+
+  /* 条目走 Collection Item 的 overlay 语境：悬停 / 键盘锚点（data-highlighted，白底承载 100）、按下（200）、
+     子层开着的打开路径（data-in-path，与 hover 同档）与禁用面（aria-disabled）都由家族给，这里只把公开槽映射到
+     桥接槽。布局保持 flex 而不用家族网格：图标、正文、快捷键按一行排布，说明另起一行靠 flex-wrap 折下去，
+     子菜单箭头是行尾的伪元素；间距统一由行的 gap 给，家族按槽下发的外边距归零 */
+  .xh-scope-context-menu[data-part='item'] {
+    --xh-collection-block-padding: var(--xh-context-menu-item-py, var(--xh-_context-menu-item-py));
+    --xh-collection-row-h: var(--xh-context-menu-item-h, var(--xh-_context-menu-item-h));
+    --xh-collection-inline-padding: var(--xh-context-menu-item-px, var(--xh-_context-menu-item-px));
+    --xh-collection-gap: 0;
+    --xh-collection-font-size: var(--xh-context-menu-item-font-size, var(--xh-_context-menu-font-size));
+    --xh-collection-radius: var(--xh-context-menu-item-radius, 0);
+    --xh-collection-fg-rest: var(--xh-context-menu-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-hover: var(--xh-context-menu-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-keyboard-highlight: var(--xh-context-menu-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-pressed: var(--xh-context-menu-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-open-path: var(--xh-context-menu-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-bg-hover: var(--xh-context-menu-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-keyboard-highlight: var(--xh-context-menu-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-pressed: var(--xh-context-menu-item-bg-pressed, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-open-path: var(--xh-context-menu-item-bg-active, var(--xh-bg-subtle));
+    /* data-highlighted 同时覆盖指针与键盘路径：指针只换面，焦点环在 :focus-visible 下再接回 */
+    --xh-collection-outline-keyboard-highlight: transparent;
+
+    display: flex;
+    align-items: center;
+    gap: var(--xh-context-menu-item-gap, var(--xh-_context-menu-item-gap));
+    line-height: var(--xh-context-menu-item-leading, var(--xh-leading-normal));
+    white-space: nowrap;
+    user-select: none;
+  }
+
+  /* 条目可以按需收起（按上下文过滤掉的命令），有 display 就得补这条 */
+  .xh-scope-context-menu[data-part='item'][hidden] {
+    display: none;
+  }
+
+  /* 键盘焦点出现时环才接回并立即到位，不压在背景过渡的中间帧上 */
+  .xh-scope-context-menu[data-part='item']:focus-visible:not(:hover) {
+    --xh-collection-outline-keyboard-highlight: var(--xh-ring-focus);
+
+    transition: none;
+  }
+
+  /* 子菜单箭头留在主行末端；description 即使写在它前面，也由 order 独占下一行。
+     箭头是指示符：与标记位的盒同走 --xh-control-indicator-size，不读 --xh-icon-size——
+     按图标档取的 20px 会比 16px 的标记位盒大一圈 */
+  .xh-scope-context-menu[data-part='item'][aria-haspopup='menu']::after {
+    content: '';
+    flex: none;
+    order: 1;
+    margin-inline-start: auto;
+    inline-size: var(--xh-context-menu-submenu-indicator-size, var(--xh-control-indicator-size));
+    block-size: var(--xh-context-menu-submenu-indicator-size, var(--xh-control-indicator-size));
+    background-color: var(--xh-context-menu-submenu-indicator-fg, currentColor);
+    -webkit-mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
+  }
+
+  /* rtl 下子菜单开在左侧，箭头跟着指向行进方向 */
+  [dir='rtl'] .xh-scope-context-menu[data-part='item'][aria-haspopup='menu']::after {
+    -webkit-mask-image: var(--xh-glyph-mark-chevron-left);
+    mask-image: var(--xh-glyph-mark-chevron-left);
+  }
+
+  .xh-scope-context-menu[data-part='item-text'] {
+    flex: 1;
+    min-inline-size: 0;
+    overflow: hidden;
+    white-space: nowrap;
+    text-overflow: ellipsis;
+  }
+
+  .xh-scope-context-menu[data-part='item-text'][hidden] {
+    display: none;
+  }
+
+  /* 标记位（勾选符号 / 图标）按作者写入的槽位留在主行，不为没写的条目强制占列。盒是指示符：按指示符档
+     取尺，与 Menu / Cascader 的标记位同走 --xh-control-indicator-size，不读家族按档下发的 --xh-icon-size——
+     按图标档取的 20px 会比同一行 16px 的指示符档大一圈。盒在自己身上把 --xh-icon-size 改接到盒的尺，
+     皮肤画的兜底勾与作者塞进标记位的 XhIcon 读同一把尺、与盒同边长（行尾标记不是勾选格，不取 × 0.75）；
+     条目上那支只管作者直接放进条目里的图标 */
+  .xh-scope-context-menu[data-part='item-indicator'] {
+    --xh-icon-size: var(--xh-context-menu-item-indicator-size, var(--xh-control-indicator-size));
+
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-context-menu-item-indicator-size, var(--xh-control-indicator-size));
+    block-size: var(--xh-context-menu-item-indicator-size, var(--xh-control-indicator-size));
+    color: var(--xh-context-menu-item-indicator-fg, var(--xh-_tone, var(--xh-fg-brand)));
+  }
+
+  .xh-scope-context-menu[data-part='item-indicator'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-context-menu[data-part='item-indicator'][data-disabled] {
+    color: var(--xh-fg-disabled);
+  }
+
+  /* 副文本另起一行：整行占满，把条目的一行内容折成两行 */
+  .xh-scope-context-menu[data-part='item-description'] {
+    flex: 1 0 100%;
+    order: 2;
+    min-inline-size: 0;
+    color: var(--xh-context-menu-item-description-fg, var(--xh-material-frosted-fg-muted));
+    /* 与同一行的快捷键、Select 等列表的说明同档：控件次级字号，不取 caption 令牌 */
+    font-size: var(--xh-context-menu-item-description-font-size, var(--xh-control-caption-md));
+    white-space: nowrap;
+    text-overflow: ellipsis;
+    overflow: hidden;
+  }
+
+  .xh-scope-context-menu[data-part='item-description'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-context-menu[data-part='item-description'][data-disabled] {
+    color: var(--xh-fg-disabled);
+  }
+
+  /* 没有说明时主行不允许无意换行；有说明才开启第二行。任意图标/快捷键仍保留作者的 DOM 顺序。 */
+  .xh-scope-context-menu[data-part='item']:has(
+    > .xh-scope-context-menu[data-part='item-description']
+  ) {
+    flex-wrap: wrap;
+  }
+
+  .xh-scope-context-menu[data-part='separator'] {
+    block-size: var(--xh-context-menu-separator-thickness, var(--xh-stroke-thin));
+    margin-block: var(--xh-context-menu-separator-my, var(--xh-space-0_5));
+    border-radius: var(--xh-context-menu-separator-radius, var(--xh-shape-pill));
+    background: var(--xh-context-menu-separator-color, var(--xh-material-frosted-separator));
+  }
+
+  .xh-scope-context-menu[data-part='separator'][hidden] {
+    display: none;
+  }
+
+  /* 箭头的底色与描边色，几何在 overlay-arrow.css。
+     交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中 */
+  .xh-scope-context-menu[data-part='arrow'] {
+    --xh-_context-menu-arrow-x: 50%;
+    --xh-_context-menu-arrow-y: 50%;
+    --xh-_overlay-arrow-size: var(--xh-context-menu-arrow-size, var(--xh-overlay-arrow-size));
+    --xh-_overlay-arrow-x: var(--xh-_context-menu-arrow-x);
+    --xh-_overlay-arrow-y: var(--xh-_context-menu-arrow-y);
+
+    background: var(--xh-context-menu-content-bg, var(--xh-material-frosted-bg));
+    border: var(--xh-stroke-thin) solid var(--xh-context-menu-border, var(--xh-material-frosted-border));
+  }
+
+  .xh-scope-context-menu[data-part='arrow'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中。
+     尺寸读标记位自己改接过的 --xh-icon-size：与盒同边长，随指示符档换档（见上面标记位那块） */
+  .xh-scope-context-menu[data-part='item-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-check) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       条目面上取 CanvasText；按下与没被高亮时的悬停，家族把条目涂成 Highlight，字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-context-menu[data-part='item'][aria-haspopup='menu']::after,
+    .xh-scope-context-menu[data-part='item-indicator']:empty::before {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    .xh-scope-context-menu[data-part='item'][aria-haspopup='menu']:not([aria-disabled='true'], [data-disabled], [aria-busy='true'], [data-error]):is(:active, [data-pressed], :hover:not(:focus-visible, [data-highlighted]))::after,
+    .xh-scope-context-menu[data-part='item']:not([aria-disabled='true'], [data-disabled], [aria-busy='true'], [data-error]):is(:active, [data-pressed], :hover:not(:focus-visible, [data-highlighted])) .xh-scope-context-menu[data-part='item-indicator']:empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-context-menu[data-part='item'][aria-haspopup='menu']:is([aria-disabled='true'], [data-disabled])::after,
+    .xh-scope-context-menu[data-part='item']:is([aria-disabled='true'], [data-disabled]) .xh-scope-context-menu[data-part='item-indicator']:empty::before {
+      background-color: GrayText;
+    }
+  }
+}
+
+@layer xihan.motion {
+  @media print {
+    /* 打印：定位层与遮罩是交互期才存在的东西，落到纸上只会盖住底下的正文。
+       收起写在这份皮肤里而不是 reset：reset 层排在组件层之前，组件层里任何一条 display 都压得住它。 */
+    .xh-scope-context-menu[data-part='positioner'] {
+      display: none;
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 分组之间那条线画的是一块纯底色，这一档里底色被统一换成 Canvas，线整条消失，
+       几组条目就连成了一长串。换成前景色画回来 */
+    .xh-scope-context-menu[data-part='separator'] {
+      background: CanvasText;
+    }
+  }
+}