@pisell/materials 6.7.4 → 6.8.2

package/es/components/PisellProcedure/utils/layoutRatio.js

@@ -0,0 +1,100 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+/*
+ * @Author: han.wang
+ * @Date: 2025-12-11 12:30:12
+ * @LastEditors: han.wang
+ * @LastEditTime: 2025-12-11 16:33:54
+ * @Description: 
+ */
+
+/**
+ * 布局比例工具函数
+ * @description 用于解析和计算内容区与信息区的布局比例
+ */
+
+/**
+ * 解析比例字符串
+ * @param ratio 比例字符串，如 '7:3'
+ * @returns [内容区比例, 信息区比例]
+ * @example
+ * parseLayoutRatio('7:3') // => [7, 3]
+ * parseLayoutRatio('6:4') // => [6, 4]
+ */
+export var parseLayoutRatio = function parseLayoutRatio(ratio) {
+  if (!ratio || typeof ratio !== 'string') {
+    return [7, 3]; // 默认比例
+  }
+  var parts = ratio.split(':');
+  if (parts.length !== 2) {
+    return [7, 3]; // 默认比例
+  }
+  var content = Number(parts[0]);
+  var sidebar = Number(parts[1]);
+  // 确保解析出的数字是有效的
+  if (isNaN(content) || isNaN(sidebar) || content <= 0 || sidebar <= 0) {
+    return [7, 3]; // 默认比例
+  }
+  return [content, sidebar];
+};
+
+/**
+ * 计算百分比
+ * @param ratio 比例字符串，如 '7:3'
+ * @returns { contentPercent, sidebarPercent }
+ * @example
+ * calculateRatioPercent('7:3') // => { contentPercent: 70, sidebarPercent: 30 }
+ */
+export var calculateRatioPercent = function calculateRatioPercent(ratio) {
+  var _parseLayoutRatio = parseLayoutRatio(ratio),
+    _parseLayoutRatio2 = _slicedToArray(_parseLayoutRatio, 2),
+    content = _parseLayoutRatio2[0],
+    sidebar = _parseLayoutRatio2[1];
+  var total = content + sidebar;
+  return {
+    contentPercent: content / total * 100,
+    sidebarPercent: sidebar / total * 100
+  };
+};
+
+/**
+ * 生成 flex 比例样式
+ * @param ratio 比例字符串，如 '7:3'
+ * @param gap 间距（px）
+ * @returns { contentStyle, sidebarStyle }
+ */
+export var generateRatioStyles = function generateRatioStyles(ratio) {
+  var gap = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 16;
+  var _calculateRatioPercen = calculateRatioPercent(ratio),
+    contentPercent = _calculateRatioPercen.contentPercent,
+    sidebarPercent = _calculateRatioPercen.sidebarPercent;
+  var sidebarWidth = "calc(".concat(sidebarPercent, "% - ").concat(gap / 2, "px)");
+  var sidebarFlex = "0 0 ".concat(sidebarWidth);
+  return {
+    contentStyle: {
+      flex: "0 0 calc(".concat(contentPercent, "% - ").concat(gap / 2, "px)"),
+      maxWidth: "calc(".concat(contentPercent, "% - ").concat(gap / 2, "px)")
+    },
+    sidebarStyle: {
+      // 使用 CSS 变量，让 CSS 中的 !important 可以引用这些值
+      '--sidebar-ratio-width': sidebarWidth,
+      '--sidebar-ratio-max-width': sidebarWidth,
+      '--sidebar-ratio-flex': sidebarFlex
+    }
+  };
+};
+
+/**
+ * 预设比例选项
+ */
+export var LAYOUT_RATIO_PRESETS = [{
+  label: '7:3',
+  value: '7:3'
+}, {
+  label: '6:4',
+  value: '6:4'
+}];

package/es/components/PisellProcedure/utils/slotHelper.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+/**
+ * 插槽包装工具函数
+ * @description 用于包装 React 插槽元素，添加额外的事件处理
+ */
+/**
+ * 包装插槽元素，添加点击事件
+ * @param slotContent 插槽内容
+ * @param onClick 点击回调
+ * @returns 包装后的插槽内容
+ * @example
+ * wrapSlotWithClick(leftSlot, handleBackClick)
+ */
+export declare const wrapSlotWithClick: (slotContent: React.ReactNode, onClick?: () => void | boolean) => React.ReactNode;
+/**
+ * 检查插槽是否为有效的 React 元素
+ * @param slotContent 插槽内容
+ * @returns 是否为有效元素
+ */
+export declare const isValidSlot: (slotContent: React.ReactNode) => boolean;
+/**
+ * 渲染插槽内容，如果为空则返回默认内容
+ * @param slotContent 插槽内容
+ * @param defaultContent 默认内容
+ * @returns 最终渲染内容
+ */
+export declare const renderSlotOrDefault: (slotContent: React.ReactNode, defaultContent?: React.ReactNode) => React.ReactNode;

package/es/components/PisellProcedure/utils/slotHelper.js

@@ -0,0 +1,50 @@
+import { isValidElement, cloneElement } from 'react';
+
+/**
+ * 插槽包装工具函数
+ * @description 用于包装 React 插槽元素，添加额外的事件处理
+ */
+
+/**
+ * 包装插槽元素，添加点击事件
+ * @param slotContent 插槽内容
+ * @param onClick 点击回调
+ * @returns 包装后的插槽内容
+ * @example
+ * wrapSlotWithClick(leftSlot, handleBackClick)
+ */
+export var wrapSlotWithClick = function wrapSlotWithClick(slotContent, _onClick) {
+  if (!slotContent) return null;
+  if ( /*#__PURE__*/isValidElement(slotContent)) {
+    return /*#__PURE__*/cloneElement(slotContent, {
+      onClick: function onClick(e) {
+        var _props;
+        // 先调用原有的 onClick
+        var originalOnClick = (_props = slotContent.props) === null || _props === void 0 ? void 0 : _props.onClick;
+        originalOnClick === null || originalOnClick === void 0 || originalOnClick(e);
+        // 再调用传入的 onClick
+        _onClick === null || _onClick === void 0 || _onClick();
+      }
+    });
+  }
+  return slotContent;
+};
+
+/**
+ * 检查插槽是否为有效的 React 元素
+ * @param slotContent 插槽内容
+ * @returns 是否为有效元素
+ */
+export var isValidSlot = function isValidSlot(slotContent) {
+  return slotContent !== null && slotContent !== undefined;
+};
+
+/**
+ * 渲染插槽内容，如果为空则返回默认内容
+ * @param slotContent 插槽内容
+ * @param defaultContent 默认内容
+ * @returns 最终渲染内容
+ */
+export var renderSlotOrDefault = function renderSlotOrDefault(slotContent, defaultContent) {
+  return isValidSlot(slotContent) ? slotContent : defaultContent;
+};

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

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PisellScrollViewProps, PisellScrollViewRef } from './types';
+import './PisellScrollView.less';
+declare const PisellScrollView: React.ForwardRefExoticComponent<Omit<PisellScrollViewProps, "ref"> & React.RefAttributes<PisellScrollViewRef>>;
+export default PisellScrollView;

package/es/components/PisellScrollView/PisellScrollView.js

@@ -0,0 +1,323 @@
+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); }
+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; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import React, { forwardRef, useRef, useImperativeHandle, useEffect, useMemo } from 'react';
+import classNames from 'classnames';
+import "./PisellScrollView.less";
+import { useScrollState, useScrollEvents, useIntersection } from "./hooks";
+import ActionsContainer from "./components/Actions";
+var snapScrollPaddings = {
+  rArrows: {
+    start: 0,
+    end: 117 + 10
+  },
+  lrArrows: {
+    start: 47 + 10,
+    end: 47 + 10
+  },
+  tbArrows: {
+    start: 47 + 10,
+    end: 47 + 10
+  }
+};
+var PisellScrollView = /*#__PURE__*/forwardRef(function (props, ref) {
+  var children = props.children,
+    className = props.className,
+    style = props.style,
+    _props$overflow = props.overflow,
+    overflow = _props$overflow === void 0 ? 'auto' : _props$overflow,
+    _props$scrollbarStyle = props.scrollbarStyle,
+    scrollbarStyle = _props$scrollbarStyle === void 0 ? 'default' : _props$scrollbarStyle,
+    scrollbarClassName = props.scrollbarClassName,
+    width = props.width,
+    height = props.height,
+    maxWidth = props.maxWidth,
+    maxHeight = props.maxHeight,
+    minWidth = props.minWidth,
+    minHeight = props.minHeight,
+    onScroll = props.onScroll,
+    onScrollStart = props.onScrollStart,
+    onScrollEnd = props.onScrollEnd,
+    onReachTop = props.onReachTop,
+    onReachBottom = props.onReachBottom,
+    onReachLeft = props.onReachLeft,
+    onReachRight = props.onReachRight,
+    reachThreshold = props.reachThreshold,
+    scrollEndDelay = props.scrollEndDelay,
+    intersection = props.intersection,
+    _props$scrollActionsC = props.scrollActionsConfig,
+    scrollActionsConfig = _props$scrollActionsC === void 0 ? {
+      show: true,
+      type: 'rArrows'
+    } : _props$scrollActionsC,
+    _props$snapScroll = props.snapScroll,
+    snapScroll = _props$snapScroll === void 0 ? {
+      enabled: true,
+      type: 'mandatory'
+    } : _props$snapScroll,
+    __designMode = props.__designMode;
+  var containerRef = useRef(null);
+  // 1. 状态管理 Hooks
+  var _useScrollState = useScrollState({
+      containerRef: containerRef,
+      overflow: overflow
+    }),
+    scrollState = _useScrollState.scrollState,
+    updateScrollState = _useScrollState.updateScrollState;
+
+  // 2. 事件处理 Hooks
+  var _useScrollEvents = useScrollEvents({
+      containerRef: containerRef,
+      onScroll: onScroll,
+      onScrollStart: onScrollStart,
+      onScrollEnd: onScrollEnd,
+      onReachTop: onReachTop,
+      onReachBottom: onReachBottom,
+      onReachLeft: onReachLeft,
+      onReachRight: onReachRight,
+      reachThreshold: reachThreshold,
+      scrollEndDelay: scrollEndDelay,
+      updateScrollState: updateScrollState,
+      scrollState: scrollState
+    }),
+    handleScroll = _useScrollEvents.handleScroll;
+  useEffect(function () {
+    document.body.id = 'body';
+  }, []);
+
+  // 3. 视图监听 Hooks
+  useIntersection({
+    containerRef: containerRef,
+    config: intersection
+  });
+  var scrollTo = function scrollTo(position) {
+    var container = containerRef.current;
+    if (!container) return;
+    var scrollTop = position.scrollTop,
+      scrollLeft = position.scrollLeft,
+      _position$behavior = position.behavior,
+      behavior = _position$behavior === void 0 ? 'auto' : _position$behavior;
+    var options = {
+      behavior: behavior
+    };
+    if (scrollTop !== undefined) options.top = scrollTop;
+    if (scrollLeft !== undefined) options.left = scrollLeft;
+    container.scrollTo(options);
+  };
+  var scrollToElement = function scrollToElement(config) {
+    var container = containerRef.current;
+    if (!container) return;
+    var targetId = config.targetId,
+      _config$align = config.align,
+      align = _config$align === void 0 ? 'start' : _config$align,
+      _config$behavior = config.behavior,
+      behavior = _config$behavior === void 0 ? 'auto' : _config$behavior,
+      _config$offset = config.offset,
+      offset = _config$offset === void 0 ? 0 : _config$offset;
+    var target = container.querySelector("#".concat(targetId));
+    if (!target) return;
+
+    // 简单实现：使用 scrollIntoView 或者计算 offsetTop
+    // scrollIntoView 不支持 offset，所以手动计算更灵活
+    var containerRect = container.getBoundingClientRect();
+    var targetRect = target.getBoundingClientRect();
+    var top = container.scrollTop;
+    var left = container.scrollLeft;
+
+    // 垂直方向计算
+    if (align === 'start') {
+      top += targetRect.top - containerRect.top;
+    } else if (align === 'center') {
+      top += targetRect.top - containerRect.top - (container.clientHeight / 2 - targetRect.height / 2);
+    } else if (align === 'end') {
+      top += targetRect.bottom - containerRect.bottom;
+    }
+
+    // 加上偏移
+    top += offset;
+    container.scrollTo({
+      top: top,
+      left: left,
+      behavior: behavior
+    });
+  };
+  var scrollToPercentage = function scrollToPercentage(percentage) {
+    var container = containerRef.current;
+    if (!container) return;
+    var percentX = percentage.percentX,
+      percentY = percentage.percentY,
+      _percentage$behavior = percentage.behavior,
+      behavior = _percentage$behavior === void 0 ? 'auto' : _percentage$behavior;
+    var maxScrollTop = container.scrollHeight - container.clientHeight;
+    var maxScrollLeft = container.scrollWidth - container.clientWidth;
+    var options = {
+      behavior: behavior
+    };
+    if (percentY !== undefined) {
+      options.top = percentY / 100 * maxScrollTop;
+    }
+    if (percentX !== undefined) {
+      options.left = percentX / 100 * maxScrollLeft;
+    }
+    container.scrollTo(options);
+  };
+  var scrollToTop = function scrollToTop() {
+    var _containerRef$current;
+    var behavior = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'auto';
+    (_containerRef$current = containerRef.current) === null || _containerRef$current === void 0 || _containerRef$current.scrollTo({
+      top: 0,
+      behavior: behavior
+    });
+  };
+  var scrollToBottom = function scrollToBottom() {
+    var behavior = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'auto';
+    var container = containerRef.current;
+    if (container) {
+      container.scrollTo({
+        top: container.scrollHeight,
+        behavior: behavior
+      });
+    }
+  };
+  var scrollToLeft = function scrollToLeft() {
+    var _containerRef$current2;
+    var behavior = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'auto';
+    (_containerRef$current2 = containerRef.current) === null || _containerRef$current2 === void 0 || _containerRef$current2.scrollTo({
+      left: 0,
+      behavior: behavior
+    });
+  };
+  var scrollToRight = function scrollToRight() {
+    var behavior = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'auto';
+    var container = containerRef.current;
+    if (container) {
+      container.scrollTo({
+        left: container.scrollWidth,
+        behavior: behavior
+      });
+    }
+  };
+  var getScrollData = function getScrollData() {
+    return scrollState;
+  };
+  var getScrollContainer = function getScrollContainer() {
+    return containerRef.current;
+  };
+
+  // 4. Ref 方法实现
+  useImperativeHandle(ref, function () {
+    if (__designMode) {
+      return containerRef.current;
+    }
+    return {
+      scrollTo: scrollTo,
+      scrollToElement: scrollToElement,
+      scrollToPercentage: scrollToPercentage,
+      scrollToTop: scrollToTop,
+      scrollToBottom: scrollToBottom,
+      scrollToLeft: scrollToLeft,
+      scrollToRight: scrollToRight,
+      getScrollData: getScrollData,
+      getScrollContainer: getScrollContainer,
+      // Snap Scroll 占位 (需要更复杂的计算逻辑，此处为基础版)
+      scrollToSnapPoint: function scrollToSnapPoint(index) {
+        var behavior = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'auto';
+      } // 如果使用了 CSS snap，这里可能需要计算 snapPoints 或者直接控制 scrollTop
+      // 暂留空或做简单实现
+      ,
+      getSnapPoints: function getSnapPoints() {
+        return [];
+      },
+      getCurrentSnapIndex: function getCurrentSnapIndex() {
+        return 0;
+      },
+      scrollToNextSnap: function scrollToNextSnap() {},
+      scrollToPrevSnap: function scrollToPrevSnap() {}
+    };
+  });
+
+  // 6. 滚动按钮逻辑
+  var handleButtonClick = function handleButtonClick(direction) {
+    var container = containerRef.current;
+    if (!container) return;
+    var distance = typeof (scrollActionsConfig === null || scrollActionsConfig === void 0 ? void 0 : scrollActionsConfig.scrollDistance) === 'number' ? scrollActionsConfig.scrollDistance : 300; // 默认 100px
+    var top = container.scrollTop;
+    var left = container.scrollLeft;
+    if (direction === 'top') top -= distance;
+    if (direction === 'bottom') top += distance;
+    if (direction === 'left') left -= distance;
+    if (direction === 'right') left += distance;
+    container.scrollTo({
+      top: top,
+      left: left,
+      behavior: 'smooth'
+    });
+  };
+
+  // 计算容器样式
+  var containerStyle = _objectSpread(_objectSpread({}, style), {}, {
+    width: width,
+    height: height,
+    maxWidth: maxWidth,
+    maxHeight: maxHeight,
+    minWidth: minWidth,
+    minHeight: minHeight
+  });
+
+  // 计算视口样式
+  var viewportStyle = useMemo(function () {
+    var _viewportStyle = {};
+    if (overflow === 'x') {
+      _viewportStyle.overflowX = 'auto';
+    }
+    if (overflow === 'y') {
+      _viewportStyle.overflowY = 'auto';
+    }
+    if (overflow === 'both') {
+      _viewportStyle.overflowX = 'auto';
+      _viewportStyle.overflowY = 'auto';
+    }
+    if (overflow === 'hidden') {
+      _viewportStyle.overflowX = 'hidden';
+      _viewportStyle.overflowY = 'hidden';
+    }
+    if (snapScroll !== null && snapScroll !== void 0 && snapScroll.enabled && scrollActionsConfig !== null && scrollActionsConfig !== void 0 && scrollActionsConfig.show) {
+      _viewportStyle.scrollSnapType = "".concat(overflow === 'x' ? 'x' : 'y', " ").concat(snapScroll.type);
+      if (overflow === 'x') {
+        var _snapScrollPaddings, _snapScrollPaddings2;
+        _viewportStyle.scrollPaddingLeft = ((_snapScrollPaddings = snapScrollPaddings[scrollActionsConfig.type]) === null || _snapScrollPaddings === void 0 ? void 0 : _snapScrollPaddings.start) || 0;
+        _viewportStyle.scrollPaddingRight = ((_snapScrollPaddings2 = snapScrollPaddings[scrollActionsConfig.type]) === null || _snapScrollPaddings2 === void 0 ? void 0 : _snapScrollPaddings2.end) || 0;
+      }
+      if (overflow === 'y') {
+        var _snapScrollPaddings3, _snapScrollPaddings4;
+        _viewportStyle.scrollPaddingTop = ((_snapScrollPaddings3 = snapScrollPaddings[scrollActionsConfig.type]) === null || _snapScrollPaddings3 === void 0 ? void 0 : _snapScrollPaddings3.start) || 0;
+        _viewportStyle.scrollPaddingBottom = ((_snapScrollPaddings4 = snapScrollPaddings[scrollActionsConfig.type]) === null || _snapScrollPaddings4 === void 0 ? void 0 : _snapScrollPaddings4.end) || 0;
+      }
+    }
+    return _viewportStyle;
+  }, [overflow, scrollActionsConfig === null || scrollActionsConfig === void 0 ? void 0 : scrollActionsConfig.show, scrollActionsConfig === null || scrollActionsConfig === void 0 ? void 0 : scrollActionsConfig.type, snapScroll]);
+  var viewportClasses = classNames('pisell-scroll-view-viewport', _defineProperty(_defineProperty({
+    'pisell-scroll-view-viewport--hide-scrollbar': scrollbarStyle === 'none' || !scrollState.isOverflows
+  }, "pisell-scroll-view-viewport--".concat(scrollbarStyle), scrollbarStyle !== 'default' && scrollbarStyle !== 'custom'), scrollbarClassName || '', scrollbarStyle === 'custom'));
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-scroll-view', className),
+    style: _objectSpread({}, containerStyle)
+  }, /*#__PURE__*/React.createElement("div", {
+    className: classNames(viewportClasses),
+    style: _objectSpread({}, viewportStyle),
+    ref: containerRef,
+    "data-scrollbar-style": scrollbarStyle,
+    onScroll: handleScroll
+  }, children), /*#__PURE__*/React.createElement(ActionsContainer, {
+    containerRef: containerRef,
+    scrollState: scrollState,
+    overflow: overflow,
+    scrollActionsConfig: scrollActionsConfig,
+    onClick: handleButtonClick
+  }));
+});
+PisellScrollView.displayName = 'PisellScrollView';
+export default PisellScrollView;

package/es/components/PisellScrollView/PisellScrollView.less

@@ -0,0 +1,178 @@
+.pisell-scroll-view {
+  position: relative;
+  overflow: hidden;
+
+  &-viewport {
+    width: 100%;
+    height: 100%;
+    box-sizing: border-box;
+
+    // 隐藏滚动条样式
+    &--hide-scrollbar {
+      -ms-overflow-style: none !important;
+      /* IE and Edge */
+      scrollbar-width: none !important;
+      /* Firefox */
+
+      &::-webkit-scrollbar {
+        display: none !important;
+      }
+    }
+
+    // 内置滚动条样式
+    &[data-scrollbar-style='thin'] {
+      &::-webkit-scrollbar {
+        width: 8px;
+        height: 8px;
+      }
+
+      &::-webkit-scrollbar-thumb {
+        background-color: rgba(0, 0, 0, 0.2);
+        border-radius: 4px;
+
+        &:hover {
+          background-color: rgba(0, 0, 0, 0.3);
+        }
+      }
+
+      &::-webkit-scrollbar-track {
+        background-color: transparent;
+      }
+    }
+
+    &[data-scrollbar-style='minimal'] {
+      &::-webkit-scrollbar {
+        width: 4px;
+        height: 4px;
+      }
+
+      &::-webkit-scrollbar-thumb {
+        background-color: rgba(0, 0, 0, 0.15);
+        border-radius: 2px;
+
+        &:hover {
+          background-color: rgba(0, 0, 0, 0.25);
+        }
+      }
+    }
+
+    &[data-scrollbar-style='rounded'] {
+      &::-webkit-scrollbar {
+        width: 12px;
+        height: 12px;
+      }
+
+      &::-webkit-scrollbar-thumb {
+        background-color: rgba(0, 0, 0, 0.2);
+        border-radius: 6px;
+        border: 2px solid transparent;
+        background-clip: content-box;
+
+        &:hover {
+          background-color: rgba(0, 0, 0, 0.3);
+        }
+      }
+    }
+  }
+
+  // 滚动按钮容器
+  &-button-wrapper {
+    position: absolute;
+    z-index: 10;
+    pointer-events: none; // 允许点击穿透到内容，具体按钮开启 pointer-events: auto
+
+    &--top,
+    &--bottom,
+    &--left,
+    &--right {
+      display: flex;
+      justify-content: center;
+      align-items: center;
+    }
+
+    // 内部定位
+    &--inside-top {
+      top: 0;
+      left: 0;
+      right: 0;
+      padding: 8px;
+    }
+
+    &--inside-bottom {
+      bottom: 0;
+      left: 0;
+      right: 0;
+      padding: 8px;
+    }
+
+    &--inside-left {
+      top: 0;
+      bottom: 0;
+      left: 0;
+      padding: 8px;
+    }
+
+    &--inside-right {
+      top: 0;
+      bottom: 0;
+      right: 0;
+      padding: 8px;
+    }
+
+    // 外部定位 (通过 margin 或 transform 处理)
+  }
+
+  &-button {
+    pointer-events: auto;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+    border: none;
+    outline: none;
+    background: #fff;
+    color: #333;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
+    transition: all 0.2s;
+
+    &:hover {
+      background: #f5f5f5;
+    }
+
+    &:active {
+      transform: scale(0.95);
+    }
+
+    &:disabled {
+      opacity: 0.5;
+      cursor: not-allowed;
+      box-shadow: none;
+    }
+
+    &--circle {
+      border-radius: 50%;
+      width: 32px;
+      height: 32px;
+    }
+
+    &--square {
+      border-radius: 4px;
+      width: 32px;
+      height: 32px;
+    }
+
+    &--minimal {
+      background: transparent;
+      box-shadow: none;
+
+      &:hover {
+        background: rgba(0, 0, 0, 0.05);
+      }
+    }
+
+    &--floating {
+      background: rgba(255, 255, 255, 0.8);
+      backdrop-filter: blur(4px);
+    }
+  }
+}