@xihan-ui/styles 1.0.0-alpha.1 → 1.0.0-alpha.3

package/css/floating-panel.css

@@ -0,0 +1,310 @@
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='floating-panel'] {
+    --xh-floating-panel-skin: 1;
+  }
+
+  /* 分工：**面板的落位与尺寸**由连接层每帧写进 positioner 的内联样式
+     （position / left / top / width / height）。这份皮肤一条都不碰那五个属性——
+     内联优先级高于样式表，写了不但是死声明，还会在切换形态的那一帧跟连接层抢位置。
+     皮肤只管层级、配色、圆角、阴影、把手的摆放与状态表现。 */
+
+  [data-scope='floating-panel'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-floating-panel-icon-size, var(--xh-glyph-size-text));
+
+    /* 面板本身是 fixed 定位，root 只是作者那棵树里的容器，不参与排布 */
+    display: contents;
+  }
+
+  [data-scope='floating-panel'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  [data-scope='floating-panel'][data-part='trigger'] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    block-size: var(--xh-floating-panel-trigger-h, var(--xh-control-h-md));
+    padding-inline: var(--xh-floating-panel-trigger-px, var(--xh-control-px-md));
+    border: var(--xh-stroke-thin) solid var(--xh-floating-panel-trigger-border, var(--xh-border-control));
+    border-radius: var(--xh-floating-panel-trigger-radius, var(--xh-shape-control));
+    background: var(--xh-floating-panel-trigger-bg, var(--xh-bg-surface));
+    color: var(--xh-floating-panel-trigger-fg, var(--xh-fg-default));
+    font-size: var(--xh-text-label-size);
+    cursor: pointer;
+  }
+
+  [data-scope='floating-panel'][data-part='trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='floating-panel'][data-part='trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 把手的粗细：八个把手共用这两档，声明在这里往下继承。 */
+  [data-scope='floating-panel'][data-part='positioner'] {
+    --xh-_floating-panel-handle: var(--xh-floating-panel-handle-size, var(--xh-space-2));
+    --xh-_floating-panel-corner: var(--xh-floating-panel-corner-size, var(--xh-space-4));
+
+    position: fixed;
+    /* 与抽屉同一档：面板要盖住吸顶栏，又该被随后打开的弹窗与浮层压住 */
+    z-index: var(--xh-floating-panel-layer, var(--xh-layer-drawer));
+    display: block;
+  }
+
+  [data-scope='floating-panel'][data-part='positioner'][hidden] {
+    display: none;
+  }
+
+  [data-scope='floating-panel'][data-part='content'] {
+    position: relative;
+    block-size: 100%;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    /* 面板底下没有遮罩，压着的是任意页面内容：这条描边是它与背景之间唯一的边界，
+       取 border-default 与同样无遮罩的气泡卡片一档，别退到更淡的 border-subtle */
+    border: var(--xh-stroke-thin) solid var(--xh-floating-panel-border, var(--xh-border-default));
+    border-radius: var(--xh-floating-panel-radius, var(--xh-shape-surface));
+    background: var(--xh-floating-panel-bg, var(--xh-bg-surface));
+    color: var(--xh-floating-panel-fg, var(--xh-fg-default));
+    box-shadow: var(--xh-floating-panel-shadow, var(--xh-elevation-sheet));
+  }
+
+  [data-scope='floating-panel'][data-part='content'][hidden] {
+    display: none;
+  }
+
+  /* 面板本体不接收焦点，只是键盘事件的收口点，画环反而像是选中了整块 */
+  [data-scope='floating-panel'][data-part='content']:focus-visible {
+    outline: none;
+  }
+
+  /* 跟手期间整块不许选中文字：手在标题栏上来回蹭时会顺带把正文刷成高亮 */
+  [data-scope='floating-panel'][data-part='content'][data-dragging],
+  [data-scope='floating-panel'][data-part='content'][data-resizing] {
+    user-select: none;
+  }
+
+  [data-scope='floating-panel'][data-part='header'] {
+    display: flex;
+    align-items: center;
+    gap: var(--xh-floating-panel-header-gap, var(--xh-control-gap-sm));
+    padding-block: var(--xh-floating-panel-header-py, var(--xh-space-2));
+    padding-inline: var(--xh-floating-panel-header-px, var(--xh-space-3));
+    border-block-end: var(--xh-stroke-thin) solid var(--xh-floating-panel-header-border, var(--xh-border-subtle));
+    background: var(--xh-floating-panel-header-bg, var(--xh-bg-subtle));
+  }
+
+  [data-scope='floating-panel'][data-part='header'][hidden] {
+    display: none;
+  }
+
+  [data-scope='floating-panel'][data-part='title'] {
+    margin: 0;
+    flex: 1 1 auto;
+    overflow: hidden;
+    font-size: var(--xh-floating-panel-title-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-floating-panel-title-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-tight);
+    white-space: nowrap;
+    text-overflow: ellipsis;
+    color: var(--xh-floating-panel-title-fg, var(--xh-fg-default));
+  }
+
+  /* 拖拽把手铺满标题栏剩下的横向空间：只给一小块纹理的话很难抓住 */
+  [data-scope='floating-panel'][data-part='drag-trigger'] {
+    flex: 1 1 auto;
+    align-self: stretch;
+    min-inline-size: var(--xh-space-6);
+    border: 0;
+    padding: 0;
+    background: transparent;
+    cursor: grab;
+  }
+
+  [data-scope='floating-panel'][data-part='drag-trigger'][data-dragging] {
+    cursor: grabbing;
+  }
+
+  [data-scope='floating-panel'][data-part='drag-trigger'][data-disabled] {
+    cursor: default;
+  }
+
+  [data-scope='floating-panel'][data-part='drag-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: calc(-1 * var(--xh-ring-offset));
+  }
+
+  /* —— 改尺把手 ——
+     这一段刻意用物理的 inset / width / height：面板的坐标是屏幕坐标（连接层写的是
+     left/top），指针位移与方向键推动的也是屏幕方向。改成逻辑属性后，RTL 下 inset-inline-start
+     会翻到另一侧，守着「西边」的把手会长在东边，手往右拖却从左边收——把手与它推的那条边脱钩。 */
+  [data-scope='floating-panel'][data-part='resize-trigger'] {
+    position: absolute;
+    border: 0;
+    padding: 0;
+    /* 把手是透明的命中区：看不见但要摸得着，嫌小就调 --xh-floating-panel-handle-size */
+    background: transparent;
+  }
+
+  /* 只换指针形状，不摘 pointer-events：点击守卫在连接层，摘掉会让"键盘还在、指针没了"
+     这两套禁用语义对不上 */
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-disabled] {
+    cursor: default;
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: calc(-1 * var(--xh-ring-offset));
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='n'] {
+    inset: 0 0 auto 0;
+    height: var(--xh-_floating-panel-handle);
+    cursor: ns-resize;
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='s'] {
+    inset: auto 0 0 0;
+    height: var(--xh-_floating-panel-handle);
+    cursor: ns-resize;
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='w'] {
+    inset: 0 auto 0 0;
+    width: var(--xh-_floating-panel-handle);
+    cursor: ew-resize;
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='e'] {
+    inset: 0 0 0 auto;
+    width: var(--xh-_floating-panel-handle);
+    cursor: ew-resize;
+  }
+
+  /* 四个角排在四条边之后，命中区大一圈：角上要同时抓住两条边 */
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='nw'] {
+    inset: 0 auto auto 0;
+    width: var(--xh-_floating-panel-corner);
+    height: var(--xh-_floating-panel-corner);
+    cursor: nwse-resize;
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='ne'] {
+    inset: 0 0 auto auto;
+    width: var(--xh-_floating-panel-corner);
+    height: var(--xh-_floating-panel-corner);
+    cursor: nesw-resize;
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='se'] {
+    inset: auto 0 0 auto;
+    width: var(--xh-_floating-panel-corner);
+    height: var(--xh-_floating-panel-corner);
+    cursor: nwse-resize;
+  }
+
+  [data-scope='floating-panel'][data-part='resize-trigger'][data-edge='sw'] {
+    inset: auto auto 0 0;
+    width: var(--xh-_floating-panel-corner);
+    height: var(--xh-_floating-panel-corner);
+    cursor: nesw-resize;
+  }
+
+  /* —— 标题栏上的按钮 —— */
+  [data-scope='floating-panel'][data-part='stage-trigger'],
+  [data-scope='floating-panel'][data-part='close-trigger'] {
+    flex: 0 0 auto;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    border: 0;
+    background: transparent;
+    color: var(--xh-floating-panel-action-fg, var(--xh-fg-muted));
+    cursor: pointer;
+    transition:
+      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 两颗钮同高同圆角，尺寸与圆角槽按各自角色命名 */
+  [data-scope='floating-panel'][data-part='stage-trigger'] {
+    inline-size: var(--xh-floating-panel-action-size, var(--xh-control-h-sm));
+    block-size: var(--xh-floating-panel-action-size, var(--xh-control-h-sm));
+    border-radius: var(--xh-floating-panel-action-radius, var(--xh-shape-control));
+  }
+
+  [data-scope='floating-panel'][data-part='close-trigger'] {
+    inline-size: var(--xh-floating-panel-close-size, var(--xh-control-h-sm));
+    block-size: var(--xh-floating-panel-close-size, var(--xh-control-h-sm));
+    border-radius: var(--xh-floating-panel-close-radius, var(--xh-shape-control));
+  }
+
+  [data-scope='floating-panel'][data-part='stage-trigger'][hidden],
+  [data-scope='floating-panel'][data-part='close-trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='floating-panel'][data-part='stage-trigger']:hover,
+  [data-scope='floating-panel'][data-part='close-trigger']:hover {
+    background: var(--xh-floating-panel-action-bg-hover, var(--xh-bg-subtle-hover));
+    color: var(--xh-floating-panel-action-fg-hover, var(--xh-fg-default));
+  }
+
+  [data-scope='floating-panel'][data-part='stage-trigger']:active,
+  [data-scope='floating-panel'][data-part='close-trigger']:active {
+    background: var(--xh-floating-panel-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
+  /* 当前形态的那个按钮压着不放，用户一眼看得出面板正处于哪一档。
+     按下态的前景取 fg-default 而不是品牌色：品牌色压在这块底上只有 3.4:1（深色皮肤 2.9:1），
+     按钮里通常就一个字形，够不着文字该有的对比度。 */
+  [data-scope='floating-panel'][data-part='stage-trigger'][data-state='on'] {
+    background: var(--xh-floating-panel-action-bg-active, var(--xh-bg-subtle-active));
+    color: var(--xh-floating-panel-action-fg-active, var(--xh-fg-default));
+  }
+
+  /* 只换前景不叠 opacity：叠了之后禁用文字的对比度会掉到读不出来 */
+  [data-scope='floating-panel'][data-part='stage-trigger'][data-disabled] {
+    background: transparent;
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  [data-scope='floating-panel'][data-part='stage-trigger']:focus-visible,
+  [data-scope='floating-panel'][data-part='close-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  [data-scope='floating-panel'][data-part='body'] {
+    flex: 1 1 auto;
+    display: block;
+    overflow: auto;
+    padding-block: var(--xh-floating-panel-body-py, var(--xh-surface-py-sm));
+    padding-inline: var(--xh-floating-panel-body-px, var(--xh-surface-px-sm));
+  }
+
+  /* 收拢时连接层给正文打 hidden，这里把 UA 的 [hidden] 还回来（上面那条 display 盖掉了它） */
+  [data-scope='floating-panel'][data-part='body'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='floating-panel'][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;
+  }
+}

package/css/form.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='form'] {
+    --xh-form-skin: 1;
+  }
+
   /* 表单是一列字段：竖排、字段之间留一档间距。root 就是那个原生 <form> */
   [data-scope='form'][data-part='root'] {
     display: flex;
@@ -39,7 +44,7 @@
      用逻辑属性，RTL 下自动换到右侧 */
   [data-scope='form'][data-part='field-group'][data-invalid] {
     padding-inline-start: var(--xh-form-field-invalid-px, var(--xh-space-2));
-    border-inline-start: var(--xh-stroke-thick) solid var(--xh-form-field-invalid-border, var(--xh-color-danger-500));
+    border-inline-start: var(--xh-stroke-thick) solid var(--xh-form-field-invalid-border, var(--xh-border-invalid));
   }
 
   /* 容器带着 tabindex=-1：控件全禁用时焦点会落在它自己身上，
@@ -56,13 +61,13 @@
     gap: var(--xh-form-summary-gap, var(--xh-space-1_5));
     padding-block: var(--xh-form-summary-py, var(--xh-space-3));
     padding-inline: var(--xh-form-summary-px, var(--xh-control-px-md));
-    border: var(--xh-stroke-thin) solid var(--xh-form-summary-border, var(--xh-color-danger-500));
+    border: var(--xh-stroke-thin) solid var(--xh-form-summary-border, var(--xh-border-invalid));
     border-radius: var(--xh-form-summary-radius, var(--xh-shape-surface));
     background: var(--xh-form-summary-bg, var(--xh-bg-surface));
     color: var(--xh-form-summary-fg, var(--xh-fg-danger));
     font-size: var(--xh-form-summary-font-size, var(--xh-text-body-size));
     line-height: var(--xh-leading-normal);
-    box-shadow: var(--xh-form-summary-shadow, var(--xh-elevation-1));
+    box-shadow: var(--xh-form-summary-shadow, var(--xh-elevation-raised));
   }
 
   /* 漏了这条，摘要一旦出现过就再也撤不下去（上面那条 display 盖掉了 UA 的 [hidden] 规则） */
@@ -85,7 +90,7 @@
   [data-scope='form'][data-part='error-summary-item'] {
     display: block;
     color: inherit;
-    font-size: var(--xh-form-summary-item-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-form-summary-item-font-size, var(--xh-text-secondary-size));
     text-decoration: underline;
     text-underline-offset: 2px;
     cursor: pointer;
@@ -186,7 +191,7 @@
   @keyframes xh-form-summary-enter {
     from {
       opacity: 0;
-      translate: 0 calc(-1 * var(--xh-space-1));
+      translate: 0 calc(-1 * var(--xh-motion-distance-sm));
     }
 
     to {

package/css/gradient-text.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='gradient-text'] {
+    --xh-gradient-text-skin: 1;
+  }
+
   /* 渐变画在背景上，再用 background-clip 把背景裁进字形里；前景必须透明才透得出底下的渐变。
      两条 background-clip 都写：WebKit 只认带前缀那条。
      -webkit-text-fill-color 在 WebKit 里决定字形填充色并盖过 color，也要一并透明。 */

package/css/grid.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='grid'] {
+    --xh-grid-skin: 1;
+  }
+
   [data-scope='grid'][data-part='root'] {
     display: grid;
     /* 各列等宽；下限写 0 而不是 auto，一段长文本才不会把自己那列撑宽 */