@qsxy/element-plus-react 1.0.2 → 2.0.0

package/dist/Anchor/Anchor.js

@@ -0,0 +1,258 @@
+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 { useMount } from 'ahooks';
+import classNames from 'classnames';
+import React, { createContext, forwardRef, memo, useCallback, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
+import { useClassNames } from "../hooks";
+import { animateScrollTo, getOffsetTopDistance, getScrollElement, getScrollTop, isWindow, mergeDefaultProps } from "../Util";
+import { throttleByRaf } from "../Util/throttleByRaf";
+import { getElement } from "./element";
+/** 锚点 Context */
+export var AnchorContext = /*#__PURE__*/createContext(null);
+var Anchor = /*#__PURE__*/memo( /*#__PURE__*/forwardRef(function (props, ref) {
+  props = mergeDefaultProps({
+    classPrefix: 'anchor',
+    offset: 0,
+    bound: 15,
+    duration: 300,
+    marker: true,
+    type: 'default',
+    direction: 'vertical'
+  }, props);
+  var _props = props,
+    classPrefix = _props.classPrefix,
+    offset = _props.offset,
+    bound = _props.bound,
+    duration = _props.duration,
+    marker = _props.marker,
+    type = _props.type,
+    direction = _props.direction,
+    selectScrollTop = _props.selectScrollTop,
+    container = _props.container,
+    onChange = _props.onChange,
+    onClick = _props.onClick,
+    className = _props.className,
+    style = _props.style,
+    children = _props.children;
+  var ns = useClassNames(classPrefix);
+  var _useState = useState(''),
+    _useState2 = _slicedToArray(_useState, 2),
+    currentAnchor = _useState2[0],
+    setCurrentAnchor = _useState2[1];
+  var _useState3 = useState({}),
+    _useState4 = _slicedToArray(_useState3, 2),
+    markerStyle = _useState4[0],
+    setMarkerStyle = _useState4[1];
+  var anchorRef = useRef(null);
+  var markerRef = useRef(null);
+  var containerElRef = useRef();
+  var linksRef = useRef({});
+  var isScrollingRef = useRef(false);
+  var currentScrollTopRef = useRef(0);
+  var clearAnimateRef = useRef(null);
+  var currentTargetHrefRef = useRef('');
+  var cls = useMemo(function () {
+    return classNames(ns.b(), type === 'underline' ? ns.m('underline') : '', ns.m(direction));
+  }, [ns, type, direction]);
+  var addLink = useCallback(function (state) {
+    linksRef.current[state.href] = state.el;
+  }, []);
+  var removeLink = useCallback(function (href) {
+    delete linksRef.current[href];
+  }, []);
+  var handleCurrentAnchorChange = useCallback(function (href) {
+    if (currentAnchor !== href) {
+      setCurrentAnchor(href);
+      onChange === null || onChange === void 0 || onChange(href);
+    }
+  }, [currentAnchor, onChange]);
+  var getCurrentHref = useCallback(function () {
+    var containerEl = containerElRef.current;
+    if (!containerEl) {
+      return;
+    }
+    var scrollTop = getScrollTop(containerEl);
+    var anchorTopList = [];
+    for (var _i = 0, _Object$keys = Object.keys(linksRef.current); _i < _Object$keys.length; _i++) {
+      var href = _Object$keys[_i];
+      var target = getElement(href);
+      if (!target) {
+        continue;
+      }
+      var scrollEle = getScrollElement(target, containerEl);
+      var distance = getOffsetTopDistance(target, scrollEle);
+      anchorTopList.push({
+        top: distance - offset - bound,
+        href: href
+      });
+    }
+    anchorTopList.sort(function (prev, next) {
+      return prev.top - next.top;
+    });
+    for (var i = 0; i < anchorTopList.length; i++) {
+      var item = anchorTopList[i];
+      var next = anchorTopList[i + 1];
+      if (i === 0 && scrollTop === 0) {
+        return selectScrollTop ? item.href : '';
+      }
+      if (item.top <= scrollTop && (!next || next.top > scrollTop)) {
+        return item.href;
+      }
+    }
+  }, [offset, bound, selectScrollTop]);
+  var scrollToAnchor = useCallback(function (href) {
+    var containerEl = containerElRef.current;
+    if (!containerEl) {
+      return;
+    }
+    var target = getElement(href);
+    if (!target) {
+      return;
+    }
+    if (clearAnimateRef.current) {
+      if (currentTargetHrefRef.current === href) {
+        return;
+      }
+      clearAnimateRef.current();
+    }
+    currentTargetHrefRef.current = href;
+    isScrollingRef.current = true;
+    var scrollEle = getScrollElement(target, containerEl);
+    var distance = getOffsetTopDistance(target, scrollEle);
+    var max = scrollEle.scrollHeight - scrollEle.clientHeight;
+    var to = Math.min(distance - offset, max);
+    clearAnimateRef.current = animateScrollTo(containerEl, currentScrollTopRef.current, to, duration, function () {
+      setTimeout(function () {
+        isScrollingRef.current = false;
+        currentTargetHrefRef.current = '';
+      }, 20);
+    });
+  }, [offset, duration]);
+  var scrollTo = useCallback(function (href) {
+    if (href) {
+      handleCurrentAnchorChange(href);
+      scrollToAnchor(href);
+    }
+  }, [handleCurrentAnchorChange, scrollToAnchor]);
+  var handleClick = useCallback(function (e, href) {
+    onClick === null || onClick === void 0 || onClick(e, href);
+    scrollTo(href);
+  }, [onClick, scrollTo]);
+  var handleScroll = useMemo(function () {
+    return throttleByRaf(function () {
+      var containerEl = containerElRef.current;
+      if (containerEl) {
+        currentScrollTopRef.current = getScrollTop(containerEl);
+      }
+      var currentHref = getCurrentHref();
+      if (isScrollingRef.current || currentHref === undefined) {
+        return;
+      }
+      handleCurrentAnchorChange(currentHref);
+    });
+  }, [getCurrentHref, handleCurrentAnchorChange]);
+  var getContainer = useCallback(function () {
+    var el = getElement(container !== null && container !== void 0 ? container : null);
+    if (!el || isWindow(el)) {
+      containerElRef.current = window;
+    } else {
+      containerElRef.current = el;
+    }
+  }, [container]);
+  var updateMarkerStyle = useCallback(function () {
+    if (!anchorRef.current || !markerRef.current || !currentAnchor) {
+      setMarkerStyle({});
+      return;
+    }
+    var currentLinkEl = linksRef.current[currentAnchor];
+    if (!currentLinkEl) {
+      setMarkerStyle({});
+      return;
+    }
+    var anchorRect = anchorRef.current.getBoundingClientRect();
+    var markerRect = markerRef.current.getBoundingClientRect();
+    var linkRect = currentLinkEl.getBoundingClientRect();
+    if (direction === 'horizontal') {
+      var left = linkRect.left - anchorRect.left;
+      setMarkerStyle({
+        left: "".concat(left, "px"),
+        width: "".concat(linkRect.width, "px"),
+        opacity: 1
+      });
+    } else {
+      var top = linkRect.top - anchorRect.top + (linkRect.height - markerRect.height) / 2;
+      setMarkerStyle({
+        top: "".concat(top, "px"),
+        opacity: 1
+      });
+    }
+  }, [currentAnchor, direction]);
+
+  // 在挂载后更新 marker 样式
+  useEffect(function () {
+    updateMarkerStyle();
+  }, [currentAnchor, children]);
+
+  // 挂载时初始化
+  useMount(function () {
+    getContainer();
+    var hash = decodeURIComponent(window.location.hash);
+    var target = getElement(hash);
+    if (target) {
+      scrollTo(hash);
+    } else {
+      handleScroll();
+    }
+  });
+
+  // 监听 container 变化
+  useEffect(function () {
+    getContainer();
+  }, [container]);
+
+  // 绑定滚动事件
+  useEffect(function () {
+    var containerEl = containerElRef.current;
+    if (!containerEl) {
+      return;
+    }
+    containerEl.addEventListener('scroll', handleScroll);
+    return function () {
+      containerEl.removeEventListener('scroll', handleScroll);
+    };
+  }, []);
+  var contextValue = useMemo(function () {
+    return {
+      ns: ns,
+      direction: direction,
+      currentAnchor: currentAnchor,
+      addLink: addLink,
+      removeLink: removeLink,
+      handleClick: handleClick
+    };
+  }, [ns, direction, currentAnchor, addLink, removeLink, handleClick]);
+  useImperativeHandle(ref, function () {
+    return {
+      scrollTo: scrollTo
+    };
+  }, [scrollTo]);
+  return /*#__PURE__*/React.createElement(AnchorContext.Provider, {
+    value: contextValue
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: anchorRef,
+    className: classNames(cls, className),
+    style: style
+  }, marker && /*#__PURE__*/React.createElement("div", {
+    ref: markerRef,
+    className: ns.e('marker'),
+    style: markerStyle
+  }), /*#__PURE__*/React.createElement("div", {
+    className: ns.e('list')
+  }, children)));
+}));
+Anchor.displayName = 'ElAnchor';
+export default Anchor;

package/dist/Anchor/AnchorLink.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { AnchorLinkProps } from './typings';
+declare const AnchorLink: FC<AnchorLinkProps>;
+export default AnchorLink;

package/dist/Anchor/AnchorLink.js

@@ -0,0 +1,77 @@
+var _templateObject, _templateObject2, _templateObject3;
+function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
+import classNames from 'classnames';
+import React, { memo, useCallback, useContext, useEffect, useMemo, useRef } from 'react';
+import { AnchorContext } from "./Anchor";
+var AnchorLink = /*#__PURE__*/memo(function (props) {
+  var _props$title = props.title,
+    title = _props$title === void 0 ? '' : _props$title,
+    _props$href = props.href,
+    href = _props$href === void 0 ? '' : _props$href,
+    className = props.className,
+    style = props.style,
+    children = props.children;
+  var linkRef = useRef(null);
+  var context = useContext(AnchorContext);
+  var ns = context.ns,
+    direction = context.direction,
+    currentAnchor = context.currentAnchor,
+    addLink = context.addLink,
+    removeLink = context.removeLink,
+    contextHandleClick = context.handleClick;
+  var cls = useMemo(function () {
+    return classNames(ns.e(_templateObject || (_templateObject = _taggedTemplateLiteral(["link"]))), ns.is({
+      active: currentAnchor === href
+    }));
+  }, [ns, currentAnchor, href]);
+  var handleClick = useCallback(function (e) {
+    contextHandleClick(e, href);
+  }, [contextHandleClick, href]);
+  var prevHrefRef = useRef(href);
+
+  // 注册/移除链接
+  useEffect(function () {
+    if (href) {
+      addLink({
+        href: href,
+        el: linkRef.current
+      });
+    }
+    return function () {
+      if (href) {
+        removeLink(href);
+      }
+    };
+  }, []);
+
+  // 监听 href 变化，更新链接
+  useEffect(function () {
+    var oldVal = prevHrefRef.current;
+    if (oldVal && oldVal !== href) {
+      removeLink(oldVal);
+    }
+    if (href && href !== oldVal) {
+      addLink({
+        href: href,
+        el: linkRef.current
+      });
+    }
+    prevHrefRef.current = href;
+  }, [href]);
+  if (!context) {
+    return null;
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: ns.e(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["item"])))
+  }, /*#__PURE__*/React.createElement("a", {
+    ref: linkRef,
+    className: classNames(cls, className),
+    href: href,
+    style: style,
+    onClick: handleClick
+  }, title), children && React.Children.count(children) > 0 && direction === 'vertical' && /*#__PURE__*/React.createElement("div", {
+    className: ns.e(_templateObject3 || (_templateObject3 = _taggedTemplateLiteral(["list"])))
+  }, children));
+});
+AnchorLink.displayName = 'ElAnchorLink';
+export default AnchorLink;

package/dist/Anchor/element.d.ts

@@ -0,0 +1,4 @@
+import { RefObject } from 'react';
+type GetElement = <T extends string | HTMLElement | null | undefined>(target: string | RefObject<HTMLElement> | Window | null | undefined) => T extends string ? HTMLElement | null : T;
+export declare const getElement: GetElement;
+export {};

package/dist/Anchor/element.js

@@ -0,0 +1,17 @@
+import { isClient, isString } from "../Util";
+export var getElement = function getElement(target) {
+  if (!isClient || target === '' || target === null) {
+    return null;
+  }
+  if (isString(target)) {
+    try {
+      return document.querySelector(target);
+    } catch (_unused) {
+      return null;
+    }
+  }
+  if (!(target instanceof Window) && Object.prototype.hasOwnProperty.call(target, 'current')) {
+    return target.current;
+  }
+  return target;
+};

package/dist/Anchor/index.d.ts

@@ -0,0 +1,3 @@
+export { default as Anchor } from './Anchor';
+export { default as AnchorLink } from './AnchorLink';
+export type { AnchorContext, AnchorLinkProps, AnchorLinkState, AnchorProps, AnchorRef } from './typings';

package/dist/Anchor/index.js

@@ -0,0 +1,2 @@
+export { default as Anchor } from "./Anchor";
+export { default as AnchorLink } from "./AnchorLink";

package/dist/Anchor/typings.d.ts

@@ -0,0 +1,101 @@
+import React, { RefObject } from 'react';
+import type { UseNamespaceReturn } from '../hooks';
+import type { BaseProps, NativeProps } from '../types/common';
+/**
+ * 锚点链接状态
+ */
+export interface AnchorLinkState {
+    /** 链接对应的 DOM 元素 */
+    el: HTMLElement;
+    /** 链接的 href 地址 */
+    href: string;
+}
+/**
+ * 锚点上下文
+ */
+export interface AnchorContext {
+    /** 命名空间工具 */
+    ns: UseNamespaceReturn;
+    /** 锚点方向 */
+    direction: 'vertical' | 'horizontal';
+    /** 当前激活的锚点 */
+    currentAnchor: string;
+    /** 注册锚点链接 */
+    addLink: (state: AnchorLinkState) => void;
+    /** 移除锚点链接 */
+    removeLink: (href: string) => void;
+    /** 点击事件处理 */
+    handleClick: (e: React.MouseEvent, href?: string) => void;
+}
+/**
+ * Anchor 组件 Props
+ */
+export interface AnchorProps extends BaseProps, NativeProps<'--el-anchor-bg-color' | '--el-anchor-padding-indent' | '--el-anchor-line-height' | '--el-anchor-font-size' | '--el-anchor-color' | '--el-anchor-active-color' | '--el-anchor-marker-bg-color'> {
+    /**
+     * 滚动的容器
+     */
+    container?: string | RefObject<HTMLElement> | Window | null;
+    /**
+     * 设置锚点滚动的偏移量
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * 触发锚点的元素的位置偏移量
+     * @default 15
+     */
+    bound?: number;
+    /**
+     * 设置容器滚动持续时间，单位为毫秒
+     * @default 300
+     */
+    duration?: number;
+    /**
+     * 是否显示标记
+     * @default true
+     */
+    marker?: boolean;
+    /**
+     * 设置锚点类型
+     * @default 'default'
+     */
+    type?: 'default' | 'underline';
+    /**
+     * 设置锚点方向
+     * @default 'vertical'
+     */
+    direction?: 'vertical' | 'horizontal';
+    /**
+     * 滚动时，链接是否选中位于顶部
+     * @default false
+     */
+    selectScrollTop?: boolean;
+    /**
+     * 锚点链接改变时触发
+     */
+    onChange?: (href: string) => void;
+    /**
+     * 当用户点击链接时触发
+     */
+    onClick?: (e: React.MouseEvent, href?: string) => void;
+}
+/**
+ * AnchorLink 组件 Props
+ */
+export interface AnchorLinkProps extends BaseProps, NativeProps {
+    /**
+     * 链接的文本内容
+     */
+    title?: string | React.ReactNode;
+    /**
+     * 链接的地址
+     */
+    href?: string;
+}
+/**
+ * Anchor 组件暴露的实例方法
+ */
+export interface AnchorRef {
+    /** 手动滚动到特定锚点位置 */
+    scrollTo: (href: string) => void;
+}

package/dist/Anchor/typings.js

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

package/dist/Backtop/Backtop.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { BacktopProps } from './typings';
+/**
+ * Backtop 回到顶部组件
+ */
+declare const Backtop: React.MemoExoticComponent<React.ForwardRefExoticComponent<BacktopProps & React.RefAttributes<HTMLDivElement>>>;
+export default Backtop;

package/dist/Backtop/Backtop.js

@@ -0,0 +1,153 @@
+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 _templateObject;
+function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
+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); }
+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 { useMount } from 'ahooks';
+import classNames from 'classnames';
+import { useComposeRef } from 'rc-util';
+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useClassNames } from "../hooks";
+import { namespace } from "../hooks/prefix";
+import Icon from "../Icon/Icon";
+import { Transition } from "../Transition";
+import { cAF, mergeDefaultProps, rAF } from "../Util";
+/**
+ * Backtop 回到顶部组件
+ */
+var Backtop = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (props, ref) {
+  props = mergeDefaultProps({
+    classPrefix: 'backtop',
+    visibilityHeight: 200,
+    target: '',
+    right: 40,
+    bottom: 40
+  }, props);
+  var _props = props,
+    classPrefix = _props.classPrefix,
+    visibilityHeight = _props.visibilityHeight,
+    target = _props.target,
+    right = _props.right,
+    bottom = _props.bottom,
+    onClick = _props.onClick,
+    className = _props.className,
+    style = _props.style,
+    children = _props.children;
+  var _useClassNames = useClassNames(classPrefix),
+    b = _useClassNames.b,
+    e = _useClassNames.e;
+  var elRef = useRef();
+  var containerRef = useRef();
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    visible = _useState2[0],
+    setVisible = _useState2[1];
+  var _nodeRef = useRef(null);
+  var mergedRef = useComposeRef(ref, _nodeRef);
+
+  /** 节流处理滚动事件 */
+  var handleScroll = useCallback(function () {
+    if (elRef.current) {
+      setVisible(elRef.current.scrollTop >= visibilityHeight);
+    }
+  }, [visibilityHeight]);
+  var throttledRef = useRef(handleScroll);
+  throttledRef.current = handleScroll;
+  var handleScrollThrottled = useRef();
+
+  // 初始化节流函数
+  useEffect(function () {
+    var timer = 0;
+    var fn = function fn() {
+      if (timer) {
+        cAF(timer);
+      }
+      timer = rAF(function () {
+        throttledRef.current();
+        timer = 0;
+      });
+    };
+    fn.cancel = function () {
+      cAF(timer);
+      timer = 0;
+    };
+    handleScrollThrottled.current = fn;
+    return function () {
+      fn.cancel();
+    };
+  }, []);
+
+  /** 点击回到顶部 */
+  var handleClick = useCallback(function (event) {
+    var _elRef$current;
+    (_elRef$current = elRef.current) === null || _elRef$current === void 0 || _elRef$current.scrollTo({
+      top: 0,
+      behavior: 'smooth'
+    });
+    onClick === null || onClick === void 0 || onClick(event);
+  }, [onClick]);
+
+  // 挂载时初始化
+  useMount(function () {
+    containerRef.current = document;
+    elRef.current = document.documentElement;
+    if (target) {
+      var el = document.querySelector(target);
+      if (!el) {
+        throw new Error("[Backtop] target does not exist: ".concat(target));
+      }
+      elRef.current = el;
+      containerRef.current = el;
+    }
+
+    // 初始检查
+    handleScroll();
+    var container = containerRef.current;
+    var scrollFn = handleScrollThrottled.current;
+    if (container && scrollFn) {
+      container.addEventListener('scroll', scrollFn, {
+        passive: true
+      });
+    }
+    return function () {
+      if (container && scrollFn) {
+        container.removeEventListener('scroll', scrollFn);
+      }
+    };
+  });
+  var backTopStyle = useMemo(function () {
+    return _objectSpread({
+      right: "".concat(right, "px"),
+      bottom: "".concat(bottom, "px")
+    }, style);
+  }, [right, bottom, style]);
+  return /*#__PURE__*/React.createElement(Transition, {
+    visible: visible,
+    name: "".concat(namespace, "-fade-in"),
+    duration: 300,
+    nodeRef: function nodeRef() {
+      return _nodeRef;
+    },
+    display: "flex"
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: mergedRef,
+    className: classNames(b(), className),
+    style: backTopStyle,
+    onClick: handleClick
+  }, children || /*#__PURE__*/React.createElement(Icon, {
+    className: e(_templateObject || (_templateObject = _taggedTemplateLiteral(["icon"]))),
+    name: "caret-up",
+    prefix: "fas"
+  })));
+}));
+Backtop.displayName = 'ElBacktop';
+export default Backtop;

package/dist/Backtop/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Backtop } from './Backtop';
+export type { BacktopProps } from './typings';

package/dist/Backtop/index.js

@@ -0,0 +1 @@
+export { default as Backtop } from "./Backtop";

package/dist/Backtop/typings.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { BaseProps, NativeProps } from '../types/common';
+/**
+ * Backtop 组件 Props
+ */
+export interface BacktopProps extends BaseProps, NativeProps<'--el-backtop-bg-color' | '--el-backtop-text-color' | '--el-backtop-text-color:' | '--el-backtop-hover-bg-color'> {
+    /**
+     * 滚动高度达到此参数值才出现
+     * @default 200
+     */
+    visibilityHeight?: number;
+    /**
+     * 触发滚动的对象
+     * @default ''
+     */
+    target?: string;
+    /**
+     * 控制其显示位置，距离页面右边距
+     * @default 40
+     */
+    right?: number;
+    /**
+     * 控制其显示位置，距离页面底部距离
+     * @default 40
+     */
+    bottom?: number;
+    /**
+     * 点击按钮触发的事件
+     */
+    onClick?: (evt: React.MouseEvent) => void;
+}

package/dist/Backtop/typings.js

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