@agile-team/wl-skills-kit 1.0.0

package/files/src/components/local/c_formSections/data.ts

@@ -0,0 +1,175 @@
+/*
+ * @Author: ChenYu ycyplus@gmail.com
+ * @Date: 2026-01-01 13:30:00
+ * @LastEditors: ChenYu ycyplus@gmail.com
+ * @LastEditTime: 2026-01-01 13:30:00
+ * @FilePath: \cx-ui-sale\src\components\local\c_formSections\data.ts
+ * @Description: 表单区块组件 - 类型定义
+ * Copyright (c) 2026 by CHENY, All Rights Reserved 😎.
+ */
+
+import type { Component } from "vue";
+
+// ========== 类型定义 ==========
+
+/**
+ * 字段配置接口
+ * 定义表单字段的基本属性和行为
+ */
+export interface FieldConfig {
+  /** 字段属性名（对应 form 对象的 key） */
+  prop: string;
+  /** 字段标签 */
+  label: string;
+  /** 字段类型 */
+  type?:
+    | "input"
+    | "select"
+    | "textarea"
+    | "date"
+    | "datetime"
+    | "number"
+    | "custom";
+  /** 栅格占据列数（1-24） */
+  span?: number;
+  /** 是否必填 */
+  required?: boolean;
+  /** 占位符文本 */
+  placeholder?: string;
+  /** 是否可清空（select） */
+  clearable?: boolean;
+  /** 下拉选项（select） */
+  options?: Array<{ label: string; value: string | number }>;
+  /** 文本域行数（textarea） */
+  rows?: number;
+  /** 最小值（number） */
+  min?: number;
+  /** 最大值（number） */
+  max?: number;
+  /** 数字精度（number） */
+  precision?: number;
+  /** 步长（number） */
+  step?: number;
+}
+
+/**
+ * 区块配置接口
+ * 定义折叠面板区块的结构和行为
+ */
+export interface SectionConfig {
+  /** 折叠面板的 name 值（唯一标识） */
+  name: string;
+  /** 折叠面板 ID（用于锚点跳转） */
+  id: string;
+  /** 显示的标题 */
+  title: string;
+  /** 字段配置数组 */
+  fieldsConfig: FieldConfig[];
+  /** 显示条件函数（可选，返回 true 显示，false 隐藏） */
+  visible?: () => boolean;
+  /** 是否为特殊处理的区块（如特殊需求） */
+  isSpecial?: boolean;
+}
+
+/**
+ * 表单数据类型
+ * 使用索引签名支持动态字段
+ */
+export interface FormDataType {
+  [key: string]: any;
+}
+
+/**
+ * 楼层导航配置接口
+ */
+export interface NavTabConfig {
+  /** 标签名称（唯一标识） */
+  name: string;
+  /** 显示文本 */
+  label: string;
+  /** 关联的 section name（用于锚点跳转） */
+  sectionName?: string | null;
+}
+
+/**
+ * 顶部操作按钮配置接口
+ */
+export interface HeaderAction {
+  /** 按钮文本 */
+  label: string;
+  /** 按钮类型 */
+  type?: "primary" | "success" | "warning" | "danger" | "info" | "text" | "";
+  /** 图标名称（Element Plus Icon 组件或字符串） */
+  icon?: string | Component;
+  /** 点击事件回调 */
+  onClick: () => void;
+  /** 是否禁用 */
+  disabled?: boolean;
+}
+
+/**
+ * 布局选项配置接口
+ */
+export interface LayoutOption {
+  /** 列数 */
+  columns: 2 | 3 | 4 | 5;
+  /** 显示图标 */
+  icon: string;
+  /** 提示文本 */
+  title: string;
+}
+
+// ========== 工具函数 ==========
+
+/**
+ * 根据必填条件过滤字段配置
+ * @param fields 原始字段配置数组
+ * @param onlyRequired 是否只显示必填字段
+ */
+export function filterFieldsByRequired(
+  fields: FieldConfig[],
+  onlyRequired: boolean
+): FieldConfig[] {
+  if (!onlyRequired) return fields;
+  return fields.filter((field) => field.required);
+}
+
+/**
+ * 判断区块是否有可显示的字段
+ * @param fields 字段配置数组
+ */
+export function hasSectionFields(fields: FieldConfig[]): boolean {
+  return fields.length > 0;
+}
+
+/**
+ * 生成默认表单数据
+ * @param sections 区块配置数组
+ */
+export function generateDefaultFormData(
+  sections: SectionConfig[]
+): FormDataType {
+  const formData: FormDataType = {};
+
+  sections.forEach((section) => {
+    section.fieldsConfig.forEach((field) => {
+      // 根据字段类型设置默认值
+      switch (field.type) {
+        case "number":
+          formData[field.prop] = field.min || 0;
+          break;
+        case "select":
+          formData[field.prop] = "";
+          break;
+        case "date":
+        case "datetime":
+          formData[field.prop] = null;
+          break;
+        default:
+          formData[field.prop] = "";
+      }
+    });
+  });
+
+  return formData;
+}

package/files/src/components/local/c_formSections/index.scss

@@ -0,0 +1,280 @@
+/*
+ * @Author: ChenYu ycyplus@gmail.com
+ * @Date: 2026-01-01 13:30:00
+ * @LastEditors: ChenYu ycyplus@gmail.com
+ * @LastEditTime: 2026-01-01 16:30:00
+ * @FilePath: \cx-ui-sale\src\components\local\c_formSections\index.scss
+ * @Description: 表单区块组件 - 样式
+ * Copyright (c) 2026 by CHENY, All Rights Reserved 😎.
+ */
+
+// ===== 组件包裹容器 =====
+.c-form-sections-wrapper {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  background: #fff;
+}
+
+// ===== 顶部标题栏 =====
+.c-form-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 10px 16px;
+  background: #fff;
+  border-bottom: 1px solid #e4e7ed;
+  flex-shrink: 0;
+
+  .header-title {
+    font-size: 14px;
+    font-weight: 600;
+    color: #303133;
+  }
+
+  .header-right {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+// 按钮样式优化
+  .el-button {
+    font-size: 13px;
+
+    .el-icon {
+      margin-right: 4px;
+    }
+  }
+  }
+}
+
+// ===== 布局切换器 =====
+.layout-switcher {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  border: 1px dashed #dcdfe6;
+  padding: 4px 8px;
+  border-radius: 2px;
+
+  .layout-icon {
+    font-size: 11px;
+    color: #c0c4cc;
+    cursor: pointer;
+    padding: 2px 6px;
+    border-radius: 2px;
+    font-family: Arial, sans-serif;
+    letter-spacing: -1px;
+    user-select: none;
+    transition: color 0.2s;
+
+    &:hover {
+      color: #409eff;
+    }
+
+    &.active {
+      color: #409eff;
+    }
+  }
+}
+
+// ===== 工具栏 =====
+.c-form-toolbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 10px 20px;
+  background: #fafafa;
+  border-bottom: 1px solid #e4e7ed;
+
+  .toolbar-left,
+  .toolbar-right {
+    display: flex;
+    align-items: center;
+    gap: 16px;
+  }
+
+  .required-toggle {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+
+    .label {
+      font-size: 13px;
+      color: #606266;
+      user-select: none;
+    }
+  }
+}
+
+// ===== 主体内容区域 =====
+.c-form-content {
+  display: flex;
+  flex: 1;
+  overflow: hidden;
+
+  // 左侧导航
+  .nav-tabs {
+    flex-shrink: 0;
+    width: 140px;
+    border-right: 1px solid #e4e7ed;
+
+    :deep(.el-tabs__header) {
+      margin: 0;
+    }
+
+    :deep(.el-tabs__nav-wrap) {
+      &::after {
+        display: none;
+      }
+    }
+
+    // 隐藏 Element Plus 默认的激活指示器竖线
+    :deep(.el-tabs__active-bar) {
+      display: none;
+    }
+
+    :deep(.el-tabs__item) {
+      padding: 0 16px;
+      height: 36px;
+      line-height: 36px;
+      font-size: 13px;
+      color: #606266;
+      text-align: left;
+
+      &:hover {
+        background-color: #f5f7fa !important;
+      }
+
+      &.is-active {
+        color: #409eff !important;
+        background-color: rgba(64, 158, 255, 0.1) !important;
+        font-weight: 500;
+      }
+    }
+  }
+
+  // 表单容器
+  .form-container {
+    flex: 1;
+    overflow-y: auto;
+    padding: 16px 20px;
+  }
+}
+
+// ===== 折叠面板标题样式 =====
+.section-title {
+  font-size: 14px;
+  font-weight: 600;
+  color: #303133;
+  margin-right: 12px;
+  padding-left: 12px;
+  position: relative;
+
+  // 左侧短竖线装饰
+  &::before {
+    content: "";
+    position: absolute;
+    left: 0;
+    top: 50%;
+    transform: translateY(-50%);
+    width: 3px;
+    height: 14px;
+    background-color: #409eff;
+    border-radius: 2px;
+  }
+}
+
+// ===== 折叠面板内容样式 =====
+:deep(.el-collapse-item__content) {
+  padding-top: 10px;
+  padding-bottom: 10px;
+}
+
+// ===== 表单项样式优化 =====
+:deep(.el-form-item) {
+  margin-bottom: 14px;
+
+  // 标签样式
+  .el-form-item__label {
+    font-size: 13px;
+    color: #606266;
+
+    // 必填标记样式
+    &::before {
+      margin-right: 2px;
+    }
+  }
+
+  // 输入框样式
+  .el-input__inner,
+  .el-textarea__inner {
+    font-size: 13px;
+  }
+
+  // 选择框样式
+  .el-select {
+    width: 100%;
+  }
+}
+
+// ===== 分割线样式 =====
+:deep(.el-divider) {
+  margin: 0;
+  flex: 1;
+}
+
+// ===== 折叠面板标题容器 =====
+:deep(.el-collapse) {
+  border-top: 0;
+  border-bottom: 0;
+}
+:deep(.el-collapse-item__header) {
+  display: flex;
+  align-items: center;
+  padding: 0 16px;
+  height: 48px;
+  font-weight: normal;
+  border-bottom: 0;
+  border-top: 0;
+  // hover 效果
+  &:hover {
+    background-color: #f5f7fa;
+  }
+
+  // 展开箭头
+  .el-collapse-item__arrow {
+    margin-right: 8px;
+  }
+}
+:deep(.el-collapse-item__wrap) {
+  border-bottom: 0;
+}
+
+// ===== 空状态样式 =====
+:deep(.el-empty) {
+  padding: 24px 0;
+
+  .el-empty__description {
+    font-size: 13px;
+    color: #909399;
+  }
+}
+
+// ===== 响应式适配 =====
+@media screen and (max-width: 1440px) {
+  :deep(.el-form-item) {
+    margin-bottom: 16px;
+  }
+
+  .section-title {
+    font-size: 13px;
+  }
+
+  .c-form-header .header-title {
+    font-size: 15px;
+  }
+
+  .nav-tabs {
+    width: 120px;
+  }
+}