@pisell/materials 1.0.983 → 1.0.988

package/es/components/PisellScrollView/types.d.ts

@@ -0,0 +1,203 @@
+import React, { ReactNode, CSSProperties } from 'react';
+/**
+ * 滚动位置配置
+ */
+export interface ScrollPosition {
+    /** 竖向滚动位置（像素） */
+    scrollTop?: number;
+    /** 横向滚动位置（像素） */
+    scrollLeft?: number;
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+}
+/**
+ * 滚动到元素配置
+ */
+export interface ScrollToElementConfig {
+    /** 目标元素 ID */
+    targetId: string;
+    /** 对齐方式 */
+    align?: 'start' | 'center' | 'end' | 'nearest';
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+    /** 偏移量 */
+    offset?: number;
+}
+/**
+ * 滚动百分比配置
+ */
+export interface ScrollPercentage {
+    /** 竖向滚动百分比 (0-100) */
+    percentY?: number;
+    /** 横向滚动百分比 (0-100) */
+    percentX?: number;
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+}
+/**
+ * 滚动按钮配置
+ */
+export interface ScrollActionsConfig {
+    show?: boolean;
+    /** 按钮类型 */
+    type: "backTop" | "rArrows" | "lrArrows" | "tbArrows" | "custom";
+    style?: CSSProperties;
+    scrollDistance?: number;
+    /** 按钮配置 根据type不同，配置不同 */
+    config?: any;
+}
+/**
+ * 滚动事件数据
+ */
+export interface ScrollEventData {
+    /** 当前滚动位置 */
+    scrollTop: number;
+    scrollLeft: number;
+    /** 滚动百分比 */
+    percentY: number;
+    percentX: number;
+    /** 可滚动高度/宽度 */
+    scrollHeight: number;
+    scrollWidth: number;
+    /** 容器尺寸 */
+    clientHeight: number;
+    clientWidth: number;
+    /** 滚动方向 */
+    direction: 'up' | 'down' | 'left' | 'right' | null;
+    /** 是否滚动到顶部 */
+    isScrollToTop: boolean;
+    /** 是否滚动到底部 */
+    isScrollToBottom: boolean;
+    /** 是否滚动到左边 */
+    isScrollToLeft: boolean;
+    /** 是否滚动到右边 */
+    isScrollToRight: boolean;
+    /** 是否已经产生滚动条 */
+    isOverflows: boolean;
+}
+/**
+ * 视图监听配置
+ */
+export interface IntersectionConfig {
+    /** 是否启用视图监听 */
+    enabled?: boolean;
+    /** 交叉阈值 (0-1) */
+    threshold?: number | number[];
+    /** 根边距 */
+    rootMargin?: string;
+    /** 元素进入视图回调 */
+    onEnterViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 元素离开视图回调 */
+    onLeaveViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 可见度变化回调 */
+    onVisibilityChange?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 需要监听的元素选择器 */
+    targetSelector?: string;
+}
+/**
+ * 吸附滚动配置
+ */
+export interface SnapScrollConfig {
+    /** 是否启用吸附滚动 */
+    enabled?: boolean;
+    /** 吸附类型 */
+    type?: 'mandatory' | 'proximity';
+    /** 吸附对齐方式 */
+    align?: 'start' | 'center' | 'end';
+    /** 吸附开始回调 */
+    onSnapStart?: (targetIndex: number, targetPosition: number) => void;
+    /** 吸附结束回调 */
+    onSnapEnd?: (currentIndex: number, currentPosition: number) => void;
+}
+/**
+ * PisellScrollView 组件 Props
+ */
+export interface PisellScrollViewProps {
+    /** 子元素 */
+    children?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 滚动方向 */
+    overflow?: 'auto' | 'scroll' | 'hidden' | 'x' | 'y' | 'both';
+    /** 滚动条样式 */
+    scrollbarStyle?: 'default' | 'thin' | 'minimal' | 'rounded' | 'overlay' | 'custom' | 'none';
+    /** 自定义滚动条类名（当 scrollbarStyle 为 'custom' 时使用） */
+    scrollbarClassName?: string;
+    /** 是否显示滚动按钮 */
+    showScrollButtons?: boolean;
+    /** 箭头操作 */
+    scrollActionsConfig?: ScrollActionsConfig;
+    /** 滚动时触发 */
+    onScroll?: (data: ScrollEventData) => void;
+    /** 开始滚动时触发 */
+    onScrollStart?: (data: ScrollEventData) => void;
+    /** 滚动结束时触发（防抖延迟，默认 150ms） */
+    onScrollEnd?: (data: ScrollEventData) => void;
+    /** 滚动结束防抖延迟时间（ms） */
+    scrollEndDelay?: number;
+    /** 到达顶部时触发 */
+    onReachTop?: (data: ScrollEventData) => void;
+    /** 到达底部时触发 */
+    onReachBottom?: (data: ScrollEventData) => void;
+    /** 到达左边时触发 */
+    onReachLeft?: (data: ScrollEventData) => void;
+    /** 到达右边时触发 */
+    onReachRight?: (data: ScrollEventData) => void;
+    /** 边界阈值（到达边界的像素阈值） */
+    reachThreshold?: number;
+    /** IntersectionObserver 配置 */
+    intersection?: IntersectionConfig;
+    /** 吸附滚动配置 */
+    snapScroll?: SnapScrollConfig;
+    /** 容器宽度 */
+    width?: number | string;
+    /** 容器高度 */
+    height?: number | string;
+    /** 最大宽度 */
+    maxWidth?: number | string;
+    /** 最大高度 */
+    maxHeight?: number | string;
+    /** 最小宽度 */
+    minWidth?: number | string;
+    /** 最小高度 */
+    minHeight?: number | string;
+    /** Ref 引用 */
+    ref?: React.Ref<PisellScrollViewRef>;
+    /** 设计模式 */
+    __designMode?: boolean;
+}
+/**
+ * 组件暴露的方法
+ */
+export interface PisellScrollViewRef {
+    /** 滚动到指定位置 */
+    scrollTo: (position: ScrollPosition) => void;
+    /** 滚动到指定元素 */
+    scrollToElement: (config: ScrollToElementConfig) => void;
+    /** 滚动到百分比位置 */
+    scrollToPercentage: (percentage: ScrollPercentage) => void;
+    /** 滚动到顶部 */
+    scrollToTop: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到底部 */
+    scrollToBottom: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到最左侧 */
+    scrollToLeft: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到最右侧 */
+    scrollToRight: (behavior?: 'auto' | 'smooth') => void;
+    /** 获取当前滚动信息 */
+    getScrollData: () => ScrollEventData;
+    /** 获取滚动容器 DOM 元素 */
+    getScrollContainer: () => HTMLElement | null;
+    /** 滚动到指定吸附点（索引） */
+    scrollToSnapPoint: (index: number, behavior?: 'auto' | 'smooth') => void;
+    /** 获取所有吸附点位置 */
+    getSnapPoints: () => number[];
+    /** 获取当前吸附点索引 */
+    getCurrentSnapIndex: () => number;
+    /** 滚动到下一个吸附点 */
+    scrollToNextSnap: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到上一个吸附点 */
+    scrollToPrevSnap: (behavior?: 'auto' | 'smooth') => void;
+}

package/es/components/PisellScrollView/types.js

@@ -0,0 +1 @@
+export {};

package/es/components/PisellScrollView/utils/index.js

@@ -0,0 +1 @@
+// 自定义工具函数

package/es/components/PisellSteps/PisellSteps.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["type", "current", "defaultCurrent", "direction", "size", "status", "initial", "items", "percent", "labelPlacement", "responsive", "onChange", "className", "style", "progressDot", "clickable", "allowClickFinished", "showProgressPercent", "iconSize", "iconColor", "connectorStyle", "connectorPosition", "animated", "gridLayout", "gridColumns", "itemLayout", "itemGap", "enableAnchor", "anchorContainer", "__designMode", "__id", "other"];
+var _excluded = ["type", "current", "defaultCurrent", "direction", "size", "status", "initial", "items", "labelPlacement", "responsive", "onChange", "className", "style", "progressDot", "clickable", "allowClickFinished", "gridLayout", "gridColumns", "itemGap", "enableAnchor", "anchorContainer", "mobileMode", "mobileBreakpoint", "enableScrollMode", "scrollActionsConfig", "__designMode", "__id", "other"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -19,6 +19,7 @@ import React, { useMemo } from 'react';
 import "./PisellSteps.less";
 import { useStepsState, useStepClick, useAnchor, useResponsive } from "./hooks";
 import { getStepStatus, mergeStepClassName } from "./utils";
+import { PisellScrollView } from "../PisellScrollView";
 
 /**
  * PisellSteps 步骤条组件
@@ -45,7 +46,6 @@ var PisellSteps = function PisellSteps(_ref) {
     initial = _ref$initial === void 0 ? 0 : _ref$initial,
     _ref$items = _ref.items,
     items = _ref$items === void 0 ? [] : _ref$items,
-    percent = _ref.percent,
     _ref$labelPlacement = _ref.labelPlacement,
     labelPlacement = _ref$labelPlacement === void 0 ? 'horizontal' : _ref$labelPlacement,
     _ref$responsive = _ref.responsive,
@@ -58,24 +58,20 @@ var PisellSteps = function PisellSteps(_ref) {
     clickable = _ref$clickable === void 0 ? false : _ref$clickable,
     _ref$allowClickFinish = _ref.allowClickFinished,
     allowClickFinished = _ref$allowClickFinish === void 0 ? true : _ref$allowClickFinish,
-    _ref$showProgressPerc = _ref.showProgressPercent,
-    showProgressPercent = _ref$showProgressPerc === void 0 ? false : _ref$showProgressPerc,
-    iconSize = _ref.iconSize,
-    iconColor = _ref.iconColor,
-    connectorStyle = _ref.connectorStyle,
-    _ref$connectorPositio = _ref.connectorPosition,
-    connectorPosition = _ref$connectorPositio === void 0 ? 'center' : _ref$connectorPositio,
-    _ref$animated = _ref.animated,
-    animated = _ref$animated === void 0 ? true : _ref$animated,
     _ref$gridLayout = _ref.gridLayout,
     gridLayout = _ref$gridLayout === void 0 ? false : _ref$gridLayout,
     gridColumns = _ref.gridColumns,
-    _ref$itemLayout = _ref.itemLayout,
-    itemLayout = _ref$itemLayout === void 0 ? 'horizontal' : _ref$itemLayout,
     itemGap = _ref.itemGap,
     _ref$enableAnchor = _ref.enableAnchor,
     enableAnchor = _ref$enableAnchor === void 0 ? false : _ref$enableAnchor,
     anchorContainer = _ref.anchorContainer,
+    _ref$mobileMode = _ref.mobileMode,
+    mobileMode = _ref$mobileMode === void 0 ? 'full' : _ref$mobileMode,
+    _ref$mobileBreakpoint = _ref.mobileBreakpoint,
+    mobileBreakpoint = _ref$mobileBreakpoint === void 0 ? 744 : _ref$mobileBreakpoint,
+    _ref$enableScrollMode = _ref.enableScrollMode,
+    enableScrollMode = _ref$enableScrollMode === void 0 ? false : _ref$enableScrollMode,
+    scrollActionsConfig = _ref.scrollActionsConfig,
     __designMode = _ref.__designMode,
     __id = _ref.__id,
     other = _ref.other,
@@ -92,13 +88,40 @@ var PisellSteps = function PisellSteps(_ref) {
   // 锚链接功能
   useAnchor(currentStep, enableAnchor, anchorContainer);
 
-  // 响应式监听
-  var isMobile = useResponsive(768);
+  // 响应式监听（使用自定义断点）
+  var isMobile = useResponsive(mobileBreakpoint);
+
+  // 判断是否显示移动端当前步骤视图
+  var showMobileCurrentView = useMemo(function () {
+    if (mobileMode === 'current') return true;
+    if (mobileMode === 'auto' && isMobile) return true;
+    return false;
+  }, [mobileMode, isMobile]);
+
+  // 确保 items 始终是数组
+  var safeItems = useMemo(function () {
+    if (!items) return [];
+    if (!Array.isArray(items)) return [];
+    return items;
+  }, [items]);
+
+  // 获取当前步骤信息（用于移动端显示）
+  var currentStepItem = useMemo(function () {
+    var visibleItems = safeItems.filter(function (item) {
+      return !item.hidden;
+    });
+    var adjustedIndex = currentStep - initial;
+    // 确保索引在有效范围内
+    if (adjustedIndex < 0 || adjustedIndex >= visibleItems.length) {
+      return null;
+    }
+    return visibleItems[adjustedIndex] || null;
+  }, [safeItems, currentStep, initial]);
 
   // 处理步骤数据
   var processedItems = useMemo(function () {
     // 过滤隐藏的步骤
-    var visibleItems = items.filter(function (item) {
+    var visibleItems = safeItems.filter(function (item) {
       return !item.hidden;
     });
 
@@ -120,7 +143,10 @@ var PisellSteps = function PisellSteps(_ref) {
     }
 
     // 处理每个步骤项
-    return visibleItems.map(function (item, index) {
+    return visibleItems.filter(function (item) {
+      return item != null;
+    }) // 过滤掉 null 或 undefined 的项
+    .map(function (item, index) {
       var adjustedIndex = index + initial;
 
       // 计算步骤状态
@@ -154,67 +180,105 @@ var PisellSteps = function PisellSteps(_ref) {
         onClick: clickable || item.onClick ? handleClick : undefined
       });
     });
-  }, [items, currentStep, initial, status, clickable, handleStepClick, __designMode]);
+  }, [safeItems, currentStep, initial, status, clickable, handleStepClick, __designMode]);
 
   // 合并样式类名
   var wrapperClassName = useMemo(function () {
     var classes = ['pisell-steps'];
     if (className) classes.push(className);
-    if (type !== 'default') classes.push("pisell-steps-".concat(type));
+    // type 只支持 'default' 和 'navigation'，dot 模式通过 progressDot 控制
+    if (type === 'navigation') classes.push('pisell-steps-navigation');
+    // 如果设置了 progressDot，添加 dot 样式类
+    if (progressDot) classes.push('pisell-steps-dot');
     if (size !== 'default') classes.push("pisell-steps-".concat(size));
     if (direction === 'vertical') classes.push('pisell-steps-vertical');
     if (responsive) classes.push('pisell-steps-responsive');
-    if (animated) classes.push('pisell-steps-animated');
     if (clickable) classes.push('pisell-steps-clickable');
     if (gridLayout) classes.push('pisell-steps-grid-layout');
-    if (connectorPosition !== 'center') classes.push("pisell-steps-connector-".concat(connectorPosition));
-    if (itemLayout === 'vertical') classes.push('pisell-steps-item-vertical');
+    // 如果设置了 itemGap，添加标记类名
+    if (itemGap !== undefined && itemGap !== null) {
+      classes.push('pisell-steps-has-item-gap');
+    }
+    // labelPlacement 通过 antd Steps 的 labelPlacement 属性控制，不需要额外的类名
+
     return classes.join(' ');
-  }, [className, type, size, direction, responsive, animated, clickable, gridLayout, connectorPosition, itemLayout]);
+  }, [className, type, progressDot, size, direction, responsive, clickable, gridLayout, itemGap]);
 
   // 合并自定义样式
   var wrapperStyle = useMemo(function () {
     var customStyle = _objectSpread({}, style);
-    if (iconSize) {
-      customStyle['--pisell-steps-icon-size'] = "".concat(iconSize, "px");
-    }
-    if (iconColor) {
-      customStyle['--pisell-steps-icon-color'] = iconColor;
-    }
-    if (itemGap) {
+
+    // itemGap 用于控制图标和文本之间的间距
+    // 只有当 itemGap 有值时才设置 CSS 变量，否则保持 antd 原样式
+    if (itemGap !== undefined && itemGap !== null) {
       customStyle['--pisell-steps-item-gap'] = "".concat(itemGap, "px");
+      // 添加标记类名，用于样式选择器
+      customStyle['--pisell-steps-has-item-gap'] = '1';
     }
     if (gridColumns && gridLayout) {
       customStyle['--pisell-steps-grid-columns'] = gridColumns;
     }
     return customStyle;
-  }, [style, iconSize, iconColor, itemGap, gridColumns, gridLayout]);
+  }, [style, itemGap, gridColumns, gridLayout]);
 
-  // 处理进度百分比显示
-  var effectivePercent = showProgressPercent ? percent : undefined;
+  // 默认滚动箭头配置
+  var defaultScrollActionsConfig = useMemo(function () {
+    return _objectSpread({
+      show: true,
+      type: 'lrArrows',
+      scrollDistance: 200
+    }, scrollActionsConfig);
+  }, [scrollActionsConfig]);
 
-  // 根据 type 设置 Ant Design 的展示类型
-  var antdType = type === 'dot' ? 'inline' : type === 'navigation' ? 'navigation' : 'default';
+  // 渲染步骤条内容
+  var renderStepsContent = function renderStepsContent() {
+    var forceHorizontal = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+    return /*#__PURE__*/React.createElement(AntdSteps, _extends({
+      current: Math.max(0, currentStep - initial)
+      // 滚动模式下强制水平方向
+      ,
+      direction: forceHorizontal ? 'horizontal' : direction,
+      size: size === 'large' ? 'default' : size,
+      status: status,
+      items: processedItems,
+      labelPlacement: labelPlacement,
+      type: type,
+      progressDot: progressDot
+      // 滚动模式下禁用 Ant Design 的响应式行为
+      ,
+      responsive: forceHorizontal ? false : responsive
+    }, restProps, other || {}));
+  };
+
+  // 渲染桌面端步骤条（可能带滚动）
+  var renderDesktopSteps = function renderDesktopSteps() {
+    if (enableScrollMode) {
+      return /*#__PURE__*/React.createElement(PisellScrollView, {
+        className: "pisell-steps-scroll-view",
+        overflow: "x",
+        scrollbarStyle: "none",
+        scrollActionsConfig: defaultScrollActionsConfig,
+        snapScroll: {
+          enabled: false
+        }
+      }, /*#__PURE__*/React.createElement("div", {
+        className: "pisell-steps-scroll-content"
+      }, renderStepsContent(true)));
+    }
+    return renderStepsContent(false);
+  };
   return /*#__PURE__*/React.createElement("div", {
-    className: wrapperClassName,
-    style: wrapperStyle,
+    className: showMobileCurrentView ? "pisell-steps pisell-steps-mobile-current ".concat(className || '') : wrapperClassName,
+    style: showMobileCurrentView ? style : wrapperStyle,
     "data-component": "pisell-steps",
     "data-id": __id
-  }, /*#__PURE__*/React.createElement(AntdSteps, _extends({
-    current: currentStep - initial,
-    direction: direction,
-    size: size === 'large' ? 'default' : size,
-    status: status,
-    items: processedItems,
-    percent: effectivePercent,
-    labelPlacement: labelPlacement,
-    type: antdType,
-    progressDot: type === 'dot' ? progressDot : false
-  }, restProps, other)), showProgressPercent && percent !== undefined && /*#__PURE__*/React.createElement("div", {
-    className: "pisell-steps-progress-info"
-  }, /*#__PURE__*/React.createElement("span", {
-    className: "pisell-steps-progress-percent"
-  }, percent, "%")));
+  }, showMobileCurrentView ? /*#__PURE__*/React.createElement("div", {
+    className: "pisell-steps-mobile-current__info"
+  }, (currentStepItem === null || currentStepItem === void 0 ? void 0 : currentStepItem.title) && /*#__PURE__*/React.createElement("span", {
+    className: "pisell-steps-mobile-current__number"
+  }, currentStepItem.title), (currentStepItem === null || currentStepItem === void 0 ? void 0 : currentStepItem.description) && /*#__PURE__*/React.createElement("span", {
+    className: "pisell-steps-mobile-current__title"
+  }, currentStepItem.description)) : /*#__PURE__*/React.createElement(React.Fragment, null, renderDesktopSteps()));
 };
 
 // 添加 displayName 用于调试