From 1dc36f1ebcfe353dbbc0c9093604a977b9935cc3 Mon Sep 17 00:00:00 2001 From: anlyyao Date: Mon, 23 Dec 2024 16:53:08 +0800 Subject: [PATCH] feat(Calendar): add panel-change event --- db/TDesign.db | Bin 1003520 -> 1003520 bytes .../src/calendar/README.en-US.md | 1 + .../src/calendar/README.md | 7 +-- .../tdesign-miniprogram/src/calendar/props.ts | 6 +-- .../tdesign-miniprogram/src/calendar/type.ts | 6 +-- packages/scripts/api.json | 41 +++++++++++++++++- 6 files changed, 50 insertions(+), 11 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index 56771f70fd2be47710a262117eb039ac2ade267e..bd2db3c423d938c2b336315fbdd4edcc70c6e413 100644 GIT binary patch delta 568 zcmZozVB4_3c7inH&WSS4tUDR>%DNg;T2mNXQjswzM+N&+HgQ(h?J@xznymGWesfi&SQup)l^JMPH z7#KJ?csXntIMOqfzd1N3=A`DOBo;9hB<7{&IA85$ji@5RRF4aHmCF1)Q{_QN-}_aFjv#az{o_`&`8(FSi!);%EZFT)D(+QwUTdUUS>g2 zetJ=2u9B64lA)f3o{3WJcJVNdSDZ}DOw*YYIMmn$8D}%HGSp3U6xr^Qz_E`>4(L68 zke4|XIYrHz3Y&!IN+7tw(*=_`?6=1!b1dVLWH`gjr^C;{vxmoq`xdtt<4G<}&b1t` z8O}_XE8tki-&i@>Uy2E6kT@{xnslcdRB$*sHgrCpvO*y@GtVWlBvs+*#(B>gmOpLS z0}Q4oyStt)S^0iX&yzhfp0;*8-?jYxo>?%3b_yl=DT$Sj8=9s!RB+@>KUK)Fnu$Yk zdwCJZDpnS*B@Cz9RVz4vm=lP(fS4PIdA6%o@ZNvU=&+qNfv=H?iD$|7jwHTtPR0|{ VA7t~LU;{-T-_q^ta`=KC0{}5S$3y@C delta 315 zcmV-B0mS}*pgn+~J&+p#wUHb{1+@S!c8Gywg=7JRWCDd`1BGM+g=7VVWCn#~2eo7f zpidYH1{VMhM-1!?T?@_%*a|cVcn9SM7Yxd`98d@;1(&ej3J8~w=L$#%W0MaV0s$MB z&{PN(mr~yfO92j-LEQ=&w-;6j>Inh>0G9(`2qp&t0h<8@0Dh4{6t_fR2)+Ujf+C$5 z8Uz6y2_Xp;H-d4OAY%wW595H4<-CC9kCEiKt>b`^w_jrjrVJSY$pa274*(3j3_J_k z3l;&%3MmP#2J8x2|jsQsW^kX#xNM diff --git a/packages/products/tdesign-miniprogram/src/calendar/README.en-US.md b/packages/products/tdesign-miniprogram/src/calendar/README.en-US.md index b9e753b3..ed778b8c 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/README.en-US.md +++ b/packages/products/tdesign-miniprogram/src/calendar/README.en-US.md @@ -31,5 +31,6 @@ name | params | description change | `(value: timestamp)` | `0.28.0` close | `(trigger: CalendarTrigger)` | `0.34.0`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts)。
`type CalendarTrigger = 'close-btn' \| 'confirm-btn' \| 'overlay'`
confirm | `(value: timestamp)` | \- +panel-change | `(year: number; month: number)` | `1.8.4` scroll | `({scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY})` | `1.4.6`。triggered when scrolling select | `(value: timestamp)` | `0.28.0` diff --git a/packages/products/tdesign-miniprogram/src/calendar/README.md b/packages/products/tdesign-miniprogram/src/calendar/README.md index 63e693bc..ffa7899c 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/README.md +++ b/packages/products/tdesign-miniprogram/src/calendar/README.md @@ -15,13 +15,13 @@ format | Function | - | 用于格式化日期的函数。TS 类型：`CalendarFo locale-text | Object | - | 国际化文案。TS 类型：`CalendarLocaleText` `interface CalendarLocaleText {title?: string; weekdays?: string[]; monthTitle?: string; months?: string[]; confirm?: string;}`。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts) | N max-date | Number | - | 最大可选的日期，不传则默认半年后 | N min-date | Number | - | 最小可选的日期，不传则默认今天 | N -switch-mode | String | none | 【开发中】切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换。可选项：none/month/year-month | N +switch-mode | String | none | 切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换。可选项：none/month/year-month | N title | String / Slot | - | 标题，不传默认为“请选择日期”。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N type | String | 'single' | 日历的选择类型，single = 单选；multiple = 多选; range = 区间选择。可选项：single/multiple/range | N use-popup | Boolean | true | `0.32.0`。是否使用弹出层包裹日历 | N using-custom-navbar | Boolean | false | 是否使用了自定义导航栏 | N -value | Number / Array | - | 当前选择的日期，不传则默认今天，当 type = multiple 或 range 时传入数组。TS 类型：`number \| number[]` | N -default-value | Number / Array | undefined | 当前选择的日期，不传则默认今天，当 type = multiple 或 range 时传入数组。非受控属性。TS 类型：`number \| number[]` | N +value | Number / Array | - | 当前选择的日期，不传则选用 minDate 属性值或今天，优先级：minDate > today。当 type = multiple 或 range 时传入数组。TS 类型：`number \| number[]` | N +default-value | Number / Array | undefined | 当前选择的日期，不传则选用 minDate 属性值或今天，优先级：minDate > today。当 type = multiple 或 range 时传入数组。非受控属性。TS 类型：`number \| number[]` | N visible | Boolean | false | 是否显示日历；`usePopup` 为 true 时有效 | N ### Calendar Events @@ -31,5 +31,6 @@ visible | Boolean | false | 是否显示日历；`usePopup` 为 true 时有效 | change | `(value: timestamp)` | `0.28.0`。不显示 confirm-btn 时，完成选择时触发（暂不支持 type = multiple） close | `(trigger: CalendarTrigger)` | `0.34.0`。关闭按钮时触发。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts)。
`type CalendarTrigger = 'close-btn' \| 'confirm-btn' \| 'overlay'`
confirm | `(value: timestamp)` | 点击确认按钮时触发 +panel-change | `(year: number; month: number)` | `1.8.4`。切换月或年时触发（switch-mode 不为 none 时有效） scroll | `({scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY})` | `1.4.6`。滚动时触发 select | `(value: timestamp)` | `0.28.0`。点击日期时触发 diff --git a/packages/products/tdesign-miniprogram/src/calendar/props.ts b/packages/products/tdesign-miniprogram/src/calendar/props.ts index 4cdb8ceb..df84b62b 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/props.ts +++ b/packages/products/tdesign-miniprogram/src/calendar/props.ts @@ -37,7 +37,7 @@ const props: TdCalendarProps = { minDate: { type: Number, }, - /** 【开发中】切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换 */ + /** 切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换 */ switchMode: { type: String, value: 'none', @@ -61,12 +61,12 @@ const props: TdCalendarProps = { type: Boolean, value: false, }, - /** 当前选择的日期，不传则默认今天，当 type = multiple 或 range 时传入数组 */ + /** 当前选择的日期，不传则选用 minDate 属性值或今天，优先级：minDate > today。当 type = multiple 或 range 时传入数组 */ value: { type: null, value: null, }, - /** 当前选择的日期，不传则默认今天，当 type = multiple 或 range 时传入数组，非受控属性 */ + /** 当前选择的日期，不传则选用 minDate 属性值或今天，优先级：minDate > today。当 type = multiple 或 range 时传入数组，非受控属性 */ defaultValue: { type: null, }, diff --git a/packages/products/tdesign-miniprogram/src/calendar/type.ts b/packages/products/tdesign-miniprogram/src/calendar/type.ts index 7fb466b5..dc596838 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/type.ts +++ b/packages/products/tdesign-miniprogram/src/calendar/type.ts @@ -60,7 +60,7 @@ export interface TdCalendarProps { value?: number; }; /** - * 【开发中】切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换 + * 切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换 * @default none */ switchMode?: { @@ -99,14 +99,14 @@ export interface TdCalendarProps { value?: boolean; }; /** - * 当前选择的日期，不传则默认今天，当 type = multiple 或 range 时传入数组 + * 当前选择的日期，不传则选用 minDate 属性值或今天，优先级：minDate > today。当 type = multiple 或 range 时传入数组 */ value?: { type: null; value?: number | number[]; }; /** - * 当前选择的日期，不传则默认今天，当 type = multiple 或 range 时传入数组，非受控属性 + * 当前选择的日期，不传则选用 minDate 属性值或今天，优先级：minDate > today。当 type = multiple 或 range 时传入数组，非受控属性 */ defaultValue?: { type: null; diff --git a/packages/scripts/api.json b/packages/scripts/api.json index 3d911866..a0532290 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -16823,7 +16823,7 @@ ], "field_default_value": "none", "field_enum": "none/month/year-month", - "field_desc_zh": "【开发中】切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换", + "field_desc_zh": "切换模式。 `none` 表示水平方向平铺展示所有月份； `month` 表示支持按月切换， `year-month` 表示既按年切换，也支持按月切换", "field_desc_en": null, "field_required": 0, "event_input": "", @@ -17118,7 +17118,7 @@ ], "field_default_value": "", "field_enum": "", - "field_desc_zh": "当前选择的日期，不传则默认今天，当 type = multiple 或 range 时传入数组", + "field_desc_zh": "当前选择的日期，不传则选用 minDate 属性值或今天，优先级：minDate > today。当 type = multiple 或 range 时传入数组", "field_desc_en": null, "field_required": 0, "event_input": "", @@ -17716,6 +17716,43 @@ ], "field_type_text": [] }, + { + "id": 1734943734, + "platform_framework": [ + "64" + ], + "component": "Calendar", + "field_category": 2, + "field_name": "panelChange", + "field_type": [ + "16" + ], + "field_default_value": "", + "field_enum": "", + "field_desc_zh": "切换月或年时触发（switch-mode 不为 none 时有效）", + "field_desc_en": null, + "field_required": 0, + "event_input": "(year: number; month: number)", + "create_time": "2024-12-23 08:48:55", + "update_time": "2024-12-23 08:48:55", + "event_output": null, + "custom_field_type": null, + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "{\"Miniprogram\": \"1.8.4\"}", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Events", + "platform_framework_text": [ + "Miniprogram" + ], + "field_type_text": [ + "Array" + ] + }, { "id": 1720685482, "platform_framework": [