@qsxy/element-plus-react 1.0.3 → 2.0.0

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 {};

package/dist/Button/Button.d.ts

@@ -1,13 +1,4 @@
-import React, { RefObject } from 'react';
-import ButtonGroup from './ButtonGroup';
+import React from 'react';
 import { ButtonProps, ButtonRef } from './typings';
-declare const Comp: (props: ButtonProps & {
-    ref?: RefObject<ButtonRef>;
-}) => React.ReactElement;
-type InternalType = typeof Comp;
-interface CompInterface extends InternalType {
-    displayName?: string;
-    Group: typeof ButtonGroup;
-}
-declare const Button: CompInterface;
+declare const Button: React.MemoExoticComponent<React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<ButtonRef>>>;
 export default Button;

package/dist/Button/Button.js

@@ -24,10 +24,9 @@ import { useConfigProvider } from "../ConfigProvider/ConfigProviderContext";
 import Icon from "../Icon/Icon";
 import { isNotEmpty } from "../Util";
 import { partitionHTMLProps, useClassNames, useDisabled, useSize } from "../hooks";
-import ButtonGroup from "./ButtonGroup";
 import { ButtonGroupContext } from "./ButtonGroupContext";
 import { useButtonCustomStyle } from "./useButtonCustomStyle";
-var InternalButton = function InternalButton(props, ref) {
+var Button = /*#__PURE__*/memo( /*#__PURE__*/forwardRef(function (props, ref) {
   var _ref, _button$type, _button$plain, _button$round;
   var _useContext = useContext(ButtonGroupContext),
     groupDisabled = _useContext.disabled,
@@ -135,9 +134,6 @@ var InternalButton = function InternalButton(props, ref) {
   }), loading && spin, icon && !loading && typeof icon === 'string' ? /*#__PURE__*/React.createElement(Icon, _extends({
     name: icon
   }, iconProps)) : null, children);
-};
-var Comp = /*#__PURE__*/memo( /*#__PURE__*/forwardRef(InternalButton));
-var Button = Comp;
-Button.Group = ButtonGroup;
+}));
 Button.displayName = 'ElButton';
 export default Button;

package/dist/Button/index.d.ts

@@ -1,3 +1,3 @@
 export { default as Button } from './Button';
 export { default as ButtonGroup } from './ButtonGroup';
-export type { ButtonGroupProps, ButtonProps } from './typings';
+export type { ButtonGroupProps, ButtonProps, ButtonRef } from './typings';

package/dist/Calendar/Calendar.js

@@ -44,7 +44,8 @@ var Calendar = /*#__PURE__*/forwardRef(function (props, ref) {
     showToday = _useContext.showToday,
     showNow = _useContext.showNow,
     popperInstRef = _useContext.popperInstRef,
-    onChange = _useContext.onChange,
+    _onChange = _useContext.onChange,
+    close = _useContext.close,
     onChangeRange = _useContext.onChangeRange,
     shortcuts = _useContext.shortcuts;
   var _useClassNames = useClassNames('picker-panel'),
@@ -218,10 +219,10 @@ var Calendar = /*#__PURE__*/forwardRef(function (props, ref) {
         setView('quarter');
         setValue(date);
       } else {
-        onChange === null || onChange === void 0 || onChange(date);
+        _onChange === null || _onChange === void 0 || _onChange(date);
       }
     }
-  }, [dateType, hasMonth, onChange, popperInstRef, rangePosition, valueRange]);
+  }, [dateType, hasMonth, _onChange, popperInstRef, rangePosition, valueRange]);
 
   /**
    * 选中月份后的回调
@@ -258,19 +259,19 @@ var Calendar = /*#__PURE__*/forwardRef(function (props, ref) {
       }
     } else {
       // 如果日期类型就是月份的话，直接返回值
-      onChange === null || onChange === void 0 || onChange(date, {
+      _onChange === null || _onChange === void 0 || _onChange(date, {
         month: month
       });
     }
-  }, [dateType, onChange, popperInstRef, rangePosition, valueRange]);
+  }, [dateType, _onChange, popperInstRef, rangePosition, valueRange]);
 
   /**
    * 选中日期后的回调
    * @param date
    */
   var onPickDate = useCallback(function (date) {
-    onChange === null || onChange === void 0 || onChange(date);
-  }, [onChange]);
+    _onChange === null || _onChange === void 0 || _onChange(date);
+  }, [_onChange]);
 
   /**
    * 选中范围日期后的回调
@@ -311,7 +312,10 @@ var Calendar = /*#__PURE__*/forwardRef(function (props, ref) {
     className: e(_templateObject || (_templateObject = _taggedTemplateLiteral(["body-wrapper"])))
   }, /*#__PURE__*/React.createElement(ShortCuts, {
     shortcuts: shortcuts,
-    onChange: onChange,
+    onChange: function onChange(val, params) {
+      _onChange === null || _onChange === void 0 || _onChange(val, params);
+      close === null || close === void 0 || close();
+    },
     e: e
   }), /*#__PURE__*/React.createElement("div", {
     className: e(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["body"])))

package/dist/Calendar/YearRangePanel.js

@@ -71,7 +71,7 @@ var YearRangePanel = function YearRangePanel(props) {
     }), " - ").concat(curYear + (9 - position), " ").concat(t('el.datepicker.year', {
       lng: locale
     }));
-  }, [startDate]);
+  }, [locale, startDate, t]);
 
   // 当前年份
   var rightYear = useMemo(function () {

package/dist/Carousel/typings.d.ts

@@ -1,6 +1,6 @@
 import { RefObject } from 'react';
 import { BaseProps, NativeProps } from '../types/common';
-export interface CarouselProps extends BaseProps, NativeProps {
+export interface CarouselProps extends BaseProps, NativeProps<'--el-carousel-arrow-font-size' | '--el-carousel-arrow-size' | '--el-carousel-arrow-background' | '--el-carousel-arrow-hover-background' | '--el-carousel-indicator-width' | '--el-carousel-indicator-height' | '--el-carousel-indicator-padding-horizontal' | '--el-carousel-indicator-padding-vertical' | '--el-carousel-indicator-out-color'> {
     /** carousel 的高度	 */
     height?: string | number;
     /** 初始状态激活的幻灯片的索引，从 0 开始	 */

package/dist/Cascader/Cascader.d.ts

@@ -1,4 +1,4 @@
-import { FC } from 'react';
-import { CascaderProps } from './typings';
-declare const Cascader: FC<CascaderProps>;
+import React from 'react';
+import { CascaderProps, CascaderRef } from './typings';
+declare const Cascader: React.MemoExoticComponent<React.ForwardRefExoticComponent<CascaderProps<import("./typings").CascaderValue, any> & React.RefAttributes<CascaderRef>>>;
 export default Cascader;