From 3bdda50cf1d37abe4995f0cb36ff3bff789bfc2a Mon Sep 17 00:00:00 2001 From: "Y." Date: Tue, 12 Nov 2024 22:26:37 +0800 Subject: [PATCH] feat(Calendar): add localText props (#463) --- db/TDesign.db | Bin 1003520 -> 1003520 bytes .../src/calendar/README.en-US.md | 4 +- .../src/calendar/README.md | 4 +- .../tdesign-miniprogram/src/calendar/props.ts | 7 ++- .../tdesign-miniprogram/src/calendar/type.ts | 18 +++++++- packages/scripts/api.json | 41 +++++++++++++++++- 6 files changed, 66 insertions(+), 8 deletions(-) diff --git a/db/TDesign.db b/db/TDesign.db index 1f0f8cd98d84bb4a3f7968052194741b3202396a..87f8ea5ae86411102581a2837c5e1ce6304b07e6 100644 GIT binary patch delta 880 zcmZvaZAep57{~9u=iKeSo$D+ksf-ClkuEk}W?Ez#1{L~6LyBN?-r3xovW+rIokh+{ zMI$_lnlnlYhE`BVN~xgFQ6Ls!V!n(Gq=J@ao3>61L#k2~e0#u+1tD;fSl29>M zrc2cF^;E(UxeLY6PBA9b^EmaHFiDIS?i$zFbiQBS0O=Gyl}0Fy;!tKLbzwKfbBIF} zSDCq~Bd@^fQrs0*kE_O}RwYWEk6Y*+kM>+zXzdDj1;T?Z8O98=!DKR+GW5nhIVN+? zuB`t^zvmoXoipce>~Oe!ipOrXDf)kX{W+h*=Ti3P=)FFV!(ExHKcgtl3hP<#s&wLH zuD-g)?K@TSS7%)Ov(HxJwmUr4t9Ntj=NNw{sjuQfENvz`YPlkYeu~d}xYyX?<<=X* z!9et8_ouPe`O&udv0(H`cVzh1{OIFZe_v#TME#e;SMP@L?Qq|~tiK-*dbza$^-$qe z1TyFqZLQD?h8UceNT)p9D)lf%_7NLmr?oo-S%CaESP1vR47eR`hDlI>6j%a_U>3Xu zFTo4&7~BIx_#-2Yvu)|$#bG>Ig>I8lC>^8M!T1*F3Y}v2a&^!uVyvIgChNFtN+S)# z)kMBY>>&|W%BO|6u?LNcw1r{BJNP&+-H_tOp#w`|Kb4IAPLvc#79^4^plGR< zqUb!(z>sVUGBS`otZm1f1*PlJJM=1HDPi&Nw4e`M11+Edx0ItFc+n}>ksmfxwEVhV zd^aIYk`e{wF!4C5FeSYq-IXXG;43b98n@d}E{QqOdphY?EW7xjS^Bb4)k!gIv7vOL zbE6qrXBX$vq@@+FRr>m<7SW%z;uLLQMk!Kek;@ncmE#BHauK;#E~oQQ{Y*2NamvlK P=GS7&?Zj0rU!VO6p+PBU delta 655 zcmZ{iT}V_x6o6;u-raleoSFTp$n`HaNCYvn5{*#Mj6w_72MsZZ+;x>&lPw{L5R9O$ z)KH8@%UTsBizR=^CP<=QdR8!t#fOMmlzb3`MXHC!^*IjToR47+hr^k!k+QClvc61= z`?D%-7!_Qtqv%+c94x=EDl2&=k7Drm!mv8S|M9E~lM# zBIg;$BfiNCV3UgdAL#O2p>@F;DEAi2&dX-ZhO1>>*sLM=v$%21T;#0-_2~p>TWRqz?C|xqD zWR9KLFg1@M+Po+y;gT#e*a1SUEzxMPXI_{@Ufv5CY#MoZ52UN?;@#j;+2r>jE#jd} zdMID3H*D3oP)ia~>gV~oGwEEH=0#pevb5w*u)T~i0$cC{;;;apU>;_-A7_fFpa0b7 zpR=f#4e<&Q2=b%yZ-CceYCJ%+1#T9xtFkW0j}yul)CC>yXC-p5m7mbWYmJSToUTa1 z)6_OALv1jevfN)|@Oa10Zo-q4xvg6;lrq<;5DZGyZXa=|udt^D-iO(^GAbGaJWrbK zd=Z33I$*AcX74TO`(-c$M)RHXs2jYF0-Bk<)%hzNK#$$ZsLX S9c*ub_zL?X+pahse*Xum=EjWx 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 24a0238e9..e0ba4434f 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/README.en-US.md +++ b/packages/products/tdesign-miniprogram/src/calendar/README.en-US.md @@ -12,9 +12,10 @@ auto-close | Boolean | true | `0.34.0` | N confirm-btn | String / Object / Slot | '' | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts) | N first-day-of-week | Number | 0 | \- | N format | Function | - | Typescript：`CalendarFormatType ` `type CalendarFormatType = (day: TDate) => TDate` `type TDateType = 'selected' \| 'disabled' \| 'start' \| 'centre' \| 'end' \| ''` `interface TDate { date: Date; day: number; type: TDateType; className?: string; prefix?: string; suffix?: string;}`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts) | N +locale-text | Object | - | Typescript：`CalendarLocaleText` `interface CalendarLocaleText {title?: string; weekdays?: string[]; monthTitle?: string; months?: string[]; confirm?: string;}`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts) | N max-date | Number | - | \- | N min-date | Number | - | \- | N -title | String / Slot | '请选择日期' | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N +title | String / Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N type | String | 'single' | options: single/multiple/range | N use-popup | Boolean | true | `0.32.0` | N using-custom-navbar | Boolean | false | \- | N @@ -29,4 +30,5 @@ 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)` | \- +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 e8754bc34..3950f8c20 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/README.md +++ b/packages/products/tdesign-miniprogram/src/calendar/README.md @@ -12,9 +12,10 @@ auto-close | Boolean | true | `0.34.0`。自动关闭；在点击关闭按钮、 confirm-btn | String / Object / Slot | '' | 确认按钮。值为 null 则不显示确认按钮。值类型为字符串，则表示自定义按钮文本，值类型为 Object 则表示透传 Button 组件属性。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts) | N first-day-of-week | Number | 0 | 第一天从星期几开始，默认 0 = 周日 | N format | Function | - | 用于格式化日期的函数。TS 类型：`CalendarFormatType ` `type CalendarFormatType = (day: TDate) => TDate` `type TDateType = 'selected' \| 'disabled' \| 'start' \| 'centre' \| 'end' \| ''` `interface TDate { date: Date; day: number; type: TDateType; className?: string; prefix?: string; suffix?: string;}`。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/calendar/type.ts) | N +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 -title | String / Slot | '请选择日期' | 标题。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | 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 @@ -29,4 +30,5 @@ 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)` | 点击确认按钮时触发 +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 5e166b1a4..ef1144380 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/props.ts +++ b/packages/products/tdesign-miniprogram/src/calendar/props.ts @@ -25,6 +25,10 @@ const props: TdCalendarProps = { format: { type: null, }, + /** 国际化文案 */ + localeText: { + type: Object, + }, /** 最大可选的日期，不传则默认半年后 */ maxDate: { type: Number, @@ -33,10 +37,9 @@ const props: TdCalendarProps = { minDate: { type: Number, }, - /** 标题 */ + /** 标题，不传默认为“请选择日期” */ title: { type: String, - value: '', }, /** 日历的选择类型，single = 单选；multiple = 多选; range = 区间选择 */ type: { diff --git a/packages/products/tdesign-miniprogram/src/calendar/type.ts b/packages/products/tdesign-miniprogram/src/calendar/type.ts index 61e6bd4ee..7e8db7283 100644 --- a/packages/products/tdesign-miniprogram/src/calendar/type.ts +++ b/packages/products/tdesign-miniprogram/src/calendar/type.ts @@ -38,6 +38,13 @@ export interface TdCalendarProps { type: undefined; value?: CalendarFormatType; }; + /** + * 国际化文案 + */ + localeText?: { + type: ObjectConstructor; + value?: CalendarLocaleText; + }; /** * 最大可选的日期，不传则默认半年后 */ @@ -53,8 +60,7 @@ export interface TdCalendarProps { value?: number; }; /** - * 标题 - * @default '请选择日期' + * 标题，不传默认为“请选择日期” */ title?: { type: StringConstructor; @@ -120,3 +126,11 @@ export interface TDate { prefix?: string; suffix?: string; } + +export interface CalendarLocaleText { + title?: string; + weekdays?: string[]; + monthTitle?: string; + months?: string[]; + confirm?: string; +} diff --git a/packages/scripts/api.json b/packages/scripts/api.json index a95df47d3..750b95ace 100644 --- a/packages/scripts/api.json +++ b/packages/scripts/api.json @@ -16362,6 +16362,43 @@ "Boolean" ] }, + { + "id": 1731402896, + "platform_framework": [ + "64" + ], + "component": "Calendar", + "field_category": 1, + "field_name": "localeText", + "field_type": [ + "8" + ], + "field_default_value": "", + "field_enum": "", + "field_desc_zh": "国际化文案", + "field_desc_en": null, + "field_required": 0, + "event_input": "", + "create_time": "2024-11-12 09:14:56", + "update_time": "2024-11-12 09:14:56", + "event_output": null, + "custom_field_type": "CalendarLocaleText【interface CalendarLocaleText {title?: string; weekdays?: string[]; monthTitle?: string; months?: string[]; confirm?: string;}】", + "syntactic_sugar": null, + "readonly": 1, + "html_attribute": 0, + "trigger_elements": "", + "deprecated": 0, + "version": "", + "test_description": null, + "support_default_value": 0, + "field_category_text": "Props", + "platform_framework_text": [ + "Miniprogram" + ], + "field_type_text": [ + "Object" + ] + }, { "id": 3142, "platform_framework": [ @@ -16785,9 +16822,9 @@ "1", "64" ], - "field_default_value": "'请选择日期'", + "field_default_value": "", "field_enum": "", - "field_desc_zh": "标题", + "field_desc_zh": "标题，不传默认为“请选择日期”", "field_desc_en": null, "field_required": 0, "event_input": "",