@xihan-ui/styles 1.0.0-alpha.2 → 1.0.0

package/css/context-menu.css

@@ -4,26 +4,54 @@
     --xh-context-menu-skin: 1;
   }
 
-  /* 根只是把触发区与浮层圈在一起做作用域，不该在作者布局里多插一层盒子 */
-  [data-scope='context-menu'][data-part='root'] {
-    /* 尺寸档只换这四个私有槽，条目与分组标题都从 root 继承它们，
-       换档不必给每个部件各写一条选择器。浮层在 positioner 里、也是 root 的后代，一并继承
-       （display:contents 不影响继承：自定义属性沿 DOM 树传） */
-    --xh-_context-menu-item-py: var(--xh-space-1_5);
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  [data-scope='context-menu'][data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，content 继承它限高；
+       引擎没算（尚未落位 / 无引擎）时不额外限高 */
+    --xh-_context-menu-available-h: 100vh;
+
+    /* 条目列表的自绘条浮在内容之上：轨道不上底色，实色轨道会在菜单右缘糊一条竖灰带 */
+    --xh-scrollbar-track-bg: transparent;
+
+    position: fixed;
+    z-index: var(--xh-context-menu-layer, var(--xh-layer-popover));
+    /* 空壳不吃指针，交互只发生在 content 上 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  [data-scope='context-menu'][data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  [data-scope='context-menu']:is([data-part='root'], [data-part='positioner']) {
+    /* 尺寸档只换这四个私有槽，条目与分组标题都从这两处继承它们，
+       换档不必给每个部件各写一条选择器 */
+    --xh-_context-menu-item-py: var(--xh-list-option-py-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-text-body-size);
+    --xh-_context-menu-font-size: var(--xh-control-font-md);
 
     /* 打开子菜单的触发条目走品牌淡底强档，随语气换色相；没写 data-tone 时退回品牌淡底。
        悬停与键盘焦点恒中性灰轻档、不接语气槽——两档同色相的话打开路径就认不出来了 */
     --xh-_context-menu-item-active-bg: var(--xh-_tone-subtle, var(--xh-bg-brand-subtle));
+  }
 
-    /* 标记位强调色随语气走，没写 data-tone 时退回原来的取值 */
-    --xh-_context-menu-accent: var(--xh-_tone, var(--xh-fg-subtle));
+  /* 根只是把触发区与浮层圈在一起做作用域，不该在作者布局里多插一层盒子 */
+  [data-scope='context-menu'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-context-menu-icon-size, var(--xh-glyph-size-text));
 
     display: contents;
   }
 
+  /* 浮层被搬到 portal 落点，继承不到 root 上的槽：这把尺在被搬走的那一侧再声明一次，
+     关闭钮与条目里作者塞的图标才和皮肤画的兜底字形一样大 */
+  [data-scope='context-menu'][data-part='content'] {
+    --xh-icon-size: var(--xh-context-menu-icon-size, var(--xh-glyph-size-text));
+  }
+
   [data-scope='context-menu'][data-part='root'][hidden] {
     display: none;
   }
@@ -31,18 +59,18 @@
   /* —— 尺寸 —— */
   /* 缺省档写在上面的基础规则里。条目高度由 padding 撑出来：
      纵向走 space 档、行内内缩走 control-px 档（随密度轴），换档各挪一级 */
-  [data-scope='context-menu'][data-part='root'][data-size='sm'] {
-    --xh-_context-menu-item-py: var(--xh-space-1);
+  [data-scope='context-menu']:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
+    --xh-_context-menu-item-py: var(--xh-list-option-py-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-font-size-sm);
+    --xh-_context-menu-font-size: var(--xh-control-font-sm);
   }
 
-  [data-scope='context-menu'][data-part='root'][data-size='lg'] {
-    --xh-_context-menu-item-py: var(--xh-space-2);
+  [data-scope='context-menu']:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
+    --xh-_context-menu-item-py: var(--xh-list-option-py-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-font-size-lg);
+    --xh-_context-menu-font-size: var(--xh-control-font-lg);
   }
 
   /* 触发区是作者自己的一块内容，尺寸与排布归他；这里只管交互观感：
@@ -57,38 +85,32 @@
     outline-offset: var(--xh-ring-offset);
   }
 
-  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
-  [data-scope='context-menu'][data-part='positioner'] {
-    position: fixed;
-    z-index: var(--xh-layer-popover);
-    /* 空壳不吃指针，交互只发生在 content 上 */
-    pointer-events: none;
-  }
-
-  /* 锚点被滚出可视区：整个浮层随之收起 */
-  [data-scope='context-menu'][data-part='positioner'][data-hidden] {
-    visibility: hidden;
-  }
-
   [data-scope='context-menu'][data-part='content'] {
     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: var(--xh-context-menu-max-w, var(--xh-overlay-max-w));
+    /* 两道上限取更小的那道：自己的高度上限，以及落定那一侧真正剩下的空间。
+       列表族的 16rem 对命令菜单偏矮，这里另给一档 */
+    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-py, var(--xh-space-1));
     padding-inline: var(--xh-context-menu-px, var(--xh-space-1));
     border: var(--xh-stroke-thin) solid var(--xh-context-menu-border, var(--xh-border-default));
     border-radius: var(--xh-context-menu-radius, var(--xh-shape-surface));
     background: var(--xh-context-menu-bg, var(--xh-bg-surface));
     color: var(--xh-context-menu-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-context-menu-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-context-menu-shadow, var(--xh-elevation-floating));
+    /* 条目超过上限就在菜单内部滚。条目的焦点环是内收的，滚动容器裁在内边距缘上，环切不着 */
+    overflow-y: auto;
     pointer-events: auto;
   }
 
-  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
-  [data-scope='context-menu'][data-part='content'][hidden] {
-    display: none;
-  }
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 dialog 一致：
+     收起态连接层会给 content 打 hidden，而上面那条 display 正是要盖掉 UA 的
+     [hidden]{display:none}——退场动画得先能播。presence 读的是 content 的 animationName，
+     真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
+     其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
 
   /* 焦点落在容器上只有一种情形：指针打开、还没有任何条目当锚点。那一刻它认领着 Tab 位，
      环画在浮层内沿，用户才看得出键盘此刻在哪儿；有锚点时环长在条目上，容器不再画 */
@@ -104,12 +126,19 @@
   /* 展开时轻微涨开：菜单是被光标"点出来"的，纯淡入显得它一直都在
      （不设 transform-origin：那个属性没有逻辑关键字，写死方向会在 RTL 下反着涨） */
   [data-scope='context-menu'][data-part='content'][data-state='open'] {
-    animation: xh-context-menu-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
+     免得动画结束到真收起之间闪一下原样 */
+  [data-scope='context-menu'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   [data-scope='context-menu'][data-part='group'] {
     display: flex;
     flex-direction: column;
+    gap: var(--xh-context-menu-group-gap, var(--xh-list-option-gap));
   }
 
   [data-scope='context-menu'][data-part='group'][hidden] {
@@ -123,7 +152,7 @@
     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-fg-subtle));
-    font-size: var(--xh-context-menu-group-label-font-size, var(--xh-font-size-xs));
+    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-medium));
     line-height: var(--xh-leading-none);
     user-select: none;
@@ -156,10 +185,8 @@
     display: none;
   }
 
-  /* 悬停与键盘焦点共用中性灰轻档：条目本身承载焦点，不另画描边。
-     data-highlighted 跟的是连接层记的焦点条目，与 :focus 说的是同一件事，
-     子部件够不着那个伪类，只能读这个标记 */
-  [data-scope='context-menu'][data-part='item']:not([data-disabled]):is(:hover, :focus, [data-highlighted]) {
+  /* 悬停与键盘锚点共用中性灰轻档：锚点只认连接层打的 data-highlighted，不读 :focus */
+  [data-scope='context-menu'][data-part='item']:not([data-disabled]):is(:hover, [data-highlighted]) {
     background: var(--xh-context-menu-item-bg-hover, var(--xh-bg-subtle));
   }
 
@@ -170,6 +197,25 @@
     font-weight: var(--xh-context-menu-item-active-font-weight, var(--xh-font-weight-semibold));
   }
 
+  /* 带子菜单的条目行尾画右向小箭头：不点开也看得出还有下一级。
+     位置靠 margin 顶到行尾，图形取兜底字形令牌 */
+  [data-scope='context-menu'][data-part='item'][aria-haspopup='menu']::after {
+    content: '';
+    flex: none;
+    margin-inline-start: auto;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    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;
+  }
+
+  /* rtl 下子菜单开在左侧，箭头跟着指向行进方向 */
+  [dir='rtl'] [data-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);
+  }
+
   /* 键盘走到条目上要画环：轻档底色只有 1.1:1，够不上焦点指示器的对比度要求。
      指针悬停走的是程序化聚焦，鼠标模态下 :focus-visible 不匹配，不会误画 */
   [data-scope='context-menu'][data-part='item']:focus-visible {
@@ -206,7 +252,7 @@
     align-items: center;
     justify-content: center;
     inline-size: var(--xh-context-menu-item-indicator-size, var(--xh-control-indicator-size));
-    color: var(--xh-context-menu-item-indicator-fg, var(--xh-_context-menu-accent));
+    color: var(--xh-context-menu-item-indicator-fg, var(--xh-_tone, var(--xh-fg-brand)));
   }
 
   [data-scope='context-menu'][data-part='item-indicator'][hidden] {
@@ -219,7 +265,7 @@
 
   [data-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-1));
+    margin-block: var(--xh-context-menu-separator-my, var(--xh-space-0_5));
     background: var(--xh-context-menu-separator-color, var(--xh-border-default));
   }
 
@@ -227,57 +273,39 @@
     display: none;
   }
 
-  /* 箭头是旋转 45° 的方块，只保留朝向锚点那两条边的描边；
+  /* 箭头的底色与描边色，几何在 overlay-arrow.css。
      交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中 */
   [data-scope='context-menu'][data-part='arrow'] {
-    --xh-_context-menu-arrow-size: var(--xh-context-menu-arrow-size, var(--xh-overlay-arrow-size));
     --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);
 
-    position: absolute;
-    inline-size: var(--xh-_context-menu-arrow-size);
-    block-size: var(--xh-_context-menu-arrow-size);
     background: var(--xh-context-menu-bg, var(--xh-bg-surface));
     border: var(--xh-stroke-thin) solid var(--xh-context-menu-border, var(--xh-border-default));
-    rotate: 45deg;
   }
 
   [data-scope='context-menu'][data-part='arrow'][hidden] {
     display: none;
   }
 
-  [data-scope='context-menu'][data-part='arrow'][data-placement^='bottom'] {
-    inset-block-start: calc(var(--xh-_context-menu-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_context-menu-arrow-x) - var(--xh-_context-menu-arrow-size) / 2);
-    border-block-end: 0;
-    border-inline-end: 0;
-  }
-
-  [data-scope='context-menu'][data-part='arrow'][data-placement^='top'] {
-    inset-block-end: calc(var(--xh-_context-menu-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_context-menu-arrow-x) - var(--xh-_context-menu-arrow-size) / 2);
-    border-block-start: 0;
-    border-inline-start: 0;
-  }
-
-  [data-scope='context-menu'][data-part='arrow'][data-placement^='right'] {
-    inset-inline-start: calc(var(--xh-_context-menu-arrow-size) / -2);
-    inset-block-start: calc(var(--xh-_context-menu-arrow-y) - var(--xh-_context-menu-arrow-size) / 2);
-    border-block-start: 0;
-    border-inline-end: 0;
-  }
-
-  [data-scope='context-menu'][data-part='arrow'][data-placement^='left'] {
-    inset-inline-end: calc(var(--xh-_context-menu-arrow-size) / -2);
-    inset-block-start: calc(var(--xh-_context-menu-arrow-y) - var(--xh-_context-menu-arrow-size) / 2);
-    border-block-end: 0;
-    border-inline-start: 0;
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-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;
   }
 }
 
 @layer xihan.motion {
   /* 自带前缀独占一个名字，不动公共的那份关键帧 */
-  @keyframes xh-context-menu-in {
+  @keyframes xh-pop-in {
     from {
       opacity: 0;
       scale: var(--xh-motion-scale-enter);
@@ -288,4 +316,15 @@
       scale: 1;
     }
   }
+  @keyframes xh-pop-out {
+    from {
+      opacity: 1;
+      scale: 1;
+    }
+
+    to {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
+    }
+  }
 }

package/css/date-field.css

@@ -6,11 +6,15 @@
 
   /* 与文本框、数字框同一套堆叠：标签一行、分段框一行 */
   [data-scope='date-field'][data-part='root'] {
+    /* 作者塞进来的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    --xh-icon-size: var(--xh-date-field-icon-size, var(--xh-glyph-size-md));
+
     /* 尺寸档只换这四个私有槽，标题与分段框都从 root 继承它们，换档不必给每个部件各写一条选择器 */
     --xh-_date-field-control-h: var(--xh-control-h-md);
     --xh-_date-field-control-px: var(--xh-control-px-md);
-    --xh-_date-field-font-size: var(--xh-text-body-size);
-    --xh-_date-field-label-font-size: var(--xh-text-label-size);
+    --xh-_date-field-gap: var(--xh-control-gap-md);
+    --xh-_date-field-font-size: var(--xh-control-font-md);
+    --xh-_date-field-label-font-size: var(--xh-control-font-md);
     /* 形态档只换这三个私有槽：底色与两档描边 */
     --xh-_date-field-control-bg: var(--xh-bg-canvas);
     --xh-_date-field-control-border: var(--xh-border-control);
@@ -27,17 +31,21 @@
 
   /* —— 尺寸 —— */
   [data-scope='date-field'][data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-date-field-icon-size, var(--xh-glyph-size-sm));
     --xh-_date-field-control-h: var(--xh-control-h-sm);
     --xh-_date-field-control-px: var(--xh-control-px-sm);
-    --xh-_date-field-font-size: var(--xh-font-size-sm);
-    --xh-_date-field-label-font-size: var(--xh-font-size-sm);
+    --xh-_date-field-gap: var(--xh-control-gap-sm);
+    --xh-_date-field-font-size: var(--xh-control-font-sm);
+    --xh-_date-field-label-font-size: var(--xh-control-font-sm);
   }
 
   [data-scope='date-field'][data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-date-field-icon-size, var(--xh-glyph-size-lg));
     --xh-_date-field-control-h: var(--xh-control-h-lg);
     --xh-_date-field-control-px: var(--xh-control-px-lg);
-    --xh-_date-field-font-size: var(--xh-font-size-lg);
-    --xh-_date-field-label-font-size: var(--xh-font-size-lg);
+    --xh-_date-field-gap: var(--xh-control-gap-lg);
+    --xh-_date-field-font-size: var(--xh-control-font-lg);
+    --xh-_date-field-label-font-size: var(--xh-control-font-lg);
   }
 
   /* —— 形态 —— */
@@ -55,11 +63,11 @@
     --xh-_date-field-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
   }
 
-  /* 无框式：底与边都让开，可见反馈只剩聚焦那一档 */
+  /* 无框：底与常态描边透明，悬停与聚焦浮出描边 */
   [data-scope='date-field'][data-part='root'][data-variant='ghost'] {
     --xh-_date-field-control-bg: transparent;
     --xh-_date-field-control-border: transparent;
-    --xh-_date-field-control-border-hover: transparent;
+    --xh-_date-field-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
   }
 
   /* 声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
@@ -72,8 +80,6 @@
     font-size: var(--xh-date-field-label-font-size, var(--xh-_date-field-label-font-size));
     font-weight: var(--xh-date-field-label-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
-    /* 点标题会把焦点送进首段，指针得说明这件事 */
-    cursor: default;
   }
 
   [data-scope='date-field'][data-part='label'][hidden] {
@@ -85,11 +91,12 @@
     cursor: not-allowed;
   }
 
-  /* 分段框整体长得像一个输入框：边框与背景长在 control 上，各段只是里面的文字。
-     段与段之间的分隔符（'/'、'年'）由作者自己写在段之间，不在角色表里 */
+  /* 分段框整体长得像一个输入框：边框与背景长在 control 上，各段只是里面的文字 */
   [data-scope='date-field'][data-part='control'] {
     display: inline-flex;
+    min-inline-size: var(--xh-date-field-control-min-w, var(--xh-control-min-w));
     align-items: center;
+    gap: var(--xh-date-field-control-gap, var(--xh-_date-field-gap));
     block-size: var(--xh-date-field-control-h, var(--xh-_date-field-control-h));
     padding-inline: var(--xh-date-field-control-px, var(--xh-_date-field-control-px));
     padding-block: 0;
@@ -115,14 +122,17 @@
 
   /* 焦点落在某一段上，而边框长在 control 上：焦点环得由内向外借一层。
      control 自己不占 Tab 位，:focus-within 是它唯一能感知组内焦点的方式 */
-  [data-scope='date-field'][data-part='control']:focus-within {
-    border-color: var(--xh-date-field-control-border-focus, var(--xh-_date-field-ring));
+  [data-scope='date-field'][data-part='control']:focus-within:not([data-disabled]) {
+    border-color: var(--xh-date-field-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
     outline: var(--xh-ring-width) solid var(--xh-_date-field-ring);
     outline-offset: var(--xh-ring-offset);
   }
 
   [data-scope='date-field'][data-part='control'][data-invalid] {
-    border-color: var(--xh-date-field-control-border-invalid, var(--xh-color-danger-500));
+    border-color: var(--xh-date-field-control-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_date-field-ring: var(--xh-ring-invalid);
   }
 
   /* 只读仍可聚焦、可换段，不置灰，只把底色压下去表示"改不动" */
@@ -137,12 +147,25 @@
     cursor: not-allowed;
   }
 
+  /* 段位与作者写在段间的分隔符（'/'、'年'）都在这一层里：它占满盒里剩下的宽度，
+     清空钮因此靠在框内末端 */
+  [data-scope='date-field'][data-part='segment-group'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    min-inline-size: 0;
+  }
+
+  [data-scope='date-field'][data-part='segment-group'][hidden] {
+    display: none;
+  }
+
   /* 每一段是一块可聚焦的文字：宽度随内容走，两侧留一点让选中底色不贴着数字 */
   [data-scope='date-field'][data-part='segment'] {
     display: inline-block;
     padding-inline: var(--xh-date-field-segment-px, var(--xh-space-1));
     padding-block: var(--xh-date-field-segment-py, var(--xh-space-0));
-    border-radius: var(--xh-date-field-segment-radius, var(--xh-radius-sm));
+    border-radius: var(--xh-date-field-segment-radius, var(--xh-shape-inset));
     color: inherit;
     font: inherit;
     /* 等宽数字：各位字宽不一时，上下键连按会让整行数字左右跳 */
@@ -187,6 +210,60 @@
     color: var(--xh-date-field-segment-fg-focus, var(--xh-_date-field-segment-fg));
   }
 
+  /* 清空钮排在段位之后、与框等高的一颗小方钮：没值或不可编辑时连接层给 hidden 收起 */
+  [data-scope='date-field'][data-part='clear-trigger'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-date-field-action-size, var(--xh-control-action-size));
+    block-size: var(--xh-date-field-action-size, var(--xh-control-action-size));
+    padding: 0;
+    border: 0;
+    border-radius: var(--xh-date-field-action-radius, var(--xh-shape-control));
+    background: var(--xh-date-field-action-bg, transparent);
+    color: var(--xh-date-field-action-fg, var(--xh-fg-muted));
+    font-family: inherit;
+    font-size: var(--xh-date-field-action-font-size, var(--xh-text-secondary-size));
+    line-height: var(--xh-leading-none);
+    cursor: pointer;
+    user-select: none;
+    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter), scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 上面给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  [data-scope='date-field'][data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='date-field'][data-part='clear-trigger']:hover {
+    background: var(--xh-date-field-action-bg-hover, var(--xh-bg-subtle-hover));
+    color: var(--xh-date-field-action-fg-hover, var(--xh-fg-default));
+  }
+
+  [data-scope='date-field'][data-part='clear-trigger']:active {
+    background: var(--xh-date-field-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
+  /* 按钮不占 Tab 位（tabindex=-1），留给程序化聚焦兜底，落焦时得看得见 */
+  [data-scope='date-field'][data-part='clear-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-_date-field-ring);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这条即不命中 */
+  [data-scope='date-field'][data-part='clear-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;
+  }
+
   /* 连接层把它写成 type=hidden，UA 自己就不渲染；这里的视觉隐藏是给元素升级前那一瞬兜底
      （作者手写的是一个普通 input，升级完成前它是可见的文本框）。
      刻意不写 display：写了反而会盖掉 UA 对 type=hidden 的收起，把它显出来 */