@qsxy/element-plus-react 1.0.0-next.1 → 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 (213) hide show
  1. package/README.md +31 -0
  2. package/dist/Badge/Badge.js +4 -5
  3. package/dist/Badge/typings.d.ts +10 -0
  4. package/dist/Breadcrumb/Breadcrumb.js +1 -4
  5. package/dist/Breadcrumb/typings.d.ts +4 -0
  6. package/dist/Button/Button.d.ts +0 -1
  7. package/dist/Button/Button.js +21 -9
  8. package/dist/Button/typings.d.ts +28 -0
  9. package/dist/Calendar/Calendar.js +1 -2
  10. package/dist/Calendar/CalendarContext.d.ts +10 -0
  11. package/dist/Calendar/Footer.js +1 -2
  12. package/dist/Calendar/Header.js +3 -8
  13. package/dist/Calendar/ShortCuts.d.ts +2 -0
  14. package/dist/Calendar/typings.d.ts +18 -0
  15. package/dist/Card/typings.d.ts +4 -0
  16. package/dist/Cascader/Cascader.js +26 -25
  17. package/dist/Cascader/CascaderDropdown.d.ts +1 -0
  18. package/dist/Cascader/CascaderMenu.d.ts +7 -0
  19. package/dist/Cascader/typings.d.ts +80 -0
  20. package/dist/Cascader/useCascader.d.ts +72 -0
  21. package/dist/Checkbox/Checkbox.js +2 -6
  22. package/dist/Checkbox/CheckboxButton.js +2 -6
  23. package/dist/Checkbox/typings.d.ts +11 -0
  24. package/dist/CheckboxGroup/CheckboxGroup.d.ts +4 -0
  25. package/dist/CheckboxGroup/CheckboxGroupContext.d.ts +1 -0
  26. package/dist/Col/Col.js +1 -8
  27. package/dist/Col/typings.d.ts +10 -0
  28. package/dist/Collapse/CollapseContext.d.ts +3 -0
  29. package/dist/Collapse/CollapseItem.js +9 -7
  30. package/dist/Collapse/CollapseTransition.d.ts +7 -6
  31. package/dist/Collapse/CollapseTransition.js +49 -31
  32. package/dist/Collapse/typings.d.ts +7 -0
  33. package/dist/ColorPicker/AlphaSlider.d.ts +7 -0
  34. package/dist/ColorPicker/AlphaSlider.js +0 -1
  35. package/dist/ColorPicker/ColorPicker.js +0 -1
  36. package/dist/ColorPicker/HueSlider.d.ts +7 -0
  37. package/dist/ColorPicker/HueSlider.js +0 -1
  38. package/dist/ColorPicker/Predefine.d.ts +7 -0
  39. package/dist/ColorPicker/Predefine.js +0 -1
  40. package/dist/ColorPicker/SvPanel.d.ts +7 -0
  41. package/dist/ColorPicker/SvPanel.js +0 -1
  42. package/dist/ColorPicker/typings.d.ts +9 -0
  43. package/dist/ConfigProvider/ConfigProvider.d.ts +5 -0
  44. package/dist/DatePicker/DatePicker.js +19 -8
  45. package/dist/DatePicker/DateRangePicker.js +11 -10
  46. package/dist/DatePicker/typings.d.ts +69 -0
  47. package/dist/DateTimePicker/DateTimePicker.d.ts +1 -1
  48. package/dist/DateTimePicker/DateTimePicker.js +10 -8
  49. package/dist/DateTimePicker/typings.d.ts +1 -0
  50. package/dist/Descriptions/Descriptions.js +1 -5
  51. package/dist/Descriptions/DescriptionsContext.d.ts +2 -0
  52. package/dist/Descriptions/typings.d.ts +13 -0
  53. package/dist/Dialog/Dialog.d.ts +0 -1
  54. package/dist/Dialog/Dialog.js +3 -6
  55. package/dist/Dialog/DialogBody.js +0 -3
  56. package/dist/Dialog/DialogContext.d.ts +8 -0
  57. package/dist/Dialog/DialogHeader.js +1 -4
  58. package/dist/Dialog/typings.d.ts +36 -0
  59. package/dist/Divider/Divider.d.ts +4 -0
  60. package/dist/Divider/Divider.js +1 -6
  61. package/dist/Drawer/Drawer.js +10 -5
  62. package/dist/Drawer/DrawerBody.js +1 -4
  63. package/dist/Drawer/DrawerContext.d.ts +10 -0
  64. package/dist/Drawer/DrawerHeader.js +1 -4
  65. package/dist/Drawer/typings.d.ts +16 -0
  66. package/dist/Dropdown/Dropdown.js +11 -7
  67. package/dist/Dropdown/DropdownContext.d.ts +2 -0
  68. package/dist/Dropdown/typings.d.ts +15 -0
  69. package/dist/Empty/Empty.js +1 -4
  70. package/dist/Form/Form.js +10 -6
  71. package/dist/Form/FormItem.d.ts +12 -0
  72. package/dist/Form/FormItem.js +3 -1
  73. package/dist/Form/typings.d.ts +55 -0
  74. package/dist/Form/useForm.d.ts +22 -0
  75. package/dist/Form/utils/NameMap.d.ts +3 -0
  76. package/dist/Form/utils/validateUtil.d.ts +4 -0
  77. package/dist/Form/utils/valueUtil.d.ts +17 -0
  78. package/dist/Icon/Icon.js +1 -4
  79. package/dist/Icon/typings.d.ts +7 -0
  80. package/dist/Input/Input.js +16 -9
  81. package/dist/Input/InputRange.js +11 -8
  82. package/dist/Input/TextArea.js +8 -4
  83. package/dist/Input/typings.d.ts +61 -0
  84. package/dist/InputNumber/InputNumber.js +10 -7
  85. package/dist/InputNumber/typings.d.ts +21 -0
  86. package/dist/Link/Link.js +1 -4
  87. package/dist/Link/typings.d.ts +6 -1
  88. package/dist/Loading/Loading.js +3 -5
  89. package/dist/Loading/typings.d.ts +5 -0
  90. package/dist/Message/Main.d.ts +7 -0
  91. package/dist/Message/Message.js +11 -8
  92. package/dist/Message/index.d.ts +8 -0
  93. package/dist/Message/typings.d.ts +11 -0
  94. package/dist/MessageBox/Main.js +3 -1
  95. package/dist/MessageBox/index.d.ts +17 -3
  96. package/dist/MessageBox/index.js +1 -1
  97. package/dist/MessageBox/typings.d.ts +50 -0
  98. package/dist/Notification/Main.d.ts +7 -0
  99. package/dist/Notification/Notification.js +17 -14
  100. package/dist/Notification/index.d.ts +15 -0
  101. package/dist/Notification/typings.d.ts +13 -0
  102. package/dist/Pagination/Pagination.js +15 -11
  103. package/dist/Pagination/typings.d.ts +28 -0
  104. package/dist/Popconfirm/Popconfirm.js +13 -9
  105. package/dist/Popconfirm/typings.d.ts +10 -0
  106. package/dist/Popover/Popover.js +12 -8
  107. package/dist/Popover/typings.d.ts +12 -0
  108. package/dist/Popper/Popper.js +15 -11
  109. package/dist/Popper/typings.d.ts +7 -1
  110. package/dist/Progress/Progress.js +12 -8
  111. package/dist/Progress/typings.d.ts +12 -0
  112. package/dist/Radio/typings.d.ts +7 -0
  113. package/dist/RadioGroup/typings.d.ts +1 -0
  114. package/dist/Row/Row.js +8 -5
  115. package/dist/Row/RowContext.d.ts +1 -0
  116. package/dist/Row/typings.d.ts +4 -0
  117. package/dist/Scrollbar/Scrollbar.js +13 -9
  118. package/dist/Scrollbar/Thumb.js +1 -1
  119. package/dist/Scrollbar/typings.d.ts +20 -0
  120. package/dist/Select/SelectCore.js +17 -14
  121. package/dist/Select/typings.d.ts +33 -0
  122. package/dist/Skeleton/PlaceholderGraph.d.ts +4 -0
  123. package/dist/Skeleton/PlaceholderGrid.d.ts +4 -0
  124. package/dist/Skeleton/PlaceholderGrid.js +0 -4
  125. package/dist/Skeleton/PlaceholderParagraph.d.ts +4 -0
  126. package/dist/Skeleton/PlaceholderParagraph.js +0 -4
  127. package/dist/Switch/Switch.js +13 -10
  128. package/dist/Switch/typings.d.ts +15 -0
  129. package/dist/Table/Colgroup.d.ts +1 -0
  130. package/dist/Table/Table.js +13 -9
  131. package/dist/Table/TableBody.js +10 -41
  132. package/dist/Table/TableCell.js +0 -5
  133. package/dist/Table/TableColumn.js +0 -4
  134. package/dist/Table/TableContext.d.ts +8 -0
  135. package/dist/Table/hooks/useSelection.d.ts +17 -0
  136. package/dist/Table/hooks/useTable.d.ts +7 -0
  137. package/dist/Table/treeUtil.d.ts +39 -0
  138. package/dist/Table/typings.d.ts +137 -1
  139. package/dist/Table/util.d.ts +10 -0
  140. package/dist/Tabs/Tabs.js +1 -4
  141. package/dist/Tabs/typings.d.ts +38 -0
  142. package/dist/Tag/Tag.d.ts +1 -1
  143. package/dist/Tag/Tag.js +7 -8
  144. package/dist/Tag/typings.d.ts +10 -0
  145. package/dist/TimeLine/TimeLineItem.js +7 -4
  146. package/dist/TimeLine/typings.d.ts +9 -0
  147. package/dist/TimePicker/TimePicker.js +14 -11
  148. package/dist/TimePicker/TimePickerRange.js +15 -12
  149. package/dist/TimePicker/TimeSpinnerPanel.js +1 -4
  150. package/dist/TimePicker/typings.d.ts +13 -0
  151. package/dist/TimePicker/useTimePicker.d.ts +7 -0
  152. package/dist/Tooltip/Tooltip.js +8 -15
  153. package/dist/Tooltip/TooltipContext.d.ts +1 -0
  154. package/dist/Tooltip/typings.d.ts +14 -1
  155. package/dist/Transfer/List.js +12 -8
  156. package/dist/Transfer/ListItem.d.ts +1 -0
  157. package/dist/Transfer/Transfer.js +11 -7
  158. package/dist/Transfer/typings/index.d.ts +27 -0
  159. package/dist/Transfer/typings/list.d.ts +25 -0
  160. package/dist/Transfer/typings/listBody.d.ts +1 -0
  161. package/dist/Transition/Transition.d.ts +16 -3
  162. package/dist/Transition/Transition.js +6 -4
  163. package/dist/Transition/TransitionGroup.d.ts +59 -0
  164. package/dist/Transition/childMapping.d.ts +23 -0
  165. package/dist/Tree/NodeList.d.ts +3 -0
  166. package/dist/Tree/RCTree.d.ts +15 -0
  167. package/dist/Tree/Tree.d.ts +15 -0
  168. package/dist/Tree/TreeNode.d.ts +7 -0
  169. package/dist/Tree/TreeNode.js +1 -4
  170. package/dist/Tree/contextTypes.d.ts +4 -0
  171. package/dist/Tree/typings.d.ts +3 -0
  172. package/dist/Tree/util.d.ts +17 -0
  173. package/dist/Tree/utils/KeyCode.d.ts +326 -0
  174. package/dist/Tree/utils/conductUtil.d.ts +6 -0
  175. package/dist/Tree/utils/dictUtil.d.ts +1 -0
  176. package/dist/Tree/utils/pickAttrs.d.ts +5 -0
  177. package/dist/Tree/utils/treeUtil.d.ts +25 -1
  178. package/dist/TreeSelect/TreeSelect.js +14 -13
  179. package/dist/TreeSelect/Utils.d.ts +1 -0
  180. package/dist/TreeSelect/typings.d.ts +19 -0
  181. package/dist/Upload/Upload.js +9 -8
  182. package/dist/Upload/UploadList.js +2 -1
  183. package/dist/Upload/typings.d.ts +34 -0
  184. package/dist/Upload/use-handlers.d.ts +1 -0
  185. package/dist/Upload/use-handlers.js +1 -1
  186. package/dist/Util/Math.d.ts +34 -0
  187. package/dist/Util/base.d.ts +22 -0
  188. package/dist/Util/base.js +5 -0
  189. package/dist/Util/shallowEqual.d.ts +11 -0
  190. package/dist/Util/treeUtils.d.ts +8 -0
  191. package/dist/VirtualList/Filler.d.ts +5 -0
  192. package/dist/VirtualList/VirtualList.d.ts +3 -0
  193. package/dist/VirtualList/hooks/useLayoutEffect.d.ts +3 -0
  194. package/dist/VirtualList/utils/algorithmUtil.d.ts +17 -0
  195. package/dist/VirtualList/utils/findDOMNode.d.ts +3 -0
  196. package/dist/hooks/animationPropsUtils.d.ts +12 -0
  197. package/dist/hooks/htmlPropsUtils.d.ts +8 -0
  198. package/dist/hooks/popperPropsUtils.d.ts +12 -0
  199. package/dist/hooks/treePropsUtils.d.ts +12 -0
  200. package/dist/hooks/useChildrenInstance.d.ts +11 -0
  201. package/dist/hooks/useClassNames.d.ts +78 -0
  202. package/dist/hooks/useControlled.d.ts +8 -0
  203. package/dist/hooks/useForceUpdate.d.ts +1 -0
  204. package/dist/index.css +72 -45422
  205. package/dist/index.d.ts +1 -0
  206. package/dist/theme-chalk/build.scss +64 -0
  207. package/dist/theme-chalk/icon/fonts.scss +8 -0
  208. package/dist/theme-chalk/icon/index.scss +0 -9
  209. package/dist/theme-chalk/index.scss +1 -0
  210. package/dist/theme-chalk/link/index.scss +0 -85
  211. package/dist/types/common.d.ts +24 -0
  212. package/dist/types/type.d.ts +5 -0
  213. package/package.json +1 -1
@@ -12,84 +12,153 @@ export type DatePickerRef = {
12
12
  setVisible: (value: boolean) => void;
13
13
  };
14
14
  export interface DatePickerProps extends Omit<FormControlBaseProps, 'name' | 'value' | 'defaultValue' | 'onChange'>, BaseProps, NativeProps, AnimationEventProps, Omit<React.AllHTMLAttributes<HTMLInputElement>, 'value' | 'defaultValue' | 'size' | 'prefix' | 'type' | 'onInput' | 'onChange' | 'className' | 'style' | 'readOnly' | 'disabled' | 'children'> {
15
+ /** 等价于原生 name 属性 */
15
16
  name?: string;
17
+ /** 选中项绑定值 */
16
18
  value?: string;
19
+ /** 默认值 */
17
20
  defaultValue?: string;
21
+ /** 只读 */
18
22
  readonly?: boolean;
23
+ /** 必输项*/
19
24
  required?: boolean;
25
+ /** 是否显示清除按钮 */
20
26
  clearable?: boolean;
27
+ /** 非范围选择时的占位内容 */
21
28
  placeholder?: string;
29
+ /** 是否展示“今天”按钮 */
22
30
  showToday?: boolean;
31
+ /** 显示类型 */
23
32
  type?: DateType;
33
+ /** 显示在输入框中的格式 */
24
34
  format?: string;
35
+ /** 可选,绑定值的格式。 不指定则绑定值为 Date 对象 */
25
36
  valueFormat?: string;
37
+ /** 设置ISO周数,其中1为星期一,7为星期日 */
26
38
  isoWeek?: boolean;
39
+ /** 表单校验错误提示 */
27
40
  error?: boolean;
41
+ /** 表单校验警告提示 */
28
42
  warning?: boolean;
43
+ /** 输入框前置内容,只对 type="text" 有效 */
29
44
  prepend?: React.ReactElement<any> | string | number;
45
+ /** 输入框后置内容,只对 type="text" 有效 */
30
46
  append?: React.ReactElement | string | number;
47
+ /** 是否纯文本模式,即无边框 */
31
48
  plain?: boolean;
32
49
  size?: TypeAttributes.Size;
50
+ /** 一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。 */
33
51
  disabledDate?: (time: Date) => boolean;
34
52
  shortcuts?: Shortcuts[];
53
+ /** 是否追加到body下 */
35
54
  appendToBody?: boolean;
55
+ /** 点击确定按钮的回调 */
36
56
  onOk?: () => void;
37
57
  onChange?: (value: string | Date | number, event?: Event) => void;
58
+ /** 格式化 */
38
59
  formatter?: (value: Dayjs, text: number) => React.ReactElement;
39
60
  }
40
61
  export interface DatePickerRangeProps extends Omit<FormControlBaseProps, 'name' | 'value' | 'defaultValue' | 'onChange'>, BaseProps, AnimationEventProps, NativeProps {
62
+ /** 等价于原生 name 属性 */
41
63
  name?: [string, string];
64
+ /** 选中项绑定值 */
42
65
  value?: [string, string];
66
+ /** 默认值 */
43
67
  defaultValue?: [string, string];
68
+ /** 只读 */
44
69
  readOnly?: boolean;
70
+ /** 禁用 */
45
71
  disabled?: boolean;
72
+ /** 是否显示清除按钮 */
46
73
  clearable?: boolean;
74
+ /** 范围选择时开始日期的占位内容 */
47
75
  startPlaceholder?: string;
76
+ /** 范围选择时结束日期的占位内容 */
48
77
  endPlaceholder?: string;
78
+ /** 显示类型 */
49
79
  type?: DateRangeType;
80
+ /** 显示在输入框中的格式 */
50
81
  format?: string;
82
+ /** 可选,绑定值的格式。 不指定则绑定值为 Date 对象 */
51
83
  valueFormat?: string;
84
+ /** 选择范围时的分隔符 */
52
85
  rangeSeparator?: string;
86
+ /** 在范围选择器里取消两个日期面板之间的联动 */
53
87
  unlinkPanels?: boolean;
88
+ /** 设置ISO周数,其中1为星期一,7为星期日 */
54
89
  isoWeek?: boolean;
90
+ /** 表单校验错误提示 */
55
91
  error?: boolean;
92
+ /** 表单校验警告提示 */
56
93
  warning?: boolean;
94
+ /** 输入框前置内容,只对 type="text" 有效 */
57
95
  prepend?: React.ReactElement<any> | string | number;
96
+ /** 输入框后置内容,只对 type="text" 有效 */
58
97
  append?: React.ReactElement | string | number;
98
+ /** 点击确定按钮的回调 */
59
99
  onOk?: () => void;
100
+ /** 一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。 */
60
101
  disabledDate?: (time: Date) => boolean;
61
102
  onChange?: (value: [string, string] | [Date, Date] | [number, number], event?: Event) => void;
103
+ /** 格式化 */
62
104
  formatter?: (value: Dayjs, text: number) => React.ReactElement;
63
105
  }
64
106
  export interface AllDatePickerProps extends Omit<FormControlBaseProps, 'name' | 'value' | 'defaultValue' | 'onChange'>, BaseProps, NativeProps, AnimationEventProps, Omit<React.AllHTMLAttributes<HTMLInputElement>, 'name' | 'value' | 'defaultValue' | 'size' | 'prefix' | 'type' | 'onInput' | 'onChange' | 'className' | 'style' | 'readOnly' | 'disabled' | 'children'> {
107
+ /** 等价于原生 name 属性 */
65
108
  name?: string | [string, string];
109
+ /** 选中项绑定值 */
66
110
  value?: string | Date | number | [string, string] | [Date, Date] | [number, number];
111
+ /** 默认值 */
67
112
  defaultValue?: string | Date | number | [string, string] | [Date, Date] | [number, number];
113
+ /** 只读 */
68
114
  readonly?: boolean;
115
+ /** 必输项*/
69
116
  required?: boolean;
117
+ /** 是否显示清除按钮 */
70
118
  clearable?: boolean;
119
+ /** 非范围选择时的占位内容 */
71
120
  placeholder?: string;
121
+ /** 是否展示“今天”按钮 */
72
122
  showToday?: boolean;
123
+ /** 显示类型 */
73
124
  type?: DateType | DateRangeType;
125
+ /** 显示在输入框中的格式 */
74
126
  format?: string;
127
+ /** 可选,绑定值的格式。 不指定则绑定值为 Date 对象 */
75
128
  valueFormat?: string;
129
+ /** 设置ISO周数,其中1为星期一,7为星期日 */
76
130
  isoWeek?: boolean;
131
+ /** 表单校验错误提示 */
77
132
  error?: boolean;
133
+ /** 表单校验警告提示 */
78
134
  warning?: boolean;
135
+ /** 输入框前置内容,只对 type="text" 有效 */
79
136
  prepend?: React.ReactElement<any> | string | number;
137
+ /** 输入框后置内容,只对 type="text" 有效 */
80
138
  append?: React.ReactElement | string | number;
139
+ /** 是否纯文本模式,即无边框 */
81
140
  plain?: boolean;
82
141
  size?: TypeAttributes.Size;
142
+ /** 一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。 */
83
143
  disabledDate?: (time: Date) => boolean;
84
144
  shortcuts?: Shortcuts[];
145
+ /** 是否追加到body下 */
85
146
  appendToBody?: boolean;
147
+ /** 点击确定按钮的回调 */
86
148
  onOk?: () => void;
87
149
  onChange?: (value: string | Date | number | [string, string] | [Date, Date] | [number, number], event?: Event) => void;
150
+ /** 格式化 */
88
151
  formatter?: (value: Dayjs, text: number) => React.ReactElement;
152
+ /** 只读 */
89
153
  readOnly?: boolean;
154
+ /** 禁用 */
90
155
  disabled?: boolean;
156
+ /** 范围选择时开始日期的占位内容 */
91
157
  startPlaceholder?: string;
158
+ /** 范围选择时结束日期的占位内容 */
92
159
  endPlaceholder?: string;
160
+ /** 选择范围时的分隔符 */
93
161
  rangeSeparator?: string;
162
+ /** 在范围选择器里取消两个日期面板之间的联动 */
94
163
  unlinkPanels?: boolean;
95
164
  }
@@ -1,6 +1,6 @@
1
1
  import React from 'react';
2
2
  import { DateTimePickerRef } from './typings';
3
- declare const _default: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<import("..").DatePickerProps, "type" | "value" | "name" | "defaultValue" | "onChange"> & {
3
+ declare const _default: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<import("..").DatePickerProps, "name" | "value" | "type" | "defaultValue" | "onChange"> & {
4
4
  name?: string;
5
5
  value?: string;
6
6
  defaultValue?: string;
@@ -45,6 +45,15 @@ var import_Util = require("../Util");
45
45
  var import_hooks = require("../hooks");
46
46
  var import_util = require("./util");
47
47
  var DateTimePicker = (0, import_react.forwardRef)((props, ref) => {
48
+ props = {
49
+ format: "YYYY-MM-DD HH:mm:ss",
50
+ readonly: true,
51
+ isoWeek: true,
52
+ clearable: true,
53
+ disabled: false,
54
+ placeholder: "请选择日期时间",
55
+ ...props
56
+ };
48
57
  const {
49
58
  name,
50
59
  readonly,
@@ -181,6 +190,7 @@ var DateTimePicker = (0, import_react.forwardRef)((props, ref) => {
181
190
  /* @__PURE__ */ import_react.default.createElement(import_Calendar.Calendar, { hasTime: true }, /* @__PURE__ */ import_react.default.createElement("div", { className: e`time-header` }, /* @__PURE__ */ import_react.default.createElement("div", { className: e`editor-wrap` }, /* @__PURE__ */ import_react.default.createElement(import_Input.Input, { placeholder: "选择日期", value: date, clearable: false })), /* @__PURE__ */ import_react.default.createElement("div", { className: e`editor-wrap` }, /* @__PURE__ */ import_react.default.createElement(import_Input.Input, { placeholder: "选择时间", value: time, clearable: false, onFocus: () => setShowTime(true), ref: timeReferenceElement }), /* @__PURE__ */ import_react.default.createElement(
182
191
  import_Transition.Transition,
183
192
  {
193
+ nodeRef: () => ({ current: timePanelRef.current.ref }),
184
194
  visible: showTime,
185
195
  name: "r-slide-up",
186
196
  transitionAppear: true,
@@ -215,13 +225,5 @@ var DateTimePicker = (0, import_react.forwardRef)((props, ref) => {
215
225
  )
216
226
  ));
217
227
  });
218
- DateTimePicker.defaultProps = {
219
- format: "YYYY-MM-DD HH:mm:ss",
220
- readonly: true,
221
- isoWeek: true,
222
- clearable: true,
223
- disabled: false,
224
- placeholder: "请选择日期时间"
225
- };
226
228
  DateTimePicker.displayName = "DateTimePicker";
227
229
  var DateTimePicker_default = (0, import_react.memo)(DateTimePicker);
@@ -4,6 +4,7 @@ import { PopperOptionRef } from '../Popper';
4
4
  export type DateTimePickerRef = {
5
5
  inputInstance?: InputRef;
6
6
  popperInstRef: PopperOptionRef;
7
+ /** �Ƿ�׷�ӵ�body�� */
7
8
  appendToBody?: boolean;
8
9
  getValue: () => string;
9
10
  setValue: (value: string) => void;
@@ -38,7 +38,7 @@ var import_hooks = require("../hooks");
38
38
  var import_DescriptionsContext = require("./DescriptionsContext");
39
39
  var import_DescriptionsRow = __toESM(require("./DescriptionsRow"));
40
40
  var Descriptions = (0, import_react.forwardRef)((props, ref) => {
41
- const { border, column, direction, title, size, extra, classPrefix = "descriptions", className, style } = props;
41
+ const { border, column = 3, direction = "horizontal", title, size, extra, classPrefix = "descriptions", className, style } = props;
42
42
  const { b, e, m, is } = (0, import_hooks.useClassNames)(classPrefix);
43
43
  const getChildInstance = (0, import_hooks.useChildrenInstance)("DescriptionsItem");
44
44
  const filledNode = (0, import_react.useCallback)((node, span, count, isLast = false) => {
@@ -89,8 +89,4 @@ var Descriptions = (0, import_react.forwardRef)((props, ref) => {
89
89
  return /* @__PURE__ */ import_react.default.createElement("div", { ref, className: (0, import_classnames.default)(b(), { [m(size)]: size }, className), style }, (title || extra) && /* @__PURE__ */ import_react.default.createElement("div", { className: e`header` }, /* @__PURE__ */ import_react.default.createElement("div", { className: e`title` }, title), /* @__PURE__ */ import_react.default.createElement("div", { className: e`extra` }, extra)), /* @__PURE__ */ import_react.default.createElement(import_DescriptionsContext.DescriptionsContext.Provider, { value: { direction, border } }, /* @__PURE__ */ import_react.default.createElement("div", { className: e`body` }, /* @__PURE__ */ import_react.default.createElement("table", { className: (0, import_classnames.default)(e`table`, is({ bordered: border })) }, /* @__PURE__ */ import_react.default.createElement("tbody", null, rows.map((row) => /* @__PURE__ */ import_react.default.createElement(import_DescriptionsRow.default, { row })))))));
90
90
  });
91
91
  Descriptions.displayName = "Descriptions";
92
- Descriptions.defaultProps = {
93
- column: 3,
94
- direction: "horizontal"
95
- };
96
92
  var Descriptions_default = (0, import_react.memo)(Descriptions);
@@ -1,6 +1,8 @@
1
1
  /// <reference types="react" />
2
2
  interface DescriptionsContextProps {
3
+ /** 排列的方向 */
3
4
  direction?: 'vertical' | 'horizontal';
5
+ /** 是否带有边框 */
4
6
  border?: boolean;
5
7
  }
6
8
  export declare const DescriptionsContext: import("react").Context<DescriptionsContextProps>;
@@ -1,19 +1,32 @@
1
1
  import React from 'react';
2
2
  import { BaseProps, NativeProps, TypeAttributes } from '../types/common';
3
3
  export interface DescriptionsProps extends BaseProps<React.ReactElement<DescriptionsItemProps> | React.ReactElement<DescriptionsItemProps>[]>, NativeProps<'--el-descriptions-table-border' | '--el-descriptions-item-bordered-label-background'> {
4
+ /** 是否带有边框 */
4
5
  border?: boolean;
6
+ /** 一行 Descriptions Item 的数量 */
5
7
  column?: number;
8
+ /** 排列的方向 */
6
9
  direction?: 'vertical' | 'horizontal';
10
+ /** 列表的尺寸 */
7
11
  size?: TypeAttributes.Size;
12
+ /** 标题文本,显示在左上方 */
8
13
  title?: string | React.ReactElement<any>;
14
+ /** 操作区文本,显示在右上方 */
9
15
  extra?: string | React.ReactElement<any>;
10
16
  }
11
17
  export interface DescriptionsItemProps extends BaseProps, NativeProps {
18
+ /** 标签文本 */
12
19
  label?: string | React.ReactElement<any>;
20
+ /** 列的数量 */
13
21
  span?: number;
22
+ /** 列的宽度,不同行相同列的宽度按最大值设定(如无 border ,宽度包含标签与内容) */
14
23
  width?: number | string;
24
+ /** 列的最小宽度,与 width 的区别是 width 是固定的,minWidth 会把剩余宽度按比例分配给设置了 minWidth 的列(如无 border,宽度包含标签与内容) */
15
25
  minWidth?: number | string;
26
+ /** 列的内容对齐方式(如无 border,对标签和内容均生效) */
16
27
  align?: 'left' | 'center' | 'right';
28
+ /** 列的标签对齐方式,若不设置该项,则使用内容的对齐方式(如无 border,请使用 align 参数) */
17
29
  labelAlign?: 'left' | 'center' | 'right';
30
+ /** 列标题自定义类名 */
18
31
  labelClassName?: string;
19
32
  }
@@ -8,7 +8,6 @@ declare const Comp: (props: DialogProps & {
8
8
  type InternalType = typeof Comp;
9
9
  interface CompInterface extends InternalType {
10
10
  displayName?: string;
11
- defaultProps?: Partial<DialogProps>;
12
11
  body: typeof DialogBody;
13
12
  footer: typeof DialogFooter;
14
13
  }
@@ -47,10 +47,10 @@ var import_DialogHeader = __toESM(require("./DialogHeader"));
47
47
  var import_useDraggable = require("./useDraggable");
48
48
  function InternalElDialog(props, ref) {
49
49
  const {
50
- modal,
50
+ modal = true,
51
51
  closeOnClickModal = true,
52
52
  width = "50%",
53
- overflow,
53
+ overflow = false,
54
54
  title,
55
55
  showClose,
56
56
  border,
@@ -136,6 +136,7 @@ function InternalElDialog(props, ref) {
136
136
  /* @__PURE__ */ import_react.default.createElement(
137
137
  import_Transition.Transition,
138
138
  {
139
+ nodeRef: wrapperRef,
139
140
  visible,
140
141
  transitionAppear: true,
141
142
  unmountOnExit: props.unmountOnExit || !draggable,
@@ -202,10 +203,6 @@ function InternalElDialog(props, ref) {
202
203
  }
203
204
  var Comp = (0, import_react.memo)((0, import_react.forwardRef)(InternalElDialog));
204
205
  var Dialog = Comp;
205
- Dialog.defaultProps = {
206
- modal: true,
207
- overflow: false
208
- };
209
206
  Dialog.body = import_DialogBody.default;
210
207
  Dialog.footer = import_DialogFooter.default;
211
208
  Dialog.displayName = "ElDialog";
@@ -57,7 +57,4 @@ var DialogBody = (0, import_react.memo)(
57
57
  })
58
58
  );
59
59
  DialogBody.displayName = "ElDialogBody";
60
- DialogBody.defaultProps = {
61
- padding: "0 20px"
62
- };
63
60
  var DialogBody_default = DialogBody;
@@ -1,13 +1,21 @@
1
1
  /// <reference types="react" />
2
2
  interface DialogContentProps {
3
+ /** 当设置为 true,Dialog 打开时会显示背景,点击背景会关闭 Dialog,如果不想关闭 Dialog,可以设置为 'static' */
3
4
  backdrop: boolean | 'static';
4
5
  setVisible: (visible: boolean) => void;
6
+ /** 隐藏时的回调函数 */
5
7
  doClose: () => void;
8
+ /** 是否可控 */
6
9
  isControlled: boolean;
10
+ /** 是否让 Dialog 的 header 和 footer 部分居中排列 */
7
11
  center: boolean;
12
+ /** body 内容过长时自动设置高度 */
8
13
  overflow: boolean;
14
+ /** 是否加载成功 */
9
15
  mounted?: boolean;
16
+ /** 是否有标题 */
10
17
  haveTitle: boolean;
18
+ /** 是否有按钮组 */
11
19
  haveFooter: boolean;
12
20
  }
13
21
  export declare const DialogContext: import("react").Context<DialogContentProps>;
@@ -39,15 +39,12 @@ var import_hooks = require("../hooks");
39
39
  var import_DialogContext = require("./DialogContext");
40
40
  var DialogHeader = (0, import_react.memo)(
41
41
  (0, import_react.forwardRef)((props, ref) => {
42
- const { showClose, classPrefix = "dialog", border } = props;
42
+ const { showClose = true, classPrefix = "dialog", border } = props;
43
43
  const { e, is } = (0, import_hooks.useClassNames)(classPrefix);
44
44
  const { doClose, center } = (0, import_react.useContext)(import_DialogContext.DialogContext);
45
45
  const isString = (0, import_react.useMemo)(() => typeof props.children === "string", [props.children]);
46
46
  return /* @__PURE__ */ import_react.default.createElement("div", { ref, className: (0, import_classnames.default)(e`header`, is({ border }), { "show-close": showClose }, props.headerClass) }, isString ? /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, /* @__PURE__ */ import_react.default.createElement("div", { className: e`title`, style: center ? { textAlign: "center" } : {} }, props.children), showClose && /* @__PURE__ */ import_react.default.createElement("button", { className: e`headerbtn`, onClick: doClose }, /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: "xmark", className: e`close` }))) : props.children);
47
47
  })
48
48
  );
49
- DialogHeader.defaultProps = {
50
- showClose: true
51
- };
52
49
  DialogHeader.displayName = "ElDialogHeader";
53
50
  var DialogHeader_default = DialogHeader;
@@ -2,47 +2,83 @@ import React from 'react';
2
2
  import { TransitionProps } from '../Transition';
3
3
  import { AnimationEventProps, BaseProps, NativeProps } from '../types/common';
4
4
  export interface DialogProps extends AnimationEventProps, BaseProps, NativeProps, TransitionProps {
5
+ /** 是否显示模态框(可控) */
5
6
  visible?: boolean;
7
+ /** 默认是否显示模态框 */
6
8
  defaultVisible?: boolean;
9
+ /** 是否需要遮罩层 */
7
10
  modal?: boolean;
11
+ /** 遮罩的自定义类名 */
8
12
  className?: string;
13
+ /** 是否可以通过点击 modal 关闭 Dialog */
9
14
  closeOnClickModal?: boolean;
15
+ /** 应用于 backdrop DOM 节点的 css class */
10
16
  backdropClassName?: string;
17
+ /** 对话框的宽度,默认值为 50% */
11
18
  width?: string | number;
19
+ /** header 部分的自定义 class 名 */
12
20
  headerClass?: string;
21
+ /** Dialog 对话框 Dialog 的标题, 也可通过ElDialog.header传入 */
13
22
  title?: string | React.ReactElement;
23
+ /** 当设置为 true, 显示关闭按钮 */
14
24
  showClose?: boolean;
25
+ /** 标题是否有边框 */
15
26
  border?: boolean;
27
+ /** dialog CSS 中的 margin-top 值,默认为 15vh */
16
28
  top?: string;
29
+ /** 是否让 Dialog 的 header 和 footer 部分居中排列 */
17
30
  center?: boolean;
31
+ /** 是否水平垂直对齐对话框 */
18
32
  alignCenter?: boolean;
33
+ /** 为 Dialog 启用可拖拽功能 */
19
34
  draggable?: boolean;
35
+ /** 拖动范围可以超出可视区 */
20
36
  overflow?: boolean;
37
+ /** 是否为全屏 Dialog */
21
38
  fullscreen?: boolean;
39
+ /** 是否在 Dialog 出现时将 body 滚动锁定 */
22
40
  lockScroll?: boolean;
41
+ /** 是否可以通过按下 ESC 关闭 Dialog */
42
+ /** 和原生的 CSS 的 z-index 相同,改变 z 轴的顺序 */
23
43
  zIndex?: number;
44
+ /** Dialog 打开的回调 */
24
45
  onOpen?: () => void;
46
+ /** Dialog 打开动画结束时的回调 */
25
47
  onOpened?: () => void;
48
+ /** Dialog 关闭的回调 */
26
49
  onClose?: () => void;
50
+ /** Dialog 关闭动画结束时的回调 */
27
51
  onClosed?: () => void;
52
+ /** 关闭弹窗函数 */
28
53
  close?: () => void;
54
+ /** 关闭前的回调,会暂停 Dialog 的关闭. 回调函数内执行 done 参数方法的时候才是真正关闭对话框的时候. */
29
55
  beforeClose?: DialogBeforeCloseFn;
30
56
  }
31
57
  type DoneFn = (cancel?: boolean) => void;
32
58
  export type DialogBeforeCloseFn = (done: DoneFn) => void;
33
59
  export interface DialogHeaderProps extends BaseProps {
60
+ /** header 部分的自定义 class 名 */
34
61
  headerClass?: string;
62
+ /** 当设置为 true, 显示关闭按钮 */
35
63
  showClose?: boolean;
64
+ /** 标题是否有边框 */
36
65
  border?: boolean;
66
+ /** 组件 CSS 类的前缀 */
37
67
  classPrefix?: string;
68
+ /** 隐藏时的回调函数 */
69
+ /** 自定义标题内联样式 */
38
70
  titleStyle?: React.CSSProperties;
39
71
  }
40
72
  export interface DialogBodyProps extends BaseProps, NativeProps {
73
+ /** 组件 CSS 类的前缀 */
41
74
  classPrefix?: string;
75
+ /** 内容区域padding */
42
76
  padding?: string | number;
43
77
  }
44
78
  export interface DialogFooterProps extends BaseProps, NativeProps {
79
+ /** 组件 CSS 类的前缀 */
45
80
  classPrefix?: string;
81
+ /** 内容位置 */
46
82
  position?: 'left' | 'center' | 'right';
47
83
  }
48
84
  export {};
@@ -1,9 +1,13 @@
1
1
  import React from 'react';
2
2
  import { BaseProps, NativeProps } from '../types/common';
3
3
  export interface DividerProps extends BaseProps, NativeProps<'--el-divider-text-bg-color' | '--el-divider-border-color' | '--el-divider-margin' | '--el-divider-tip-bg-color' | '--el-border-style'> {
4
+ /** 设置分割线方向 */
4
5
  direction?: 'horizontal' | 'vertical';
6
+ /** 设置分隔符样式 */
5
7
  borderStyle?: string;
8
+ /** 自定义文本样式 */
6
9
  textStyle?: React.CSSProperties;
10
+ /** 设置分割线文案的位置 */
7
11
  contentPosition?: 'left' | 'right' | 'center';
8
12
  }
9
13
  declare const _default: React.NamedExoticComponent<DividerProps>;
@@ -36,17 +36,12 @@ var import_classnames = __toESM(require("classnames"));
36
36
  var import_react = __toESM(require("react"));
37
37
  var import_hooks = require("../hooks");
38
38
  var Divider = (props) => {
39
- const { direction, borderStyle, contentPosition, classPrefix = "divider" } = props;
39
+ const { direction = "horizontal", borderStyle = "solid", contentPosition = "left", classPrefix = "divider" } = props;
40
40
  const { b, m, e, is } = (0, import_hooks.useClassNames)(classPrefix);
41
41
  return (
42
42
  // @ts-ignore
43
43
  /* @__PURE__ */ import_react.default.createElement("div", { className: (0, import_classnames.default)(b(), m(direction), props.className), style: { ...props.style, "--el-border-style": borderStyle } }, props.children && /* @__PURE__ */ import_react.default.createElement("div", { className: (0, import_classnames.default)(e`text`, is(contentPosition)), style: props.textStyle }, props.children))
44
44
  );
45
45
  };
46
- Divider.defaultProps = {
47
- direction: "horizontal",
48
- borderStyle: "solid",
49
- contentPosition: "left"
50
- };
51
46
  Divider.displayName = "Divider";
52
47
  var Divider_default = (0, import_react.memo)(Divider);
@@ -44,6 +44,14 @@ var import_DrawerContext = require("./DrawerContext");
44
44
  var import_DrawerFooter = __toESM(require("./DrawerFooter"));
45
45
  var import_DrawerHeader = __toESM(require("./DrawerHeader"));
46
46
  function InternalComp(props, ref) {
47
+ props = (0, import_Util.mergeDefaultProps)(
48
+ {
49
+ placement: "right",
50
+ backdrop: true,
51
+ size: "small"
52
+ },
53
+ props
54
+ );
47
55
  const { backdrop, size, placement, children, onClose, classPrefix = "drawer" } = props;
48
56
  const { b, wb } = (0, import_hooks.useClassNames)(classPrefix);
49
57
  const [visible, setVisible, isControlled] = (0, import_hooks.useControlled)(props.visible, props.defaultVisible);
@@ -80,6 +88,7 @@ function InternalComp(props, ref) {
80
88
  /* @__PURE__ */ import_react.default.createElement(
81
89
  import_Transition.Transition,
82
90
  {
91
+ nodeRef: backdropRef,
83
92
  visible,
84
93
  transitionAppear: true,
85
94
  unmountOnExit: true,
@@ -98,6 +107,7 @@ function InternalComp(props, ref) {
98
107
  /* @__PURE__ */ import_react.default.createElement(
99
108
  import_Transition.Transition,
100
109
  {
110
+ nodeRef: ref || wrapperRef,
101
111
  visible,
102
112
  transitionAppear: true,
103
113
  unmountOnExit: true,
@@ -124,11 +134,6 @@ function InternalComp(props, ref) {
124
134
  }
125
135
  var Comp = (0, import_react.forwardRef)(InternalComp);
126
136
  var Drawer = Comp;
127
- Drawer.defaultProps = {
128
- placement: "right",
129
- backdrop: true,
130
- size: "small"
131
- };
132
137
  Drawer.Header = import_DrawerHeader.default;
133
138
  Drawer.Body = import_DrawerBody.default;
134
139
  Drawer.Footer = import_DrawerFooter.default;
@@ -38,7 +38,7 @@ var import_react = __toESM(require("react"));
38
38
  var import_Scrollbar = require("../Scrollbar");
39
39
  var import_hooks = require("../hooks");
40
40
  var DrawerBody = (0, import_react.forwardRef)((props, ref) => {
41
- const { classPrefix = "drawer-body", padding } = props;
41
+ const { classPrefix = "drawer-body", padding = "0 20px" } = props;
42
42
  const { b } = (0, import_hooks.useClassNames)(classPrefix);
43
43
  const scrollbarInstance = (0, import_react.useRef)(null);
44
44
  const resizeFn = (0, import_debounce.default)(
@@ -57,7 +57,4 @@ var DrawerBody = (0, import_react.forwardRef)((props, ref) => {
57
57
  return /* @__PURE__ */ import_react.default.createElement("div", { className: (0, import_classnames.default)(b(), props.className), ref, style: props.style }, /* @__PURE__ */ import_react.default.createElement(import_Scrollbar.Scrollbar, { ref: scrollbarInstance }, /* @__PURE__ */ import_react.default.createElement("div", { style: { padding } }, props.children)));
58
58
  });
59
59
  DrawerBody.displayName = "DrawerBody";
60
- DrawerBody.defaultProps = {
61
- padding: "0 20px"
62
- };
63
60
  var DrawerBody_default = DrawerBody;
@@ -1,9 +1,19 @@
1
1
  /// <reference types="react" />
2
2
  interface DrawerContentProps {
3
+ /** 当设置为 true,Drawer 打开时会显示背景,点击背景会关闭 Drawer,如果不想关闭 Drawer,可以设置为 'static' */
3
4
  backdrop: boolean | 'static';
4
5
  setVisible: (visible: boolean) => void;
6
+ /** 隐藏时的回调函数 */
5
7
  onClose: () => void;
8
+ /** 是否可控 */
6
9
  isControlled: boolean;
7
10
  }
11
+ /**
12
+ * @author Parker
13
+ * @CreateTime 2022/3/20下午3:10:40
14
+ * @LastEditor Parker
15
+ * @ModifyTime 2022/5/3 22:55:13
16
+ * @Description 模态框上下文
17
+ */
8
18
  export declare const DrawerContext: import("react").Context<DrawerContentProps>;
9
19
  export {};
@@ -38,7 +38,7 @@ var import_Icon = require("../Icon");
38
38
  var import_hooks = require("../hooks");
39
39
  var import_DrawerContext = require("./DrawerContext");
40
40
  var DrawerHeader = (props) => {
41
- const { closeButton, onClose: onCloseHeader, classPrefix = "drawer", border } = props;
41
+ const { closeButton = true, onClose: onCloseHeader, classPrefix = "drawer", border } = props;
42
42
  const { b, is } = (0, import_hooks.useClassNames)(classPrefix);
43
43
  const { setVisible, isControlled, onClose } = (0, import_react.useContext)(import_DrawerContext.DrawerContext);
44
44
  const handleCloseDialog = (0, import_react.useCallback)(() => {
@@ -51,8 +51,5 @@ var DrawerHeader = (props) => {
51
51
  }, [isControlled, onClose, onCloseHeader, setVisible]);
52
52
  return /* @__PURE__ */ import_react.default.createElement("div", { className: (0, import_classnames.default)(b`header`, props.className, is({ border })), style: props.style }, /* @__PURE__ */ import_react.default.createElement("h4", { className: b`title`, style: props.titleStyle }, props.children), closeButton && /* @__PURE__ */ import_react.default.createElement("span", { className: b`header-close`, onClick: handleCloseDialog }, /* @__PURE__ */ import_react.default.createElement(import_Icon.Icon, { name: "xmark" })));
53
53
  };
54
- DrawerHeader.defaultProps = {
55
- closeButton: true
56
- };
57
54
  DrawerHeader.displayName = "DrawerHeader";
58
55
  var DrawerHeader_default = DrawerHeader;
@@ -1,26 +1,42 @@
1
1
  import React from 'react';
2
2
  import { AnimationEventProps, BaseProps, NativeProps } from '../types/common';
3
3
  export interface DrawerProps extends AnimationEventProps, BaseProps, NativeProps {
4
+ /** 是否显示抽屉(可控) */
4
5
  visible?: boolean;
6
+ /** 默认是否显示抽屉 */
5
7
  defaultVisible?: boolean;
8
+ /** 当设置为 true,Drawer 打开时会显示背景,点击背景会关闭 Drawer,如果不想关闭 Drawer,可以设置为 'static' */
6
9
  backdrop?: boolean | 'static';
10
+ /** 应用于 backdrop DOM 节点的 css class */
7
11
  backdropClassName?: string;
12
+ /** 设置 Drawer 尺寸 */
8
13
  size?: 'full' | 'large' | 'md' | 'small' | 'xs';
14
+ /** 设置 Drawer 显示的位置 */
9
15
  placement?: 'top' | 'bottom' | 'right' | 'left';
16
+ /** 显示时的回调函数 */
10
17
  onOpen?: () => void;
18
+ /** 隐藏时的回调函数 */
11
19
  onClose?: () => void;
12
20
  }
13
21
  export interface DrawerHeaderProps extends BaseProps, NativeProps {
22
+ /** 当设置为 true, 显示关闭按钮 */
14
23
  closeButton?: boolean;
24
+ /** 标题是否有边框 */
15
25
  border?: boolean;
26
+ /** 组件 CSS 类的前缀 */
16
27
  classPrefix?: string;
28
+ /** 隐藏时的回调函数 */
17
29
  onClose?: () => void;
30
+ /** 自定义标题内联样式 */
18
31
  titleStyle?: React.CSSProperties;
19
32
  }
20
33
  export interface DrawerBodyProps extends BaseProps, NativeProps {
34
+ /** 组件 CSS 类的前缀 */
21
35
  classPrefix?: string;
36
+ /** 内容区域padding */
22
37
  padding?: string | number;
23
38
  }
24
39
  export interface DrawerFooterProps extends BaseProps, NativeProps {
40
+ /** 组件 CSS 类的前缀 */
25
41
  classPrefix?: string;
26
42
  }