UI设计规范及说明

Appearance

Collapse 折叠面板 ​

可以将较多或较复杂的内容进行分组，分组内容区可以折叠展开或隐藏。

CSS样式 ​

全部collapse样式代码：

查看代码
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-collapse {
  border: 1px solid var(--hnui-border-color);
  border-radius: 6px;
  background-color: transparent;
}

/* === 折叠项 === */
.hnui-collapse-item {
  border-bottom: 1px solid var(--hnui-border-color);
}

.hnui-collapse-item:last-child {
  border-bottom: none;
}

/* === 折叠项头部 === */
.hnui-collapse-header {
  display: flex;
  align-items: center;
  padding: 12px 16px;
  cursor: pointer;
  user-select: none;
  transition: background-color 0.3s;
  background-color: transparent;
}

.hnui-collapse-header:hover {
  background-color: var(--hnui-neutral-color-7);
}

/* 头部内容区域 */
.hnui-collapse-header-content {
  flex: 1;
  display: flex;
  align-items: center;
  gap: 8px;
}

/* 展开图标 */
.hnui-collapse-expand-icon {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  font-size: 12px;
  color: var(--hnui-text-color);
  transition: transform 0.3s;
}

.hnui-collapse-item-active .hnui-collapse-expand-icon {
  transform: rotate(90deg);
}

/* 标题文本 */
.hnui-collapse-title {
  font-size: 14px;
  color: var(--hnui-text-color);
  line-height: 22px;
}

/* 额外内容（右侧插槽） */
.hnui-collapse-extra {
  margin-left: auto;
  display: flex;
  align-items: center;
  gap: 8px;
}

/* === 折叠内容区域 === */
.hnui-collapse-content {
  max-height: 0;
  overflow: hidden;
  transition: max-height 0.3s ease-in-out;
  background-color: var(--hnui-neutral-color-7);
}

.hnui-collapse-item-active .hnui-collapse-content {
  max-height: 1000px;
}

.hnui-collapse-content-box {
  padding: 16px;
  font-size: 14px;
  color: var(--hnui-text-color);
  line-height: 22px;
}

/* === 暗色模式适配 === */
.dark .hnui-collapse {
  border-color: var(--hnui-neutral-color-6);
}

.dark .hnui-collapse-item {
  border-color: var(--hnui-neutral-color-6);
}

.dark .hnui-collapse-header:hover {
  background-color: var(--hnui-neutral-color-6);
}

.dark .hnui-collapse-content {
  background-color: var(--hnui-neutral-color-6);
}
js
~(function () {
  'use strict';

  const activeClass = 'hnui-collapse-item-active';
  const accordionClass = 'hnui-collapse-accordion';
  const headerSelector = '.hnui-collapse-header';
  const itemSelector = '.hnui-collapse-item';
  const collapseSelector = '.hnui-collapse';
  const extraSelector = '.hnui-collapse-extra';

  /**
   * 切换折叠面板项的展开/收起状态
   * @param {HTMLElement} item - 折叠面板项元素
   * @param {HTMLElement} collapse - 折叠面板容器元素
   */
  function toggleItem(item, collapse) {
    const isAccordion = collapse.classList.contains(accordionClass);
    const isActive = item.classList.contains(activeClass);

    if (isAccordion) {
      // 手风琴模式：先关闭所有其他项
      const allItems = collapse.querySelectorAll(itemSelector);
      allItems.forEach(function (otherItem) {
        if (otherItem !== item) {
          otherItem.classList.remove(activeClass);
        }
      });
    }

    // 切换当前项状态
    if (isActive) {
      item.classList.remove(activeClass);
    } else {
      item.classList.add(activeClass);
    }
  }

  // 使用事件委托监听点击事件
  document.body.addEventListener('click', function (event) {
    const header = event.target.closest(headerSelector);
    if (!header) return;

    // 检查是否点击在 extra 区域，如果是则不触发折叠
    const extra = event.target.closest(extraSelector);
    if (extra) return;

    const item = header.closest(itemSelector);
    const collapse = header.closest(collapseSelector);

    if (item && collapse) {
      toggleItem(item, collapse);
    }
  });
})();

基础用法 ​

可以同时展开多个面板，面板之间互不影响。

这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容，可根据不同业务或用户的使用诉求，进行自定义填充。可以是纯文本、图文、子列表等内容形式。
这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容。
这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容。
这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容。
查看代码
html
<div class="hnui-collapse">
  <div class="hnui-collapse-item hnui-collapse-item-active">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容，可根据不同业务或用户的使用诉求，进行自定义填充。可以是纯文本、图文、子列表等内容形式。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item hnui-collapse-item-active">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>
</div>

手风琴折叠面板 ​

手风琴模式下，一次只能展开一个面板。

这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容。
这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容,可根据不同业务或用户的使用诉求,进行自定义填充。可以是纯文本、图文、子列表等内容形式。
这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容。
这是一个折叠面板标题
这部分是每个折叠面板折叠或展开的内容。
查看代码
html
<div class="hnui-collapse hnui-collapse-accordion">
  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item hnui-collapse-item-active">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容,可根据不同业务或用户的使用诉求,进行自定义填充。可以是纯文本、图文、子列表等内容形式。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>
</div>

带插槽的折叠面板 ​

可以在折叠面板标题右侧自定义额外内容，如添加链接等。

这是一个折叠面板标题
跳转链接跳转链接跳转链接
这部分是每个折叠面板折叠或展开的内容。
这是一个折叠面板标题
跳转链接跳转链接跳转链接
这部分是每个折叠面板折叠或展开的内容。
这是一个折叠面板标题
跳转链接跳转链接跳转链接
这部分是每个折叠面板折叠或展开的内容。
这是一个折叠面板标题
跳转链接跳转链接跳转链接
这部分是每个折叠面板折叠或展开的内容。
查看代码
html
<div class="hnui-collapse">
  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
      <div class="hnui-collapse-extra">
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
      <div class="hnui-collapse-extra">
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
      <div class="hnui-collapse-extra">
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>

  <div class="hnui-collapse-item">
    <div class="hnui-collapse-header">
      <div class="hnui-collapse-header-content">
        <span class="hnui-collapse-expand-icon">
          <i class="hnui-icon hnui-icon-chevron-right"></i>
        </span>
        <span class="hnui-collapse-title">这是一个折叠面板标题</span>
      </div>
      <div class="hnui-collapse-extra">
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
        <a href="#" class="hnui-link">跳转链接</a>
      </div>
    </div>
    <div class="hnui-collapse-content">
      <div class="hnui-collapse-content-box">
        这部分是每个折叠面板折叠或展开的内容。
      </div>
    </div>
  </div>
</div>

统一UI

Copyright © 2024