@pisell/private-materials 6.4.55 → 6.4.57

package/es/components/list/hooks/useDevice.js

@@ -0,0 +1,102 @@
+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; }
+import { useState, useEffect } from 'react';
+/**
+ * 设备检测Hook
+ * 根据屏幕宽度和用户代理判断当前设备类型
+ */
+export var useDevice = function useDevice() {
+  var _useState = useState(function () {
+      // 初始化时的默认值
+      var initialWidth = typeof window !== 'undefined' ? window.innerWidth : 1920;
+      var initialHeight = typeof window !== 'undefined' ? window.innerHeight : 1080;
+      var initialType = getDeviceType(initialWidth);
+      return {
+        type: initialType,
+        isMobile: initialType === 'mobile',
+        isPad: initialType === 'pad',
+        isPc: initialType === 'pc',
+        width: initialWidth,
+        height: initialHeight
+      };
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    deviceInfo = _useState2[0],
+    setDeviceInfo = _useState2[1];
+  useEffect(function () {
+    var handleResize = function handleResize() {
+      var width = window.innerWidth;
+      var height = window.innerHeight;
+      var type = getDeviceType(width);
+      setDeviceInfo({
+        type: type,
+        isMobile: type === 'mobile',
+        isPad: type === 'pad',
+        isPc: type === 'pc',
+        width: width,
+        height: height
+      });
+    };
+
+    // 初次加载时检测一次
+    handleResize();
+
+    // 监听窗口尺寸变化
+    window.addEventListener('resize', handleResize);
+
+    // 清理监听器
+    return function () {
+      window.removeEventListener('resize', handleResize);
+    };
+  }, []);
+  return deviceInfo;
+};
+
+/**
+ * 根据屏幕宽度判断设备类型
+ * @param width 屏幕宽度
+ * @returns 设备类型
+ */
+function getDeviceType(width) {
+  // 移动端：小于 768px
+  if (width < 768) {
+    return 'mobile';
+  }
+  // 平板：768px - 1200px
+  else if (width < 1200) {
+    return 'pad';
+  }
+  // PC端：大于等于 1200px
+  else {
+    return 'pc';
+  }
+}
+
+/**
+ * 获取用户代理信息
+ * @returns 用户代理相关信息
+ */
+export var getUserAgentInfo = function getUserAgentInfo() {
+  if (typeof window === 'undefined' || !window.navigator) {
+    return {
+      isMobileUA: false,
+      isTabletUA: false,
+      isDesktopUA: true,
+      userAgent: ''
+    };
+  }
+  var userAgent = window.navigator.userAgent.toLowerCase();
+  var isMobileUA = /mobile|android|iphone|ipod|phone/.test(userAgent);
+  var isTabletUA = /tablet|ipad/.test(userAgent) && !isMobileUA;
+  var isDesktopUA = !isMobileUA && !isTabletUA;
+  return {
+    isMobileUA: isMobileUA,
+    isTabletUA: isTabletUA,
+    isDesktopUA: isDesktopUA,
+    userAgent: userAgent
+  };
+};

package/es/components/list/hooks/useListState.js

@@ -0,0 +1,176 @@
+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 _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; }
+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 { useReducer, useCallback } from 'react';
+
+// 状态接口
+
+// 动作类型
+
+// reducer函数
+function listStateReducer(state, action) {
+  switch (action.type) {
+    case 'SET_ACTIVE_TAB':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        activeTab: action.payload
+      });
+    case 'SET_CURRENT_PAGE':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        currentPage: action.payload
+      });
+    case 'SET_STICKY_ACTIVE':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        isStickyActive: action.payload
+      });
+    case 'RESET_PAGE':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        currentPage: 1
+      });
+    default:
+      return state;
+  }
+}
+
+// Hook参数接口
+
+// Hook返回值接口
+
+export var useListState = function useListState(_ref) {
+  var externalCurrentPage = _ref.externalCurrentPage,
+    tabItems = _ref.tabItems,
+    defaultPageSize = _ref.defaultPageSize,
+    onLoadData = _ref.onLoadData;
+  // 初始状态
+  var initialState = {
+    activeTab: tabItems.length > 0 ? tabItems[0].key : 'all',
+    currentPage: 1,
+    isStickyActive: false
+  };
+  var _useReducer = useReducer(listStateReducer, initialState),
+    _useReducer2 = _slicedToArray(_useReducer, 2),
+    state = _useReducer2[0],
+    dispatch = _useReducer2[1];
+
+  // 计算实际使用的当前页码
+  var actualCurrentPage = externalCurrentPage || state.currentPage;
+
+  // 状态更新函数
+  var setActiveTab = useCallback(function (tab) {
+    dispatch({
+      type: 'SET_ACTIVE_TAB',
+      payload: tab
+    });
+  }, []);
+  var setCurrentPage = useCallback(function (page) {
+    dispatch({
+      type: 'SET_CURRENT_PAGE',
+      payload: page
+    });
+  }, []);
+  var setStickyActive = useCallback(function (active) {
+    dispatch({
+      type: 'SET_STICKY_ACTIVE',
+      payload: active
+    });
+  }, []);
+  var resetPage = useCallback(function () {
+    dispatch({
+      type: 'RESET_PAGE'
+    });
+  }, []);
+
+  // 统一的数据加载函数
+  var loadData = useCallback(function (params) {
+    onLoadData === null || onLoadData === void 0 || onLoadData(params);
+  }, [onLoadData]);
+
+  // 业务逻辑函数
+  var handleTabChange = useCallback(function (key) {
+    setActiveTab(key);
+    resetPage();
+    loadData({
+      trigger: 'tabChange',
+      currentPage: 1,
+      pageSize: defaultPageSize,
+      activeTab: key
+    });
+  }, [setActiveTab, resetPage, loadData, defaultPageSize]);
+  var handlePageChange = useCallback(function (page, size) {
+    var previousPage = actualCurrentPage;
+    var pageSize = size || defaultPageSize;
+    setCurrentPage(page);
+    loadData({
+      trigger: 'pagination',
+      currentPage: page,
+      pageSize: pageSize,
+      activeTab: state.activeTab,
+      previousPage: previousPage
+    });
+  }, [actualCurrentPage, defaultPageSize, setCurrentPage, loadData, state.activeTab]);
+  var handleShowSizeChange = useCallback(function (current, size) {
+    var previousPageSize = defaultPageSize;
+    setCurrentPage(current);
+    loadData({
+      trigger: 'pageSize',
+      currentPage: current,
+      pageSize: size,
+      activeTab: state.activeTab,
+      previousPageSize: previousPageSize
+    });
+  }, [defaultPageSize, setCurrentPage, loadData, state.activeTab]);
+  var handleLoadMore = useCallback(function () {
+    var nextPage = actualCurrentPage + 1;
+    setCurrentPage(nextPage);
+    loadData({
+      trigger: 'loadMore',
+      currentPage: nextPage,
+      pageSize: defaultPageSize,
+      activeTab: state.activeTab
+    });
+  }, [actualCurrentPage, setCurrentPage, loadData, defaultPageSize, state.activeTab]);
+  var handleViewLess = useCallback(function () {
+    resetPage();
+    loadData({
+      trigger: 'pagination',
+      currentPage: 1,
+      pageSize: defaultPageSize,
+      activeTab: state.activeTab,
+      previousPage: actualCurrentPage
+    });
+  }, [resetPage, loadData, defaultPageSize, state.activeTab, actualCurrentPage]);
+
+  // 处理滚动加载
+  var handleScrollLoad = useCallback(function () {
+    var nextPage = actualCurrentPage + 1;
+    setCurrentPage(nextPage);
+    loadData({
+      trigger: 'scroll',
+      currentPage: nextPage,
+      pageSize: defaultPageSize,
+      activeTab: state.activeTab
+    });
+  }, [actualCurrentPage, setCurrentPage, loadData, defaultPageSize, state.activeTab]);
+  return {
+    state: state,
+    setActiveTab: setActiveTab,
+    setCurrentPage: setCurrentPage,
+    setStickyActive: setStickyActive,
+    resetPage: resetPage,
+    handleTabChange: handleTabChange,
+    handlePageChange: handlePageChange,
+    handleShowSizeChange: handleShowSizeChange,
+    handleLoadMore: handleLoadMore,
+    handleViewLess: handleViewLess,
+    handleScrollLoad: handleScrollLoad,
+    actualCurrentPage: actualCurrentPage
+  };
+};

package/es/components/list/hooks/useWaterfall.js

@@ -0,0 +1,161 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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; }
+import { useState, useEffect, useRef, useMemo, useCallback } from 'react';
+export var useWaterfall = function useWaterfall(items, options) {
+  // 用于强制重新计算的版本号
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    recalcVersion = _useState2[0],
+    setRecalcVersion = _useState2[1];
+
+  // 分别存储高度和宽度
+  var itemSizes = useRef(new Map());
+  var itemRefs = useRef(new Map());
+
+  // 注册元素引用的函数
+  var registerItemRef = useCallback(function (id, element) {
+    if (element) {
+      itemRefs.current.set(id, element);
+    } else {
+      itemRefs.current.delete(id);
+    }
+  }, []);
+
+  // 测量元素尺寸（高度和宽度）
+  var measureItemSize = useCallback(function (id) {
+    var element = itemRefs.current.get(id);
+    if (element) {
+      var rect = element.getBoundingClientRect();
+      var size = {
+        width: rect.width,
+        height: rect.height
+      };
+      itemSizes.current.set(id, size);
+      return size;
+    }
+    return itemSizes.current.get(id) || {
+      width: 200,
+      height: 200
+    }; // 默认尺寸
+  }, []);
+
+  // 根据direction获取相关尺寸
+  var getItemSize = useCallback(function (item) {
+    var direction = options.direction;
+    if (direction === 'vertical') {
+      // 垂直模式：使用高度
+      if (item.height) return item.height;
+      var measured = itemSizes.current.get(item.id);
+      return (measured === null || measured === void 0 ? void 0 : measured.height) || 200;
+    } else {
+      // 水平模式：使用宽度
+      if (item.width) return item.width;
+      var _measured = itemSizes.current.get(item.id);
+      return (_measured === null || _measured === void 0 ? void 0 : _measured.width) || 200;
+    }
+  }, [options]);
+
+  // 直接使用useMemo计算布局，支持垂直和水平两种模式
+  var layout = useMemo(function () {
+    var trackCount = options.tracks,
+      trackGap = options.trackGap,
+      itemGap = options.itemGap,
+      direction = options.direction;
+
+    // 初始化轨道（垂直模式为列，水平模式为行）
+    var newTracks = Array.from({
+      length: trackCount
+    }, function () {
+      return {
+        items: [],
+        size: 0
+      };
+    });
+
+    // 为每个项目分配到最短的轨道
+    items.forEach(function (item) {
+      // 找到当前尺寸最小的轨道
+      var shortestTrackIndex = newTracks.reduce(function (minIndex, track, index, arr) {
+        return track.size < arr[minIndex].size ? index : minIndex;
+      }, 0);
+      var targetTrack = newTracks[shortestTrackIndex];
+
+      // 获取项目在当前方向上的尺寸
+      var itemSize = getItemSize(item);
+
+      // 将项目添加到目标轨道
+      targetTrack.items.push(item);
+
+      // 更新轨道尺寸（如果不是第一个项目，需要加上项目间距）
+      if (targetTrack.items.length > 1) {
+        targetTrack.size += itemGap;
+      }
+      targetTrack.size += itemSize;
+    });
+
+    // 计算总尺寸
+    var totalSize = Math.max.apply(Math, _toConsumableArray(newTracks.map(function (track) {
+      return track.size;
+    })).concat([0]));
+    return {
+      tracks: newTracks,
+      totalSize: totalSize
+    };
+  }, [items, options, recalcVersion, getItemSize]);
+
+  // 重新计算布局的函数 - 重新测量元素尺寸，然后触发重新计算
+  var recalculateLayout = useCallback(function () {
+    // 重新测量所有已注册的元素尺寸
+    var hasChanges = false;
+    itemRefs.current.forEach(function (element, id) {
+      var rect = element.getBoundingClientRect();
+      var newSize = {
+        width: rect.width,
+        height: rect.height
+      };
+      var oldSize = itemSizes.current.get(id);
+      if (!oldSize || oldSize.width !== newSize.width || oldSize.height !== newSize.height) {
+        hasChanges = true;
+        itemSizes.current.set(id, newSize);
+      }
+    });
+
+    // 如果有变化，更新版本号来触发重新计算
+    if (hasChanges) {
+      setRecalcVersion(function (prev) {
+        return prev + 1;
+      });
+    }
+  }, []);
+
+  // 监听窗口大小变化，重新计算布局
+  useEffect(function () {
+    var timeoutId;
+    var handleResize = function handleResize() {
+      clearTimeout(timeoutId);
+      timeoutId = setTimeout(function () {
+        recalculateLayout();
+      }, 100);
+    };
+    window.addEventListener('resize', handleResize);
+    return function () {
+      window.removeEventListener('resize', handleResize);
+      clearTimeout(timeoutId);
+    };
+  }, [recalculateLayout]);
+  return {
+    layout: layout,
+    registerItemRef: registerItemRef,
+    measureItemSize: measureItemSize,
+    recalculateLayout: recalculateLayout
+  };
+};
+export default useWaterfall;

package/es/components/list/index.js

@@ -0,0 +1,7 @@
+export { default } from "./List";
+export { default as ResponsiveList, createResponsiveConfig } from "./ResponsiveWrapper";
+export { default as TestResponsiveWrapper } from "./TestResponsiveWrapper";
+export { default as Pagination } from "./components/Pagination";
+export { default as Tab } from "./components/Tab";
+export { useDevice, getUserAgentInfo } from "./hooks/useDevice";
+export { default as TestList } from "./TestResponsiveWrapper";

package/es/components/list/locales.js

@@ -0,0 +1,107 @@
+export default {
+  "en": {
+    // Tab related
+    'pisell-list-tab-group-default': 'Field',
+    // Empty state
+    'pisell-list-empty-text-default': 'No data available',
+    // Load more actions
+    'pisell-list-load-more': 'Load More',
+    'pisell-list-view-less': 'View Less',
+    // Pagination
+    'pisell-list-pagination-total': function pisellListPaginationTotal(start, end, total) {
+      return "Showing ".concat(start, "-").concat(end, " of ").concat(total, " items");
+    },
+    'pisell-list-pagination-total-fallback': function pisellListPaginationTotalFallback(start, end, total) {
+      return "Showing ".concat(start, "-").concat(end, " of ").concat(total, " items");
+    },
+    'pisell-list-pagination-page-of': function pisellListPaginationPageOf(current, total) {
+      return "Page ".concat(current, " of ").concat(total);
+    },
+    'pisell-list-pagination-previous': 'Previous',
+    'pisell-list-pagination-next': 'Next',
+    // Scroll actions
+    'pisell-list-scroll-down': 'Scroll Down',
+    'pisell-list-scroll-right': 'Scroll Right',
+    'pisell-list-scroll-to-bottom': 'Scroll to bottom and load more',
+    'pisell-list-scroll-to-end': 'Scroll to end and load more',
+    // Loading states
+    'pisell-list-loading': 'Loading...',
+    'pisell-list-loading-more': 'Loading more...',
+    'pisell-list-no-more-data': 'No more data',
+    // Group titles
+    'pisell-list-group-title-all': 'All',
+    // Error states
+    'pisell-list-load-error': 'Failed to load data',
+    'pisell-list-retry': 'Retry'
+  },
+  'zh-CN': {
+    // Tab related
+    'pisell-list-tab-group-default': '字段',
+    // Empty state
+    'pisell-list-empty-text-default': '暂无数据',
+    // Load more actions
+    'pisell-list-load-more': '查看更多',
+    'pisell-list-view-less': '查看更少',
+    // Pagination
+    'pisell-list-pagination-total': function pisellListPaginationTotal(start, end, total) {
+      return "\u663E\u793A\u7B2C ".concat(start, "-").concat(end, " \u6761\uFF0C\u5171 ").concat(total, " \u6761");
+    },
+    'pisell-list-pagination-total-fallback': function pisellListPaginationTotalFallback(start, end, total) {
+      return "\u663E\u793A\u7B2C ".concat(start, "-").concat(end, " \u6761\uFF0C\u5171 ").concat(total, " \u6761");
+    },
+    'pisell-list-pagination-page-of': function pisellListPaginationPageOf(current, total) {
+      return "\u7B2C ".concat(current, " \u9875\uFF0C\u5171 ").concat(total, " \u9875");
+    },
+    'pisell-list-pagination-previous': '上一页',
+    'pisell-list-pagination-next': '下一页',
+    // Scroll actions
+    'pisell-list-scroll-down': '向下滚动',
+    'pisell-list-scroll-right': '向右滚动',
+    'pisell-list-scroll-to-bottom': '滚动到底部并加载更多',
+    'pisell-list-scroll-to-end': '滚动到末尾并加载更多',
+    // Loading states
+    'pisell-list-loading': '加载中...',
+    'pisell-list-loading-more': '加载更多中...',
+    'pisell-list-no-more-data': '没有更多数据了',
+    // Group titles
+    'pisell-list-group-title-all': '全部',
+    // Error states
+    'pisell-list-load-error': '数据加载失败',
+    'pisell-list-retry': '重试'
+  },
+  'zh-HK': {
+    // Tab related
+    'pisell-list-tab-group-default': '字段',
+    // Empty state
+    'pisell-list-empty-text-default': '暫無數據',
+    // Load more actions
+    'pisell-list-load-more': '查看更多',
+    'pisell-list-view-less': '查看更少',
+    // Pagination
+    'pisell-list-pagination-total': function pisellListPaginationTotal(start, end, total) {
+      return "\u986F\u793A\u7B2C ".concat(start, "-").concat(end, " \u689D\uFF0C\u5171 ").concat(total, " \u689D");
+    },
+    'pisell-list-pagination-total-fallback': function pisellListPaginationTotalFallback(start, end, total) {
+      return "\u986F\u793A\u7B2C ".concat(start, "-").concat(end, " \u689D\uFF0C\u5171 ").concat(total, " \u689D");
+    },
+    'pisell-list-pagination-page-of': function pisellListPaginationPageOf(current, total) {
+      return "\u7B2C ".concat(current, " \u9801\uFF0C\u5171 ").concat(total, " \u9801");
+    },
+    'pisell-list-pagination-previous': '上一頁',
+    'pisell-list-pagination-next': '下一頁',
+    // Scroll actions
+    'pisell-list-scroll-down': '向下滾動',
+    'pisell-list-scroll-right': '向右滾動',
+    'pisell-list-scroll-to-bottom': '滾動到底部並加載更多',
+    'pisell-list-scroll-to-end': '滾動到末尾並加載更多',
+    // Loading states
+    'pisell-list-loading': '加載中...',
+    'pisell-list-loading-more': '加載更多中...',
+    'pisell-list-no-more-data': '沒有更多數據了',
+    // Group titles
+    'pisell-list-group-title-all': '全部',
+    // Error states
+    'pisell-list-load-error': '數據加載失敗',
+    'pisell-list-retry': '重試'
+  }
+};

package/es/components/list/styles/base.less

@@ -0,0 +1,39 @@
+/* List 组件基础样式 */
+@import './header.less';
+@import './content.less';
+@import './footer.less';
+@import './floatButton.less';
+@import './responsive.less';
+@import '../components/Pagination/Pagination.less';
+
+/* 主容器样式 */
+.pisell-list {
+  display: flex;
+  flex-direction: column;
+  background: #f8f9fa;
+  border-radius: 8px;
+  overflow: hidden;
+
+  /* 垂直排版的特殊滚动处理 */
+  &.pisell-list-vertical {
+    .list-content {
+      /* 默认禁用内容区域的独立滚动，让容器级别滚动 */
+      &:not(.list-content-scroll) {
+        overflow-y: visible;
+      }
+
+      /* scroll模式下仍需要内容区域滚动 */
+      &.list-content-scroll {
+        overflow-y: auto;
+      }
+    }
+  }
+
+  /* 当启用sticky时的额外样式 */
+  &.pisell-list-sticky-enabled {
+    /* sticky相关的额外处理可以在这里添加 */
+    position: relative;
+  }
+
+  /* 空状态样式已移至 EmptyState 组件 */
+}