@agentscope-ai/design 1.0.20 → 1.0.21-beta.1766979118636

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.
package/llms/all.llms.txt CHANGED
@@ -143,6 +143,54 @@
143
143
 
144
144
 
145
145
 
146
+ <DemoTitle title="Tag" desc="进行标记和分类的小标签">
147
+ #### API
148
+
149
+ | 属性名 | 描述 | 类型 | 默认值 |
150
+ |--------|--------|--------|--------|
151
+ | size | 尺寸 | 'small' \| 'middle' | 'middle' |
152
+ | color | 标签色 | SparkTagColors \| string | 'purple' |
153
+
154
+ <AntdApiRef url="https://ant.design/components/tag-cn/#api"></AntdApiRef>
155
+
156
+
157
+ ## antd API
158
+
159
+ 通用属性参考:[通用属性](/docs/react/common-props)
160
+
161
+ ### Tag
162
+
163
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
164
+ |--------|--------|--------|--------|--------|
165
+ | closeIcon | 自定义关闭按钮。5.7.0:设置为 | ReactNode | false | 4.4.0 |
166
+ | icon | 设置图标 | ReactNode | - | |
167
+ | bordered | 是否有边框 | boolean | true | 5.4.0 |
168
+ | onClose | 关闭时的回调(可通过 | (e: React.MouseEvent) => void | - | |
169
+
170
+
171
+ ### Tag.CheckableTag
172
+
173
+ | 参数 | 说明 | 类型 | 默认值 |
174
+ |--------|--------|--------|--------|
175
+ | checked | 设置标签的选中状态 | boolean | false |
176
+ | onChange | 点击标签时触发的回调 | (checked) => void | - |
177
+
178
+
179
+
180
+
181
+ <DemoTitle title="Video" desc="视频展示">
182
+ #### API
183
+
184
+ | 属性名 | 描述 | 类型 | 默认值 |
185
+ |--------|--------|--------|--------|
186
+ | mouseEnterAutoPlay | 鼠标进入时是否自动播放 | boolean | false |
187
+ | children | video内部设置了按钮在暗色背景下的样式,如果有一些操作按钮想继承这个样式可以在这里传入 | React.ReactNode | |
188
+
189
+
190
+
191
+
192
+
193
+
146
194
  <DemoTitle title="TimePicker" desc="输入或选择时间的控件。">
147
195
  #### API
148
196
 
@@ -256,54 +304,6 @@ type RangeDisabledTime = (
256
304
 
257
305
 
258
306
 
259
- <DemoTitle title="Tag" desc="进行标记和分类的小标签">
260
- #### API
261
-
262
- | 属性名 | 描述 | 类型 | 默认值 |
263
- |--------|--------|--------|--------|
264
- | size | 尺寸 | 'small' \| 'middle' | 'middle' |
265
- | color | 标签色 | SparkTagColors \| string | 'purple' |
266
-
267
- <AntdApiRef url="https://ant.design/components/tag-cn/#api"></AntdApiRef>
268
-
269
-
270
- ## antd API
271
-
272
- 通用属性参考:[通用属性](/docs/react/common-props)
273
-
274
- ### Tag
275
-
276
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
277
- |--------|--------|--------|--------|--------|
278
- | closeIcon | 自定义关闭按钮。5.7.0:设置为 | ReactNode | false | 4.4.0 |
279
- | icon | 设置图标 | ReactNode | - | |
280
- | bordered | 是否有边框 | boolean | true | 5.4.0 |
281
- | onClose | 关闭时的回调(可通过 | (e: React.MouseEvent) => void | - | |
282
-
283
-
284
- ### Tag.CheckableTag
285
-
286
- | 参数 | 说明 | 类型 | 默认值 |
287
- |--------|--------|--------|--------|
288
- | checked | 设置标签的选中状态 | boolean | false |
289
- | onChange | 点击标签时触发的回调 | (checked) => void | - |
290
-
291
-
292
-
293
-
294
- <DemoTitle title="Video" desc="视频展示">
295
- #### API
296
-
297
- | 属性名 | 描述 | 类型 | 默认值 |
298
- |--------|--------|--------|--------|
299
- | mouseEnterAutoPlay | 鼠标进入时是否自动播放 | boolean | false |
300
- | children | video内部设置了按钮在暗色背景下的样式,如果有一些操作按钮想继承这个样式可以在这里传入 | React.ReactNode | |
301
-
302
-
303
-
304
-
305
-
306
-
307
307
  <DemoTitle title="Tabs" desc="用户可以通过点击不同的标签在同一页面中查看不同的内容区域。">
308
308
  #### API
309
309
 
@@ -870,67 +870,6 @@ TypeScript 里使用 Table 的 [CodeSandbox 实例](https://codesandbox.io/s/ser
870
870
 
871
871
 
872
872
 
873
- <DemoTitle title="Skeleton" desc="在内容加载时提供占位图形展示。">
874
- ## antd API
875
-
876
- 通用属性参考:[通用属性](/docs/react/common-props)
877
-
878
- ### Skeleton
879
-
880
- | 属性 | 说明 | 类型 | 默认值 |
881
- |--------|--------|--------|--------|
882
- | active | 是否展示动画效果 | boolean | false |
883
- | avatar | 是否显示头像占位图 | boolean \| | false |
884
- | loading | 为 true 时,显示占位图。反之则直接展示子组件 | boolean | - |
885
- | paragraph | 是否显示段落占位图 | boolean \| | true |
886
- | round | 为 true 时,段落和标题显示圆角 | boolean | false |
887
- | title | 是否显示标题占位图 | boolean \| | true |
888
-
889
-
890
- ### SkeletonAvatarProps
891
-
892
- | 属性 | 说明 | 类型 | 默认值 |
893
- |--------|--------|--------|--------|
894
- | active | 是否展示动画效果,仅在单独使用头像骨架时生效 | boolean | false |
895
- | shape | 指定头像的形状 | circle | - |
896
- | size | 设置头像占位图的大小 | number \| | - |
897
-
898
-
899
- ### SkeletonTitleProps
900
-
901
- | 属性 | 说明 | 类型 | 默认值 |
902
- |--------|--------|--------|--------|
903
- | width | 设置标题占位图的宽度 | number \| string | - |
904
-
905
-
906
- ### SkeletonParagraphProps
907
-
908
- | 属性 | 说明 | 类型 | 默认值 |
909
- |--------|--------|--------|--------|
910
- | rows | 设置段落占位图的行数 | number | - |
911
- | width | 设置段落占位图的宽度,若为数组时则为对应的每行宽度,反之则是最后一行的宽度 | number \| string \| Array | - |
912
-
913
-
914
- ### SkeletonButtonProps
915
-
916
- | 属性 | 说明 | 类型 | 默认值 | 版本 |
917
- |--------|--------|--------|--------|--------|
918
- | active | 是否展示动画效果 | boolean | false | |
919
- | block | 将按钮宽度调整为其父宽度的选项 | boolean | false | 4.17.0 |
920
- | shape | 指定按钮的形状 | circle | - | |
921
- | size | 设置按钮的大小 | large | - | |
922
-
923
-
924
- ### SkeletonInputProps
925
-
926
- | 属性 | 说明 | 类型 | 默认值 |
927
- |--------|--------|--------|--------|
928
- | active | 是否展示动画效果 | boolean | false |
929
- | size | 设置输入框的大小 | large | - |
930
-
931
-
932
-
933
-
934
873
  <DemoTitle title="Select" desc="下拉选择器">
935
874
  ## antd API
936
875
 
@@ -1029,6 +968,67 @@ TypeScript 里使用 Table 的 [CodeSandbox 实例](https://codesandbox.io/s/ser
1029
968
 
1030
969
 
1031
970
 
971
+ <DemoTitle title="Skeleton" desc="在内容加载时提供占位图形展示。">
972
+ ## antd API
973
+
974
+ 通用属性参考:[通用属性](/docs/react/common-props)
975
+
976
+ ### Skeleton
977
+
978
+ | 属性 | 说明 | 类型 | 默认值 |
979
+ |--------|--------|--------|--------|
980
+ | active | 是否展示动画效果 | boolean | false |
981
+ | avatar | 是否显示头像占位图 | boolean \| | false |
982
+ | loading | 为 true 时,显示占位图。反之则直接展示子组件 | boolean | - |
983
+ | paragraph | 是否显示段落占位图 | boolean \| | true |
984
+ | round | 为 true 时,段落和标题显示圆角 | boolean | false |
985
+ | title | 是否显示标题占位图 | boolean \| | true |
986
+
987
+
988
+ ### SkeletonAvatarProps
989
+
990
+ | 属性 | 说明 | 类型 | 默认值 |
991
+ |--------|--------|--------|--------|
992
+ | active | 是否展示动画效果,仅在单独使用头像骨架时生效 | boolean | false |
993
+ | shape | 指定头像的形状 | circle | - |
994
+ | size | 设置头像占位图的大小 | number \| | - |
995
+
996
+
997
+ ### SkeletonTitleProps
998
+
999
+ | 属性 | 说明 | 类型 | 默认值 |
1000
+ |--------|--------|--------|--------|
1001
+ | width | 设置标题占位图的宽度 | number \| string | - |
1002
+
1003
+
1004
+ ### SkeletonParagraphProps
1005
+
1006
+ | 属性 | 说明 | 类型 | 默认值 |
1007
+ |--------|--------|--------|--------|
1008
+ | rows | 设置段落占位图的行数 | number | - |
1009
+ | width | 设置段落占位图的宽度,若为数组时则为对应的每行宽度,反之则是最后一行的宽度 | number \| string \| Array | - |
1010
+
1011
+
1012
+ ### SkeletonButtonProps
1013
+
1014
+ | 属性 | 说明 | 类型 | 默认值 | 版本 |
1015
+ |--------|--------|--------|--------|--------|
1016
+ | active | 是否展示动画效果 | boolean | false | |
1017
+ | block | 将按钮宽度调整为其父宽度的选项 | boolean | false | 4.17.0 |
1018
+ | shape | 指定按钮的形状 | circle | - | |
1019
+ | size | 设置按钮的大小 | large | - | |
1020
+
1021
+
1022
+ ### SkeletonInputProps
1023
+
1024
+ | 属性 | 说明 | 类型 | 默认值 |
1025
+ |--------|--------|--------|--------|
1026
+ | active | 是否展示动画效果 | boolean | false |
1027
+ | size | 设置输入框的大小 | large | - |
1028
+
1029
+
1030
+
1031
+
1032
1032
  <DemoTitle title="Result" desc="为操作结果提供反馈信息的展示。">
1033
1033
  ## API
1034
1034
 
@@ -1201,42 +1201,86 @@ TypeScript 里使用 Table 的 [CodeSandbox 实例](https://codesandbox.io/s/ser
1201
1201
 
1202
1202
 
1203
1203
 
1204
- <DemoTitle title="Progress" desc="用于指示任务的完成进度">
1205
- ## antd API
1206
-
1207
- 通用属性参考:[通用属性](/docs/react/common-props)
1204
+ <DemoTitle title="Popover" desc="点击/鼠标移入元素,弹出气泡式的卡片浮层">
1205
+ #### API
1208
1206
 
1209
- 各类型共用的属性。
1207
+ <AntdApiRef url="https://ant.design/components/popover-cn/#api"></AntdApiRef>
1210
1208
 
1211
- | 属性 | 说明 | 类型 | 默认值 | 版本 |
1212
- |--------|--------|--------|--------|--------|
1213
- | format | 内容的模板函数 | function(percent, successPercent) | (percent) => percent + | - |
1214
- | percent | 百分比 | number | 0 | - |
1215
- | showInfo | 是否显示进度数值或状态图标 | boolean | true | - |
1216
- | status | 状态,可选: | string | - | - |
1217
- | strokeColor | 进度条的色彩 | string | - | - |
1218
- | strokeLinecap | 进度条的样式 | round | round | - |
1219
- | success | 成功进度条相关配置 | { percent: number, strokeColor: string } | - | - |
1220
- | trailColor | 未完成的分段的颜色 | string | - | - |
1221
- | type | 类型,可选 | string | line | - |
1222
- | size | 进度条的尺寸 | number \| [number \| string, number] \| { width: number, height: number } \| "small" \| "default" | "default" | 5.3.0, Object: 5.18.0 |
1223
1209
 
1210
+ ## antd API
1224
1211
 
1225
- ### `type="line"`
1212
+ 通用属性参考:[通用属性](/docs/react/common-props)
1226
1213
 
1227
- | 属性 | 说明 | 类型 | 默认值 | 版本 |
1214
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
1228
1215
  |--------|--------|--------|--------|--------|
1229
- | steps | 进度条总共步数 | number | - | - |
1230
- | rounding | 用于四舍五入数值的函数 | (step: number) => number | Math.round | 5.24.0 |
1231
- | strokeColor | 进度条的色彩,传入 object 时为渐变。当有 | string \| string[] \| { from: string; to: string; direction: string } | - | 4.21.0: |
1232
- | percentPosition | 进度数值位置,传入对象, | { align: string; type: string } | { align: "end", type: "outer" } | 5.18.0 |
1216
+ | content | 卡片内容 | ReactNode \| () => ReactNode | - | |
1217
+ | title | 卡片标题 | ReactNode \| () => ReactNode | - | |
1233
1218
 
1234
1219
 
1235
- ### `type="circle"`
1220
+ <!-- 共同的 API -->
1221
+ 以下 API 为 Tooltip、Popconfirm、Popover 共享的 API。
1236
1222
 
1237
- | 属性 | 说明 | 类型 | 默认值 | 版本 |
1223
+ <!-- prettier-ignore -->
1224
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
1238
1225
  |--------|--------|--------|--------|--------|
1239
- | steps | 进度条总共步数,传入 object 时,count 指步数,gap 指间隔大小。传 number 类型时,gap 默认为 2。 | number \| { count: number, gap: number } | - | 5.16.0 |
1226
+ | align | 该值将合并到 placement 的配置中,设置参考 | object | - | |
1227
+ | arrow | 修改箭头的显示状态以及修改箭头是否指向目标元素中心 | boolean \| { pointAtCenter: boolean } | true | 5.2.0 |
1228
+ | autoAdjustOverflow | 气泡被遮挡时自动调整位置 | boolean | true | |
1229
+ | color | 背景颜色 | string | - | 4.3.0 |
1230
+ | defaultOpen | 默认是否显隐 | boolean | false | 4.23.0 |
1231
+ | destroyOnHidden | 关闭后是否销毁 dom | boolean | false | 5.25.0 |
1232
+ | fresh | 默认情况下,Tooltip 在关闭时会缓存内容。设置该属性后会始终保持更新 | boolean | false | 5.10.0 |
1233
+ | getPopupContainer | 浮层渲染父节点,默认渲染到 body 上 | (triggerNode: HTMLElement) => HTMLElement | () => document.body | |
1234
+ | mouseEnterDelay | 鼠标移入后延时多少才显示 Tooltip,单位:秒 | number | 0.1 | |
1235
+ | mouseLeaveDelay | 鼠标移出后延时多少才隐藏 Tooltip,单位:秒 | number | 0.1 | |
1236
+ | placement | 气泡框位置,可选 | string | top | |
1237
+ | trigger | 触发行为,可选 | string \| string[] | hover | |
1238
+ | open | 用于手动控制浮层显隐,小于 4.23.0 使用 | boolean | false | 4.23.0 |
1239
+ | zIndex | 设置 Tooltip 的 | number | - | |
1240
+ | onOpenChange | 显示隐藏的回调 | (open: boolean) => void | - | 4.23.0 |
1241
+
1242
+ ## 注意
1243
+
1244
+ 请确保 `Popover` 的子元素能接受 `onMouseEnter`、`onMouseLeave`、`onFocus`、`onClick` 事件。
1245
+
1246
+
1247
+
1248
+ <DemoTitle title="Progress" desc="用于指示任务的完成进度">
1249
+ ## antd API
1250
+
1251
+ 通用属性参考:[通用属性](/docs/react/common-props)
1252
+
1253
+ 各类型共用的属性。
1254
+
1255
+ | 属性 | 说明 | 类型 | 默认值 | 版本 |
1256
+ |--------|--------|--------|--------|--------|
1257
+ | format | 内容的模板函数 | function(percent, successPercent) | (percent) => percent + | - |
1258
+ | percent | 百分比 | number | 0 | - |
1259
+ | showInfo | 是否显示进度数值或状态图标 | boolean | true | - |
1260
+ | status | 状态,可选: | string | - | - |
1261
+ | strokeColor | 进度条的色彩 | string | - | - |
1262
+ | strokeLinecap | 进度条的样式 | round | round | - |
1263
+ | success | 成功进度条相关配置 | { percent: number, strokeColor: string } | - | - |
1264
+ | trailColor | 未完成的分段的颜色 | string | - | - |
1265
+ | type | 类型,可选 | string | line | - |
1266
+ | size | 进度条的尺寸 | number \| [number \| string, number] \| { width: number, height: number } \| "small" \| "default" | "default" | 5.3.0, Object: 5.18.0 |
1267
+
1268
+
1269
+ ### `type="line"`
1270
+
1271
+ | 属性 | 说明 | 类型 | 默认值 | 版本 |
1272
+ |--------|--------|--------|--------|--------|
1273
+ | steps | 进度条总共步数 | number | - | - |
1274
+ | rounding | 用于四舍五入数值的函数 | (step: number) => number | Math.round | 5.24.0 |
1275
+ | strokeColor | 进度条的色彩,传入 object 时为渐变。当有 | string \| string[] \| { from: string; to: string; direction: string } | - | 4.21.0: |
1276
+ | percentPosition | 进度数值位置,传入对象, | { align: string; type: string } | { align: "end", type: "outer" } | 5.18.0 |
1277
+
1278
+
1279
+ ### `type="circle"`
1280
+
1281
+ | 属性 | 说明 | 类型 | 默认值 | 版本 |
1282
+ |--------|--------|--------|--------|--------|
1283
+ | steps | 进度条总共步数,传入 object 时,count 指步数,gap 指间隔大小。传 number 类型时,gap 默认为 2。 | number \| { count: number, gap: number } | - | 5.16.0 |
1240
1284
  | strokeColor | 圆形进度条线的色彩,传入 object 时为渐变 | string \| { number%: string } | - | - |
1241
1285
  | strokeWidth | 圆形进度条线的宽度,单位是进度条画布宽度的百分比 | number | 6 | - |
1242
1286
 
@@ -1310,50 +1354,6 @@ TypeScript 里使用 Table 的 [CodeSandbox 实例](https://codesandbox.io/s/ser
1310
1354
 
1311
1355
 
1312
1356
 
1313
- <DemoTitle title="Popover" desc="点击/鼠标移入元素,弹出气泡式的卡片浮层">
1314
- #### API
1315
-
1316
- <AntdApiRef url="https://ant.design/components/popover-cn/#api"></AntdApiRef>
1317
-
1318
-
1319
- ## antd API
1320
-
1321
- 通用属性参考:[通用属性](/docs/react/common-props)
1322
-
1323
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
1324
- |--------|--------|--------|--------|--------|
1325
- | content | 卡片内容 | ReactNode \| () => ReactNode | - | |
1326
- | title | 卡片标题 | ReactNode \| () => ReactNode | - | |
1327
-
1328
-
1329
- <!-- 共同的 API -->
1330
- 以下 API 为 Tooltip、Popconfirm、Popover 共享的 API。
1331
-
1332
- <!-- prettier-ignore -->
1333
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
1334
- |--------|--------|--------|--------|--------|
1335
- | align | 该值将合并到 placement 的配置中,设置参考 | object | - | |
1336
- | arrow | 修改箭头的显示状态以及修改箭头是否指向目标元素中心 | boolean \| { pointAtCenter: boolean } | true | 5.2.0 |
1337
- | autoAdjustOverflow | 气泡被遮挡时自动调整位置 | boolean | true | |
1338
- | color | 背景颜色 | string | - | 4.3.0 |
1339
- | defaultOpen | 默认是否显隐 | boolean | false | 4.23.0 |
1340
- | destroyOnHidden | 关闭后是否销毁 dom | boolean | false | 5.25.0 |
1341
- | fresh | 默认情况下,Tooltip 在关闭时会缓存内容。设置该属性后会始终保持更新 | boolean | false | 5.10.0 |
1342
- | getPopupContainer | 浮层渲染父节点,默认渲染到 body 上 | (triggerNode: HTMLElement) => HTMLElement | () => document.body | |
1343
- | mouseEnterDelay | 鼠标移入后延时多少才显示 Tooltip,单位:秒 | number | 0.1 | |
1344
- | mouseLeaveDelay | 鼠标移出后延时多少才隐藏 Tooltip,单位:秒 | number | 0.1 | |
1345
- | placement | 气泡框位置,可选 | string | top | |
1346
- | trigger | 触发行为,可选 | string \| string[] | hover | |
1347
- | open | 用于手动控制浮层显隐,小于 4.23.0 使用 | boolean | false | 4.23.0 |
1348
- | zIndex | 设置 Tooltip 的 | number | - | |
1349
- | onOpenChange | 显示隐藏的回调 | (open: boolean) => void | - | 4.23.0 |
1350
-
1351
- ## 注意
1352
-
1353
- 请确保 `Popover` 的子元素能接受 `onMouseEnter`、`onMouseLeave`、`onFocus`、`onClick` 事件。
1354
-
1355
-
1356
-
1357
1357
  <DemoTitle title="Pagination" desc="分页器用于分隔长列表,每次只加载一个页面。">
1358
1358
  ## API
1359
1359
 
@@ -2168,6 +2168,59 @@ type PresetColors = 'blue' | 'purple' | 'cyan' | 'green' | 'magenta' | 'pink' |
2168
2168
 
2169
2169
 
2170
2170
 
2171
+ <DemoTitle title="FloatButton" desc="用于网站上的全局功能;无论浏览到何处都可以看见的按钮。">
2172
+ #### API
2173
+
2174
+ <AntdApiRef url="https://ant.design/components/float-button-cn/#api"></AntdApiRef>
2175
+
2176
+
2177
+ ## antd API
2178
+
2179
+ 通用属性参考:[通用属性](/docs/react/common-props)
2180
+
2181
+ 自 `antd@5.0.0` 版本开始提供该组件。
2182
+
2183
+ ### 共同的 API
2184
+
2185
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
2186
+ |--------|--------|--------|--------|--------|
2187
+ | icon | 自定义图标 | ReactNode | - | |
2188
+ | description | 文字及其它内容 | ReactNode | - | |
2189
+ | tooltip | 气泡卡片的内容 | ReactNode \| | - | TooltipProps: 5.25.0 |
2190
+ | type | 设置按钮类型 | default | default | |
2191
+ | shape | 设置按钮形状 | circle | circle | |
2192
+ | onClick | 点击按钮时的回调 | (event) => void | - | |
2193
+ | href | 点击跳转的地址,指定此属性 button 的行为和 a 链接一致 | string | - | |
2194
+ | target | 相当于 a 标签的 target 属性,href 存在时生效 | string | - | |
2195
+ | htmlType | 设置 | submit | button | 5.21.0 |
2196
+ | badge | 带徽标数字的悬浮按钮(不支持 | | - | 5.4.0 |
2197
+
2198
+
2199
+ ### FloatButton.Group
2200
+
2201
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
2202
+ |--------|--------|--------|--------|--------|
2203
+ | shape | 设置包含的 FloatButton 按钮形状 | circle | circle | |
2204
+ | trigger | 触发方式(有触发方式为菜单模式) | click | - | |
2205
+ | open | 受控展开,需配合 trigger 一起使用 | boolean | - | |
2206
+ | closeIcon | 自定义关闭按钮 | React.ReactNode | | |
2207
+ | placement | 自定义菜单弹出位置 | top | top | 5.21.0 |
2208
+ | onOpenChange | 展开收起时的回调,需配合 trigger 一起使用 | (open: boolean) => void | - | |
2209
+ | onClick | 点击按钮时的回调(仅在菜单模式中有效) | (event) => void | - | 5.3.0 |
2210
+
2211
+
2212
+ ### FloatButton.BackTop
2213
+
2214
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
2215
+ |--------|--------|--------|--------|--------|
2216
+ | duration | 回到顶部所需时间(ms) | number | 450 | |
2217
+ | target | 设置需要监听其滚动事件的元素 | () => HTMLElement | () => window | |
2218
+ | visibilityHeight | 滚动高度达到此参数值才出现 BackTop | number | 400 | |
2219
+ | onClick | 点击按钮的回调函数 | () => void | - | |
2220
+
2221
+
2222
+
2223
+
2171
2224
  <DemoTitle title="Form" desc="高性能表单控件,自带数据域管理。包含数据录入、校验以及对应样式。">
2172
2225
  #### API
2173
2226
 
@@ -2728,59 +2781,6 @@ type Rule = RuleConfig | ((form: FormInstance) => RuleConfig);
2728
2781
 
2729
2782
 
2730
2783
 
2731
- <DemoTitle title="FloatButton" desc="用于网站上的全局功能;无论浏览到何处都可以看见的按钮。">
2732
- #### API
2733
-
2734
- <AntdApiRef url="https://ant.design/components/float-button-cn/#api"></AntdApiRef>
2735
-
2736
-
2737
- ## antd API
2738
-
2739
- 通用属性参考:[通用属性](/docs/react/common-props)
2740
-
2741
- 自 `antd@5.0.0` 版本开始提供该组件。
2742
-
2743
- ### 共同的 API
2744
-
2745
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
2746
- |--------|--------|--------|--------|--------|
2747
- | icon | 自定义图标 | ReactNode | - | |
2748
- | description | 文字及其它内容 | ReactNode | - | |
2749
- | tooltip | 气泡卡片的内容 | ReactNode \| | - | TooltipProps: 5.25.0 |
2750
- | type | 设置按钮类型 | default | default | |
2751
- | shape | 设置按钮形状 | circle | circle | |
2752
- | onClick | 点击按钮时的回调 | (event) => void | - | |
2753
- | href | 点击跳转的地址,指定此属性 button 的行为和 a 链接一致 | string | - | |
2754
- | target | 相当于 a 标签的 target 属性,href 存在时生效 | string | - | |
2755
- | htmlType | 设置 | submit | button | 5.21.0 |
2756
- | badge | 带徽标数字的悬浮按钮(不支持 | | - | 5.4.0 |
2757
-
2758
-
2759
- ### FloatButton.Group
2760
-
2761
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
2762
- |--------|--------|--------|--------|--------|
2763
- | shape | 设置包含的 FloatButton 按钮形状 | circle | circle | |
2764
- | trigger | 触发方式(有触发方式为菜单模式) | click | - | |
2765
- | open | 受控展开,需配合 trigger 一起使用 | boolean | - | |
2766
- | closeIcon | 自定义关闭按钮 | React.ReactNode | | |
2767
- | placement | 自定义菜单弹出位置 | top | top | 5.21.0 |
2768
- | onOpenChange | 展开收起时的回调,需配合 trigger 一起使用 | (open: boolean) => void | - | |
2769
- | onClick | 点击按钮时的回调(仅在菜单模式中有效) | (event) => void | - | 5.3.0 |
2770
-
2771
-
2772
- ### FloatButton.BackTop
2773
-
2774
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
2775
- |--------|--------|--------|--------|--------|
2776
- | duration | 回到顶部所需时间(ms) | number | 450 | |
2777
- | target | 设置需要监听其滚动事件的元素 | () => HTMLElement | () => window | |
2778
- | visibilityHeight | 滚动高度达到此参数值才出现 BackTop | number | 400 | |
2779
- | onClick | 点击按钮的回调函数 | () => void | - | |
2780
-
2781
-
2782
-
2783
-
2784
2784
  <DemoTitle title="Empty" desc="用于空状态的占位图形展示。">
2785
2785
  ## API
2786
2786
 
@@ -3077,77 +3077,6 @@ span 是 Description.Item 的数量。 span={2} 会占用两个 DescriptionItem
3077
3077
 
3078
3078
 
3079
3079
 
3080
- <DemoTitle title="CollapsePanel" desc="折叠面板">
3081
- #### API
3082
-
3083
- | 属性名 | 描述 | 类型 | 默认值 |
3084
- |--------|--------|--------|--------|
3085
- | collapsedHeight | 收起状态下显示的内容高度 | number | 0 |
3086
- | expandedHeight | 展开状态下的内容高度,设置后内容超出时可滚动,不设置则自适应内容高度 | number | 300 |
3087
- | title | 面板标题 | string \| React.ReactNode | "" |
3088
- | expandOnPanelClick | 是否允许点击整个面板进行展开 | boolean | false |
3089
- | extra | 面板右侧内容 | React.ReactNode | |
3090
- | children | 面板内容 | React.ReactNode | |
3091
- | defaultExpanded | 是否默认展开 | boolean | false |
3092
- | classNames | 语义化的classNames | Partial> | |
3093
- | styles | 语义化的styles | Partial<
3094
- Record
3095
- > | |
3096
-
3097
-
3098
-
3099
- ## antd API
3100
-
3101
- 通用属性参考:[通用属性](/docs/react/common-props)
3102
-
3103
- ### Collapse
3104
-
3105
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
3106
- |--------|--------|--------|--------|--------|
3107
- | accordion | 手风琴模式 | boolean | false | |
3108
- | activeKey | 当前激活 tab 面板的 key | string[] \| string | | |
3109
- | bordered | 带边框风格的折叠面板 | boolean | true | |
3110
- | collapsible | 所有子面板是否可折叠或指定可折叠触发区域 | header | - | 4.9.0 |
3111
- | defaultActiveKey | 初始化选中面板的 key | string[] \| string | - | |
3112
- | destroyOnHidden | 销毁折叠隐藏的面板 | boolean | false | 5.25.0 |
3113
- | expandIcon | 自定义切换图标 | (panelProps) => ReactNode | - | |
3114
- | expandIconPosition | 设置图标位置 | start | - | 4.21.0 |
3115
- | ghost | 使折叠面板透明且无边框 | boolean | false | 4.4.0 |
3116
- | size | 设置折叠面板大小 | large | middle | 5.2.0 |
3117
- | onChange | 切换面板的回调 | function | - | |
3118
- | items | 折叠项目内容 | | - | 5.6.0 |
3119
-
3120
-
3121
- ### ItemType
3122
-
3123
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
3124
- |--------|--------|--------|--------|--------|
3125
- | classNames | 语义化结构 className | | - | 5.21.0 |
3126
- | collapsible | 是否可折叠或指定可折叠触发区域 | header | - | |
3127
- | forceRender | 被隐藏时是否渲染 body 区域 DOM 结构 | boolean | false | |
3128
- | key | 对应 activeKey | string \| number | - | |
3129
- | label | 面板标题 | ReactNode | - | - |
3130
- | showArrow | 是否展示当前面板上的箭头(为 false 时,collapsible 不能设为 icon) | boolean | true | |
3131
- | styles | 语义化结构 style | | - | 5.21.0 |
3132
-
3133
-
3134
- ### Collapse.Panel
3135
-
3136
- <!-- prettier-ignore -->
3137
- <Container type="warning" title="已废弃">
3138
- 版本 >= 5.6.0 时请使用 items 方式配置面板。
3139
- </Container>
3140
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
3141
- |--------|--------|--------|--------|--------|
3142
- | collapsible | 是否可折叠或指定可折叠触发区域 | header | - | 4.9.0 (icon: 4.24.0) |
3143
- | forceRender | 被隐藏时是否渲染 body 区域 DOM 结构 | boolean | false | |
3144
- | header | 面板标题 | ReactNode | - | |
3145
- | key | 对应 activeKey | string \| number | - | |
3146
- | showArrow | 是否展示当前面板上的箭头(为 false 时,collapsible 不能设为 icon) | boolean | true | |
3147
-
3148
-
3149
-
3150
-
3151
3080
  <DemoTitle title="DatePicker" desc="输入或选择时间的控件。">
3152
3081
  #### API
3153
3082
 
@@ -3370,6 +3299,77 @@ export type FormatType =
3370
3299
 
3371
3300
 
3372
3301
 
3302
+ <DemoTitle title="CollapsePanel" desc="折叠面板">
3303
+ #### API
3304
+
3305
+ | 属性名 | 描述 | 类型 | 默认值 |
3306
+ |--------|--------|--------|--------|
3307
+ | collapsedHeight | 收起状态下显示的内容高度 | number | 0 |
3308
+ | expandedHeight | 展开状态下的内容高度,设置后内容超出时可滚动,不设置则自适应内容高度 | number | 300 |
3309
+ | title | 面板标题 | string \| React.ReactNode | "" |
3310
+ | expandOnPanelClick | 是否允许点击整个面板进行展开 | boolean | false |
3311
+ | extra | 面板右侧内容 | React.ReactNode | |
3312
+ | children | 面板内容 | React.ReactNode | |
3313
+ | defaultExpanded | 是否默认展开 | boolean | false |
3314
+ | classNames | 语义化的classNames | Partial> | |
3315
+ | styles | 语义化的styles | Partial<
3316
+ Record
3317
+ > | |
3318
+
3319
+
3320
+
3321
+ ## antd API
3322
+
3323
+ 通用属性参考:[通用属性](/docs/react/common-props)
3324
+
3325
+ ### Collapse
3326
+
3327
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
3328
+ |--------|--------|--------|--------|--------|
3329
+ | accordion | 手风琴模式 | boolean | false | |
3330
+ | activeKey | 当前激活 tab 面板的 key | string[] \| string | | |
3331
+ | bordered | 带边框风格的折叠面板 | boolean | true | |
3332
+ | collapsible | 所有子面板是否可折叠或指定可折叠触发区域 | header | - | 4.9.0 |
3333
+ | defaultActiveKey | 初始化选中面板的 key | string[] \| string | - | |
3334
+ | destroyOnHidden | 销毁折叠隐藏的面板 | boolean | false | 5.25.0 |
3335
+ | expandIcon | 自定义切换图标 | (panelProps) => ReactNode | - | |
3336
+ | expandIconPosition | 设置图标位置 | start | - | 4.21.0 |
3337
+ | ghost | 使折叠面板透明且无边框 | boolean | false | 4.4.0 |
3338
+ | size | 设置折叠面板大小 | large | middle | 5.2.0 |
3339
+ | onChange | 切换面板的回调 | function | - | |
3340
+ | items | 折叠项目内容 | | - | 5.6.0 |
3341
+
3342
+
3343
+ ### ItemType
3344
+
3345
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
3346
+ |--------|--------|--------|--------|--------|
3347
+ | classNames | 语义化结构 className | | - | 5.21.0 |
3348
+ | collapsible | 是否可折叠或指定可折叠触发区域 | header | - | |
3349
+ | forceRender | 被隐藏时是否渲染 body 区域 DOM 结构 | boolean | false | |
3350
+ | key | 对应 activeKey | string \| number | - | |
3351
+ | label | 面板标题 | ReactNode | - | - |
3352
+ | showArrow | 是否展示当前面板上的箭头(为 false 时,collapsible 不能设为 icon) | boolean | true | |
3353
+ | styles | 语义化结构 style | | - | 5.21.0 |
3354
+
3355
+
3356
+ ### Collapse.Panel
3357
+
3358
+ <!-- prettier-ignore -->
3359
+ <Container type="warning" title="已废弃">
3360
+ 版本 >= 5.6.0 时请使用 items 方式配置面板。
3361
+ </Container>
3362
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
3363
+ |--------|--------|--------|--------|--------|
3364
+ | collapsible | 是否可折叠或指定可折叠触发区域 | header | - | 4.9.0 (icon: 4.24.0) |
3365
+ | forceRender | 被隐藏时是否渲染 body 区域 DOM 结构 | boolean | false | |
3366
+ | header | 面板标题 | ReactNode | - | |
3367
+ | key | 对应 activeKey | string \| number | - | |
3368
+ | showArrow | 是否展示当前面板上的箭头(为 false 时,collapsible 不能设为 icon) | boolean | true | |
3369
+
3370
+
3371
+
3372
+
3373
3373
  <DemoTitle title="Collapse" desc="可以折叠/展开的内容区域">
3374
3374
  #### API
3375
3375
 
@@ -3489,75 +3489,20 @@ export type FormatType =
3489
3489
  | 参数 | 说明 | 类型 | 默认值 | 版本 |
3490
3490
  |--------|--------|--------|--------|--------|
3491
3491
  | className | 网格容器类名 | string | - | |
3492
- | hoverable | 鼠标移过时可浮起 | boolean | true | |
3493
- | style | 定义网格容器类名的样式 | CSSProperties | - | |
3494
-
3495
-
3496
- ### Card.Meta
3497
-
3498
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
3499
- |--------|--------|--------|--------|--------|
3500
- | avatar | 头像/图标 | ReactNode | - | |
3501
- | className | 容器类名 | string | - | |
3502
- | description | 描述内容 | ReactNode | - | |
3503
- | style | 定义容器类名的样式 | CSSProperties | - | |
3504
- | title | 标题内容 | ReactNode | - | |
3505
-
3506
-
3507
-
3508
-
3509
- <DemoTitle title="Button" desc="按钮用于开始一个即时操作。">
3510
- #### API
3511
-
3512
- | 属性名 | 描述 | 类型 | 默认值 |
3513
- |--------|--------|--------|--------|
3514
- | size | 按钮大小 | 'small' \| 'middle' \| 'large' | 'middle' |
3515
- | type | 类型 | \| 'primary'
3516
- \| 'dashed'
3517
- \| 'link'
3518
- \| 'text'
3519
- \| 'default'
3520
- \| 'primaryLess'
3521
- \| 'textCompact' | 'deafult' |
3522
- | tooltipContent | hover上去tooltip的内容 | string \| ReactNode | |
3523
- | iconType | 百炼图标iconfont的key,依赖ConfigProvider传入的iconfont,例如bl-icon-add | string | |
3524
- | iconSize | 图标大小 | SparkIconFontProps['size'] | |
3525
-
3526
- <AntdApiRef url="https://ant.design/components/button-cn/#api"></AntdApiRef>
3527
-
3528
-
3529
- ## antd API
3530
-
3531
- 通用属性参考:[通用属性](/docs/react/common-props)
3532
-
3533
- 通过设置 Button 的属性来产生不同的按钮样式,推荐顺序为:`type` -> `shape` -> `size` -> `loading` -> `disabled`。
3534
-
3535
- 按钮的属性说明如下:
3536
-
3537
- | 属性 | 说明 | 类型 | 默认值 | 版本 |
3538
- |--------|--------|--------|--------|--------|
3539
- | autoInsertSpace | 我们默认提供两个汉字之间的空格,可以设置 | boolean | true | 5.17.0 |
3540
- | block | 将按钮宽度调整为其父宽度的选项 | boolean | false | |
3541
- | classNames | 语义化结构 class | | - | 5.4.0 |
3542
- | color | 设置按钮的颜色 | default | - | default |
3543
- | danger | 语法糖,设置危险按钮。当设置 | boolean | false | |
3544
- | disabled | 设置按钮失效状态 | boolean | false | |
3545
- | ghost | 幽灵属性,使按钮背景透明 | boolean | false | |
3546
- | href | 点击跳转的地址,指定此属性 button 的行为和 a 链接一致 | string | - | |
3547
- | htmlType | 设置 | submit | button | |
3548
- | iconPosition | 设置按钮图标组件的位置 | start | start | 5.17.0 |
3549
- | loading | 设置按钮载入状态 | boolean \| { delay: number, icon: ReactNode } | false | icon: 5.23.0 |
3550
- | styles | 语义化结构 style | | - | 5.4.0 |
3551
- | target | 相当于 a 链接的 target 属性,href 存在时生效 | string | - | |
3552
- | onClick | 点击按钮时的回调 | (event: React.MouseEvent) => void | - | |
3553
- | variant | 设置按钮的变体 | outlined | - | 5.21.0 |
3492
+ | hoverable | 鼠标移过时可浮起 | boolean | true | |
3493
+ | style | 定义网格容器类名的样式 | CSSProperties | - | |
3554
3494
 
3555
3495
 
3556
- 支持原生 button 的其他所有属性。
3496
+ ### Card.Meta
3557
3497
 
3558
- ### PresetColors
3498
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
3499
+ |--------|--------|--------|--------|--------|
3500
+ | avatar | 头像/图标 | ReactNode | - | |
3501
+ | className | 容器类名 | string | - | |
3502
+ | description | 描述内容 | ReactNode | - | |
3503
+ | style | 定义容器类名的样式 | CSSProperties | - | |
3504
+ | title | 标题内容 | ReactNode | - | |
3559
3505
 
3560
- type PresetColors = 'blue' | 'purple' | 'cyan' | 'green' | 'magenta' | 'pink' | 'red' | 'orange' | 'yellow' | 'volcano' | 'geekblue' | 'lime' | 'gold';
3561
3506
 
3562
3507
 
3563
3508
 
@@ -3632,42 +3577,58 @@ interface Option {
3632
3577
 
3633
3578
 
3634
3579
 
3635
- <DemoTitle title="Avatar" desc="用来代表用户或事物,支持图片、图标或字符展示。">
3580
+ <DemoTitle title="Button" desc="按钮用于开始一个即时操作。">
3636
3581
  #### API
3637
3582
 
3638
- <AntdApiRef url="https://ant.design/components/avatar-cn/#api"></AntdApiRef>
3583
+ | 属性名 | 描述 | 类型 | 默认值 |
3584
+ |--------|--------|--------|--------|
3585
+ | size | 按钮大小 | 'small' \| 'middle' \| 'large' | 'middle' |
3586
+ | type | 类型 | \| 'primary'
3587
+ \| 'dashed'
3588
+ \| 'link'
3589
+ \| 'text'
3590
+ \| 'default'
3591
+ \| 'primaryLess'
3592
+ \| 'textCompact' | 'deafult' |
3593
+ | tooltipContent | hover上去tooltip的内容 | string \| ReactNode | |
3594
+ | iconType | 百炼图标iconfont的key,依赖ConfigProvider传入的iconfont,例如bl-icon-add | string | |
3595
+ | iconSize | 图标大小 | SparkIconFontProps['size'] | |
3596
+
3597
+ <AntdApiRef url="https://ant.design/components/button-cn/#api"></AntdApiRef>
3639
3598
 
3640
3599
 
3641
3600
  ## antd API
3642
3601
 
3643
3602
  通用属性参考:[通用属性](/docs/react/common-props)
3644
3603
 
3645
- ### Avatar
3604
+ 通过设置 Button 的属性来产生不同的按钮样式,推荐顺序为:`type` -> `shape` -> `size` -> `loading` -> `disabled`。
3646
3605
 
3647
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
3648
- |--------|--------|--------|--------|--------|
3649
- | alt | 图像无法显示时的替代文本 | string | - | |
3650
- | gap | 字符类型距离左右两侧边界单位像素 | number | 4 | 4.3.0 |
3651
- | icon | 设置头像的自定义图标 | ReactNode | - | |
3652
- | shape | 指定头像的形状 | circle | circle | |
3653
- | size | 设置头像的大小 | number \| | default | 4.7.0 |
3654
- | src | 图片类头像的资源地址或者图片元素 | string \| ReactNode | - | ReactNode: 4.8.0 |
3655
- | srcSet | 设置图片类头像响应式资源地址 | string | - | |
3656
- | draggable | 图片是否允许拖动 | boolean \| | true | |
3657
- | crossOrigin | CORS 属性设置 | 'anonymous' | - | 4.17.0 |
3658
- | onError | 图片加载失败的事件,返回 false 会关闭组件默认的 fallback 行为 | () => boolean | - | |
3606
+ 按钮的属性说明如下:
3659
3607
 
3608
+ | 属性 | 说明 | 类型 | 默认值 | 版本 |
3609
+ |--------|--------|--------|--------|--------|
3610
+ | autoInsertSpace | 我们默认提供两个汉字之间的空格,可以设置 | boolean | true | 5.17.0 |
3611
+ | block | 将按钮宽度调整为其父宽度的选项 | boolean | false | |
3612
+ | classNames | 语义化结构 class | | - | 5.4.0 |
3613
+ | color | 设置按钮的颜色 | default | - | default |
3614
+ | danger | 语法糖,设置危险按钮。当设置 | boolean | false | |
3615
+ | disabled | 设置按钮失效状态 | boolean | false | |
3616
+ | ghost | 幽灵属性,使按钮背景透明 | boolean | false | |
3617
+ | href | 点击跳转的地址,指定此属性 button 的行为和 a 链接一致 | string | - | |
3618
+ | htmlType | 设置 | submit | button | |
3619
+ | iconPosition | 设置按钮图标组件的位置 | start | start | 5.17.0 |
3620
+ | loading | 设置按钮载入状态 | boolean \| { delay: number, icon: ReactNode } | false | icon: 5.23.0 |
3621
+ | styles | 语义化结构 style | | - | 5.4.0 |
3622
+ | target | 相当于 a 链接的 target 属性,href 存在时生效 | string | - | |
3623
+ | onClick | 点击按钮时的回调 | (event: React.MouseEvent) => void | - | |
3624
+ | variant | 设置按钮的变体 | outlined | - | 5.21.0 |
3660
3625
 
3661
- Tip:你可以设置 `icon` 或 `children` 作为图片加载失败的默认 fallback 行为,优先级为 `icon` > `children`
3662
3626
 
3663
- ### Avatar.Group <Badge>4.5.0+</Badge>
3627
+ 支持原生 button 的其他所有属性。
3664
3628
 
3665
- | 参数 | 说明 | 类型 | 默认值 | 版本 |
3666
- |--------|--------|--------|--------|--------|
3667
- | max | 设置最多显示相关配置, | { count?: number; style?: CSSProperties; popover?: PopoverProps } | - | 5.18.0 |
3668
- | size | 设置头像的大小 | number \| | default | 4.8.0 |
3669
- | shape | 设置头像的形状 | circle | circle | 5.8.0 |
3629
+ ### PresetColors
3670
3630
 
3631
+ type PresetColors = 'blue' | 'purple' | 'cyan' | 'green' | 'magenta' | 'pink' | 'red' | 'orange' | 'yellow' | 'volcano' | 'geekblue' | 'lime' | 'gold';
3671
3632
 
3672
3633
 
3673
3634
 
@@ -3790,6 +3751,45 @@ return <Breadcrumb itemRender={itemRender} items={items} />;
3790
3751
 
3791
3752
 
3792
3753
 
3754
+ <DemoTitle title="Avatar" desc="用来代表用户或事物,支持图片、图标或字符展示。">
3755
+ #### API
3756
+
3757
+ <AntdApiRef url="https://ant.design/components/avatar-cn/#api"></AntdApiRef>
3758
+
3759
+
3760
+ ## antd API
3761
+
3762
+ 通用属性参考:[通用属性](/docs/react/common-props)
3763
+
3764
+ ### Avatar
3765
+
3766
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
3767
+ |--------|--------|--------|--------|--------|
3768
+ | alt | 图像无法显示时的替代文本 | string | - | |
3769
+ | gap | 字符类型距离左右两侧边界单位像素 | number | 4 | 4.3.0 |
3770
+ | icon | 设置头像的自定义图标 | ReactNode | - | |
3771
+ | shape | 指定头像的形状 | circle | circle | |
3772
+ | size | 设置头像的大小 | number \| | default | 4.7.0 |
3773
+ | src | 图片类头像的资源地址或者图片元素 | string \| ReactNode | - | ReactNode: 4.8.0 |
3774
+ | srcSet | 设置图片类头像响应式资源地址 | string | - | |
3775
+ | draggable | 图片是否允许拖动 | boolean \| | true | |
3776
+ | crossOrigin | CORS 属性设置 | 'anonymous' | - | 4.17.0 |
3777
+ | onError | 图片加载失败的事件,返回 false 会关闭组件默认的 fallback 行为 | () => boolean | - | |
3778
+
3779
+
3780
+ Tip:你可以设置 `icon` 或 `children` 作为图片加载失败的默认 fallback 行为,优先级为 `icon` > `children`
3781
+
3782
+ ### Avatar.Group <Badge>4.5.0+</Badge>
3783
+
3784
+ | 参数 | 说明 | 类型 | 默认值 | 版本 |
3785
+ |--------|--------|--------|--------|--------|
3786
+ | max | 设置最多显示相关配置, | { count?: number; style?: CSSProperties; popover?: PopoverProps } | - | 5.18.0 |
3787
+ | size | 设置头像的大小 | number \| | default | 4.8.0 |
3788
+ | shape | 设置头像的形状 | circle | circle | 5.8.0 |
3789
+
3790
+
3791
+
3792
+
3793
3793
  <DemoTitle title="Audio" desc="音频展示">
3794
3794
  #### API
3795
3795
 
@@ -4175,27 +4175,72 @@ npm install antd @agentscope-ai/icons @agentscope-ai/design --save
4175
4175
 
4176
4176
  # 使用
4177
4177
 
4178
+ 如果您有自己的 iconfont 项目,可以将您的图标集成到 Spark Design 中,并通过简单的符号名称访问您的图标。
4178
4179
 
4179
4180
 
4180
4181
  ```tsx
4181
- import { SparkLoadingLine } from '@agentscope-ai/icons';
4182
+ import {
4183
+ ConfigProvider,
4184
+ purpleTheme,
4185
+ Button,
4186
+ IconFont,
4187
+ IconButton,
4188
+ } from '@agentscope-ai/design';
4189
+ import { Flex } from 'antd';
4190
+ import zhCN from 'antd/locale/zh_CN';
4191
+ import { useState } from 'react';
4182
4192
 
4183
- export default () => {
4193
+ const App = () => {
4194
+ const prefix = 'sps';
4195
+ const iconSymbol = 'spark-effciency-line';
4196
+ const iconfont = '//at.alicdn.com/t/a/font_4807885_ugexdeaoq7.js'; // 您可以从 https://www.iconfont.cn/ 获取
4184
4197
  return (
4185
- <SparkLoadingLine
4186
- className="your-class-name"
4187
- style={{ color: 'var(--sps-color-primary)' }}
4188
- spin
4189
- size={48}
4190
- />
4198
+ <ConfigProvider
4199
+ {...purpleTheme}
4200
+ prefix={prefix}
4201
+ prefixCls={prefix}
4202
+ iconfont={iconfont}
4203
+ locale={zhCN}
4204
+ style={{
4205
+ width: '100%',
4206
+ height: '100%',
4207
+ }}
4208
+ >
4209
+ <Flex
4210
+ style={{
4211
+ width: '100%',
4212
+ height: '100%',
4213
+ backgroundColor: `var(--${prefix}-color-bg-base)`,
4214
+ }}
4215
+ justify="center"
4216
+ align="center"
4217
+ >
4218
+ <Flex vertical gap={16} style={{ width: '300px', padding: '12px 0' }}>
4219
+ <Flex gap={8}>
4220
+ <div style={{ width: '100px', lineHeight: '32px' }}>IconFont:</div>
4221
+ <IconFont type={iconSymbol} />
4222
+ </Flex>
4223
+ <Flex gap={8}>
4224
+ <div style={{ width: '100px', lineHeight: '32px' }}>Button:</div>
4225
+ <Button type="primary" iconType={iconSymbol}>
4226
+ 添加用户
4227
+ </Button>
4228
+ </Flex>
4229
+ <Flex gap={8}>
4230
+ <div style={{ width: '100px', lineHeight: '32px' }}>
4231
+ IconButton:
4232
+ </div>
4233
+ <IconButton iconType={iconSymbol}></IconButton>
4234
+ </Flex>
4235
+ </Flex>
4236
+ </Flex>
4237
+ </ConfigProvider>
4191
4238
  );
4192
4239
  };
4193
4240
 
4241
+ export default App;
4194
4242
  ```
4195
4243
 
4196
- 基本用法
4197
-
4198
- 访问 [Icon Library](https://sparkdesign.agentscope.io/#/resources/icons) 查看全部 Icon
4199
4244
 
4200
4245
 
4201
4246
 
@@ -4359,72 +4404,27 @@ export default App;
4359
4404
 
4360
4405
  # 使用
4361
4406
 
4362
- 如果您有自己的 iconfont 项目,可以将您的图标集成到 Spark Design 中,并通过简单的符号名称访问您的图标。
4363
4407
 
4364
4408
 
4365
4409
  ```tsx
4366
- import {
4367
- ConfigProvider,
4368
- purpleTheme,
4369
- Button,
4370
- IconFont,
4371
- IconButton,
4372
- } from '@agentscope-ai/design';
4373
- import { Flex } from 'antd';
4374
- import zhCN from 'antd/locale/zh_CN';
4375
- import { useState } from 'react';
4410
+ import { SparkLoadingLine } from '@agentscope-ai/icons';
4376
4411
 
4377
- const App = () => {
4378
- const prefix = 'sps';
4379
- const iconSymbol = 'spark-effciency-line';
4380
- const iconfont = '//at.alicdn.com/t/a/font_4807885_ugexdeaoq7.js'; // 您可以从 https://www.iconfont.cn/ 获取
4412
+ export default () => {
4381
4413
  return (
4382
- <ConfigProvider
4383
- {...purpleTheme}
4384
- prefix={prefix}
4385
- prefixCls={prefix}
4386
- iconfont={iconfont}
4387
- locale={zhCN}
4388
- style={{
4389
- width: '100%',
4390
- height: '100%',
4391
- }}
4392
- >
4393
- <Flex
4394
- style={{
4395
- width: '100%',
4396
- height: '100%',
4397
- backgroundColor: `var(--${prefix}-color-bg-base)`,
4398
- }}
4399
- justify="center"
4400
- align="center"
4401
- >
4402
- <Flex vertical gap={16} style={{ width: '300px', padding: '12px 0' }}>
4403
- <Flex gap={8}>
4404
- <div style={{ width: '100px', lineHeight: '32px' }}>IconFont:</div>
4405
- <IconFont type={iconSymbol} />
4406
- </Flex>
4407
- <Flex gap={8}>
4408
- <div style={{ width: '100px', lineHeight: '32px' }}>Button:</div>
4409
- <Button type="primary" iconType={iconSymbol}>
4410
- 添加用户
4411
- </Button>
4412
- </Flex>
4413
- <Flex gap={8}>
4414
- <div style={{ width: '100px', lineHeight: '32px' }}>
4415
- IconButton:
4416
- </div>
4417
- <IconButton iconType={iconSymbol}></IconButton>
4418
- </Flex>
4419
- </Flex>
4420
- </Flex>
4421
- </ConfigProvider>
4414
+ <SparkLoadingLine
4415
+ className="your-class-name"
4416
+ style={{ color: 'var(--sps-color-primary)' }}
4417
+ spin
4418
+ size={48}
4419
+ />
4422
4420
  );
4423
4421
  };
4424
4422
 
4425
- export default App;
4426
4423
  ```
4427
4424
 
4425
+ 基本用法
4426
+
4427
+ 访问 [Icon Library](https://sparkdesign.agentscope.io/#/resources/icons) 查看全部 Icon
4428
4428
 
4429
4429
 
4430
4430
 
@@ -4925,7 +4925,8 @@ export default App;
4925
4925
  "boxShadowSecondary": "0px 12px 24px -16px rgba(255, 255, 255, 0.06),0px 8px 40px 0px rgba(255, 255, 255, 0.12),0px 0px 1px 0px rgba(255, 255, 255, 0.04)",
4926
4926
 
4927
4927
  "colorTextWhite": "#ffffff",
4928
- "colorTextOnPrimary": "#000000",
4928
+ "colorTextBlack": "#000000",
4929
+ "colorTextOnPrimary": "#ffffff",
4929
4930
  "colorFillDisable": "#898989",
4930
4931
  "colorPurple": "#615CED",
4931
4932
  "colorPurpleHover": "#8383F0",
@@ -4957,8 +4958,8 @@ export default App;
4957
4958
 
4958
4959
  "boxShadowTertiary": "0px 12px 32px -16px rgba(255, 255, 255, 0.24),0px 12px 60px 0px rgba(255, 255, 255, 0.12),0px 0px 1px 0px rgba(255, 255, 255, 0.04)",
4959
4960
  "boxShadowTertiaryLeft": "-12px 0px 32px -16px rgba(255, 255, 255, 0.24),-12px 0px 60px 0px rgba(255, 255, 255, 0.12),0px 0px 1px 0px rgba(255, 255, 255, 0.04)",
4960
- "boxShadowInput": "0px 12px 24px -16px rgba(255, 255, 255, 0.08),0px 12px 40px 0px rgba(255, 255, 255, 0.16),0px 0px 1px 0px rgba(255, 255, 255, 0.04)",
4961
- "colorTextBlack": "#000000"
4961
+ "boxShadowInput": "0px 12px 24px -16px rgba(255, 255, 255, 0.08),0px 12px 40px 0px rgba(255, 255, 255, 0.16),0px 0px 1px 0px rgba(255, 255, 255, 0.04)"
4962
+
4962
4963
  }
4963
4964
  ```
4964
4965
 
@@ -4974,3 +4975,23 @@ Spark Design 默认启用 cssVar 模式,因此您可以利用 从 token 派生
4974
4975
  }
4975
4976
  // 提示:您可以将 'sps' 替换为您自己的前缀
4976
4977
  ```
4978
+
4979
+
4980
+
4981
+
4982
+ ### 1.0.21
4983
+ `2025-12-25`
4984
+
4985
+ ##### Changed
4986
+
4987
+ - AlertDialog 组件:定位距离顶部的默认高度调整为当前窗口高度的 36%
4988
+ - Table 组件:表格行 hover 背景色修改为 `color-bg-layout` 颜色变量;表格行选中背景色修改为 `color-primary-bg-hover` 颜色变量
4989
+ - Select 组件:多选模式的选中项背景色调整
4990
+ - 主题色变量更新:,
4991
+ - bailianDarkTheme:添加 `"colorLinkHover": "#857DE3"`
4992
+ - bailianTheme:添加 `"colorLinkHover": "#8080FF"`
4993
+ - carbonDarkTheme:修改 `"colorTextOnPrimary": "#ffffff"`
4994
+
4995
+ ##### Fixed
4996
+
4997
+ - Slider 组件:水平滑动条组件取消默认左右两边的外边距 margin,操作按钮 handle 在最左侧与最右侧不超出滑动轨道宽度