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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. package/README.md +31 -0
  2. package/dist/Badge/typings.d.ts +10 -0
  3. package/dist/Breadcrumb/typings.d.ts +4 -0
  4. package/dist/Button/typings.d.ts +28 -0
  5. package/dist/Calendar/CalendarContext.d.ts +10 -0
  6. package/dist/Calendar/ShortCuts.d.ts +2 -0
  7. package/dist/Calendar/typings.d.ts +18 -0
  8. package/dist/Card/typings.d.ts +4 -0
  9. package/dist/Cascader/CascaderDropdown.d.ts +1 -0
  10. package/dist/Cascader/CascaderMenu.d.ts +7 -0
  11. package/dist/Cascader/typings.d.ts +80 -0
  12. package/dist/Cascader/useCascader.d.ts +72 -0
  13. package/dist/Checkbox/typings.d.ts +11 -0
  14. package/dist/CheckboxGroup/CheckboxGroup.d.ts +4 -0
  15. package/dist/CheckboxGroup/CheckboxGroupContext.d.ts +1 -0
  16. package/dist/Col/typings.d.ts +10 -0
  17. package/dist/Collapse/CollapseContext.d.ts +3 -0
  18. package/dist/Collapse/typings.d.ts +7 -0
  19. package/dist/ColorPicker/AlphaSlider.d.ts +7 -0
  20. package/dist/ColorPicker/HueSlider.d.ts +7 -0
  21. package/dist/ColorPicker/Predefine.d.ts +7 -0
  22. package/dist/ColorPicker/SvPanel.d.ts +7 -0
  23. package/dist/ColorPicker/typings.d.ts +9 -0
  24. package/dist/ConfigProvider/ConfigProvider.d.ts +5 -0
  25. package/dist/DatePicker/typings.d.ts +69 -0
  26. package/dist/DateTimePicker/typings.d.ts +1 -0
  27. package/dist/Descriptions/DescriptionsContext.d.ts +2 -0
  28. package/dist/Descriptions/typings.d.ts +13 -0
  29. package/dist/Dialog/DialogContext.d.ts +8 -0
  30. package/dist/Dialog/typings.d.ts +36 -0
  31. package/dist/Divider/Divider.d.ts +4 -0
  32. package/dist/Drawer/DrawerContext.d.ts +10 -0
  33. package/dist/Drawer/typings.d.ts +16 -0
  34. package/dist/Dropdown/DropdownContext.d.ts +2 -0
  35. package/dist/Dropdown/typings.d.ts +15 -0
  36. package/dist/Form/FormItem.d.ts +12 -0
  37. package/dist/Form/typings.d.ts +55 -0
  38. package/dist/Form/useForm.d.ts +22 -0
  39. package/dist/Form/utils/NameMap.d.ts +3 -0
  40. package/dist/Form/utils/validateUtil.d.ts +4 -0
  41. package/dist/Form/utils/valueUtil.d.ts +17 -0
  42. package/dist/Icon/typings.d.ts +7 -0
  43. package/dist/Input/typings.d.ts +61 -0
  44. package/dist/InputNumber/typings.d.ts +21 -0
  45. package/dist/Link/typings.d.ts +6 -1
  46. package/dist/Loading/typings.d.ts +5 -0
  47. package/dist/Message/Main.d.ts +7 -0
  48. package/dist/Message/index.d.ts +8 -0
  49. package/dist/Message/typings.d.ts +11 -0
  50. package/dist/MessageBox/index.d.ts +14 -0
  51. package/dist/MessageBox/typings.d.ts +50 -0
  52. package/dist/Notification/Main.d.ts +7 -0
  53. package/dist/Notification/index.d.ts +15 -0
  54. package/dist/Notification/typings.d.ts +13 -0
  55. package/dist/Pagination/typings.d.ts +28 -0
  56. package/dist/Popconfirm/typings.d.ts +10 -0
  57. package/dist/Popover/typings.d.ts +12 -0
  58. package/dist/Popper/typings.d.ts +7 -1
  59. package/dist/Progress/typings.d.ts +12 -0
  60. package/dist/Radio/typings.d.ts +7 -0
  61. package/dist/RadioGroup/typings.d.ts +1 -0
  62. package/dist/Row/RowContext.d.ts +1 -0
  63. package/dist/Row/typings.d.ts +4 -0
  64. package/dist/Scrollbar/typings.d.ts +20 -0
  65. package/dist/Select/typings.d.ts +33 -0
  66. package/dist/Skeleton/PlaceholderGraph.d.ts +4 -0
  67. package/dist/Skeleton/PlaceholderGrid.d.ts +4 -0
  68. package/dist/Skeleton/PlaceholderParagraph.d.ts +4 -0
  69. package/dist/Switch/typings.d.ts +15 -0
  70. package/dist/Table/Colgroup.d.ts +1 -0
  71. package/dist/Table/TableContext.d.ts +8 -0
  72. package/dist/Table/hooks/useSelection.d.ts +17 -0
  73. package/dist/Table/hooks/useTable.d.ts +7 -0
  74. package/dist/Table/treeUtil.d.ts +39 -0
  75. package/dist/Table/typings.d.ts +137 -1
  76. package/dist/Table/util.d.ts +10 -0
  77. package/dist/Tabs/typings.d.ts +38 -0
  78. package/dist/Tag/Tag.d.ts +1 -1
  79. package/dist/Tag/Tag.js +18 -26
  80. package/dist/Tag/typings.d.ts +10 -0
  81. package/dist/TimeLine/typings.d.ts +9 -0
  82. package/dist/TimePicker/typings.d.ts +13 -0
  83. package/dist/TimePicker/useTimePicker.d.ts +7 -0
  84. package/dist/Tooltip/Tooltip.js +8 -19
  85. package/dist/Tooltip/TooltipContext.d.ts +1 -0
  86. package/dist/Tooltip/typings.d.ts +14 -1
  87. package/dist/Transfer/ListItem.d.ts +1 -0
  88. package/dist/Transfer/typings/index.d.ts +27 -0
  89. package/dist/Transfer/typings/list.d.ts +25 -0
  90. package/dist/Transfer/typings/listBody.d.ts +1 -0
  91. package/dist/Transition/Transition.d.ts +10 -0
  92. package/dist/Transition/TransitionGroup.d.ts +59 -0
  93. package/dist/Transition/childMapping.d.ts +23 -0
  94. package/dist/Tree/NodeList.d.ts +3 -0
  95. package/dist/Tree/RCTree.d.ts +15 -0
  96. package/dist/Tree/Tree.d.ts +15 -0
  97. package/dist/Tree/TreeNode.d.ts +7 -0
  98. package/dist/Tree/contextTypes.d.ts +4 -0
  99. package/dist/Tree/typings.d.ts +3 -0
  100. package/dist/Tree/util.d.ts +17 -0
  101. package/dist/Tree/utils/KeyCode.d.ts +326 -0
  102. package/dist/Tree/utils/conductUtil.d.ts +6 -0
  103. package/dist/Tree/utils/dictUtil.d.ts +1 -0
  104. package/dist/Tree/utils/pickAttrs.d.ts +5 -0
  105. package/dist/Tree/utils/treeUtil.d.ts +25 -1
  106. package/dist/TreeSelect/Utils.d.ts +1 -0
  107. package/dist/TreeSelect/typings.d.ts +19 -0
  108. package/dist/Upload/typings.d.ts +34 -0
  109. package/dist/Upload/use-handlers.d.ts +1 -0
  110. package/dist/Util/Math.d.ts +34 -0
  111. package/dist/Util/base.d.ts +21 -0
  112. package/dist/Util/shallowEqual.d.ts +11 -0
  113. package/dist/Util/treeUtils.d.ts +8 -0
  114. package/dist/VirtualList/Filler.d.ts +5 -0
  115. package/dist/VirtualList/VirtualList.d.ts +3 -0
  116. package/dist/VirtualList/hooks/useLayoutEffect.d.ts +3 -0
  117. package/dist/VirtualList/utils/algorithmUtil.d.ts +17 -0
  118. package/dist/VirtualList/utils/findDOMNode.d.ts +3 -0
  119. package/dist/hooks/animationPropsUtils.d.ts +12 -0
  120. package/dist/hooks/htmlPropsUtils.d.ts +8 -0
  121. package/dist/hooks/popperPropsUtils.d.ts +12 -0
  122. package/dist/hooks/treePropsUtils.d.ts +12 -0
  123. package/dist/hooks/useChildrenInstance.d.ts +11 -0
  124. package/dist/hooks/useClassNames.d.ts +78 -0
  125. package/dist/hooks/useControlled.d.ts +8 -0
  126. package/dist/hooks/useForceUpdate.d.ts +1 -0
  127. package/dist/index.d.ts +1 -0
  128. package/dist/theme-chalk/link/index.scss +0 -85
  129. package/dist/types/common.d.ts +24 -0
  130. package/dist/types/type.d.ts +5 -0
  131. package/package.json +1 -1
@@ -3,37 +3,70 @@ import { DialogFooterProps, DialogProps } from '../Dialog/typings';
3
3
  import { IconName, IconProps } from '../Icon';
4
4
  import { AnimationEventProps, BaseProps, NativeProps, TypeAttributes } from '../types/common';
5
5
  export interface MessageBoxProps extends BaseProps, NativeProps, AnimationEventProps {
6
+ /** 标题 */
6
7
  title?: string | React.ReactElement;
8
+ /** 消息正文内容 */
7
9
  message?: string | React.ReactElement;
10
+ /** 是否将 message 属性作为 HTML 片段处理 */
11
+ /** 消息类型,用于显示图标 */
8
12
  type?: 'success' | 'info' | 'warning' | 'error';
13
+ /** 消息自定义图标,该属性会覆盖 type 的图标 */
9
14
  icon?: IconName | React.ReactElement<IconProps>;
15
+ /** 遮罩的自定义类名 */
10
16
  modalClass?: string;
17
+ /** 自定义确认按钮及取消按钮的大小 */
11
18
  width?: DialogProps['width'];
19
+ /** 若不使用 Promise,可以使用此参数指定 MessageBox 关闭后的回调函数, instance 为 MessageBox 实例, 可以通过它访问实例上的属性和方法 */
12
20
  callback?: (value: string, action: Action) => any | ((action: Action) => any);
21
+ /** 是否显示右上角关闭按钮 */
13
22
  showClose?: boolean;
23
+ /** 是否可以通过点击 modal 关闭 MessageBox */
14
24
  closeOnClickModal?: boolean;
25
+ /** 关闭前的回调,会暂停消息弹出框的关闭过程;instance为 MessageBox 实例,可以通过它访问实例上的属性和方法;done用于关闭 MessageBox 实例 */
15
26
  beforeClose?: (action?: Action, done?: () => void, ref?: RefObject<MessageBoxRef>) => void;
27
+ /** 是否显示取消按钮(以 confirm 和 prompt 方式调用时为 true) */
16
28
  showCancelButton?: boolean;
29
+ /** 是否显示确定按钮 */
17
30
  showConfirmButton?: boolean;
31
+ /** 取消按钮的文本内容 */
18
32
  cancelButtonText?: string;
33
+ /** 确定按钮的文本内容 */
19
34
  confirmButtonText?: string;
35
+ /** 取消按钮的自定义类名 */
20
36
  cancelButtonClass?: string;
37
+ /** 确定按钮的自定义类名 */
21
38
  confirmButtonClass?: string;
39
+ /** 自定义确认和取消按钮的尺寸 */
22
40
  buttonSize?: TypeAttributes.Size;
41
+ /** 按钮位置 */
23
42
  buttonPosition?: DialogFooterProps['position'];
43
+ /** 是否将取消(点击取消按钮)与关闭(点击关闭按钮或遮罩层、按下 Esc 键)进行区分 */
24
44
  distinguishCancelAndClose?: boolean;
45
+ /** 内容区域padding */
25
46
  padding?: string | number;
47
+ /** 是否在 MessageBox 出现时将 body 滚动锁定 */
26
48
  lockScroll?: boolean;
49
+ /** 是否显示输入框 */
27
50
  showInput?: boolean;
51
+ /** 输入框占位文本 */
28
52
  inputPlaceholder?: string;
53
+ /** 输入框的类型 */
29
54
  inputType?: string;
55
+ /** 输入框的初始文本 */
30
56
  inputValue?: string;
57
+ /** 输入框的校验表达式 */
31
58
  inputPattern?: RegExp;
59
+ /** 输入框的校验函数。 应该返回一个 boolean 或者 string, 如果返回的是一个 string 类型,那么该返回值会被赋值给 inputErrorMessage 用于向用户展示错误消息。 */
32
60
  inputValidator?: (value: string) => boolean | string;
61
+ /** 校验未通过时的提示文本 */
33
62
  inputErrorMessage?: string;
63
+ /** 是否居中布局 */
34
64
  center?: boolean;
65
+ /** 为 MessageBox 启用可拖拽功能 */
35
66
  draggable?: boolean;
67
+ /** 拖动范围可以超出可视区 */
36
68
  overflow?: boolean;
69
+ /** 是否使用圆角按钮 */
37
70
  roundButton?: boolean;
38
71
  }
39
72
  export type MessageState = {
@@ -51,13 +84,30 @@ export interface MessageBoxInputData {
51
84
  export type ElMessageBoxShortcutMethod = (((message: MessageBoxProps['message'], title: MessageBoxProps['title'], options?: Omit<MessageBoxProps, 'message' | 'title'>) => Promise<MessageBoxData>) & ((message: MessageBoxProps['message'], options?: Omit<MessageBoxProps, 'message' | 'title'>) => Promise<MessageBoxData>));
52
85
  export interface MessageBoxMethod {
53
86
  (options?: MessageBoxProps): Promise<MessageBoxData>;
87
+ /**
88
+ * 消息弹窗提示
89
+ * @param message 消息内容
90
+ * @param title 标题
91
+ * @param options 其他设置项
92
+ * @returns
93
+ */
54
94
  alert: ElMessageBoxShortcutMethod;
95
+ /**
96
+ * 确认消息
97
+ * @param message 消息内容
98
+ * @param title 标题
99
+ * @param options 其他设置项
100
+ * @returns
101
+ */
55
102
  confirm: ElMessageBoxShortcutMethod;
56
103
  prompt: ElMessageBoxShortcutMethod;
57
104
  }
58
105
  export interface MessageBoxRef {
59
106
  ref: RefObject<HTMLDivElement>;
107
+ /** 关闭方法 */
60
108
  close: () => void;
109
+ /** 设置确认按钮是否加载状态 */
61
110
  setConfirmButtonLoading: (value: boolean) => void;
111
+ /** 修改确认按钮文本方法 */
62
112
  setConfirmButtonText: (value: string) => void;
63
113
  }
@@ -1,5 +1,12 @@
1
1
  import { RefObject } from 'react';
2
2
  import { NotificationProps, NotificationRef } from './typings';
3
+ /**
4
+ * @author Parker
5
+ * @CreateTime 2022/3/10 12:45:48
6
+ * @LastEditor Parker
7
+ * @ModifyTime 2022/5/3 12:24:58
8
+ * @Description
9
+ */
3
10
  export declare class Main {
4
11
  ref: RefObject<NotificationRef>;
5
12
  constructor(props: NotificationProps);
@@ -1,5 +1,20 @@
1
1
  import type { INotification, NotificationRef, Position } from './typings';
2
+ /**
3
+ * 通知组件
4
+ * @author Parker
5
+ * @CreateTime 2022/3/10 12:45:48
6
+ * @LastEditor Parker
7
+ * @ModifyTime 2022/5/3 13:43:28
8
+ * @Description Element Plus 通知组件魔改过来的,源代码见:https://github.com/element-plus/element-plus
9
+ */
2
10
  export declare const Notification: INotification;
11
+ /**
12
+ *
13
+ * @param id
14
+ * @param position
15
+ * @param userOnClose
16
+ * @returns
17
+ */
3
18
  export declare function close(id: string, position: Position, userOnClose?: (vm: NotificationRef) => void): void;
4
19
  export declare function closeAll(): void;
5
20
  export type { INotification, INotificationHandle, NotificationProps as INotificationOptions } from './typings';
@@ -18,18 +18,31 @@ export interface INotification {
18
18
  closeAll: () => void;
19
19
  }
20
20
  export interface NotificationProps extends BaseProps, NativeProps, AnimationEventProps {
21
+ /** 标题 */
21
22
  title?: string;
23
+ /** 通知栏正文内容 */
22
24
  message?: string | React.ReactElement;
25
+ /** 是否将 message 属性作为 HTML 片段处理 */
23
26
  dangerouslyUseHTMLString?: boolean;
27
+ /** 通知的类型 */
24
28
  type?: 'success' | 'warning' | 'info' | 'error' | '';
29
+ /** 显示时间, 单位为毫秒。 值为 0 则不会自动关闭 */
25
30
  duration?: number;
31
+ /** 自定义弹出位置 */
26
32
  position?: Position;
33
+ /** 是否显示关闭按钮 */
27
34
  showClose?: boolean;
35
+ /** 关闭时的回调函数 */
28
36
  onClose?: () => void;
37
+ /** */
29
38
  iconClass?: string;
39
+ /** */
30
40
  id?: string;
41
+ /** 点击 Notification 时的回调函数 */
31
42
  onClick?: () => void;
43
+ /** 相对屏幕顶部的偏移量 偏移的距离,在同一时刻,所有的 Notification 实例应当具有一个相同的偏移量 */
32
44
  offset?: number;
45
+ /** */
33
46
  onSuccess?: (ref: HTMLDivElement) => void;
34
47
  }
35
48
  export interface NotificationRef {
@@ -1,41 +1,69 @@
1
1
  import React from 'react';
2
2
  import { BaseProps, NativeProps } from '../types/common';
3
3
  export interface PaginationRef {
4
+ /** 当前页数 */
4
5
  pageNum: number;
6
+ /** 每页条数 */
5
7
  pageSize: number;
8
+ /** 设置当前页数 */
6
9
  setPageNum: (value: number) => void;
10
+ /** 设置每页条数 */
7
11
  setPageSize: (value: number) => void;
8
12
  }
9
13
  export interface PaginationProps extends BaseProps, NativeProps {
14
+ /** 当前页数 */
10
15
  current?: number;
16
+ /** 默认的当前页数 */
11
17
  defaultCurrent?: number;
18
+ /** 禁用分页 */
12
19
  disabled?: boolean;
20
+ /** 数据总数 */
13
21
  total: number;
22
+ /** 默认的每页条数 */
14
23
  defaultPageSize?: number;
24
+ /** 每页条数 */
15
25
  pageSize?: number;
26
+ /** 指定每页可以显示多少条 */
16
27
  pageSizeOptions?: Array<string>;
28
+ /** 只有一页时是否隐藏分页器 */
17
29
  hideOnSinglePage?: boolean;
30
+ /** */
18
31
  showPrevNextJumpers?: boolean;
32
+ /** 是否可以快速跳转至某页 */
19
33
  showQuickJumper?: boolean | {
20
34
  goButton: React.ReactElement;
21
35
  };
36
+ /** 用于显示数据总量和当前数据顺序 */
22
37
  showTotal?: (total: number, [from, to]: [number, number]) => React.ReactElement | boolean | string;
38
+ /** 是否显示较少页面内容 */
23
39
  showLessItems?: boolean;
40
+ /** 是否显示原生 tooltip 页码提示 */
24
41
  showTitle?: boolean;
42
+ /** 是否展示 pageSize 切换器,当 total 大于 50 时默认为 true */
25
43
  showSizeChanger?: boolean;
44
+ /** pageSize 变化的回调 */
26
45
  onShowSizeChange?: (current?: number, size?: number) => void;
46
+ /** 用于自定义页码的结构,可用于优化 SEO */
27
47
  itemRender?: (page: number, type: PageType, element: React.ReactElement) => React.ReactElement<{
28
48
  disabled?: boolean;
29
49
  }>;
50
+ /** 页码或 pageSize 改变的回调,参数是改变后的页码及每页条数 */
30
51
  onChange?: (current: number, pageSize: number) => void;
52
+ /** 当添加该属性时,显示为简单分页 */
31
53
  simple?: boolean;
54
+ /** 当为 small 时,是小尺寸分页 */
32
55
  size?: 'small';
33
56
  }
34
57
  export type PageType = 'page' | 'prev' | 'next' | 'jump-prev' | 'jump-next';
35
58
  export interface PagerProps extends BaseProps, NativeProps {
59
+ /** 页数 */
36
60
  page: number;
61
+ /** 是否显示原生 tooltip 页码提示 */
37
62
  showTitle?: boolean;
63
+ /** 是否激活状态 */
38
64
  active?: boolean;
65
+ /** 点击事件 */
39
66
  onClick?: (page: number) => void;
67
+ /** 用于自定义页码的结构,可用于优化 SEO */
40
68
  itemRender?: (current: number, type: PageType, element: React.ReactElement) => React.ReactElement;
41
69
  }
@@ -3,14 +3,24 @@ import { PopperOptions } from '../Popper';
3
3
  import { BaseProps, NativeProps, TypeAttributes } from '../types/common';
4
4
  export interface PopconfirmProps extends BaseProps, NativeProps, PopperOptions {
5
5
  classPrefix?: string;
6
+ /** 显示的内容 */
6
7
  title: string;
8
+ /** 确认按钮文字 */
7
9
  confirmButtonText?: string;
10
+ /** 取消按钮文字 */
8
11
  cancelButtonText?: string;
12
+ /** 确认按钮类型 */
9
13
  confirmButtonType?: TypeAttributes.Appearance;
14
+ /** 取消按钮类型 */
10
15
  cancelButtonType?: TypeAttributes.Appearance;
16
+ /** 自定义图标 */
11
17
  icon?: IconName;
18
+ /** Icon 颜色 */
12
19
  iconColor?: string;
20
+ /** 是否隐藏 Icon */
13
21
  hideIcon?: boolean;
22
+ /** 点击确认按钮时触发 */
14
23
  onConfirm?: () => void;
24
+ /** 点击取消按钮时触发 */
15
25
  onCancel?: () => void;
16
26
  }
@@ -2,17 +2,29 @@ import React from 'react';
2
2
  import { PopperOptions } from '../Popper';
3
3
  import { TransitionProps } from '../Transition';
4
4
  import { AnimationEventProps, BaseProps, NativeProps } from '../types/common';
5
+ /** Dropdown 属性 */
5
6
  export interface PopoverProps extends BaseProps, NativeProps, PopperOptions, AnimationEventProps, TransitionProps {
7
+ /** 触发下拉的行为 */
6
8
  trigger?: 'hover' | 'click' | 'contextmenu';
9
+ /** 标题 */
7
10
  title?: string;
11
+ /** 显示的内容 */
8
12
  content?: string | React.ReactElement;
13
+ /** 默认提供的主题 */
9
14
  theme?: 'light' | 'dark' | string;
15
+ /** 宽度 */
10
16
  width?: number | string;
17
+ /** Popover 是否可用 */
11
18
  disabled?: boolean;
19
+ /** 展开下拉菜单的延时,仅在 trigger 为 hover 时有效 */
12
20
  showTimeout?: number;
21
+ /** 收起下拉菜单的延时(仅在 trigger 为 hover 时有效) */
13
22
  hideTimeout?: number;
23
+ /** 状态是否可见 */
14
24
  visible?: boolean;
25
+ /** 初始值 */
15
26
  defaultVisible?: boolean;
27
+ /** 是否纯文本 */
16
28
  plain?: boolean;
17
29
  onMouseEnter?: (e?: React.MouseEvent<any>) => void;
18
30
  onMouseLeave?: (e?: React.MouseEvent<any>) => void;
@@ -17,13 +17,19 @@ export interface PopperOptionRef {
17
17
  }
18
18
  export type PopperOptions = {
19
19
  popperInstRef?: React.MutableRefObject<PopperOptionRef>;
20
+ /** 出现位置的偏移量 */
20
21
  offset?: number;
22
+ /** 出现的位置 */
21
23
  placement?: Placement;
24
+ /** 是否显示箭头 */
22
25
  arrowOffset?: number;
26
+ /** 箭头距离边缘的位置 */
23
27
  showArrow?: boolean;
28
+ /** 为 popper 添加自定义类名 */
24
29
  popperClass?: string;
30
+ /** 为 popper 添加自定义内联样式 */
25
31
  popperStyle?: React.CSSProperties;
26
- effect?: 'light' | 'dark';
32
+ effect?: 'light' | 'dark' | string;
27
33
  popperOptions?: Options;
28
34
  };
29
35
  export type PopperProps = {
@@ -1,18 +1,30 @@
1
1
  import { BaseProps, NativeProps } from '../types/common';
2
2
  export interface PropgressProps extends BaseProps, NativeProps {
3
+ /** 百分比,必填 */
3
4
  percentage: number;
5
+ /** 进度条类型 */
4
6
  type?: 'line' | 'circle' | 'dashboard';
7
+ /** 进度条的宽度 */
5
8
  strokeWidth?: number;
9
+ /** 进度条显示文字内置在进度条内(仅 type 为 'line' 时可用) */
6
10
  textInside?: boolean;
11
+ /** 进度条当前状态 */
7
12
  status?: 'success' | 'exception' | 'warning';
13
+ /** 是否为动画进度条 */
8
14
  indeterminate?: boolean;
15
+ /** 控制动画进度条速度 */
9
16
  duration?: number;
17
+ /** 进度条背景色 进度条背景色 (会覆盖 status 状态颜色) */
10
18
  color?: string | ((percentage: number) => string) | {
11
19
  color: string;
12
20
  percentage: number;
13
21
  }[];
22
+ /** 环形进度条画布宽度(只在 type 为 circle 或 dashboard 时可用) */
14
23
  width?: number;
24
+ /** 是否显示进度条文字内容 */
15
25
  showText?: boolean;
26
+ /** circle/dashboard 类型路径两端的形状 */
16
27
  strokeLinecap?: 'butt' | 'round' | 'square';
28
+ /** 指定进度条文字内容 */
17
29
  format?: (percentage: number) => string;
18
30
  }
@@ -7,11 +7,18 @@ export type RadioRef = {
7
7
  setChecked: (value: boolean) => void;
8
8
  };
9
9
  export interface RadioProps<T = ValueType> extends Omit<React.AllHTMLAttributes<HTMLInputElement>, 'size' | 'prefix' | 'type' | 'value' | 'defaultValue' | 'onChange' | 'style' | 'children'>, Omit<FormControlBaseProps<T>, 'onChange'>, BaseProps, NativeProps {
10
+ /** tooltip 提示*/
10
11
  title?: string;
12
+ /** 是否只读 */
11
13
  readOnly?: boolean;
14
+ /** Render the control as plain text */
12
15
  plaintext?: boolean;
16
+ /** 是否选中 */
13
17
  checked?: boolean;
18
+ /** 默认是否选中 */
14
19
  defaultChecked?: boolean;
20
+ /** 原生 name 属性 */
15
21
  name?: string;
22
+ /** 当绑定值变化时触发的事件 */
16
23
  onChange?: (checked: boolean, value: T, event: React.ChangeEvent<HTMLInputElement>) => void;
17
24
  }
@@ -6,6 +6,7 @@ export interface RadioContextProps {
6
6
  value?: ValueType;
7
7
  controlled?: boolean;
8
8
  disabled?: boolean;
9
+ /** 尺寸 */
9
10
  size?: TypeAttributes.Size;
10
11
  readOnly?: boolean;
11
12
  plaintext?: boolean;
@@ -1,5 +1,6 @@
1
1
  /// <reference types="react" />
2
2
  export interface RowContext {
3
+ /** 栅格间隔 */
3
4
  gutter?: number;
4
5
  }
5
6
  export declare const RowContext: import("react").Context<RowContext>;
@@ -1,7 +1,11 @@
1
1
  import { BaseProps, NativeProps } from '../types/common';
2
2
  export interface RowProps extends BaseProps, NativeProps {
3
+ /** 栅格间隔 */
3
4
  gutter?: number;
5
+ /** 布局下的水平排列方式 */
4
6
  justify?: 'start' | 'end' | 'center' | 'space-around' | 'space-between' | 'space-evenly';
7
+ /** flex 布局下的垂直排列方式 */
5
8
  align?: 'top' | 'middle' | 'bottom';
9
+ /** 自定义元素标签 */
6
10
  tag?: string;
7
11
  }
@@ -2,27 +2,47 @@ import React, { RefObject } from 'react';
2
2
  import { BaseProps, NativeProps } from '../types/common';
3
3
  export interface ScrollbarRef {
4
4
  ref: RefObject<HTMLDivElement>;
5
+ /** 滚动到一组特定坐标 */
5
6
  scrollTo: (options: number, yCoord?: number) => void;
7
+ /** 设置滚动条到顶部的距离 */
6
8
  setScrollTop: (value: number) => void;
9
+ /** 设置滚动条到左边的距离 */
7
10
  setScrollLeft: (value: number) => void;
11
+ /** 手动更新滚动条状态 */
8
12
  update: () => void;
13
+ /** 滚动条包裹的 ref 对象 */
9
14
  wrapRef: RefObject<HTMLDivElement>;
15
+ /** 视图ref对象 */
10
16
  resizeRef: RefObject<any>;
11
17
  }
12
18
  export interface ScrollbarProps extends BaseProps, NativeProps<'--el-scrollbar-opacity' | '--el-scrollbar-bg-color' | '--el-scrollbar-hover-opacity' | '--el-scrollbar-hover-bg-color' | '--el-scrollbar-width'> {
19
+ /** 滚动条高度 */
13
20
  height?: number | string;
21
+ /** 滚动条最大高度 */
14
22
  maxHeight?: number | string;
23
+ /** 是否使用原生滚动条样式 */
15
24
  native?: boolean;
25
+ /** 包裹容器的自定义样式 */
16
26
  wrapStyle?: React.CSSProperties;
27
+ /** 包裹容器的自定义类名 */
17
28
  wrapClass?: string;
29
+ /** 视图的自定义样式 */
18
30
  viewStyle?: React.CSSProperties;
31
+ /** 视图的自定义类名 */
19
32
  viewClass?: string;
33
+ /** 不响应容器尺寸变化,如果容器尺寸不会发生变化,最好设置它可以优化性能 */
20
34
  noresize?: boolean;
35
+ /** 视图的元素标签 */
21
36
  tag?: string;
37
+ /** 滚动条总是显示 */
22
38
  always?: boolean;
39
+ /** 滚动条最小尺寸 */
23
40
  minSize?: number;
41
+ /** 是否显示横向滚动条 */
24
42
  showHorizontal?: boolean;
43
+ /** 是否显示纵向滚动条 */
25
44
  showVertical?: boolean;
45
+ /** 滚动时触发的事件 */
26
46
  onScroll?: (data: {
27
47
  e: React.UIEvent<HTMLDivElement, UIEvent>;
28
48
  scrollTop: number;
@@ -16,43 +16,76 @@ export type SelectRef = {
16
16
  };
17
17
  type Child = React.ReactElement<SelectOptionGroupProps | SelectOptionProps> | React.ReactElement<SelectOptionGroupProps | SelectOptionProps>[];
18
18
  export interface SelectProps<V = ValueType> extends Omit<FormControlBaseProps<V>, 'onChange'>, BaseProps<Child | Child[]>, NativeProps, AnimationEventProps, PopperOptions {
19
+ /** 是否多选 */
19
20
  multiple?: boolean;
21
+ /** 是否禁用 */
20
22
  disabled?: boolean;
23
+ /** 作为 value 唯一标识的键名,绑定值为对象类型时必填 */
21
24
  valueKey?: string;
25
+ /** 是否可以清空选项 */
22
26
  clearable?: boolean;
27
+ /** 占位符 */
23
28
  placeholder?: string;
29
+ /** 是否可搜索 */
24
30
  filterable?: boolean;
31
+ /** 自定义搜索方法 */
25
32
  filterMethod?: (val: ValueType, searchText: string) => boolean;
33
+ /** 选项为空时显示的文字 */
26
34
  noDataText?: React.ReactElement | string;
35
+ /** 搜索条件无匹配时显示的文字 */
27
36
  noMatchText?: React.ReactElement | string;
37
+ /** 是否正在从远程获取数据 */
28
38
  loading?: boolean;
39
+ /** 远程加载时显示的文字 */
29
40
  loadingText?: React.ReactElement | string;
41
+ /** */
30
42
  max?: boolean;
43
+ /** */
31
44
  required?: boolean;
45
+ /** 表单校验错误提示 */
32
46
  error?: boolean;
47
+ /** 表单校验警告提示 */
33
48
  warning?: boolean;
49
+ /** 下拉项最大宽度 */
34
50
  maxWidth?: number;
51
+ /** 多选时是否将选中值按文字的形式展示 */
35
52
  collapseTags?: boolean;
53
+ /** 需要显示的 Tag 的最大数量 只有当 collapseTags 设置为 true 时才会生效。 */
36
54
  maxCollapseTags?: number;
55
+ /** 当鼠标悬停于折叠标签的文本时,是否显示所有选中的标签。 要使用此属性,collapseTags属性必须设定为 true */
37
56
  collapseTagsTooltip?: boolean;
57
+ /** 鼠标悬停于折叠标签的文本格式化函数, 要使用此属性,collapseTags属性必须设定为 true*/
38
58
  collapseTips?: (collapseNum: number, total: number) => string;
59
+ /** 是否允许用户创建新条目 */
39
60
  allowCreate?: boolean;
61
+ /** 是否纯文本模式,即无边框 */
40
62
  plain?: boolean;
63
+ /** 输入框前置内容,只对 type="text" 有效 */
41
64
  prepend?: React.ReactElement<any> | string | number;
65
+ /** 输入框后置内容,只对 type="text" 有效 */
42
66
  append?: React.ReactElement | string | number;
67
+ /** 尺寸 */
43
68
  size?: TypeAttributes.Size;
69
+ /** 是否追加到body下 */
44
70
  appendToBody?: boolean;
71
+ /** 选中值发生变化时触发 */
45
72
  onChange?: (value: ValueType, label?: string | (string | number)[]) => void;
73
+ /** 数据加载成功时调用 */
46
74
  onLoadSuccess?: (value: ValueType, label?: (string | number | undefined)[]) => void;
47
75
  }
48
76
  export interface SelectOptionProps extends BaseProps, NativeProps {
77
+ /** 选项的值 */
49
78
  value: string | number;
79
+ /** 选项的标签,若不设置则默认与 value 相同 */
50
80
  label?: string;
81
+ /** 是否禁用该选项 */
51
82
  disabled?: boolean;
52
83
  onClick?: (value: ValueType, label: string, e: Event) => void;
53
84
  }
54
85
  export interface SelectOptionGroupProps extends BaseProps<React.ReactElement<SelectOptionProps> | React.ReactElement<SelectOptionProps>[]>, NativeProps {
86
+ /** 分组的组名 */
55
87
  label: string;
88
+ /** 是否将该分组下所有选项置为禁用 */
56
89
  disabled?: boolean;
57
90
  }
58
91
  export interface SelectDropdownProps extends SelectProps {
@@ -2,9 +2,13 @@ import React from 'react';
2
2
  export interface SkeletonGraphProps {
3
3
  height?: number;
4
4
  width?: number;
5
+ /** Placeholder status */
5
6
  active?: boolean;
7
+ /** The prefix of the component CSS class */
6
8
  classPrefix?: string;
9
+ /** Additional classes */
7
10
  className?: string;
11
+ /** Additional style */
8
12
  style?: React.CSSProperties;
9
13
  }
10
14
  declare const SkeletonGraph: React.ForwardRefExoticComponent<SkeletonGraphProps & React.RefAttributes<HTMLDivElement>>;
@@ -4,9 +4,13 @@ export interface PlaceholderGridProps {
4
4
  rowHeight?: number;
5
5
  rowMargin?: number;
6
6
  columns?: number;
7
+ /** Placeholder status */
7
8
  active?: boolean;
9
+ /** The prefix of the component CSS class */
8
10
  classPrefix?: string;
11
+ /** Additional classes */
9
12
  className?: string;
13
+ /** Additional style */
10
14
  style?: React.CSSProperties;
11
15
  }
12
16
  declare const PlaceholderGrid: React.ForwardRefExoticComponent<PlaceholderGridProps & React.RefAttributes<HTMLDivElement>>;
@@ -4,9 +4,13 @@ export interface PlaceholderParagraphProps {
4
4
  rowHeight?: number;
5
5
  rowMargin?: number;
6
6
  graph?: boolean | 'circle' | 'square' | 'image';
7
+ /** Placeholder status */
7
8
  active?: boolean;
9
+ /** The prefix of the component CSS class */
8
10
  classPrefix?: string;
11
+ /** Additional classes */
9
12
  className?: string;
13
+ /** Additional style */
10
14
  style?: React.CSSProperties;
11
15
  }
12
16
  declare const PlaceholderParagraph: React.ForwardRefExoticComponent<PlaceholderParagraphProps & React.RefAttributes<HTMLDivElement>>;
@@ -7,19 +7,34 @@ export type ChangeValue = {
7
7
  value: ValueType;
8
8
  };
9
9
  export interface SwitchProps<V = ValueType> extends Omit<FormControlBaseProps<V>, 'onChange'>, BaseProps, NativeProps<'--el-switch-on-color' | '--el-switch-off-color'>, TooltipBaseProps<HTMLDivElement> {
10
+ /** switch 的宽度 */
10
11
  width?: number;
12
+ /** switch 打开时的文字描述 */
11
13
  activeText?: string;
14
+ /** switch 的状态为 off 时的文字描述 */
12
15
  inactiveText?: string;
16
+ /** switch 打开时的文字描述 */
13
17
  activeIcon?: IconName | React.ReactElement<any>;
18
+ /** switch 的状态为 off 时的文字描述 */
14
19
  inactiveIcon?: IconName | React.ReactElement<any>;
20
+ /** 当在 on 状态时的背景颜色 */
15
21
  activeColor?: string;
22
+ /** off 状态时的背景颜色 */
16
23
  inactiveColor?: string;
24
+ /** 开关的边框颜色 */
17
25
  borderColor?: string;
26
+ /** switch 状态为 on 时的值 */
18
27
  activeValue?: V;
28
+ /** switch的状态为 off 时的值 */
19
29
  inactiveValue?: V;
30
+ /** */
20
31
  validateEvent?: boolean;
32
+ /** 是否显示加载中 */
21
33
  loading?: boolean;
34
+ /** 无论图标或文本是否显示在点内,只会呈现文本的第一个字符 */
22
35
  inlinePrompt?: boolean;
36
+ /** switch 状态改变前的钩子, 返回 false 或者返回 Promise 且被 reject 则停止切换 */
23
37
  beforeChange?: () => Promise<boolean> | boolean;
38
+ /** switch 状态发生变化时的回调函数 */
24
39
  onChange?: (value?: ValueType, checked?: boolean, e?: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
25
40
  }
@@ -2,6 +2,7 @@ import { FC } from 'react';
2
2
  import { TableColumnCtx } from './typings';
3
3
  interface Props<T> {
4
4
  columns: TableColumnCtx<T>[];
5
+ /** 设置表格单元、行和列的布局方式 */
5
6
  tableLayout?: 'fixed' | 'auto';
6
7
  }
7
8
  declare const Colgroup: FC<Props<any>>;
@@ -3,9 +3,13 @@ import { Action, State } from './hooks/useSelection';
3
3
  import { TableColumnCtx, TableProps, TableRefs, TreeNode } from './typings';
4
4
  export interface TableContextProps<T> {
5
5
  tableId: string;
6
+ /** 多级列 */
6
7
  columns: TableColumnCtx<T>[][];
8
+ /** 最后一级列 */
7
9
  flattenColumns: TableColumnCtx<T>[];
10
+ /** 左固定列 */
8
11
  fixedLeftColumns: TableColumnCtx<T>[];
12
+ /** 右固定列 */
9
13
  fixedRightColumns: TableColumnCtx<T>[];
10
14
  tableRefs: TableRefs;
11
15
  props: Omit<TableProps<T>, 'children'>;
@@ -21,8 +25,11 @@ export interface TableBodyContextProps<T> {
21
25
  oldActiveRow: MutableRefObject<T | null | undefined>;
22
26
  state: State<T>;
23
27
  dispatch: (action: Action) => void;
28
+ /** 原始表格数据 */
24
29
  initialData: MutableRefObject<T[]>;
30
+ /** 排序后表格数据 */
25
31
  sortedData: MutableRefObject<T[]>;
32
+ /** 禁止选中行 */
26
33
  disabledRows: MutableRefObject<T[]>;
27
34
  isTreeTable: () => boolean;
28
35
  isTreeExpandCell: (id: string) => boolean;
@@ -30,6 +37,7 @@ export interface TableBodyContextProps<T> {
30
37
  hasChildren: string;
31
38
  children: string;
32
39
  };
40
+ /** 树节点信息 */
33
41
  treeNodes: MutableRefObject<TreeNode[]>;
34
42
  }
35
43
  export declare const TableContext: import("react").Context<TableContextProps<any>>;