@arco-design/mobile-react 2.28.2 → 2.29.1

package/esm/input/hooks.js

@@ -1,3 +1,4 @@
+import _extends from "@babel/runtime/helpers/extends";
 import React, { useState, useEffect, useRef } from 'react';
 import { cls, nextTick } from '@arco-design/mobile-utils';
 import IconClear from '../icon/IconClear';
@@ -47,23 +48,6 @@ export function useInputLogic(props, inputRef) {
       toggleClear = _useState2[1];
 
   var compositingRef = useRef(false);
-  /**
-   * clear相关问题背景
-   * 如果点击clear按钮之前已经是focusing状态了，那么在点完clear按钮之后会手动聚焦一下
-   * 该行为将导致onClear事件触发时，也会触发一次onBlur和onFocus事件，可能影响一些组件外的代码逻辑
-   *
-   * e.g. 假设input按钮右侧有一个按钮仅在聚焦时展示
-   * 实现代码大致是：onBlur设置其visible为false，onFocus设置其visible为true
-   * 那么这个按钮就会因为clear的点击造成一瞬的闪烁
-   *
-   * 解决思路
-   * 先来看一下，在输入框已激活的状态时，点击清除按钮后，组件的一些事件的触发顺序
-   * handleBlur -> handleClear -> handleFocus -> onBlur(外部回调) -> onFocus(外部回调)
-   * 可以看到外部的onBlur和onFocus回调都是在handleClear函数之后被调用
-   * 因此可以在handleClear中设置一个shouldPreventEvent的boolean标志
-   * 如果这个标志为true，则跳过调用外部的onBlur和onFocus，并在最后再将标志置回false
-   *
-   */
 
   var _useState3 = useState(false),
       isFocusing = _useState3[0],
@@ -163,28 +147,24 @@ export function useInputLogic(props, inputRef) {
   }
 
   function handleFocus(e) {
-    nextTick(function () {
-      if (preventEventWhenClearing && shouldPreventEvent.current) {
-        shouldPreventEvent.current = false;
-        return;
-      }
+    if (preventEventWhenClearing && shouldPreventEvent.current) {
+      shouldPreventEvent.current = false;
+      return;
+    }
 
-      setIsFocusing(true);
-      clearShowType === 'focus' && toggleClear(true);
-      onFocus && onFocus(e);
-    });
+    setIsFocusing(true);
+    clearShowType === 'focus' && toggleClear(true);
+    onFocus && onFocus(e);
   }
 
   function handleBlur(e) {
-    nextTick(function () {
-      if (preventEventWhenClearing && shouldPreventEvent.current) {
-        return;
-      }
+    if (preventEventWhenClearing && shouldPreventEvent.current) {
+      return;
+    }
 
-      setIsFocusing(false);
-      clearShowType === 'focus' && toggleClear(false);
-      onBlur && onBlur(e);
-    });
+    setIsFocusing(false);
+    clearShowType === 'focus' && toggleClear(false);
+    onBlur && onBlur(e);
   }
 
   function handleClick(e) {
@@ -215,10 +195,17 @@ export function useInputLogic(props, inputRef) {
 
       if (isFocusing) {
         if (preventEventWhenClearing) {
-          shouldPreventEvent.current = true;
+          shouldPreventEvent.current = true; // 一段时间未执行blur或focus则重置，避免对下次事件循环造成影响
+          // @en If blur or focus is not executed for a period of time, it will be reset to avoid affecting the next event loop
+
+          setTimeout(function () {
+            shouldPreventEvent.current = false;
+          }, 200);
         }
 
-        inputRef.current && inputRef.current.focus();
+        nextTick(function () {
+          inputRef.current && inputRef.current.focus();
+        });
       }
     });
   }
@@ -228,6 +215,12 @@ export function useInputLogic(props, inputRef) {
   }
 
   function renderWrapper(prefixCls, type, children) {
+    var _clearEvent;
+
+    // handleClear必须早于handleBlur执行，pc端仅mousedown事件触发早于blur，移动端touch相关事件均早于blur
+    // @en handleClear must be executed earlier than handleBlur
+    // @en only the mousedown event on the PC side is triggered earlier than blur, and the touch-related events on the mobile side are all earlier than blur
+    var clearEvent = (_clearEvent = {}, _clearEvent[system === 'pc' ? 'onMouseDown' : 'onTouchEnd'] = handleClear, _clearEvent);
     return /*#__PURE__*/React.createElement("div", {
       role: "search",
       className: prefixCls + "-container all-border-box " + (className || ''),
@@ -247,10 +240,9 @@ export function useInputLogic(props, inputRef) {
       className: cls(prefixCls + "-label", {
         required: required
       })
-    }, label) : prefix) : null, children, clearable && showClear ? /*#__PURE__*/React.createElement("div", {
-      className: prefixCls + "-clear",
-      onClick: handleClear
-    }, clearIcon) : null, suffix ? /*#__PURE__*/React.createElement("div", {
+    }, label) : prefix) : null, children, clearable && showClear ? /*#__PURE__*/React.createElement("div", _extends({
+      className: prefixCls + "-clear"
+    }, clearEvent), clearIcon) : null, suffix ? /*#__PURE__*/React.createElement("div", {
       className: prefixCls + "-suffix"
     }, suffix) : null), renderPendNode(append));
   }

package/esm/input/props.d.ts

@@ -124,7 +124,7 @@ export interface BasicInputProps<T = HTMLInputElement> {
      * 按下清除按钮回调
      * @en Callback when clear button is pressed
      */
-    onClear?: (e: React.MouseEvent<HTMLElement, MouseEvent>) => void;
+    onClear?: (e: React.TouchEvent<HTMLElement>) => void;
     /**
      * 输入框前置内容，在输入框内部，也可自定义
      * @en The prefix of the input box, inside the input box, can also be customized

package/esm/skeleton/demo/style/css/mobile.css

@@ -0,0 +1,7 @@
+#demo-skeleton .arcodesign-mobile-demo-content .arco-cell-group {
+  margin-bottom: 0.32rem;
+}
+#demo-skeleton .arcodesign-mobile-demo-content .arco-cell {
+  margin-left: 0;
+  padding-right: 0;
+}

package/esm/skeleton/demo/style/mobile.less

@@ -0,0 +1,13 @@
+@import '../../../../style/mixin.less';
+
+#demo-skeleton {
+    .arcodesign-mobile-demo-content {
+        .arco-cell-group {
+            margin-bottom: 0.32rem;
+        }
+        .arco-cell {
+            margin-left: 0;
+            padding-right: 0;
+        }
+    }
+}

package/esm/skeleton/elements.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { SkeletonAvatarProps, SkeletonGridProps, SkeletonNodeProps, SkeletonParagraphProps, SkeletonRef, SkeletonTitleProps } from './type';
+export declare const SkeletonNode: React.ForwardRefExoticComponent<SkeletonNodeProps & React.RefAttributes<SkeletonRef>>;
+export declare const SkeletonTitle: React.ForwardRefExoticComponent<SkeletonTitleProps & React.RefAttributes<SkeletonRef>>;
+export declare const SkeletonParagraph: React.ForwardRefExoticComponent<SkeletonParagraphProps & React.RefAttributes<SkeletonRef>>;
+export declare const SkeletonAvatar: React.ForwardRefExoticComponent<SkeletonAvatarProps & React.RefAttributes<SkeletonRef>>;
+export declare const SkeletonGrid: React.ForwardRefExoticComponent<SkeletonGridProps & React.RefAttributes<SkeletonRef>>;

package/esm/skeleton/elements.js

@@ -0,0 +1,281 @@
+import _extends from "@babel/runtime/helpers/extends";
+import React, { forwardRef, useContext, useEffect, useImperativeHandle, useRef, useState } from 'react';
+import { cls, isArray, nextTick } from '@arco-design/mobile-utils';
+import { useListenResize } from '../_helpers';
+import { GlobalContext } from '../context-provider';
+import { SkeletonContext } from './skeleton-context';
+
+var calcOffset = function calcOffset(dom, useRtl) {
+  if (!dom) {
+    return 0;
+  }
+
+  if (useRtl) {
+    return dom.offsetLeft - dom.offsetTop;
+  }
+
+  return dom.offsetLeft + dom.offsetTop;
+};
+
+function useOffset(dom, useRtl) {
+  var _useState = useState(),
+      offset = _useState[0],
+      setOffset = _useState[1];
+
+  var calcLayout = function calcLayout() {
+    var isList = Array.isArray(dom);
+
+    if (!(isList ? dom.length > 0 : dom == null ? void 0 : dom.current)) {
+      return;
+    }
+
+    setOffset(isList ? dom.map(function (item) {
+      return calcOffset(item, useRtl);
+    }) : calcOffset(dom.current, useRtl));
+  };
+
+  useEffect(function () {
+    nextTick(function () {
+      calcLayout();
+    });
+  }, [dom, useRtl]);
+  useListenResize(calcLayout);
+  return offset;
+}
+
+export var SkeletonNode = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _props$className = props.className,
+      className = _props$className === void 0 ? '' : _props$className,
+      style = props.style,
+      children = props.children;
+
+  var _useContext = useContext(GlobalContext),
+      useRtl = _useContext.useRtl,
+      prefixCls = _useContext.prefixCls;
+
+  var _useContext2 = useContext(SkeletonContext),
+      backgroundColor = _useContext2.backgroundColor,
+      showAnimation = _useContext2.showAnimation,
+      animation = _useContext2.animation;
+
+  var domRef = useRef(null);
+  var isGradientAnimation = showAnimation && animation === 'gradient';
+  var offset = useOffset(isGradientAnimation ? domRef : undefined, useRtl);
+  useImperativeHandle(ref, function () {
+    return {
+      dom: domRef.current
+    };
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    className: cls(prefixCls + "-skeleton-item", prefixCls + "-skeleton-node", showAnimation && prefixCls + "-skeleton-animation-" + animation, className),
+    style: _extends({
+      backgroundColor: backgroundColor
+    }, style),
+    ref: domRef
+  }, children, isGradientAnimation && offset !== undefined && /*#__PURE__*/React.createElement("div", {
+    className: prefixCls + "-skeleton-animation-item",
+    style: {
+      left: 0 - offset
+    }
+  }));
+});
+export var SkeletonTitle = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _props$className2 = props.className,
+      className = _props$className2 === void 0 ? '' : _props$className2,
+      style = props.style,
+      _props$width = props.width,
+      width = _props$width === void 0 ? '40%' : _props$width;
+
+  var _useContext3 = useContext(GlobalContext),
+      useRtl = _useContext3.useRtl,
+      prefixCls = _useContext3.prefixCls;
+
+  var _useContext4 = useContext(SkeletonContext),
+      backgroundColor = _useContext4.backgroundColor,
+      showAnimation = _useContext4.showAnimation,
+      animation = _useContext4.animation;
+
+  var domRef = useRef(null);
+  var isGradientAnimation = showAnimation && animation === 'gradient';
+  var offset = useOffset(isGradientAnimation ? domRef : undefined, useRtl);
+  useImperativeHandle(ref, function () {
+    return {
+      dom: domRef.current
+    };
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    className: cls(prefixCls + "-skeleton-item", prefixCls + "-skeleton-title", showAnimation && prefixCls + "-skeleton-animation-" + animation, className),
+    style: _extends({
+      width: width,
+      backgroundColor: backgroundColor
+    }, style),
+    ref: domRef
+  }, isGradientAnimation && offset !== undefined && /*#__PURE__*/React.createElement("div", {
+    className: prefixCls + "-skeleton-animation-item",
+    style: {
+      left: 0 - offset
+    }
+  }));
+});
+export var SkeletonParagraph = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _props$className3 = props.className,
+      className = _props$className3 === void 0 ? '' : _props$className3,
+      style = props.style,
+      _props$rows = props.rows,
+      rows = _props$rows === void 0 ? 3 : _props$rows,
+      _props$width2 = props.width,
+      width = _props$width2 === void 0 ? '60%' : _props$width2;
+
+  var _useContext5 = useContext(GlobalContext),
+      useRtl = _useContext5.useRtl,
+      prefixCls = _useContext5.prefixCls;
+
+  var _useContext6 = useContext(SkeletonContext),
+      backgroundColor = _useContext6.backgroundColor,
+      showAnimation = _useContext6.showAnimation,
+      animation = _useContext6.animation;
+
+  var domRef = useRef(null);
+  var lineDomRefs = useRef([]);
+  var isGradientAnimation = showAnimation && animation === 'gradient';
+  var offsets = useOffset(isGradientAnimation ? lineDomRefs.current : undefined, useRtl);
+  useImperativeHandle(ref, function () {
+    return {
+      dom: domRef.current
+    };
+  });
+
+  var getWidth = function getWidth(idx) {
+    if (isArray(width)) {
+      return width[idx];
+    }
+
+    if (rows - 1 === idx) {
+      return width;
+    }
+
+    return undefined;
+  };
+
+  return /*#__PURE__*/React.createElement("div", {
+    className: cls(prefixCls + "-skeleton-paragraph", className),
+    style: style,
+    ref: domRef
+  }, Array.from(new Array(rows)).map(function (_, idx) {
+    return /*#__PURE__*/React.createElement("div", {
+      key: idx,
+      className: cls(prefixCls + "-skeleton-item", prefixCls + "-skeleton-paragraph-line", showAnimation && prefixCls + "-skeleton-animation-" + animation),
+      style: {
+        width: getWidth(idx),
+        backgroundColor: backgroundColor
+      },
+      ref: function ref(el) {
+        return el && (lineDomRefs.current[idx] = el);
+      }
+    }, isGradientAnimation && offsets !== undefined && /*#__PURE__*/React.createElement("div", {
+      className: prefixCls + "-skeleton-animation-item",
+      style: {
+        left: 0 - (offsets[idx] || 0)
+      }
+    }));
+  }));
+});
+export var SkeletonAvatar = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _props$className4 = props.className,
+      className = _props$className4 === void 0 ? '' : _props$className4,
+      style = props.style;
+
+  var _useContext7 = useContext(GlobalContext),
+      useRtl = _useContext7.useRtl,
+      prefixCls = _useContext7.prefixCls;
+
+  var _useContext8 = useContext(SkeletonContext),
+      backgroundColor = _useContext8.backgroundColor,
+      showAnimation = _useContext8.showAnimation,
+      animation = _useContext8.animation;
+
+  var domRef = useRef(null);
+  var isGradientAnimation = showAnimation && animation === 'gradient';
+  var offset = useOffset(isGradientAnimation ? domRef : undefined, useRtl);
+  useImperativeHandle(ref, function () {
+    return {
+      dom: domRef.current
+    };
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    className: cls(prefixCls + "-skeleton-item", prefixCls + "-skeleton-avatar", showAnimation && prefixCls + "-skeleton-animation-" + animation, className),
+    style: _extends({
+      backgroundColor: backgroundColor
+    }, style),
+    ref: domRef
+  }, isGradientAnimation && offset !== undefined && /*#__PURE__*/React.createElement("div", {
+    className: prefixCls + "-skeleton-animation-item",
+    style: {
+      left: 0 - offset
+    }
+  }));
+});
+export var SkeletonGrid = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _props$className5 = props.className,
+      className = _props$className5 === void 0 ? '' : _props$className5,
+      style = props.style,
+      _props$columns = props.columns,
+      columns = _props$columns === void 0 ? 4 : _props$columns;
+
+  var _useContext9 = useContext(GlobalContext),
+      useRtl = _useContext9.useRtl,
+      prefixCls = _useContext9.prefixCls;
+
+  var _useContext10 = useContext(SkeletonContext),
+      backgroundColor = _useContext10.backgroundColor,
+      showAnimation = _useContext10.showAnimation,
+      animation = _useContext10.animation;
+
+  var domRef = useRef(null);
+  var iconDomRefs = useRef([]);
+  var textDomRefs = useRef([]);
+  var isGradientAnimation = showAnimation && animation === 'gradient';
+  var iconOffsets = useOffset(isGradientAnimation ? iconDomRefs.current : undefined, useRtl);
+  var textOffsets = useOffset(isGradientAnimation ? textDomRefs.current : undefined, useRtl);
+  useImperativeHandle(ref, function () {
+    return {
+      dom: domRef.current
+    };
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    className: cls(prefixCls + "-skeleton-grid", className),
+    style: style,
+    ref: domRef
+  }, Array.from(new Array(columns)).map(function (_, idx) {
+    return /*#__PURE__*/React.createElement("div", {
+      key: idx,
+      className: cls(prefixCls + "-skeleton-grid-item")
+    }, /*#__PURE__*/React.createElement("div", {
+      className: cls(prefixCls + "-skeleton-item", prefixCls + "-skeleton-grid-icon", showAnimation && prefixCls + "-skeleton-animation-" + animation),
+      style: {
+        backgroundColor: backgroundColor
+      },
+      ref: function ref(el) {
+        return el && (iconDomRefs.current[idx] = el);
+      }
+    }, isGradientAnimation && iconOffsets !== undefined && /*#__PURE__*/React.createElement("div", {
+      className: prefixCls + "-skeleton-animation-item",
+      style: {
+        left: 0 - ((iconOffsets == null ? void 0 : iconOffsets[idx]) || 0)
+      }
+    })), /*#__PURE__*/React.createElement("div", {
+      className: cls(prefixCls + "-skeleton-item", prefixCls + "-skeleton-grid-text", showAnimation && prefixCls + "-skeleton-animation-" + animation),
+      style: {
+        backgroundColor: backgroundColor
+      },
+      ref: function ref(el) {
+        return el && (textDomRefs.current[idx] = el);
+      }
+    }, isGradientAnimation && textOffsets !== undefined && /*#__PURE__*/React.createElement("div", {
+      className: prefixCls + "-skeleton-animation-item",
+      style: {
+        left: 0 - ((textOffsets == null ? void 0 : textOffsets[idx]) || 0)
+      }
+    })));
+  }));
+});

package/esm/skeleton/index.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import { SkeletonProps, SkeletonRef } from './type';
+declare const _default: React.ForwardRefExoticComponent<SkeletonProps & React.RefAttributes<SkeletonRef>> & {
+    Node: React.ForwardRefExoticComponent<import("./type").SkeletonNodeProps & React.RefAttributes<SkeletonRef>>;
+    Title: React.ForwardRefExoticComponent<import("./type").SkeletonTitleProps & React.RefAttributes<SkeletonRef>>;
+    Paragraph: React.ForwardRefExoticComponent<import("./type").SkeletonParagraphProps & React.RefAttributes<SkeletonRef>>;
+    Avatar: React.ForwardRefExoticComponent<import("./type").SkeletonAvatarProps & React.RefAttributes<SkeletonRef>>;
+    Grid: React.ForwardRefExoticComponent<import("./type").SkeletonGridProps & React.RefAttributes<SkeletonRef>>;
+};
+/**
+ * 在内容加载过程中展示一组占位图形。
+ * @en Display a set of placeholder graphics during content loading
+ * @type 信息展示
+ * @type_en Data Display
+ * @name 骨架屏
+ * @name_en Skeleton
+ */
+export default _default;

package/esm/skeleton/index.js

@@ -0,0 +1,82 @@
+import _extends from "@babel/runtime/helpers/extends";
+import React, { useRef, forwardRef, useImperativeHandle, useContext } from 'react';
+import { cls, componentWrapper } from '@arco-design/mobile-utils';
+import { GlobalContext } from '../context-provider';
+import { SkeletonAvatar as Avatar, SkeletonGrid as Grid, SkeletonNode as Node, SkeletonParagraph as Paragraph, SkeletonTitle as Title } from './elements';
+import { SkeletonContext } from './skeleton-context';
+
+function getComponentProps(prop) {
+  if (prop && typeof prop === 'object') {
+    return prop;
+  }
+
+  return {};
+}
+
+var Skeleton = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _cls;
+
+  var _props$className = props.className,
+      className = _props$className === void 0 ? '' : _props$className,
+      style = props.style,
+      children = props.children,
+      _props$title = props.title,
+      title = _props$title === void 0 ? true : _props$title,
+      _props$paragraph = props.paragraph,
+      paragraph = _props$paragraph === void 0 ? true : _props$paragraph,
+      _props$avatar = props.avatar,
+      avatar = _props$avatar === void 0 ? false : _props$avatar,
+      grid = props.grid,
+      _props$showAnimation = props.showAnimation,
+      showAnimation = _props$showAnimation === void 0 ? true : _props$showAnimation,
+      _props$animation = props.animation,
+      animation = _props$animation === void 0 ? 'gradient' : _props$animation,
+      animationGradientColor = props.animationGradientColor,
+      backgroundColor = props.backgroundColor;
+  var domRef = useRef(null);
+
+  var _useContext = useContext(GlobalContext),
+      prefixCls = _useContext.prefixCls;
+
+  useImperativeHandle(ref, function () {
+    return {
+      dom: domRef.current
+    };
+  });
+  var isGrid = !!grid;
+  var hasTitle = !!title;
+  var hasParagraph = !!paragraph;
+  var hasAvatar = !!avatar;
+  var content = isGrid ? /*#__PURE__*/React.createElement(Grid, getComponentProps(grid)) : /*#__PURE__*/React.createElement(React.Fragment, null, hasAvatar && /*#__PURE__*/React.createElement(Avatar, getComponentProps(avatar)), (hasTitle || hasParagraph) && /*#__PURE__*/React.createElement("div", {
+    className: prefixCls + "-skeleton-content"
+  }, hasTitle && /*#__PURE__*/React.createElement(Title, getComponentProps(title)), hasParagraph && /*#__PURE__*/React.createElement(Paragraph, getComponentProps(paragraph))));
+  return /*#__PURE__*/React.createElement("div", {
+    className: cls(prefixCls + "-skeleton", (_cls = {}, _cls[prefixCls + "-skeleton-with-avatar"] = hasAvatar, _cls), className),
+    style: _extends({
+      color: animationGradientColor
+    }, style),
+    ref: domRef
+  }, /*#__PURE__*/React.createElement(SkeletonContext.Provider, {
+    value: {
+      showAnimation: showAnimation,
+      animation: animation,
+      backgroundColor: backgroundColor
+    }
+  }, content, children));
+});
+/**
+ * 在内容加载过程中展示一组占位图形。
+ * @en Display a set of placeholder graphics during content loading
+ * @type 信息展示
+ * @type_en Data Display
+ * @name 骨架屏
+ * @name_en Skeleton
+ */
+
+export default componentWrapper(Skeleton, {
+  Node: Node,
+  Title: Title,
+  Paragraph: Paragraph,
+  Avatar: Avatar,
+  Grid: Grid
+});

package/esm/skeleton/skeleton-context.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { SkeletonContextParams } from './type';
+export declare const SkeletonContext: React.Context<SkeletonContextParams>;

package/esm/skeleton/skeleton-context.js

@@ -0,0 +1,5 @@
+import React from 'react';
+export var SkeletonContext = /*#__PURE__*/React.createContext({
+  showAnimation: true,
+  animation: 'gradient'
+});