UI设计规范及说明

Appearance

Progress 进度条 ​

CSS样式 ​

全部 progress 样式代码：

查看代码
css
/* HnuiIcon */
@import url('./icon.css');

/* 全局css变量 */

:root {
  /* #region vars-BrandColor */

  /* 品牌色 */
  --hnui-brand-color: #1f78ff;
  --hnui-brand-color1: #005ce5;
  --hnui-brand-color2: #4b83f7;
  --hnui-brand-color3: #3384ff;
  --hnui-brand-color4: #599bff;
  --hnui-brand-color5: #80b2ff;
  --hnui-brand-color6: #b2d1ff;
  --hnui-brand-color7: #cce0ff;
  --hnui-brand-color8: #d9e8ff;
  --hnui-brand-color9: #ebf3ff;
  --hnui-brand-color10: #f2f7ff;

  /* 状态颜色 */
  --hnui-brand-color-normal: var(--hnui-brand-color);
  --hnui-brand-color-hover: var(--hnui-brand-color3);
  --hnui-brand-color-active: var(--hnui-brand-color1);
  --hnui-brand-color-elected: var(--hnui-brand-color9);
  --hnui-brand-color-disabled: var(--hnui-brand-color7);

  --hnui-brand-color-disabled-border: var(--hnui-brand-color6);
  --hnui-brand-color-disabled-bg: var(--hnui-brand-color10);

  /* #endregion vars-BrandColor */

  /* #region vars-DomainColor */

  /* 功能色 */
  --hnui-success-color: #2ba471;
  --hnui-success-hover-color: #51bd90;
  --hnui-success-active-color: #2ba471;

  --hnui-warning-color: #faad14;
  --hnui-warning-hover-color: #ffc146;
  --hnui-warning-active-color: #db960b;

  --hnui-danger-color: #ff4d4d;
  --hnui-danger-hover-color: #ff7676;
  --hnui-danger-active-color: #d82a2a;

  --hnui-info-color: #8d97a6;
  --hnui-info-hover-color: #b2b7c0;
  --hnui-info-active-color: #707a89;

  /* #endregion vars-DomainColor */

  /* #region vars-NeutralColor */
  /* 中性色 */

  /* 标题文字 */
  --hnui-neutral-color-1: #2d2e33;

  /* 正文、重要信息文字、按钮文字、输入框正常状态文字等 */
  --hnui-neutral-color-2: #43454d;

  /* 内容文字、说明叙述文字 */
  --hnui-neutral-color-3: #5d606a;

  /* 提示性文字、辅助文本 */
  --hnui-neutral-color-4: #9298a0;

  /* 禁用文本 */
  --hnui-neutral-color-5: #b7bdc7;

  /* 描边格描边、输入文本描边、下拉选择描边等 */
  --hnui-neutral-color-6: #dfe2e7;

  /* 全局背景、禁用状态、分割线等 */
  --hnui-neutral-color-7: #f0f2f5;

  /* 最低颜色等 */
  --hnui-neutral-color-8: #fafbfc;

  /* #endregion vars-NeutralColor */

  /* 默认文字颜色 */
  --hnui-text-color: var(--hnui-neutral-color-2);

  --hnui-info-bg: #eceff4;
  --hnui-info-bg2: #e7e7e7;

  --hnui-color-white: #fff;
  --hnui-color-black: #000;

  --hnui-border-width: 1px;
  --hnui-border-dashed-width: 2px;
  --hnui-border-color: var(--hnui-neutral-color-6);

  --hnui-disabled-bg-color: var(--hnui-neutral-color-7);
  --hnui-disabled-color: var(--hnui-neutral-color-5);

  --hnui-control-height: 32px;
  --hnui-control-height-sm: 24px;
  --hnui-control-height-lg: 40px;

  --hnui-control-transparent: transparent;
}

.dark {
  --hnui-brand-color6: rgb(50, 59, 74);
  --hnui-brand-color7: #30353d;
  --hnui-brand-color8: #42484f;
  --hnui-brand-color9: #4c4f54;
  --hnui-brand-color10: #29292c;

  /* 中性色 */

  /* 标题文字 */
  --hnui-neutral-color-1: #c4c8dc;

  /* 正文、重要信息文字、按钮文字、输入框正常状态文字等 */
  --hnui-neutral-color-2: #b9bed3;

  /* 内容文字、说明叙述文字 */
  --hnui-neutral-color-3: #afb5c7;

  /* 提示性文字、辅助文本 */
  --hnui-neutral-color-4: #6a6f75;

  /* 禁用文本 */
  --hnui-neutral-color-5: #53565b;

  /* 描边格描边、输入文本描边、下拉选择描边等 */
  --hnui-neutral-color-6: #59595a;

  /* 全局背景、禁用状态、分割线等 */
  --hnui-neutral-color-7: #343535;

  /* 最低颜色等 */
  --hnui-neutral-color-8: #151516;

  --hnui-info-bg: #393b3d;

  --hnui-color-white: #000;
  --hnui-color-black: #fff;

  --hnui-control-transparent: transparent;
}

*,
::before,
::after {
  box-sizing: border-box;
}

body {
  color: var(--hnui-neutral-color-2);
}

/* #region vars-FontFamily */
@font-face {
  font-family: 'DIN';
  src: url('/fonts/D-DIN-PRO/D-DIN-PRO.woff2') format('woff2'),
    url('/fonts/D-DIN-PRO/D-DIN-PRO.woff') format('woff'),
    url('/fonts/D-DIN-PRO/D-DIN-PRO.ttf') format('truetype'),
    url('/fonts/D-DIN-PRO/D-DIN-PRO.eot') format('embedded-opentype'),
    url('/fonts/D-DIN-PRO/D-DIN-PRO.svg') format('svg');
  font-weight: normal;
  font-style: normal;
}

/* 使用数字字体 */
.use-font {
  font-family: DIN;
}
/* #endregion vars-FontFamily */

/* #region vars-BoxShadow */
/* 一级投影（默认向下） */
.hnui-box-shadow {
  box-shadow: 0px 6px 16px 6px rgba(0, 0, 0, 0.18);
}
.hnui-box-shadow.hover,
.hnui-box-shadow:hover {
  box-shadow: 0px 6px 16px 6px rgba(31, 120, 255, 0.18);
}

/* 二级投影（默认向下） */
.hnui-box-shadow_l2 {
  box-shadow: 0px 6px 16px 6px rgba(0, 0, 0, 0.12);
}
.hnui-box-shadow_l2.hover,
.hnui-box-shadow_l2:hover {
  box-shadow: 0px 6px 16px 6px rgba(31, 120, 255, 0.12);
}

/* 三级投影（默认向下） */
.hnui-box-shadow_l3 {
  box-shadow: 0px 6px 16px 6px rgba(0, 0, 0, 0.06);
}
.hnui-box-shadow_l3.hover,
.hnui-box-shadow_l3:hover {
  box-shadow: 0px 6px 16px 6px rgba(31, 120, 255, 0.06);
}
/* #endregion vars-BoxShadow */
css

/* ========== 线性进度条 ========== */

/* 线性进度条容器 */
.hnui-progress-linear {
  display: flex;
  align-items: center;
  gap: 12px;
  width: 500px;
}

/* 线性进度条轨道 */
.hnui-progress-linear-track {
  position: relative;
  flex: 1;
  height: 8px;
  background-color: var(--hnui-neutral-color-6);
  border-radius: 100px;
  overflow: hidden;
}

/* 线性进度条填充 */
.hnui-progress-linear-bar {
  position: absolute;
  left: 0;
  top: 0;
  height: 100%;
  background-color: var(--hnui-brand-color);
  transition: width 0.3s ease;
}

/* 线性进度条文字（外显） */
.hnui-progress-linear-text {
  font-size: 14px;
  color: var(--hnui-text-color);
  white-space: nowrap;
  min-width: 48px;
  text-align: right;
}

/* 线性进度条文字（内显） */
.hnui-progress-linear-inner {
  position: relative;
}
.hnui-progress-linear-inner .hnui-progress-linear-track {
  height: 16px;
}

.hnui-progress-linear-inner-text {
  position: absolute;
  right: 12px;
  top: 50%;
  transform: translateY(-50%);
  font-size: 14px;
  color: var(--hnui-color-white);
  white-space: nowrap;
}

/* 特殊处理：进度 0-10% 时，文字显示在进度条右侧 */
.hnui-progress-linear-inner.is-low .hnui-progress-linear-inner-text {
  left: 10%;
  color: var(--hnui-text-color);
}

/* ========== 线性进度条状态 ========== */

/* 进行中（默认） */
.hnui-progress-linear-bar.is-active {
  background-color: var(--hnui-brand-color);
}

/* 完成 */
.hnui-progress-linear-bar.is-success {
  background-color: var(--hnui-success-color);
}

/* 中断 */
.hnui-progress-linear-bar.is-warning {
  background-color: var(--hnui-warning-color);
}

/* 错误 */
.hnui-progress-linear-bar.is-exception {
  background-color: var(--hnui-danger-color);
}

/* 状态图标 */
.hnui-progress-linear-icon {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 20px;
  height: 20px;
  border-radius: 50%;
  font-size: 12px;
  color: var(--hnui-color-white);
}

.hnui-progress-linear-icon.is-success {
  background-color: var(--hnui-success-color);
}

.hnui-progress-linear-icon.is-warning {
  background-color: var(--hnui-warning-color);
}

.hnui-progress-linear-icon.is-exception {
  background-color: var(--hnui-danger-color);
}

/* ========== 环形进度条 ========== */

.hnui-progress-circle {
  position: relative;
  display: inline-flex;
  align-items: center;
  justify-content: center;
}

.hnui-progress-circle-svg {
  transform: rotate(-90deg);
}

.hnui-progress-circle-track {
  fill: none;
  stroke: var(--hnui-neutral-color-6);
  stroke-width: 8;
}

.hnui-progress-circle-bar {
  fill: none;
  stroke: var(--hnui-brand-color);
  stroke-width: 8;
  stroke-linecap: round;
  transition: stroke-dashoffset 0.3s ease;
}

/* 环形进度条文字/图标 */
.hnui-progress-circle-content {
  position: absolute;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 24px;
  font-weight: 500;
  color: var(--hnui-text-color);
}

/* ========== 环形进度条状态 ========== */

/* 进行中（默认） */
.hnui-progress-circle-bar.is-active {
  stroke: var(--hnui-brand-color);
}

/* 完成 */
.hnui-progress-circle-bar.is-success {
  stroke: var(--hnui-success-color);
}

/* 中断 */
.hnui-progress-circle-bar.is-warning {
  stroke: var(--hnui-warning-color);
}

/* 错误 */
.hnui-progress-circle-bar.is-exception {
  stroke: var(--hnui-danger-color);
}

/* 状态图标 */
.hnui-progress-circle-icon {
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 48px;
}

.hnui-progress-circle-icon.is-success {
  color: var(--hnui-success-color);
}

.hnui-progress-circle-icon.is-warning {
  color: var(--hnui-warning-color);
}

.hnui-progress-circle-icon.is-exception {
  color: var(--hnui-danger-color);
}

/* === 暗色模式适配 === */
.dark .hnui-progress-linear-track {
  background-color: var(--hnui-neutral-color-7);
}

.dark .hnui-progress-circle-track {
  stroke: var(--hnui-neutral-color-7);
}

.dark .hnui-progress-linear-text,
.dark .hnui-progress-circle-content {
  color: var(--hnui-neutral-color-3);
}

.dark .hnui-progress-linear-inner.is-low .hnui-progress-linear-inner-text {
  color: var(--hnui-neutral-color-3);
}

线性进度条 ​

线性进度条用于展示操作进度，百分比文字显示在进度条右侧。

80%
查看代码
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div
      class="hnui-progress-linear-bar"
      :style="{ width: 80 + '%' }"
    ></div>
  </div>
  <div class="hnui-progress-linear-text">80%</div>
</div>

线性进度条（百分比内显） ​

进度条百分比可以显示在进度条内部。当进度 0-10% 时，数字位置出现在当前进度的右边区域。

80%
进度0–10%时数字位置出现在目前进度的右边区域
10%
查看代码
html
<script setup></script>

<template>
  <div class="docs-demo-items">
    <!-- #region progress-linear-base -->
    <div class="hnui-progress-linear hnui-progress-linear-inner">
      <div class="hnui-progress-linear-track">
        <div class="hnui-progress-linear-bar" :style="{ width: '80%' }">
          <div class="hnui-progress-linear-inner-text">80%</div>
        </div>
      </div>
    </div>
    <!-- #endregion progress-linear-base -->

    <div style="margin-top: 40px; color: var(--hnui-neutral-color-4)">
      进度0–10%时数字位置出现在目前进度的右边区域
    </div>
    <!-- #region progress-linear-inner -->
    <div
      class="hnui-progress-linear hnui-progress-linear-inner is-low"
      style="margin-top: 16px"
    >
      <div class="hnui-progress-linear-track">
        <div class="hnui-progress-linear-bar" :style="{ width: '10%' }"></div>
        <div class="hnui-progress-linear-inner-text">10%</div>
      </div>
    </div>
    <!-- #endregion progress-linear-inner -->
  </div>
</template>

<style scoped>
@import "./progress.css";
</style>
html
<script setup></script>

<template>
  <div class="docs-demo-items">
    <!-- #region progress-linear-base -->
    <div class="hnui-progress-linear hnui-progress-linear-inner">
      <div class="hnui-progress-linear-track">
        <div class="hnui-progress-linear-bar" :style="{ width: '80%' }">
          <div class="hnui-progress-linear-inner-text">80%</div>
        </div>
      </div>
    </div>
    <!-- #endregion progress-linear-base -->

    <div style="margin-top: 40px; color: var(--hnui-neutral-color-4)">
      进度0–10%时数字位置出现在目前进度的右边区域
    </div>
    <!-- #region progress-linear-inner -->
    <div
      class="hnui-progress-linear hnui-progress-linear-inner is-low"
      style="margin-top: 16px"
    >
      <div class="hnui-progress-linear-track">
        <div class="hnui-progress-linear-bar" :style="{ width: '10%' }"></div>
        <div class="hnui-progress-linear-inner-text">10%</div>
      </div>
    </div>
    <!-- #endregion progress-linear-inner -->
  </div>
</template>

<style scoped>
@import "./progress.css";
</style>

环形进度条 ​

环形进度条以圆形方式展示操作进度，百分比文字显示在中心。

30%
查看代码
html
<div class="hnui-progress-circle" :style="{ width: 120 + 'px', height: 120 + 'px' }">
  <svg class="hnui-progress-circle-svg" :width="120" :height="120">
    <circle
      class="hnui-progress-circle-track"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
    />
    <circle
      class="hnui-progress-circle-bar"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
      :stroke-dasharray="2 * Math.PI * ((120 - 8) / 2)"
      :stroke-dashoffset="2 * Math.PI * ((120 - 8) / 2) - (30 / 100) * 2 * Math.PI * ((120 - 8) / 2)"
    />
  </svg>
  <div class="hnui-progress-circle-content">30%</div>
</div>

进度条状态 ​

环形进度条状态 ​

环形进度条支持多种状态：进行中、完成、中断、错误。完成状态显示 ✓ 图标，中断状态显示 ! 图标，错误状态显示 ✕ 图标。

进行中
30%
进度完成
✓
进度被中断
!
进度状态发生重大错误
✕
查看代码
html
<div
  class="hnui-progress-circle"
  :style="{ width: 120 + 'px', height: 120 + 'px' }"
>
  <svg class="hnui-progress-circle-svg" :width="120" :height="120">
    <circle
      class="hnui-progress-circle-track"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
    />
    <circle
      class="hnui-progress-circle-bar is-active"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
      :stroke-dasharray="2 * Math.PI * ((120 - 8) / 2)"
      :stroke-dashoffset="
        2 * Math.PI * ((120 - 8) / 2) - (30 / 100) * 2 * Math.PI * ((120 - 8) / 2)
      "
    />
  </svg>
  <div class="hnui-progress-circle-content">30%</div>
</div>
html
<div
  class="hnui-progress-circle"
  :style="{ width: 120 + 'px', height: 120 + 'px' }"
>
  <svg class="hnui-progress-circle-svg" :width="120" :height="120">
    <circle
      class="hnui-progress-circle-track"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
    />
    <circle
      class="hnui-progress-circle-bar is-success"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
      :stroke-dasharray="2 * Math.PI * ((120 - 8) / 2)"
      :stroke-dashoffset="
        2 * Math.PI * ((120 - 8) / 2) -
        (100 / 100) * 2 * Math.PI * ((120 - 8) / 2)
      "
    />
  </svg>
  <div class="hnui-progress-circle-content">
    <div class="hnui-progress-circle-icon is-success">✓</div>
  </div>
</div>
html
<div
  class="hnui-progress-circle"
  :style="{ width: 120 + 'px', height: 120 + 'px' }"
>
  <svg class="hnui-progress-circle-svg" :width="120" :height="120">
    <circle
      class="hnui-progress-circle-track"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
    />
    <circle
      class="hnui-progress-circle-bar is-warning"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
      :stroke-dasharray="2 * Math.PI * ((120 - 8) / 2)"
      :stroke-dashoffset="
        2 * Math.PI * ((120 - 8) / 2) - (75 / 100) * 2 * Math.PI * ((120 - 8) / 2)
      "
    />
  </svg>
  <div class="hnui-progress-circle-content">
    <div class="hnui-progress-circle-icon is-warning">!</div>
  </div>
</div>
html
<div
  class="hnui-progress-circle"
  :style="{ width: 120 + 'px', height: 120 + 'px' }"
>
  <svg class="hnui-progress-circle-svg" :width="120" :height="120">
    <circle
      class="hnui-progress-circle-track"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
    />
    <circle
      class="hnui-progress-circle-bar is-exception"
      :cx="120 / 2"
      :cy="120 / 2"
      :r="(120 - 8) / 2"
      :stroke-dasharray="2 * Math.PI * ((120 - 8) / 2)"
      :stroke-dashoffset="
        2 * Math.PI * ((120 - 8) / 2) - (75 / 100) * 2 * Math.PI * ((120 - 8) / 2)
      "
    />
  </svg>
  <div class="hnui-progress-circle-content">
    <div class="hnui-progress-circle-icon is-exception">✕</div>
  </div>
</div>

线性进度条状态 ​

线性进度条同样支持多种状态，完成、中断、错误状态会在进度条右侧显示对应的状态图标。

进行中
80%
进度完成
✓
进度被中断
!
进度状态发生重大错误
✕
查看代码
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-active" style="width: 80%"></div>
  </div>
  <div class="hnui-progress-linear-text">80%</div>
</div>
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-success" style="width: 100%"></div>
  </div>
  <div class="hnui-progress-linear-icon is-success">✓</div>
</div>
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-warning" style="width: 75%"></div>
  </div>
  <div class="hnui-progress-linear-icon is-warning">!</div>
</div>
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-exception" style="width: 60%"></div>
  </div>
  <div class="hnui-progress-linear-icon is-exception">✕</div>
</div>

线形进度条（百分比内显） ​

内显百分比的线性进度条状态变体，完成、中断、错误状态会在右侧显示状态图标。

进行中
80%
进度完成
✓
进度被中断
!
进度状态发生重大错误
✕
查看代码
html
<div class="hnui-progress-linear hnui-progress-linear-inner">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-active" style="width: 80%">
      <div class="hnui-progress-linear-inner-text">80%</div>
    </div>
  </div>
</div>
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-success" style="width: 100%"></div>
  </div>
  <div class="hnui-progress-linear-icon is-success">✓</div>
</div>
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-warning" style="width: 75%"></div>
  </div>
  <div class="hnui-progress-linear-icon is-warning">!</div>
</div>
html
<div class="hnui-progress-linear">
  <div class="hnui-progress-linear-track">
    <div class="hnui-progress-linear-bar is-exception" style="width: 60%"></div>
  </div>
  <div class="hnui-progress-linear-icon is-exception">✕</div>
</div>

统一UI

Copyright © 2024