@zhang_jifan/fanui 2.1.0

package/src/components/_input-plus.scss

@@ -0,0 +1,730 @@
+// =============================================================================
+// fanUI · 表单增强组件 (Advanced Inputs)
+// -----------------------------------------------------------------------------
+// 覆盖市面主流但基础层未含的输入形态，全部依赖主题色令牌，换肤 / 玻璃开关自动跟随：
+//   .fanui-slider      单值 / 双值滑块（带数值气泡）
+//   .fanui-rate        评分（支持半分、只读、清空）
+//   .fanui-upload      上传（拖拽区 + 文件卡片列表 + 进度）
+//   .fanui-tag-input   标签输入（回车成标签、可删、可建议）
+//   .fanui-stepper     数字步进器
+//   .fanui-pin         验证码 / OTP 分格输入
+//   .fanui-swatch      色板选择器（含自定义色）
+//   .fanui-combobox    组合框（输入即筛选）
+// =============================================================================
+
+@use "sass:map";
+@use "../functions" as fn;
+@use "../variables" as v;
+@use "../mixins" as mx;
+
+// -----------------------------------------------------------------------------
+// 1. 滑块 Slider
+// -----------------------------------------------------------------------------
+// 用 --fanui-slider-fill 表示已选比例（JS 或内联样式写入），
+// 轨道填充色自动取主题色，因此换主题后滑块颜色立即跟随。
+
+.fanui-slider {
+  --fanui-slider-fill: 50%;
+  --fanui-slider-track: #{fn.fanui-var("color-border")};
+  --fanui-slider-thumb: #ffffff;
+  --fanui-slider-size: 6px;
+  --fanui-slider-thumb-size: 18px;
+
+  display: block;
+  width: 100%;
+  margin: 0;
+  padding: 0;
+  background: transparent;
+  appearance: none;
+  -webkit-appearance: none;
+  cursor: pointer;
+  @include mx.fanui-transition(opacity, v.$fanui-duration-fast);
+
+  &:focus-visible {
+    outline: none;
+
+    &::-webkit-slider-thumb { @include mx.fanui-focus-ring(); }
+    &::-moz-range-thumb { @include mx.fanui-focus-ring(); }
+  }
+
+  &::-webkit-slider-runnable-track {
+    height: var(--fanui-slider-size);
+    border-radius: var(--fanui-radius-full);
+    background-image: linear-gradient(
+      to right,
+      var(--fanui-primary) 0%,
+      var(--fanui-primary-vivid) var(--fanui-slider-fill),
+      var(--fanui-slider-track) var(--fanui-slider-fill),
+      var(--fanui-slider-track) 100%
+    );
+  }
+
+  &::-moz-range-track {
+    height: var(--fanui-slider-size);
+    border-radius: var(--fanui-radius-full);
+    background-color: var(--fanui-slider-track);
+  }
+
+  &::-moz-range-progress {
+    height: var(--fanui-slider-size);
+    border-radius: var(--fanui-radius-full);
+    background-image: linear-gradient(to right, var(--fanui-primary), var(--fanui-primary-vivid));
+  }
+
+  &::-webkit-slider-thumb {
+    width: var(--fanui-slider-thumb-size);
+    height: var(--fanui-slider-thumb-size);
+    margin-top: calc((var(--fanui-slider-size) - var(--fanui-slider-thumb-size)) / 2);
+    border: 2px solid var(--fanui-primary);
+    border-radius: var(--fanui-radius-full);
+    background-color: var(--fanui-slider-thumb);
+    box-shadow: 0 1px 4px fn.fanui-alpha(#020617, 0.22);
+    appearance: none;
+    -webkit-appearance: none;
+    @include mx.fanui-transition((transform, box-shadow), v.$fanui-duration-fast);
+  }
+
+  &::-moz-range-thumb {
+    width: var(--fanui-slider-thumb-size);
+    height: var(--fanui-slider-thumb-size);
+    border: 2px solid var(--fanui-primary);
+    border-radius: var(--fanui-radius-full);
+    background-color: var(--fanui-slider-thumb);
+    box-shadow: 0 1px 4px fn.fanui-alpha(#020617, 0.22);
+  }
+
+  &:hover::-webkit-slider-thumb { transform: scale(1.12); }
+  &:active::-webkit-slider-thumb { transform: scale(1.2); }
+
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+
+    &::-webkit-slider-thumb { border-color: var(--fanui-color-border-strong); }
+  }
+
+  // 尺寸
+  &--sm { --fanui-slider-size: 4px; --fanui-slider-thumb-size: 14px; }
+  &--lg { --fanui-slider-size: 8px; --fanui-slider-thumb-size: 24px; }
+}
+
+// 带数值气泡的滑块：气泡位置由 --fanui-slider-fill 驱动，随拖动实时移动
+.fanui-slider-field {
+  position: relative;
+  display: flex;
+  align-items: center;
+  gap: fn.fanui-var("space-3");
+  padding-top: fn.fanui-var("space-5");
+
+  .fanui-slider { flex: 1 1 auto; min-width: 0; }
+
+  &__bubble {
+    position: absolute;
+    top: 0;
+    left: var(--fanui-slider-fill, 50%);
+    transform: translateX(-50%);
+    padding: 1px 7px;
+    font-size: fn.fanui-var("font-size-xs");
+    font-variant-numeric: tabular-nums;
+    color: fn.fanui-var("primary-fg");
+    background-color: fn.fanui-var("primary");
+    border-radius: fn.fanui-var("radius-sm");
+    white-space: nowrap;
+    pointer-events: none;
+  }
+
+  &__value {
+    min-width: 3.5em;
+    font-size: fn.fanui-var("font-size-sm");
+    font-variant-numeric: tabular-nums;
+    text-align: end;
+    color: fn.fanui-var("color-text-muted");
+  }
+
+  &__marks {
+    display: flex;
+    justify-content: space-between;
+    margin-top: fn.fanui-var("space-1");
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+  }
+}
+
+// 双值滑块（区间）：两根轨道叠加，视觉上呈现"已选区间"
+.fanui-slider-range {
+  position: relative;
+  height: var(--fanui-slider-thumb-size, 18px);
+
+  .fanui-slider {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    pointer-events: none;
+
+    &::-webkit-slider-thumb { pointer-events: auto; }
+    &::-moz-range-thumb { pointer-events: auto; }
+  }
+
+  &__rail {
+    position: absolute;
+    top: 50%;
+    left: 0;
+    right: 0;
+    height: var(--fanui-slider-size, 6px);
+    transform: translateY(-50%);
+    border-radius: var(--fanui-radius-full);
+    background-color: var(--fanui-color-border);
+  }
+
+  &__fill {
+    position: absolute;
+    top: 50%;
+    height: var(--fanui-slider-size, 6px);
+    transform: translateY(-50%);
+    border-radius: var(--fanui-radius-full);
+    background-image: linear-gradient(to right, var(--fanui-primary), var(--fanui-primary-vivid));
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 2. 评分 Rate
+// -----------------------------------------------------------------------------
+// 采用「行内反转 + 兄弟选择器」实现纯 CSS 高亮，无需 JS 也能工作。
+// 结构：<div class="fanui-rate"><input><label>★</label>…（倒序书写）</div>
+
+.fanui-rate {
+  display: inline-flex;
+  flex-direction: row-reverse;
+  justify-content: flex-end;
+  gap: 2px;
+  font-size: 22px;
+  line-height: 1;
+
+  &__input {
+    @include mx.fanui-visually-hidden();
+
+    &:focus-visible ~ .fanui-rate__star {
+      outline: 2px solid fn.fanui-var("primary-ring");
+      outline-offset: 2px;
+    }
+  }
+
+  &__star {
+    color: fn.fanui-var("color-border-strong");
+    cursor: pointer;
+    user-select: none;
+    @include mx.fanui-transition((color, transform), v.$fanui-duration-fast);
+
+    &::before { content: "★"; }
+
+    &:hover {
+      transform: scale(1.15);
+    }
+  }
+
+  // 选中及其之后的星（DOM 倒序 → 视觉上是"之前的星"）
+  &__input:checked ~ &__star {
+    color: fn.fanui-var("warning-vivid");
+  }
+
+  // 悬停时，悬停项及其之后全部高亮
+  &__star:hover,
+  &__star:hover ~ &__star {
+    color: fn.fanui-var("warning");
+  }
+
+  // 语义色变体
+  &--primary {
+    .fanui-rate__input:checked ~ .fanui-rate__star { color: fn.fanui-var("primary"); }
+    .fanui-rate__star:hover,
+    .fanui-rate__star:hover ~ .fanui-rate__star { color: fn.fanui-var("primary-hover"); }
+  }
+
+  &--sm { font-size: 16px; }
+  &--lg { font-size: 30px; }
+
+  &--readonly {
+    .fanui-rate__star { cursor: default; pointer-events: none; }
+
+    .fanui-rate__star:hover { transform: none; }
+  }
+
+  &__value {
+    margin-inline-start: fn.fanui-var("space-2");
+    font-size: fn.fanui-var("font-size-sm");
+    color: fn.fanui-var("color-text-muted");
+    align-self: center;
+  }
+
+  &__desc {
+    margin-inline-start: fn.fanui-var("space-2");
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+    align-self: center;
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 3. 上传 Upload
+// -----------------------------------------------------------------------------
+
+.fanui-upload {
+  display: flex;
+  flex-direction: column;
+  gap: fn.fanui-var("space-3");
+
+  &__drop {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: fn.fanui-var("space-2");
+    padding: fn.fanui-var("space-8") fn.fanui-var("space-4");
+    text-align: center;
+    border: 2px dashed fn.fanui-var("color-border-strong");
+    border-radius: fn.fanui-var("radius-lg");
+    background-color: fn.fanui-var("color-surface-sunken");
+    color: fn.fanui-var("color-text-muted");
+    cursor: pointer;
+    @include mx.fanui-transition((border-color, background-color, color, transform), v.$fanui-duration-fast);
+
+    input[type="file"] {
+      @include mx.fanui-visually-hidden();
+    }
+
+    &:hover,
+    &.is-dragover {
+      border-color: fn.fanui-var("primary");
+      background-color: fn.fanui-var("primary-soft");
+      color: fn.fanui-var("primary-ink");
+    }
+
+    &.is-dragover {
+      transform: scale(1.01);
+      box-shadow: 0 0 0 4px fn.fanui-var("primary-ring");
+    }
+  }
+
+  &__icon {
+    display: grid;
+    place-items: center;
+    width: 44px;
+    height: 44px;
+    border-radius: fn.fanui-var("radius-full");
+    background-color: fn.fanui-var("primary-soft");
+    color: fn.fanui-var("primary");
+    font-size: fn.fanui-var("font-size-xl");
+  }
+
+  &__hint {
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+  }
+
+  &__list {
+    display: flex;
+    flex-direction: column;
+    gap: fn.fanui-var("space-2");
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+
+  // 文件卡片：含名称、大小、进度、操作
+  &__item {
+    display: flex;
+    align-items: center;
+    gap: fn.fanui-var("space-3");
+    padding: fn.fanui-var("space-2") fn.fanui-var("space-3");
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-md");
+    background-color: fn.fanui-var("color-surface");
+    @include mx.fanui-transition((border-color, background-color), v.$fanui-duration-fast);
+
+    &:hover { border-color: fn.fanui-var("color-border-strong"); }
+
+    &.is-error {
+      border-color: fn.fanui-var("danger-border");
+      background-color: fn.fanui-var("danger-soft");
+    }
+
+    &.is-done &__state { color: fn.fanui-var("success"); }
+  }
+
+  &__thumb {
+    display: grid;
+    place-items: center;
+    width: 36px;
+    height: 36px;
+    flex: 0 0 auto;
+    border-radius: fn.fanui-var("radius-sm");
+    background-color: fn.fanui-var("color-surface-sunken");
+    color: fn.fanui-var("color-text-muted");
+    overflow: hidden;
+
+    img { width: 100%; height: 100%; object-fit: cover; }
+  }
+
+  &__meta {
+    flex: 1 1 auto;
+    min-width: 0;
+  }
+
+  &__name {
+    display: block;
+    font-size: fn.fanui-var("font-size-sm");
+    color: fn.fanui-var("color-text");
+    @include mx.fanui-truncate(1);
+  }
+
+  &__size {
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+    font-variant-numeric: tabular-nums;
+  }
+
+  &__state { color: fn.fanui-var("color-text-muted"); flex: 0 0 auto; }
+}
+
+// -----------------------------------------------------------------------------
+// 4. 标签输入 Tag Input
+// -----------------------------------------------------------------------------
+
+.fanui-tag-input {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: fn.fanui-var("space-1");
+  min-height: fn.fanui-var("control-h");
+  padding: 5px 8px;
+  border: 1px solid fn.fanui-var("color-border");
+  border-radius: fn.fanui-var("control-radius");
+  background-color: fn.fanui-var("color-surface");
+  cursor: text;
+  @include mx.fanui-transition((border-color, box-shadow), v.$fanui-duration-fast);
+
+  &:hover { border-color: fn.fanui-var("color-border-strong"); }
+
+  &:focus-within {
+    border-color: fn.fanui-var("primary");
+    @include mx.fanui-focus-ring();
+  }
+
+  &__tag {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    max-width: 100%;
+    padding: 2px 4px 2px 8px;
+    font-size: fn.fanui-var("font-size-xs");
+    line-height: 1.5;
+    color: fn.fanui-var("primary-ink");
+    background-color: fn.fanui-var("primary-soft");
+    border: 1px solid fn.fanui-var("primary-border");
+    border-radius: fn.fanui-var("radius-full");
+    animation: fanui-tag-pop 180ms v.$fanui-ease-spring both;
+
+    span { @include mx.fanui-truncate(1); max-width: 12em; }
+  }
+
+  &__remove {
+    display: grid;
+    place-items: center;
+    width: 16px;
+    height: 16px;
+    padding: 0;
+    border: 0;
+    border-radius: fn.fanui-var("radius-full");
+    background: transparent;
+    color: currentColor;
+    cursor: pointer;
+    opacity: 0.65;
+    @include mx.fanui-transition((opacity, background-color), v.$fanui-duration-fast);
+
+    &::before { content: "×"; font-size: 14px; line-height: 1; }
+    &:hover { opacity: 1; background-color: fn.fanui-alpha(#020617, 0.08); }
+  }
+
+  &__field {
+    flex: 1 1 6em;
+    min-width: 6em;
+    padding: 2px 4px;
+    border: 0;
+    background: transparent;
+    font: inherit;
+    font-size: fn.fanui-var("font-size-base");
+    color: fn.fanui-var("color-text");
+
+    &:focus { outline: none; }
+    &::placeholder { color: fn.fanui-var("color-text-subtle"); }
+  }
+
+  &__suggest {
+    position: absolute;
+    z-index: fn.fanui-var("z-dropdown");
+    margin-top: fn.fanui-var("space-1");
+    padding: fn.fanui-var("space-1");
+    min-width: 180px;
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-md");
+    background-color: fn.fanui-var("color-overlay");
+    box-shadow: fn.fanui-var("shadow-lg");
+
+    button {
+      display: block;
+      width: 100%;
+      padding: 6px 10px;
+      border: 0;
+      border-radius: fn.fanui-var("radius-sm");
+      background: transparent;
+      font: inherit;
+      font-size: fn.fanui-var("font-size-sm");
+      text-align: start;
+      color: fn.fanui-var("color-text");
+      cursor: pointer;
+
+      &:hover { background-color: fn.fanui-var("color-hover"); }
+      &.is-active { background-color: fn.fanui-var("primary-soft"); color: fn.fanui-var("primary-ink"); }
+    }
+  }
+}
+
+@keyframes fanui-tag-pop {
+  from { opacity: 0; transform: scale(0.86); }
+  to   { opacity: 1; transform: scale(1); }
+}
+
+// -----------------------------------------------------------------------------
+// 5. 步进器 Stepper
+// -----------------------------------------------------------------------------
+
+.fanui-stepper {
+  display: inline-flex;
+  align-items: stretch;
+  border: 1px solid fn.fanui-var("color-border");
+  border-radius: fn.fanui-var("control-radius");
+  background-color: fn.fanui-var("color-surface");
+  overflow: hidden;
+  @include mx.fanui-transition((border-color, box-shadow), v.$fanui-duration-fast);
+
+  &:focus-within {
+    border-color: fn.fanui-var("primary");
+    @include mx.fanui-focus-ring();
+  }
+
+  &__btn {
+    display: grid;
+    place-items: center;
+    width: calc(var(--fanui-control-h) + 4px);
+    border: 0;
+    background: transparent;
+    color: fn.fanui-var("color-text-muted");
+    font-size: 16px;
+    line-height: 1;
+    cursor: pointer;
+    @include mx.fanui-transition((background-color, color), v.$fanui-duration-fast);
+
+    &:hover:not(:disabled) {
+      background-color: fn.fanui-var("primary-soft");
+      color: fn.fanui-var("primary-ink");
+    }
+
+    &:disabled { opacity: 0.4; cursor: not-allowed; }
+  }
+
+  &__input {
+    width: 3.6em;
+    min-height: fn.fanui-var("control-h");
+    padding: 0 4px;
+    border: 0;
+    border-inline: 1px solid fn.fanui-var("color-border-subtle");
+    background: transparent;
+    font: inherit;
+    font-size: fn.fanui-var("font-size-base");
+    font-variant-numeric: tabular-nums;
+    text-align: center;
+    color: fn.fanui-var("color-text");
+
+    &:focus { outline: none; }
+    &::-webkit-outer-spin-button,
+    &::-webkit-inner-spin-button { appearance: none; margin: 0; }
+  }
+
+  &--sm { --fanui-control-h: #{map.get(v.$fanui-control-heights, "sm")}; }
+  &--lg { --fanui-control-h: #{map.get(v.$fanui-control-heights, "lg")}; }
+}
+
+// -----------------------------------------------------------------------------
+// 6. 验证码 / PIN 输入
+// -----------------------------------------------------------------------------
+
+.fanui-pin {
+  display: inline-flex;
+  gap: fn.fanui-var("space-2");
+
+  &__cell {
+    width: 44px;
+    height: 52px;
+    padding: 0;
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-md");
+    background-color: fn.fanui-var("color-surface");
+    font-family: fn.fanui-var("font-mono");
+    font-size: fn.fanui-var("font-size-xl");
+    font-variant-numeric: tabular-nums;
+    text-align: center;
+    color: fn.fanui-var("color-text-strong");
+    @include mx.fanui-transition((border-color, box-shadow, transform), v.$fanui-duration-fast);
+
+    &:focus {
+      outline: none;
+      border-color: fn.fanui-var("primary");
+      @include mx.fanui-focus-ring();
+      transform: translateY(-2px);
+    }
+
+    &.is-filled {
+      border-color: fn.fanui-var("primary-border");
+      background-color: fn.fanui-var("primary-soft");
+    }
+
+    &:disabled { background-color: fn.fanui-var("color-disabled-bg"); }
+  }
+
+  &--filled &__cell { background-color: fn.fanui-var("color-surface-sunken"); }
+
+  &--sm &__cell { width: 36px; height: 42px; font-size: fn.fanui-var("font-size-lg"); }
+  &--separated { gap: fn.fanui-var("space-4"); }
+}
+
+// -----------------------------------------------------------------------------
+// 7. 色板选择 Swatch
+// -----------------------------------------------------------------------------
+
+.fanui-swatch {
+  display: inline-flex;
+  flex-wrap: wrap;
+  gap: fn.fanui-var("space-2");
+
+  &__item {
+    position: relative;
+    display: grid;
+    place-items: center;
+    width: 30px;
+    height: 30px;
+    padding: 0;
+    border: 1px solid fn.fanui-alpha(#020617, 0.12);
+    border-radius: fn.fanui-var("radius-md");
+    background-color: var(--fanui-swatch-color, var(--fanui-color-border));
+    cursor: pointer;
+    @include mx.fanui-transition((transform, box-shadow), v.$fanui-duration-fast);
+
+    &:hover { transform: translateY(-2px); box-shadow: fn.fanui-var("shadow-md"); }
+
+    &[aria-checked="true"],
+    &.is-selected {
+      box-shadow: 0 0 0 2px fn.fanui-var("color-surface"), 0 0 0 4px var(--fanui-swatch-color);
+    }
+
+    &[aria-checked="true"]::after {
+      content: "";
+      width: 10px;
+      height: 6px;
+      border-inline-start: 2px solid #fff;
+      border-bottom: 2px solid #fff;
+      transform: rotate(-45deg) translate(1px, -1px);
+      filter: drop-shadow(0 1px 1px rgba(0, 0, 0, 0.4));
+    }
+  }
+
+  &--lg &__item { width: 40px; height: 40px; }
+  &--round &__item { border-radius: fn.fanui-var("radius-full"); }
+}
+
+// -----------------------------------------------------------------------------
+// 8. 组合框 Combobox（输入即筛选）
+// -----------------------------------------------------------------------------
+
+.fanui-combobox {
+  position: relative;
+
+  &__control {
+    position: relative;
+    display: flex;
+    align-items: center;
+  }
+
+  &__input {
+    @include mx.fanui-form-control();
+    padding-inline-end: 34px;
+  }
+
+  &__toggle {
+    position: absolute;
+    inset-inline-end: 6px;
+    display: grid;
+    place-items: center;
+    width: 24px;
+    height: 24px;
+    border: 0;
+    border-radius: fn.fanui-var("radius-sm");
+    background: transparent;
+    color: fn.fanui-var("color-text-muted");
+    cursor: pointer;
+
+    &:hover { background-color: fn.fanui-var("color-hover"); }
+  }
+
+  &__list {
+    position: absolute;
+    inset-inline: 0;
+    top: calc(100% + 4px);
+    z-index: fn.fanui-var("z-dropdown");
+    max-height: 260px;
+    margin: 0;
+    padding: fn.fanui-var("space-1");
+    list-style: none;
+    overflow-y: auto;
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-md");
+    background-color: fn.fanui-var("color-overlay");
+    box-shadow: fn.fanui-var("shadow-xl");
+    opacity: 0;
+    visibility: hidden;
+    transform: translateY(-4px);
+    @include mx.fanui-transition((opacity, transform, visibility), v.$fanui-duration-fast);
+
+    &.is-open { opacity: 1; visibility: visible; transform: translateY(0); }
+  }
+
+  &__option {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: fn.fanui-var("space-2");
+    padding: 7px 10px;
+    border-radius: fn.fanui-var("radius-sm");
+    font-size: fn.fanui-var("font-size-sm");
+    color: fn.fanui-var("color-text");
+    cursor: pointer;
+
+    &:hover,
+    &.is-active { background-color: fn.fanui-var("color-hover"); }
+    &.is-selected { color: fn.fanui-var("primary-ink"); background-color: fn.fanui-var("primary-soft"); }
+    &.is-disabled { opacity: 0.5; cursor: not-allowed; }
+  }
+
+  &__empty {
+    padding: fn.fanui-var("space-4");
+    text-align: center;
+    font-size: fn.fanui-var("font-size-sm");
+    color: fn.fanui-var("color-text-subtle");
+  }
+
+  &__mark {
+    background-color: fn.fanui-var("warning-soft-2");
+    color: inherit;
+    font-weight: fn.fanui-var("font-weight-semibold");
+  }
+}