@xihan-ui/styles 3.0.0 → 3.2.0

package/dist/css/date-field.css

@@ -0,0 +1,317 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* DateField 独立皮肤同时传递引入字段视觉盒与字段内动作；full bundle 递归去重。 */
+@import '../family/field-chrome.css';
+@import '../family/action-control.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-date-field {
+    --xh-date-field-skin: 1;
+  }
+
+  /* 与文本框、数字框同一套堆叠：标签一行、分段框一行。
+     组件层只把既有公开槽映射到家族合同；形态三档由家族按 control 上的 data-variant 生成，皮肤不再声明。 */
+  .xh-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-gap: var(--xh-control-gap-md);
+    --xh-_date-field-font-size: var(--xh-control-font-md);
+    /* 段位反白随语气走：当前段是「当前项」，淡底 + 淡底前景。
+       没写 data-tone 时这几个 --xh-_tone* 没被声明，退回品牌淡底 */
+    --xh-_date-field-segment-bg: var(--xh-_tone-subtle, var(--xh-bg-brand-subtle));
+    --xh-_date-field-segment-fg: var(--xh-_tone-fg, var(--xh-fg-on-brand-subtle));
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-date-field-gap, var(--xh-space-1));
+
+    /* 不传尺寸时一律这么宽，宽度不随内容走；父容器给不出这么宽时整件跟着收，地板同步让步，不越出父容器。
+       地板不高过缺省宽：使用者把缺省宽钉到底线以下时不必再放开底线 */
+    inline-size: var(--xh-date-field-control-w, var(--xh-control-w));
+    min-inline-size: min(var(--xh-date-field-control-w, var(--xh-control-w)), var(--xh-date-field-control-min-w, var(--xh-control-min-w)), 100%);
+    max-inline-size: 100%;
+  }
+
+  /* —— 尺寸 —— */
+  .xh-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-gap: var(--xh-control-gap-sm);
+    --xh-_date-field-font-size: var(--xh-control-font-sm);
+  }
+
+  .xh-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-gap: var(--xh-control-gap-lg);
+    --xh-_date-field-font-size: var(--xh-control-font-lg);
+  }
+
+  /* 声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
+  .xh-scope-date-field[data-part='root'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-date-field[data-part='label'] {
+    color: var(--xh-date-field-label-fg, var(--xh-fg-default));
+    font-size: var(--xh-date-field-label-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-date-field-label-font-weight, var(--xh-text-label-weight));
+  }
+
+  .xh-scope-date-field[data-part='label'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-date-field[data-part='label'][data-disabled] {
+    color: var(--xh-date-field-label-fg-disabled, var(--xh-fg-subtle));
+  }
+
+  /* 分段框整体长得像一个输入框：描边、底色、圆角、聚焦环、五态与悬停由 Field Chrome 家族画在
+     control 上，各段只是里面的文字。组件只映射既有公开槽；段位靠键盘编辑，盒上不是文本光标 */
+  .xh-scope-date-field[data-part='control'] {
+    --xh-field-control-height: var(--xh-date-field-control-h, var(--xh-_date-field-control-h));
+    --xh-field-control-padding-inline: var(--xh-date-field-control-px, var(--xh-_date-field-control-px));
+    --xh-field-control-gap: var(--xh-date-field-control-gap, var(--xh-_date-field-gap));
+    --xh-field-control-min-inline-size: var(--xh-date-field-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-date-field-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-date-field-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-date-field-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-date-field-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-date-field-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-date-field-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-date-field-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-date-field-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-date-field-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-date-field-control-border-invalid, var(--xh-_field-variant-border-invalid));
+    --xh-field-ring-focus: var(--xh-ring-focus);
+    --xh-field-ring-invalid: var(--xh-ring-invalid);
+    --xh-field-shadow-rest: var(--xh-date-field-control-shadow, none);
+    --xh-field-cursor-rest: default;
+    /* 家族 chrome 会重写 --xh-icon-size，使用者图标槽必须经桥接槽下发才能在盒内生效 */
+    --xh-field-glyph-size: var(--xh-date-field-icon-size, var(--xh-_field-size-glyph-size));
+
+    /* 表单控件不继承页面字体，只给字号会让分段框用 UA 默认字族 */
+    font-family: inherit;
+    font-size: var(--xh-date-field-font-size, var(--xh-_date-field-font-size));
+    line-height: var(--xh-leading-none);
+  }
+
+  .xh-scope-date-field[data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* 段位与作者写在段间的分隔符（'/'、'年'）都在这一层里：它占满盒里剩下的宽度，
+     清空钮因此靠在框内末端 */
+  .xh-scope-date-field[data-part='segment-group'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    min-inline-size: 0;
+  }
+
+  .xh-scope-date-field[data-part='segment-group'][hidden] {
+    display: none;
+  }
+
+  /* 整条占位：一段都没填、焦点也不在段上时，段位与分隔符让位给一句占位文字，焦点一进到段上就换回段位。
+     段位只是淡出（仍可聚焦、仍在读屏树里），文字以生成内容压在同一行上、不吃指针，点下去落到底下的段位 */
+  .xh-scope-date-field[data-part='segment-group'][data-placeholder-shown] {
+    position: relative;
+    color: transparent;
+  }
+
+  /* 段位与分隔符（后者是不带解剖的文字节点）一起淡出：显隐写在 segment-group 自己的私有槽上，
+     子节点只读槽——主体无特征的规则不挂在 data-placeholder-shown 后面，输入时翻转只让这一组失效 */
+  .xh-scope-date-field[data-part='segment-group'][data-placeholder-shown] {
+    --xh-_date-field-segment-opacity: 0;
+  }
+
+  .xh-scope-date-field[data-part='segment-group'] > * {
+    opacity: var(--xh-_date-field-segment-opacity, 1);
+  }
+
+  .xh-scope-date-field[data-part='segment-group'][data-placeholder-shown]::before {
+    content: attr(data-placeholder-text);
+    position: absolute;
+    inset-inline: 0;
+    inset-block-start: 50%;
+    overflow: hidden;
+    color: var(--xh-date-field-placeholder-fg, var(--xh-fg-subtle));
+    white-space: nowrap;
+    text-overflow: ellipsis;
+    pointer-events: none;
+    translate: 0 -50%;
+  }
+
+  .xh-scope-date-field[data-part='segment-group'] > :not([data-scope]) {
+    color: var(--xh-date-field-literal-fg, var(--xh-fg-subtle));
+  }
+
+  /* 每一段是一块可聚焦的文字：宽度随内容走，两侧留一点让选中底色不贴着数字 */
+  .xh-scope-date-field[data-part='segment'] {
+    display: inline-block;
+    padding-inline: var(--xh-date-field-segment-px, var(--xh-space-0_5));
+    padding-block: var(--xh-date-field-segment-py, var(--xh-space-0));
+    border-radius: var(--xh-date-field-segment-radius, var(--xh-shape-inset));
+    color: inherit;
+    font: inherit;
+    /* 等宽数字：各位字宽不一时，上下键连按会让整行数字左右跳 */
+    font-variant-numeric: tabular-nums;
+    line-height: var(--xh-leading-none);
+    text-align: center;
+    /* 段位靠键盘编辑，不是文本：让它被选中只会在拖选时选出半截日期 */
+    user-select: none;
+    /* 触屏上连点两下不该被当成缩放手势 */
+    touch-action: manipulation;
+    /* 反白随当前段换色：状态角色的 micro 淡变，与 TimeField 同一档；焦点环画在 control 上，不进过渡 */
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* granularity 用不上的段带 hidden 留在文档里（不卸载作者节点）。
+     上面给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  .xh-scope-date-field[data-part='segment'][hidden] {
+    display: none;
+  }
+
+  /* 未填的段用弱色显示占位串，和填好的数字拉开差别 */
+  .xh-scope-date-field[data-part='segment'][data-placeholder] {
+    color: var(--xh-date-field-placeholder-fg, var(--xh-fg-subtle));
+  }
+
+  /* 段位是集合里的条目，用 data-* 而不是 :disabled —— 它是 div，没有原生禁用态 */
+  .xh-scope-date-field[data-part='segment'][data-disabled] {
+    color: var(--xh-fg-disabled);
+  }
+
+  /* 正在编辑的那一段要看得出来：整行数字长得一模一样，光标那道线这里根本没有。
+     data-focus 由机器给（它知道当前是哪一段），:focus-visible 兜住机器状态还没回流的那一帧。
+     焦点环画在 control 上，段位这里只反白，两层各管各的不打架 */
+  .xh-scope-date-field[data-part='segment'][data-focus],
+  .xh-scope-date-field[data-part='segment']:focus-visible {
+    background: var(--xh-date-field-segment-bg-focus, var(--xh-_date-field-segment-bg));
+    color: var(--xh-date-field-segment-fg-focus, var(--xh-_date-field-segment-fg));
+    outline: none;
+  }
+
+  /* 反白之后占位串那条弱色规则会被盖掉，专门再压一遍才看得清 */
+  .xh-scope-date-field[data-part='segment'][data-focus][data-placeholder] {
+    color: var(--xh-date-field-segment-fg-focus, var(--xh-_date-field-segment-fg));
+  }
+
+  .xh-scope-date-field[data-part='segment'][data-invalid] {
+    color: var(--xh-date-field-segment-fg-invalid, var(--xh-fg-danger));
+  }
+
+  .xh-scope-date-field[data-part='segment'][data-invalid]:is([data-focus], :focus-visible) {
+    background: var(
+      --xh-date-field-segment-bg-invalid-focus,
+      var(--xh-bg-subtle)
+    );
+    color: var(--xh-date-field-segment-fg-invalid-focus, var(--xh-fg-danger));
+  }
+
+  /* 清空钮排在段位之后：正方视觉盒、inset 圆角、悬停 100 / 按下 200 与 0.97 按压、粗指针热区与
+     :focus-visible 关环全由 Action Control 的 field-inset ghost 档给，组件只映射既有覆盖槽。
+     没值或不可编辑时连接层给 hidden 收起 */
+  .xh-scope-date-field[data-part='clear-trigger'] {
+    --xh-action-visual-size: var(--xh-date-field-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-date-field-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-date-field-action-radius, var(--xh-shape-inset));
+    /* 底色阶梯由 ghost 档给（透明 → 100 → 200），使用者槽只作覆盖入口 */
+    --xh-action-bg-rest: var(--xh-date-field-action-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-date-field-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-date-field-action-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-date-field-action-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-date-field-action-fg-hover, var(--xh-fg-default));
+    --xh-action-border-rest: transparent;
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: none;
+    --xh-action-shadow-hover: none;
+    --xh-action-shadow-pressed: none;
+    --xh-action-font-size: var(--xh-date-field-action-font-size, var(--xh-text-secondary-size));
+    /* 配方尚未把 profile 字形档灌进 --xh-icon-size，钮内字形先按 field-inset 档逐钮取值 */
+    --xh-icon-size: var(--xh-_action-profile-glyph-size);
+
+    border-width: 0;
+  }
+
+  /* 家族给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  .xh-scope-date-field[data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这条即不命中 */
+  .xh-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;
+  }
+
+  @media (forced-colors: active) {
+    /* 整条占位的文字照系统的弱色画；段位让位时的透明字不被强制换色顶回来 */
+    .xh-scope-date-field[data-part='segment-group'][data-placeholder-shown] {
+      forced-color-adjust: none;
+    }
+
+    .xh-scope-date-field[data-part='segment-group'][data-placeholder-shown]::before {
+      color: GrayText;
+    }
+
+    .xh-scope-date-field[data-part='segment'][data-invalid]:is([data-focus], :focus-visible) {
+      outline: var(--xh-ring-width) solid Highlight;
+      outline-offset: var(--xh-ring-offset);
+    }
+  }
+
+  /* 连接层把它写成 type=hidden，UA 自己就不渲染；这里的视觉隐藏是给元素升级前那一瞬兜底
+     （作者手写的是一个普通 input，升级完成前它是可见的文本框）。
+     刻意不写 display：写了反而会盖掉 UA 对 type=hidden 的收起，把它显出来 */
+  .xh-scope-date-field[data-part='hidden-input'] {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    margin: -1px;
+    border: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+    pointer-events: none;
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-date-field[data-part='clear-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-date-field[data-part='clear-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-date-field[data-part='clear-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}