shineout 3.9.0-beta.28 → 3.9.0-beta.29

package/cjs/index.js

@@ -522,5 +522,5 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 // 此文件由脚本自动生成，请勿直接修改。
 // This file was generated automatically by a script. Please do not modify it directly.
 var _default = exports.default = {
-  version: '3.9.0-beta.28'
+  version: '3.9.0-beta.29'
 };

package/cjs/tests/utils.d.ts

@@ -9,7 +9,7 @@ export declare function textContentTest(element: Element, text: string | null |
 export declare function classContentTest(element: Element, name: string, bool?: boolean): void;
 export declare function styleTest(element: Element, style: string | null): void;
 export declare function styleContainTest(element: Element, styleObject: object): void;
-export declare function styleContentTest(element: Element, name: string, bool?: boolean): void;
+export declare function styleContentTest(element: Element, styles: string | string[], bool?: boolean): void;
 export interface StyleProps {
     [key: string]: string;
 }

package/cjs/tests/utils.js

@@ -87,10 +87,19 @@ function styleTest(element, style) {
 function styleContainTest(element, styleObject) {
   expect(element.style).toEqual(expect.objectContaining(styleObject));
 }
-function styleContentTest(element, name) {
-  var _element$getAttribute2;
+function styleContentTest(element, styles) {
   var bool = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
-  expect((_element$getAttribute2 = element.getAttribute('style')) === null || _element$getAttribute2 === void 0 ? void 0 : _element$getAttribute2.includes(name)).toBe(bool);
+  var elementStyle = element.getAttribute('style');
+  if (Array.isArray(styles)) {
+    // 如果是数组,检查每个样式属性是否都存在
+    var allMatch = styles.every(function (style) {
+      return elementStyle === null || elementStyle === void 0 ? void 0 : elementStyle.includes(style);
+    });
+    expect(allMatch).toBe(bool);
+  } else {
+    // 原有的字符串匹配方式
+    expect(elementStyle === null || elementStyle === void 0 ? void 0 : elementStyle.includes(styles)).toBe(bool);
+  }
 }
 function baseTest(Component, selector) {
   var styleV = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {

package/dist/shineout.js

@@ -12400,7 +12400,7 @@ var handleStyle = function handleStyle(style) {
 };
 /* harmony default export */ var jss_style_handleStyle = (handleStyle);
 ;// CONCATENATED MODULE: ../shineout-style/src/version.ts
-/* harmony default export */ var version = ('3.9.0-beta.28');
+/* harmony default export */ var version = ('3.9.0-beta.29');
 ;// CONCATENATED MODULE: ../shineout-style/src/jss-style/index.tsx
 
 
@@ -33678,6 +33678,30 @@ var getDuration = function getDuration(duration) {
   }
 };
 var mm = 30;
+
+/**
+ * AnimationList - 动画列表组件
+ *
+ * 动画状态流程:
+ *
+ * 展开动画 (show: false -> true):
+ *   beforeEnter: 设置初始状态(display, height: 0, opacity: 0 等)
+ *     ↓ 等待 mm(30ms) - 触发浏览器重绘
+ *   enter: 应用过渡动画(height: ${height}px, opacity: 1 等)
+ *     ↓ 等待 durationNum(240ms) - 动画执行
+ *   afterEnter: 清理动画状态(height: auto, pointer-events: initial)
+ *
+ * 收起动画 (show: true -> false):
+ *   beforeLeave: 固定当前状态(height: ${height}px, pointer-events: none)
+ *     ↓ 等待 mm(30ms) - 触发浏览器重绘
+ *   leave: 应用过渡动画(height: 0, opacity: 0 等)
+ *     ↓ 等待 durationNum(240ms) - 动画执行
+ *   afterLeave: 清理并隐藏(display: none, pointer-events: initial)
+ *
+ * pointer-events 控制:
+ *   - beforeLeave: 设置为 'none',防止动画过程中的误操作
+ *   - afterEnter/afterLeave: 恢复为 'initial',确保动画结束后可正常交互
+ */
 var AnimationList = function AnimationList(props) {
   var _props$display = props.display,
     display = _props$display === void 0 ? 'block' : _props$display,
@@ -33756,6 +33780,11 @@ var AnimationList = function AnimationList(props) {
       width: 0
     };
   };
+
+  /**
+   * 展开动画阶段1: 设置初始状态
+   * 设置 display 显示元素,并将动画属性设为起始值(如 height: 0)
+   */
   var beforeEnter = function beforeEnter() {
     var newStyle = {
       display: display
@@ -33782,6 +33811,11 @@ var AnimationList = function AnimationList(props) {
       return objectSpread2_default()(objectSpread2_default()({}, s), newStyle);
     });
   };
+
+  /**
+   * 展开动画阶段2: 执行过渡动画
+   * 添加 transition 并将动画属性过渡到目标值
+   */
   var enter = function enter() {
     var newStyle = {
       transition: transition
@@ -33801,8 +33835,15 @@ var AnimationList = function AnimationList(props) {
     });
     setStatus('enter');
   };
+
+  /**
+   * 展开动画阶段3: 清理动画状态
+   * 移除固定尺寸,恢复自动布局,恢复交互能力
+   */
   var afterEnter = function afterEnter() {
-    var newStyle = {};
+    var newStyle = {
+      pointerEvents: 'initial'
+    };
     if (type.indexOf('collapse') >= 0) {
       newStyle.height = 'auto';
       newStyle.overflow = '';
@@ -33813,9 +33854,16 @@ var AnimationList = function AnimationList(props) {
     setStatus('afterEnter');
     onAnimationAfterEnter === null || onAnimationAfterEnter === void 0 || onAnimationAfterEnter();
   };
+
+  /**
+   * 收起动画阶段1: 固定当前状态
+   * 禁用交互,固定当前高度,准备执行收起动画
+   */
   var beforeLeave = function beforeLeave() {
     var el = ref.current;
-    var newStyle = {};
+    var newStyle = {
+      pointerEvents: 'none'
+    };
     if (type.indexOf('collapse') >= 0) {
       context.height = el.offsetHeight;
       newStyle.height = "".concat(context.height, "px");
@@ -33833,6 +33881,11 @@ var AnimationList = function AnimationList(props) {
     });
     setStatus('beforeLeave');
   };
+
+  /**
+   * 收起动画阶段2: 执行过渡动画
+   * 添加 transition 并将动画属性过渡到收起状态(如 height: 0)
+   */
   var leave = function leave() {
     var newStyle = {
       transition: transition
@@ -33852,8 +33905,15 @@ var AnimationList = function AnimationList(props) {
     });
     setStatus('leave');
   };
+
+  /**
+   * 收起动画阶段3: 清理并隐藏
+   * 恢复交互能力,清理动画状态,设置 display: none 完全隐藏元素
+   */
   var afterLeave = function afterLeave() {
-    var newStyle = {};
+    var newStyle = {
+      pointerEvents: 'initial'
+    };
     if (type.indexOf('collapse') >= 0) {
       newStyle.height = 'auto';
       newStyle.overflow = '';
@@ -74235,7 +74295,7 @@ var upload_interface = __webpack_require__(8821);
 
 
 /* harmony default export */ var src_0 = ({
-  version: '3.9.0-beta.28'
+  version: '3.9.0-beta.29'
 });
 }();
 /******/ 	return __webpack_exports__;