@qsxy/element-plus-react 1.0.0-next.1 → 1.0.0-next.3

package/README.md

@@ -0,0 +1,31 @@
+# @qsxy/element-plus-react
+
+[![NPM version](https://img.shields.io/npm/v/element-plus-react.svg?style=flat)](https://npmjs.org/package/@qsxy/element-plus-react)
+[![NPM downloads](http://img.shields.io/npm/dm/element-plus-react.svg?style=flat)](https://npmjs.org/package/@qsxy/element-plus-react)
+
+@qsxy/element-plus-react
+
+## Usage
+
+TODO
+
+## Options
+
+TODO
+
+## Development
+
+```bash
+# install dependencies
+$ npm i @qsxy/element-plus-react
+```
+
+```javascript
+// how to use
+import '@qsxy/element-plus-react/dist/index.css';
+import { ElButton, ElLink } from '@qsxy/element-plus-react';
+```
+
+## LICENSE
+
+MIT

package/dist/Badge/Badge.js

@@ -38,8 +38,9 @@ var import_react = __toESM(require("react"));
 var import_Transition = __toESM(require("../Transition/Transition"));
 var import_hooks = require("../hooks");
 var Badge = (0, import_react.forwardRef)((props, ref) => {
-  const { type, isDot, value, max, hidden, showZero = true, color, offset = [], badgeClass, badgeStyle = {} } = props;
+  const { type = "danger", isDot, value, max, hidden, showZero = true, color, offset = [], badgeClass, badgeStyle = {} } = props;
   const { b, e, em, is } = (0, import_hooks.useClassNames)("badge");
+  const nodeRef = (0, import_react.useRef)(null);
   const content = (0, import_react.useMemo)(() => {
     if (isDot) {
       return "";
@@ -49,9 +50,10 @@ var Badge = (0, import_react.forwardRef)((props, ref) => {
     }
     return `${value}`;
   }, [isDot, max, value]);
-  return /* @__PURE__ */ import_react.default.createElement("div", { ref, className: (0, import_classnames.default)(b(), props.className), style: props.style }, props.children, /* @__PURE__ */ import_react.default.createElement(import_Transition.default, { name: "r-zoom-in-center", visible: !hidden && (!!content || isDot) && !(!showZero && value === 0), display: "inline-flex" }, /* @__PURE__ */ import_react.default.createElement(
+  return /* @__PURE__ */ import_react.default.createElement("div", { ref, className: (0, import_classnames.default)(b(), props.className), style: props.style }, props.children, /* @__PURE__ */ import_react.default.createElement(import_Transition.default, { nodeRef, name: "r-zoom-in-center", visible: !hidden && (!!content || isDot) && !(!showZero && value === 0), display: "inline-flex" }, /* @__PURE__ */ import_react.default.createElement(
     "sup",
     {
+      ref: nodeRef,
       className: (0, import_classnames.default)(e`content`, em("content", type), is({ fixed: !!props.children, dot: isDot }), badgeClass),
       style: { background: color, marginRight: (offset == null ? void 0 : offset[0]) ? -offset[0] : null, marginTop: offset == null ? void 0 : offset[1], ...badgeStyle }
     },
@@ -59,7 +61,4 @@ var Badge = (0, import_react.forwardRef)((props, ref) => {
   )));
 });
 Badge.displayName = "ElBadge";
-Badge.defaultProps = {
-  type: "danger"
-};
 var Badge_default = (0, import_react.memo)(Badge);

package/dist/Badge/typings.d.ts

@@ -1,14 +1,24 @@
 import React from 'react';
 import { AnimationEventProps, BaseProps, NativeProps, TypeAttributes } from '../types/common';
 export interface BadgeProps extends BaseProps, NativeProps, AnimationEventProps {
+    /** 显示值 */
     value?: string | number;
+    /** 最大值，超过最大值会显示 {max}+。 只有当 value 是数字类型时起作用。 */
     max?: number;
+    /** 是否显示小圆点。 */
     isDot?: boolean;
+    /** 是否隐藏 Badge。 */
     hidden?: Boolean;
+    /** 类型 */
     type?: TypeAttributes.Appearance;
+    /** 值为零时是否显示 Badge */
     showZero?: boolean;
+    /** 背景色 */
     color?: string;
+    /** badge 的偏移量 */
     offset?: [number, number];
+    /** 自定义 badge 样式 */
     badgeStyle?: React.CSSProperties;
+    /** 自定义 badge 类名  */
     badgeClass?: string;
 }

package/dist/Breadcrumb/Breadcrumb.js

@@ -37,13 +37,10 @@ var import_classnames = __toESM(require("classnames"));
 var import_react = __toESM(require("react"));
 var import_hooks = require("../hooks");
 var Breadcrumb = (0, import_react.memo)((props) => {
-  const { classPrefix = "breadcrumb", separator } = props;
+  const { classPrefix = "breadcrumb", separator = "/" } = props;
   const { b } = (0, import_hooks.useClassNames)(classPrefix);
   return /* @__PURE__ */ import_react.default.createElement(BreadcrumbContext.Provider, { value: { separator } }, /* @__PURE__ */ import_react.default.createElement("div", { className: (0, import_classnames.default)(b(), props.className), style: props.style }, props.children));
 });
-Breadcrumb.defaultProps = {
-  separator: "/"
-};
 var Breadcrumb_default = Breadcrumb;
 var BreadcrumbContext = (0, import_react.createContext)({
   separator: "/"

package/dist/Breadcrumb/typings.d.ts

@@ -2,12 +2,16 @@ import React from 'react';
 import { RouteProps } from 'react-router-dom';
 import { BaseProps, NativeProps } from '../types/common';
 export interface BreadcrumbProps extends BaseProps, NativeProps {
+    /** 分隔符 */
     separator?: string | React.ReactElement<any>;
 }
 export interface BreadcrumbContextProps {
+    /** 分隔符 */
     separator: string | React.ReactElement<any>;
 }
 export interface BreadcrumbItemProps extends BaseProps, NativeProps {
+    /** 路由跳转目标，同 vue-router 的 to 属性	 */
     to?: string | RouteProps;
+    /** 如果设置该属性为 true, 导航将不会留下历史记录	 */
     onClick?: (to?: string | RouteProps) => void;
 }

package/dist/Button/Button.d.ts

@@ -7,7 +7,6 @@ declare const Comp: (props: ButtonProps & {
 type InternalType = typeof Comp;
 interface CompInterface extends InternalType {
     displayName?: string;
-    defaultProps?: ButtonProps;
     Group: typeof ButtonGroup;
 }
 declare const Button: CompInterface;

package/dist/Button/Button.js

@@ -43,14 +43,32 @@ var import_ButtonGroupContext = require("./ButtonGroupContext");
 var InternalButton = (props, ref) => {
   const { disabled: groupDisabled, type: groupType, size: groupSize, bgColor, borderColor } = (0, import_react.useContext)(import_ButtonGroupContext.ButtonGroupContext);
   const { button } = (0, import_react.useContext)(import_ConfigProvider.ConfigProvider);
-  const { active, block, plain, round, circle, link, text, bg, dashed, className, loading, loadingIcon, loadingSlot, nativeType, icon, onClick, ...rest } = props;
+  const {
+    active,
+    block,
+    plain,
+    round,
+    circle,
+    link,
+    text,
+    bg,
+    dashed,
+    className,
+    loading,
+    loadingIcon = "spinner",
+    loadingSlot,
+    nativeType = "button",
+    icon = false,
+    onClick,
+    ...rest
+  } = props;
   const disabled = (0, import_hooks.useDisabled)(groupDisabled ?? props.disabled);
   const size = (0, import_hooks.useSize)(groupSize ?? props.size);
   const { b, m, is } = (0, import_hooks.useClassNames)("button");
   const [htmlInputProps] = (0, import_hooks.partitionHTMLProps)(rest);
   const containerRef = (0, import_react.useRef)(null);
-  const spin = (0, import_react.useMemo)(() => loadingSlot ?? /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: loadingIcon, className: (0, import_classnames.default)(b`spin`, is`loading`), spin: true }), [loadingSlot, loadingIcon, import_classnames.default, b, is]);
-  const type = (0, import_react.useMemo)(() => groupType ?? props.type, [groupType, props.type]);
+  const spin = (0, import_react.useMemo)(() => loadingSlot ?? /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: loadingIcon, className: (0, import_classnames.default)(b`spin`, is`loading`), spin: true }), [loadingSlot, loadingIcon, b, is]);
+  const type = (0, import_react.useMemo)(() => groupType ?? (props.type || "default"), [groupType, props.type]);
   const autoInsertSpace = (0, import_react.useMemo)(() => props.autoInsertSpace ?? (button == null ? void 0 : button.autoInsertSpace) ?? true, [button == null ? void 0 : button.autoInsertSpace, props.autoInsertSpace]);
   const children = (0, import_react.useMemo)(() => {
     if (autoInsertSpace && typeof props.children === "string" && props.children.length === 2 && /[\u4e00-\u9fa5]{2}/.test(props.children)) {
@@ -88,12 +106,6 @@ var InternalButton = (props, ref) => {
 };
 var Comp = (0, import_react.memo)((0, import_react.forwardRef)(InternalButton));
 var Button = Comp;
-Button.defaultProps = {
-  type: "default",
-  nativeType: "button",
-  icon: false,
-  loadingIcon: "spinner"
-};
 Button.Group = import_ButtonGroup.default;
 Button.displayName = "ElButton";
 var Button_default = Button;

package/dist/Button/typings.d.ts

@@ -2,36 +2,64 @@ import React from 'react';
 import { IconName } from '../Icon';
 import { BaseProps, NativeProps, TypeAttributes } from '../types/common';
 export interface ButtonProps extends Omit<React.AllHTMLAttributes<HTMLElement>, 'loading' | 'size' | 'icon' | 'style' | 'children'>, BaseProps, NativeProps {
+    /** 尺寸 */
     size?: TypeAttributes.Size;
+    /** 类型 */
     type?: TypeAttributes.Appearance;
+    /** 是否为朴素按钮 */
     plain?: boolean;
+    /** 是否为圆角按钮 */
     round?: boolean;
+    /** 是否为圆形按钮 */
     circle?: boolean;
+    /** 是否为文字按钮 */
     text?: boolean;
+    /** 是否显示文字按钮背景颜色	 */
     bg?: boolean;
+    /** 是否为链接按钮 */
     link?: boolean;
+    /** 是否为虚线按钮 */
     dashed?: boolean;
+    /** 是否为加载中状态 */
     loading?: boolean;
+    /** 自定义加载中图标 */
     loadingIcon?: IconName;
+    /** 自定义加载中图标 */
     loadingSlot?: React.ReactElement;
+    /** 是否为激活状态 */
     active?: boolean;
+    /** 是否为禁用状态 */
     disabled?: boolean;
+    /** 自定义图标 */
     icon?: IconName | boolean;
+    /** 自定义颜色 */
     color?: TypeAttributes.Color;
+    /** Format button to appear inside a content bloc */
     block?: boolean;
+    /** 自动在两个中文字符之间插入空格 */
     autoInsertSpace?: boolean;
+    /** Providing a `href` will render an `<a>` element, _styled_ as a button */
     href?: string;
+    /** Where to display the linked URL */
     target?: string;
+    /** Defines HTML button type attribute */
     nativeType?: 'button' | 'reset' | 'submit';
 }
 export type ButtonRef = {
+    /** 按钮 html 元素	 */
     ref: React.MutableRefObject<HTMLButtonElement>;
+    /** 按钮尺寸 */
     size: TypeAttributes.Size;
+    /** 类型 */
     type?: TypeAttributes.Appearance;
+    /** 是否为禁用状态 */
     disabled?: boolean;
+    /** 是否在两个字符之间插入空格 */
     shouldAddSpace?: boolean;
 };
 export type ButtonGroupProps = BaseProps & NativeProps & Pick<ButtonProps, 'disabled' | 'size' | 'type'> & {
+    /** 背景色 */
     bgColor?: string;
+    /** 边框颜色 */
     borderColor?: string;
 };

package/dist/Calendar/Calendar.js

@@ -273,6 +273,5 @@ var Calendar = (0, import_react.forwardRef)((props, ref) => {
     (showToday || showNow) && /* @__PURE__ */ import_react.default.createElement(import_Footer.default, null)
   );
 });
-Calendar.defaultProps = {};
-Calendar.displayName = "Calendar";
+Calendar.displayName = "ElCalendar";
 var Calendar_default = Calendar;

package/dist/Calendar/CalendarContext.d.ts

@@ -10,16 +10,26 @@ export interface CalendarContextProps {
     initialValue?: string | [v1: string, v2: string];
     value?: Dayjs;
     valueRange?: [value: Dayjs, value: Dayjs];
+    /** 显示类型 */
     dateType?: DateType | DateRangeType;
+    /** 是否展示“今天”按钮 */
     showToday?: boolean;
+    /** 是否展示“此刻”按钮 */
     showNow?: boolean;
+    /** 设置ISO周数，其中1为星期一，7为星期日 */
     isoWeek?: boolean;
+    /** 在范围选择器里取消两个日期面板之间的联动 */
     unlinkPanels?: boolean;
     popperInstRef?: RefObject<PopperOptionRef>;
+    /** 快捷方式 */
     shortcuts?: Shortcuts[];
+    /** 一个用来判断该日期是否被禁用的函数，接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。 */
     disabledDate?: (time: Date) => boolean;
+    /** 关闭下拉框方法 */
     close?: () => void;
+    /** 单选框提交数据方法 */
     onChange?: (value: Dayjs, params?: ChangeParams) => void;
+    /** 日期范围框提交数据方法 */
     onChangeRange?: (value: [value: Dayjs, value: Dayjs], finish: boolean) => void;
     formatter?: (value: Dayjs, text: number) => React.ReactElement;
 }

package/dist/Calendar/Footer.js

@@ -52,6 +52,5 @@ var Footer = () => {
   }, [close, disabledDate, onChange, showToday]);
   return /* @__PURE__ */ import_react.default.createElement("div", { className: e`footer` }, showToday && /* @__PURE__ */ import_react.default.createElement(import_Button.Button, { type: "primary", link: true, className: e`today-btn`, onClick: onPickToday }, "今 天"), showNow && /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, /* @__PURE__ */ import_react.default.createElement(import_Button.Button, { type: "primary", link: true, className: e`link-btn`, onClick: onPickToday }, "此 刻"), /* @__PURE__ */ import_react.default.createElement(import_Button.Button, { type: "default", className: e`link-btn`, onClick: close }, "确 定")));
 };
-Footer.defaultProps = {};
-Footer.displayName = "Calendar.Footer";
+Footer.displayName = "ElCalendar.Footer";
 var Footer_default = Footer;

package/dist/Calendar/Header.js

@@ -40,9 +40,9 @@ var import_hooks = require("../hooks");
 var Header = (props) => {
   const {
     prefix,
-    showBackward,
-    showForward,
-    showMonth,
+    showBackward = true,
+    showForward = true,
+    showMonth = true,
     plain,
     postion,
     year,
@@ -62,10 +62,5 @@ var Header = (props) => {
   const iconClass = (0, import_react.useMemo)(() => be("picker-panel", "icon-btn", false), [be]);
   return /* @__PURE__ */ import_react.default.createElement("div", { className: (0, import_classnames.default)(e`header`, { [em("header", "bordered")]: border }) }, showBackward && /* @__PURE__ */ import_react.default.createElement("div", { className: e`prev-btn` }, /* @__PURE__ */ import_react.default.createElement(import_Link.Link, { disabled: disabledBackwards, className: (0, import_classnames.default)(iconClass, "d-arrow-left"), onClick: onMoveBackwards }, /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: "angles-left" })), showMonth && /* @__PURE__ */ import_react.default.createElement(import_Link.Link, { disabled: disabledBackward, className: (0, import_classnames.default)(iconClass, "arrow-left"), onClick: onMoveBackward }, /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: "angle-left" }))), !plain && /* @__PURE__ */ import_react.default.createElement("span", { className: e`header-label`, onClick: () => onToggleView("year", postion) }, year), !plain && showMonth && /* @__PURE__ */ import_react.default.createElement("span", { className: e`header-label`, onClick: () => onToggleView("month", postion) }, month), showForward && /* @__PURE__ */ import_react.default.createElement("div", { className: e`next-btn` }, showMonth && /* @__PURE__ */ import_react.default.createElement(import_Link.Link, { disabled: disabledForward, className: (0, import_classnames.default)(iconClass, "arrow-right"), onClick: onMoveForward }, /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: "angle-right" })), /* @__PURE__ */ import_react.default.createElement(import_Link.Link, { disabled: disabledForwards, className: (0, import_classnames.default)(iconClass, "d-arrow-right"), onClick: onMoveForwards }, /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: "angles-right" }))), plain && /* @__PURE__ */ import_react.default.createElement("div", null, showMonth ? `${year}  ${month}` : year));
 };
-Header.defaultProps = {
-  showBackward: true,
-  showForward: true,
-  showMonth: true
-};
 Header.displayName = "Calendar.Header";
 var Header_default = Header;

package/dist/Calendar/ShortCuts.d.ts

@@ -4,7 +4,9 @@ import { ClassValue } from '../hooks/useClassNames';
 import { ChangeParams } from './CalendarContext';
 import { Shortcuts } from './typings';
 interface Props {
+    /** 快捷方式 */
     shortcuts: Shortcuts[];
+    /** 单选框提交数据方法 */
     onChange?: (value: Dayjs, params?: ChangeParams) => void;
     e: (...classes: ClassValue[]) => string;
 }

package/dist/Calendar/typings.d.ts

@@ -5,32 +5,50 @@ export type DateRangeType = 'daterange' | 'monthrange' | 'yearrange';
 export type RangePosition = 'left' | 'right';
 export type ValueRagne = [value: Dayjs, value: Dayjs];
 export type ValueRagneTemp = [value: Dayjs, value: Dayjs, value: Dayjs];
+/** 快捷方式 */
 export interface Shortcuts {
     text: string;
     value: Date | (() => Date);
 }
 export interface CalendarProps extends BaseProps, NativeProps {
+    /** 是否显示时间 */
     hasTime?: boolean;
 }
 export interface HeaderProps {
+    /**  */
     prefix?: string;
+    /** 年 */
     year?: number | string;
+    /** 月 */
     month?: number | string;
+    /** 是否禁用 */
     disabled?: boolean;
+    /**  */
+    /**  */
+    /** 是否显示月份 */
     showMonth?: boolean;
+    /** 是否显示后退按钮 */
     showBackward?: boolean;
+    /** 是否显示前进按钮 */
     showForward?: boolean;
+    /** 是否纯文本模式 */
     plain?: boolean;
+    /** 是否显示边框 */
     border?: boolean;
     postion?: RangePosition;
     disabledForward?: boolean;
     disabledBackward?: boolean;
     disabledForwards?: boolean;
     disabledBackwards?: boolean;
+    /**  */
     onToggleView?: (type: DateType, postion?: RangePosition) => void;
+    /**  */
     onMoveBackward?: () => void;
+    /**  */
     onMoveForward?: () => void;
+    /**  */
     onMoveBackwards?: () => void;
+    /**  */
     onMoveForwards?: () => void;
 }
 export type YearPanelProps = {

package/dist/Card/typings.d.ts

@@ -1,8 +1,12 @@
 import React from 'react';
 import { BaseProps, NativeProps } from '../types/common';
 export interface CardProps extends BaseProps, NativeProps<'--el-card-border-color' | '--el-card-border-radius' | '--el-card-padding' | '--el-card-bg-color'> {
+    /** 卡片的标题 你可以通过设置 header 来修改标题 */
     header?: string | React.ReactElement<any>;
+    /** 卡片页脚。 你既可以通过设置 footer 来修改卡片底部内容 */
     footer?: string | React.ReactElement<any>;
+    /** body 的 CSS 样式 */
     bodyStyle?: React.CSSProperties;
+    /** 设置阴影显示时机 */
     shadow?: 'always' | 'never' | 'hover';
 }

package/dist/Cascader/Cascader.js

@@ -58,6 +58,32 @@ var import_useCascader = require("./useCascader");
 var Cascader = (0, import_react.memo)(
   (0, import_react.forwardRef)((props, ref) => {
     var _a;
+    props = {
+      separator: "/",
+      showAllLevels: true,
+      props: {
+        expandTrigger: "click",
+        emitPath: true,
+        valueKey: "value",
+        labelKey: "label",
+        childrenKey: "children",
+        disabledKey: "disabled",
+        leafKey: "leaf"
+      },
+      treeMenuProps: {
+        valueKey: "key",
+        labelKey: "title",
+        childrenKey: "children",
+        disabledKey: "disabled",
+        leafKey: "leaf"
+      },
+      shouldSelect: () => true,
+      placeholder: "请选择",
+      collapseTags: true,
+      collapseTagsTooltip: true,
+      maxCollapseTags: 1,
+      ...props
+    };
     const {
       classPrefix = "cascader",
       options,
@@ -601,30 +627,5 @@ var Cascader = (0, import_react.memo)(
     );
   })
 );
-Cascader.defaultProps = {
-  separator: "/",
-  showAllLevels: true,
-  props: {
-    expandTrigger: "click",
-    emitPath: true,
-    valueKey: "value",
-    labelKey: "label",
-    childrenKey: "children",
-    disabledKey: "disabled",
-    leafKey: "leaf"
-  },
-  treeMenuProps: {
-    valueKey: "key",
-    labelKey: "title",
-    childrenKey: "children",
-    disabledKey: "disabled",
-    leafKey: "leaf"
-  },
-  shouldSelect: () => true,
-  placeholder: "请选择",
-  collapseTags: true,
-  collapseTagsTooltip: true,
-  maxCollapseTags: 1
-};
 Cascader.displayName = "Cascader";
 var Cascader_default = Cascader;

package/dist/Cascader/CascaderDropdown.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { OptionNode } from './typings';
 interface Props {
+    /** 用于分隔选项的字符 */
     separator: string;
     options: OptionNode[][];
     value: string[] | string[][];

package/dist/Cascader/CascaderMenu.d.ts

@@ -8,5 +8,12 @@ interface Props {
 export interface CascaderMenuRef {
     scrollToSelected: () => void;
 }
+/**
+ * @author	Parker
+ * @CreateTime	2022/4/17 14:14:01
+ * @LastEditor	Parker
+ * @ModifyTime	2025/2/22 16:22:21
+ * @Description
+ */
 declare const CascaderMenu: React.MemoExoticComponent<React.ForwardRefExoticComponent<Props & React.RefAttributes<CascaderMenuRef>>>;
 export default CascaderMenu;

package/dist/Cascader/typings.d.ts

@@ -5,75 +5,155 @@ import { DataNode, DirectoryTreeProps, Key } from '../Tree';
 import { AnimationEventProps, BaseProps, FormControlBaseProps, NativeProps } from '../types/common';
 export type ValueType = string[] | string[][];
 export interface CascaderProps<V = ValueType, S = DataNode> extends Omit<FormControlBaseProps<V>, 'onChange' | 'value' | 'defaultValue'>, BaseProps, NativeProps, AnimationEventProps, PopperOptions, Omit<DirectoryTreeProps<S>, 'children' | 'style' | 'expandedKeys' | 'className' | 'readOnly' | 'disabled'> {
+    /** 初始值 */
     defaultValue?: ValueType;
+    /** 值（可控） */
     value?: ValueType;
+    /** 可选项数据源，键名可通过 Props 属性配置 */
     options?: any[];
+    /** 配置选项 */
     props?: CascaderMenuProps;
+    /** 树形租金配置选项 */
     treeMenuProps?: TreeMenuProps;
+    /** 是否禁用 */
     disabled?: boolean;
+    /** 是否可以清空选项 */
     clearable?: boolean;
+    /** 输入框中是否显示选中值的完整路径 */
     showAllLevels?: boolean;
+    /** 用于分隔选项的字符 */
     separator?: string;
+    /** 是否可搜索 */
     filterable?: boolean;
+    /** 自定义搜索方法 */
     filterMethod?: (val: ValueType, searchText: string) => boolean;
+    /** 占位符 */
     placeholder?: string;
+    /** 选项为空时显示的文字 */
     noDataText?: string;
+    /** 搜索条件无匹配时显示的文字 */
     noMatchText?: string;
+    /** 是否正在从远程获取数据 */
     loading?: boolean;
+    /** 远程加载时显示的文字 */
     loadingText?: string;
+    /**  */
     required?: boolean;
+    /** 表单校验错误提示 */
     error?: boolean;
+    /** 表单校验警告提示 */
     warning?: boolean;
+    /** 多选时是否将选中值按文字的形式展示 */
     collapseTags?: boolean;
+    /** 需要显示的 Tag 的最大数量 只有当 collapseTags 设置为 true 时才会生效。 */
     maxCollapseTags?: number;
+    /** 当鼠标悬停于折叠标签的文本时，是否显示所有选中的标签。 要使用此属性，collapseTags属性必须设定为 true */
     collapseTagsTooltip?: boolean;
+    /** 鼠标悬停于折叠标签的文本格式化函数， 要使用此属性，collapseTags属性必须设定为 true */
     collapseTips?: (collapseNum: number, total: number) => string;
+    /** 是否纯文本模式，即无边框 */
     plain?: boolean;
+    /** 输入框头部内容，只对 type="text" 有效 */
     prefix?: React.ReactElement<any> | string | number;
+    /** 输入框尾部内容，只对 type="text" 有效 */
     suffix?: React.ReactElement<any> | string | number;
+    /** 输入框前置内容，只对 type="text" 有效 */
     prepend?: React.ReactElement<any> | string | number;
+    /** 输入框后置内容，只对 type="text" 有效 */
     append?: React.ReactElement | string | number;
     expandedKeys?: Key[][];
     lable?: string;
+    /** 是否追加到body下 */
     appendToBody?: boolean;
+    /** 选中值发生变化时触发 */
     onChange?: (value: ValueType, level?: number, label?: string | string[], node?: S[] | S[][]) => void;
+    /** 是否可以选择 */
     shouldSelect?: (node?: object, level?: number) => boolean;
     labelFormatter?: (level?: number, node?: object[]) => string;
 }
 export interface CascaderMenuProps {
+    /** 次级菜单的展开方式 */
     expandTrigger?: 'click' | 'hover';
+    /** 是否多选 */
     multiple?: boolean;
+    /** 是否严格的遵守父子节点不互相关联 */
     checkStrictly?: boolean;
+    /** 在选中节点改变时，是否返回由该节点所在的各级菜单的值所组成的数组，若设置 false，则只返回该节点的值 */
     emitPath?: boolean;
+    /** 是否动态加载子节点，需与 lazyLoad 方法结合使用 */
     lazy?: boolean;
+    /** 加载动态数据的方法，仅在 lazy 为 true 时有效 */
     lazyLoad?: (node: object, resolve?: (value: object[], isTree?: boolean) => void, reject?: () => void) => void;
+    /** 指定选项的值为选项对象的某个属性值 */
     valueKey?: string;
+    /** 指定选项标签为选项对象的某个属性值 */
     labelKey?: string;
+    /** 指定选项的子选项为选项对象的某个属性值 */
     childrenKey?: string;
+    /** 指定选项的禁用为选项对象的某个属性值 */
     disabledKey?: string;
+    /** 指定选项的叶子节点的标志位为选项对象的某个属性值 */
     leafKey?: string;
 }
 export interface TreeMenuProps {
+    /** 指定选项的值为选项对象的某个属性值 */
     valueKey?: string;
+    /** 指定选项标签为选项对象的某个属性值 */
     labelKey?: string;
+    /** 指定选项的子选项为选项对象的某个属性值 */
     childrenKey?: string;
+    /** 指定选项的禁用为选项对象的某个属性值 */
     disabledKey?: string;
+    /** 指定选项的叶子节点的标志位为选项对象的某个属性值 */
     leafKey?: string;
 }
 export interface CascaderRef {
     inputInstance?: InputRef;
     setLabel: (label: string) => void;
     onClear: () => void;
+    /** 重置懒加载的节点，适用于动态懒加载配置 */
     resetNodes: () => void;
     setVisible: (visible: boolean) => void;
 }
 export interface OptionNode extends Object {
+    /**
+     * 主键
+     * @private
+     */
     __id: string;
+    /**
+     * 父级节点ID
+     * @private
+     */
     __pId: string;
+    /**
+     * 层级
+     * @private
+     */
     __level?: number;
+    /**
+     * 是否叶子节点
+     * @private
+     */
     __leaf?: boolean;
+    /**
+     * 是否已勾选
+     * @private
+     */
     __checked?: boolean;
+    /**
+     * 是否半选
+     * @private
+     */
     __indeterminate?: boolean;
+    /**
+     * 时子节点集合
+     * @private
+     */
     children?: OptionNode[];
+    /**
+     * 树形组件时子节点集合
+     * @private
+     */
     treeChildren?: boolean;
 }