@pisell/materials 6.3.23 → 6.3.24

package/lib/components/PisellSteps/PisellSteps.js

@@ -0,0 +1,252 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/PisellSteps.tsx
+var PisellSteps_exports = {};
+__export(PisellSteps_exports, {
+  default: () => PisellSteps_default
+});
+module.exports = __toCommonJS(PisellSteps_exports);
+var import_antd = require("antd");
+var import_react = __toESM(require("react"));
+var import_PisellSteps = require("./PisellSteps.less");
+var import_hooks = require("./hooks");
+var import_utils = require("./utils");
+var import_PisellScrollView = __toESM(require("../PisellScrollView"));
+var PisellSteps = ({
+  // 基础属性
+  type = "default",
+  current: controlledCurrent,
+  defaultCurrent = 0,
+  direction = "horizontal",
+  size = "default",
+  status = "process",
+  initial = 0,
+  items = [],
+  labelPlacement = "horizontal",
+  responsive = true,
+  onChange,
+  className,
+  style,
+  progressDot,
+  // 扩展功能属性
+  clickable = false,
+  allowClickFinished = true,
+  gridLayout = false,
+  gridColumns,
+  itemGap,
+  enableAnchor = false,
+  anchorContainer,
+  mobileMode = "full",
+  mobileBreakpoint = 744,
+  // 滚动模式属性
+  enableScrollMode = false,
+  scrollActionsConfig,
+  // 低代码属性
+  __designMode,
+  __id,
+  other,
+  ...restProps
+}) => {
+  const [currentStep, setCurrentStep] = (0, import_hooks.useStepsState)(
+    controlledCurrent,
+    defaultCurrent,
+    onChange
+  );
+  const handleStepClick = (0, import_hooks.useStepClick)(
+    currentStep,
+    clickable,
+    allowClickFinished,
+    setCurrentStep
+  );
+  (0, import_hooks.useAnchor)(currentStep, enableAnchor, anchorContainer);
+  const isMobile = (0, import_hooks.useResponsive)(mobileBreakpoint);
+  const showMobileCurrentView = (0, import_react.useMemo)(() => {
+    if (mobileMode === "current") return true;
+    if (mobileMode === "auto" && isMobile) return true;
+    return false;
+  }, [mobileMode, isMobile]);
+  const safeItems = (0, import_react.useMemo)(() => {
+    if (!items) return [];
+    if (!Array.isArray(items)) return [];
+    return items;
+  }, [items]);
+  const currentStepItem = (0, import_react.useMemo)(() => {
+    const visibleItems = safeItems.filter((item) => !item.hidden);
+    const adjustedIndex = currentStep - initial;
+    if (adjustedIndex < 0 || adjustedIndex >= visibleItems.length) {
+      return null;
+    }
+    return visibleItems[adjustedIndex] || null;
+  }, [safeItems, currentStep, initial]);
+  const processedItems = (0, import_react.useMemo)(() => {
+    const visibleItems = safeItems.filter((item) => !item.hidden);
+    if (__designMode === "design" && visibleItems.length === 0) {
+      return [
+        {
+          title: "步骤一",
+          description: "This is a description.",
+          status: "finish"
+        },
+        {
+          title: "步骤二",
+          description: "This is a description.",
+          status: "process"
+        },
+        {
+          title: "步骤三",
+          description: "This is a description.",
+          status: "wait"
+        }
+      ];
+    }
+    return visibleItems.filter((item) => item != null).map((item, index) => {
+      const adjustedIndex = index + initial;
+      let stepStatus;
+      if (item.status) {
+        stepStatus = item.status;
+      } else if (adjustedIndex === currentStep) {
+        stepStatus = status;
+      } else {
+        stepStatus = (0, import_utils.getStepStatus)(adjustedIndex, currentStep);
+      }
+      const stepClassName = (0, import_utils.mergeStepClassName)(
+        "pisell-steps-item",
+        stepStatus,
+        item.className
+      );
+      const handleClick = () => {
+        var _a;
+        if (!item.disabled) {
+          (_a = item.onClick) == null ? void 0 : _a.call(item);
+          handleStepClick(adjustedIndex, item);
+        }
+      };
+      return {
+        ...item,
+        status: stepStatus,
+        className: stepClassName,
+        onClick: clickable || item.onClick ? handleClick : void 0
+      };
+    });
+  }, [
+    safeItems,
+    currentStep,
+    initial,
+    status,
+    clickable,
+    handleStepClick,
+    __designMode
+  ]);
+  const wrapperClassName = (0, import_react.useMemo)(() => {
+    const classes = ["pisell-steps"];
+    if (className) classes.push(className);
+    if (type === "navigation") classes.push("pisell-steps-navigation");
+    if (progressDot) classes.push("pisell-steps-dot");
+    if (size !== "default") classes.push(`pisell-steps-${size}`);
+    if (direction === "vertical") classes.push("pisell-steps-vertical");
+    if (responsive) classes.push("pisell-steps-responsive");
+    if (clickable) classes.push("pisell-steps-clickable");
+    if (gridLayout) classes.push("pisell-steps-grid-layout");
+    if (itemGap !== void 0 && itemGap !== null) {
+      classes.push("pisell-steps-has-item-gap");
+    }
+    return classes.join(" ");
+  }, [
+    className,
+    type,
+    progressDot,
+    size,
+    direction,
+    responsive,
+    clickable,
+    gridLayout,
+    itemGap
+  ]);
+  const wrapperStyle = (0, import_react.useMemo)(() => {
+    const customStyle = { ...style };
+    if (itemGap !== void 0 && itemGap !== null) {
+      customStyle["--pisell-steps-item-gap"] = `${itemGap}px`;
+      customStyle["--pisell-steps-has-item-gap"] = "1";
+    }
+    if (gridColumns && gridLayout) {
+      customStyle["--pisell-steps-grid-columns"] = gridColumns;
+    }
+    return customStyle;
+  }, [style, itemGap, gridColumns, gridLayout]);
+  const defaultScrollActionsConfig = (0, import_react.useMemo)(() => ({
+    show: true,
+    type: "lrArrows",
+    scrollDistance: 200,
+    ...scrollActionsConfig
+  }), [scrollActionsConfig]);
+  const renderStepsContent = (forceHorizontal = false) => /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Steps,
+    {
+      current: Math.max(0, currentStep - initial),
+      direction: forceHorizontal ? "horizontal" : direction,
+      size: size === "large" ? "default" : size,
+      status,
+      items: processedItems,
+      labelPlacement,
+      type,
+      progressDot,
+      responsive: forceHorizontal ? false : responsive,
+      ...restProps,
+      ...other || {}
+    }
+  );
+  const renderDesktopSteps = () => {
+    if (enableScrollMode) {
+      return /* @__PURE__ */ import_react.default.createElement(
+        import_PisellScrollView.default,
+        {
+          className: "pisell-steps-scroll-view",
+          overflow: "x",
+          scrollbarStyle: "none",
+          scrollActionsConfig: defaultScrollActionsConfig,
+          snapScroll: { enabled: false }
+        },
+        /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-steps-scroll-content" }, renderStepsContent(true))
+      );
+    }
+    return renderStepsContent(false);
+  };
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      className: showMobileCurrentView ? `pisell-steps pisell-steps-mobile-current ${className || ""}` : wrapperClassName,
+      style: showMobileCurrentView ? style : wrapperStyle,
+      "data-component": "pisell-steps",
+      "data-id": __id
+    },
+    showMobileCurrentView ? /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-steps-mobile-current__info" }, (currentStepItem == null ? void 0 : currentStepItem.title) && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-steps-mobile-current__number" }, currentStepItem.title), (currentStepItem == null ? void 0 : currentStepItem.description) && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-steps-mobile-current__title" }, currentStepItem.description)) : /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, renderDesktopSteps())
+  );
+};
+PisellSteps.displayName = "PisellSteps";
+var PisellSteps_default = PisellSteps;

package/lib/components/PisellSteps/PisellSteps.less

@@ -0,0 +1,332 @@
+// PisellSteps 组件样式
+// 基于 Ant Design Steps 进行样式扩展和定制
+
+@pisell-steps-prefix: pisell-steps;
+
+// ============ CSS 变量定义 ============
+.@{pisell-steps-prefix} {
+  // 间距相关
+  --pisell-steps-item-gap: 8px;
+  --pisell-steps-margin: 16px;
+
+  // 栅格布局
+  --pisell-steps-grid-columns: 3;
+
+  // 颜色变量
+  --pisell-steps-primary-color: #7f56d9;
+  --pisell-steps-primary-light: #f4ebff;
+  --pisell-steps-text-color: rgba(0, 0, 0, 0.88);
+  --pisell-steps-text-secondary: rgba(0, 0, 0, 0.45);
+  --pisell-steps-border-color: rgba(0, 0, 0, 0.06);
+  --pisell-steps-error-color: #ff4d4f;
+  --pisell-steps-success-color: #52c41a;
+}
+
+// ============ 基础样式 ============
+.@{pisell-steps-prefix} {
+  position: relative;
+  width: 100%;
+
+  // 默认尺寸（32px）- 当没有设置 size 或 size='default' 时
+  .ant-steps-item-icon {
+    width: 32px;
+    height: 32px;
+    line-height: 32px;
+  }
+
+  // 覆盖 Ant Design 默认样式，使用自定义主题色
+  .ant-steps-item-finish {
+    .ant-steps-item-icon {
+      background-color: var(--pisell-steps-primary-light);
+      border-color: var(--pisell-steps-primary-light);
+
+      > .ant-steps-icon {
+        color: var(--pisell-steps-primary-color);
+      }
+    }
+
+    .ant-steps-item-tail::after {
+      background-color: var(--pisell-steps-primary-color);
+    }
+  }
+
+  .ant-steps-item-process {
+    .ant-steps-item-icon {
+      background-color: var(--pisell-steps-primary-color);
+      border-color: var(--pisell-steps-primary-color);
+
+      > .ant-steps-icon {
+        color: #ffffff;
+      }
+    }
+  }
+
+  .ant-steps-item-wait {
+    .ant-steps-item-icon {
+      background-color: var(--pisell-steps-border-color);
+      border-color: var(--pisell-steps-border-color);
+
+      > .ant-steps-icon {
+        color: var(--pisell-steps-text-secondary);
+      }
+    }
+  }
+
+  .ant-steps-item-error {
+    .ant-steps-item-icon {
+      background-color: var(--pisell-steps-error-color);
+      border-color: var(--pisell-steps-error-color);
+
+      > .ant-steps-icon {
+        color: #ffffff;
+      }
+    }
+  }
+}
+
+// ============ 可点击样式 ============
+.@{pisell-steps-prefix}-clickable {
+  .ant-steps-item,
+  .pisell-lowcode-steps-item {
+    cursor: pointer;
+    transition: all 0.3s ease;
+
+    &:hover {
+      .ant-steps-item-icon {
+        transform: scale(1.1);
+      }
+    }
+
+    &-finish {
+      &:hover {
+        .ant-steps-item-title {
+          color: var(--pisell-steps-primary-color);
+        }
+      }
+    }
+  }
+}
+
+// ============ 尺寸变体 ============
+.@{pisell-steps-prefix}-small {
+  .ant-steps-item-icon {
+    width: 24px;
+    height: 24px;
+    line-height: 24px;
+    font-size: 12px;
+  }
+
+  .ant-steps-item-title {
+    font-size: 14px;
+  }
+
+  .ant-steps-item-description {
+    font-size: 14px;
+  }
+}
+
+.@{pisell-steps-prefix}-large {
+  .ant-steps-item-icon,
+  .pisell-lowcode-steps-item-icon {
+    width: 40px !important;
+    height: 40px !important;
+    line-height: 40px !important;
+    font-size: 16px !important;
+  }
+
+  .ant-steps-item-title,
+  .pisell-lowcode-steps-item-title {
+    font-size: 16px;
+  }
+
+  .ant-steps-item-description,
+  .pisell-lowcode-steps-item-description {
+    font-size: 16px;
+  }
+}
+
+// ============ 类型变体 ============
+// Dot 类型
+.@{pisell-steps-prefix}-dot {
+  .ant-steps-item-icon {
+    width: 8px;
+    height: 8px;
+
+    .ant-steps-icon-dot {
+      width: 8px;
+      height: 8px;
+    }
+  }
+}
+
+// Navigation 类型
+.@{pisell-steps-prefix}-navigation {
+  .ant-steps-item {
+    padding: 12px 24px;
+
+    &::before {
+      content: '';
+      position: absolute;
+      top: 0;
+      right: -12px;
+      width: 0;
+      height: 0;
+      border-top: 24px solid transparent;
+      border-bottom: 24px solid transparent;
+      border-left: 12px solid var(--pisell-steps-border-color);
+      z-index: 1;
+    }
+  }
+}
+
+// ============ 响应式样式 ============
+.@{pisell-steps-prefix}-responsive {
+  @media (max-width: 768px) {
+    overflow-x: auto;
+    -webkit-overflow-scrolling: touch;
+
+    .ant-steps {
+      min-width: max-content;
+    }
+
+    .ant-steps-item {
+      min-width: 120px;
+      flex-shrink: 0;
+    }
+  }
+
+  @media (max-width: 480px) {
+    .ant-steps-item {
+      min-width: 100px;
+
+      .ant-steps-item-title {
+        font-size: 12px;
+      }
+
+      .ant-steps-item-description {
+        display: none;
+      }
+
+      .ant-steps-item-icon {
+        width: 24px;
+        height: 24px;
+        line-height: 24px;
+        font-size: 12px;
+      }
+    }
+  }
+}
+
+// ============ 栅格布局 ============
+.@{pisell-steps-prefix}-grid-layout {
+  .ant-steps {
+    display: grid;
+    grid-template-columns: repeat(var(--pisell-steps-grid-columns), 1fr);
+    gap: var(--pisell-steps-margin);
+  }
+}
+
+// 连接器位置样式已移除
+
+// ============ 标识区和文本区间距 =============
+// 控制图标和文本之间的间距
+// 只有当设置了 itemGap 时才应用自定义间距，否则保持 antd 原样式
+.@{pisell-steps-prefix}-has-item-gap {
+  // 垂直布局时（labelPlacement='vertical'），控制内容区域的上边距
+  .ant-steps-label-vertical {
+    .ant-steps-item-content {
+      margin-top: var(--pisell-steps-item-gap);
+    }
+  }
+
+  // 水平布局时（labelPlacement='horizontal'），控制图标右侧的间距
+  .ant-steps-item {
+    .ant-steps-item-icon {
+      margin-right: var(--pisell-steps-item-gap) !important;
+    }
+  }
+
+  // 低代码平台中的样式支持 - 水平布局
+  .pisell-lowcode-steps-item-icon {
+    margin-right: var(--pisell-steps-item-gap) !important;
+  }
+
+  // 低代码平台垂直布局 - 设置内容区域的上边距
+  &.pisell-lowcode-steps-label-vertical,
+  .pisell-lowcode-steps-label-vertical {
+    .pisell-lowcode-steps-item-content {
+      margin-top: var(--pisell-steps-item-gap);
+    }
+  }
+}
+
+// 动画效果样式已移除
+
+// ============ 进度百分比显示 ============
+// 进度百分比样式已移除，直接使用 antd Steps 的默认进度条样式
+
+// ============ 竖向布局特殊样式 ============
+.@{pisell-steps-prefix}-vertical {
+  .ant-steps-item {
+    padding-bottom: var(--pisell-steps-margin);
+
+    &:last-child {
+      padding-bottom: 0;
+    }
+  }
+}
+
+// ============ 自定义图标尺寸 ============
+// ============ 禁用状态 ============
+.@{pisell-steps-prefix} {
+  .ant-steps-item-disabled {
+    cursor: not-allowed;
+    opacity: 0.5;
+
+    &:hover {
+      .ant-steps-item-icon {
+        transform: none;
+      }
+    }
+  }
+}
+
+// ============ 移动端当前步骤视图 ============
+.@{pisell-steps-prefix}-mobile-current {
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+
+  &__info {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    justify-content: center;
+    overflow: hidden;
+  }
+
+  &__number {
+    font-size: 14px;
+    color: black;
+    line-height: 20px;
+  }
+
+  &__title {
+    color: black;
+    font-size: 20px;
+    font-weight: 600;
+    line-height: 28px;
+  }
+}
+
+// ============ 滚动模式样式 ============
+.@{pisell-steps-prefix}-scroll-view {
+  width: 100%;
+  position: relative;
+
+  // 滚动内容容器
+  .@{pisell-steps-prefix}-scroll-content {
+    display: inline-flex;
+    min-width: max-content;
+  }
+}