diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-datepicker.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-datepicker.md index 6ce743a0f15883c6f04e11dd085cbb825ad5587f..9eb6ea3b66e032f8a441b65e509759dda062a37f 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-datepicker.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-datepicker.md @@ -26,6 +26,26 @@ DatePicker(options?: {start?: Date, end?: Date, selected?: Date}) | end | Date | 否 | 指定选择器的结束日期。
默认值：Date('2100-12-31') | | selected | Date | 否 | 设置选中项的日期。
默认值：当前系统日期
从API version 10开始，该参数支持[$$](../../quick-start/arkts-two-way-sync.md)双向绑定变量。 | +**异常情形说明:** + +| 异常情形 | 对应结果 | +| -------- | ------------------------------------------------------------ | +| 起始日期晚于结束日期，选中日期未设置 | 起始日期、结束日期和选中日期都为默认值 | +| 起始日期晚于结束日期，选中日期早于起始日期默认值 | 起始日期、结束日期都为默认值，选中日期为起始日期默认值 | +| 起始日期晚于结束日期，选中日期晚于结束日期默认值 | 起始日期、结束日期都为默认值，选中日期为结束日期默认值 | +| 起始日期晚于结束日期，选中日期在起始日期与结束日期默认值范围内 | 起始日期、结束日期都为默认值，选中日期为设置的值 | +| 选中日期早于起始日期 | 选中日期为起始日期 | +| 选中日期晚于结束日期 | 选中日期为结束日期 | +| 起始日期晚于当前系统日期，选中日期未设置 | 选中日期为起始日期 | +| 结束日期早于当前系统日期，选中日期未设置 | 选中日期为结束日期 | +| 日期格式不符合规范，如‘1999-13-32’ | 取默认值 | +| 起始日期或结束日期早于系统有效范围 | 起始日期或结束日期取系统有效范围最早日期 | +| 起始日期或结束日期晚于系统有效范围 | 起始日期或结束日期取系统有效范围最晚日期 | + +系统日期范围：1900-1-31 ~ 2100-12-31 + +选中日期会在起始日期与结束日期异常处理完成后再进行异常情形判断处理 + ## 属性 除支持[通用属性](ts-universal-attributes-size.md)外，还支持以下属性： diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md index 13653c27a6f350091794ea36af4c6847209fe355..99065afdcd9233733cb66d0d4bc08f4b8c74b4b8 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md @@ -22,7 +22,7 @@ PatternLock(controller?: PatternLockController) ## 属性 -不支持除backgroundColor以外的通用属性设置。 +除支持[通用属性](ts-universal-attributes-size.md)外，还支持以下属性： | 名称 | 参数类型 | 描述 | | --------------- | ------------------------------------- | ------------------------------------------------------------ | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md index d5be648cdb9f74ba8e20b79200d4f3162a9f726f..5fa377760f5659035aca6ad1aa8f2ced4841a889 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md @@ -33,6 +33,26 @@ show(options?: DatePickerDialogOptions) | onCancel | () => void | 否 | 点击弹窗中的“取消”按钮时触发该回调。 | | onChange | (value: [DatePickerResult](ts-basic-components-datepicker.md#DatePickerResult对象说明)) => void | 否 | 滑动弹窗中的滑动选择器使当前选中项改变时触发该回调。 | +**异常情形说明:** + +| 异常情形 | 对应结果 | +| -------- | ------------------------------------------------------------ | +| 起始日期晚于结束日期，选中日期未设置 | 起始日期、结束日期和选中日期都为默认值 | +| 起始日期晚于结束日期，选中日期早于起始日期默认值 | 起始日期、结束日期都为默认值，选中日期为起始日期默认值 | +| 起始日期晚于结束日期，选中日期晚于结束日期默认值 | 起始日期、结束日期都为默认值，选中日期为结束日期默认值 | +| 起始日期晚于结束日期，选中日期在起始日期与结束日期默认值范围内 | 起始日期、结束日期都为默认值，选中日期为设置的值 | +| 选中日期早于起始日期 | 选中日期为起始日期 | +| 选中日期晚于结束日期 | 选中日期为结束日期 | +| 起始日期晚于当前系统日期，选中日期未设置 | 选中日期为起始日期 | +| 结束日期早于当前系统日期，选中日期未设置 | 选中日期为结束日期 | +| 日期格式不符合规范，如‘1999-13-32’ | 取默认值 | +| 起始日期或结束日期早于系统有效范围 | 起始日期或结束日期取系统有效范围最早日期 | +| 起始日期或结束日期晚于系统有效范围 | 起始日期或结束日期取系统有效范围最晚日期 | + +系统日期范围：1900-1-31 ~ 2100-12-31 + +选中日期会在起始日期与结束日期异常处理完成后再进行异常情形判断处理 + ## 示例 ```ts diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md index 5f0a1994fc126dd769aad8b9dd70558fa7637cb6..9d4728db724b20473fdeec75cec56df6d9047a71 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md @@ -10,7 +10,7 @@ | 名称 | 参数类型 | 描述 | | -------- | -------- | -------- | -| background10+ | builder: [CustomBuilder](ts-types.md#custombuilder8),
options?: {align?:[Alignment](ts-appendix-enums.md#alignment)} | builder：自定义背景。
align：设置自定义背景与组件的对齐方式。
同时设置了background，backgroundColor，backgroundImage时，叠加显示，background在最上层。 | +| background10+ | builder: [CustomBuilder](ts-types.md#custombuilder8),
options?: {align?:[Alignment](ts-appendix-enums.md#alignment)} | builder：自定义背景。
align：设置自定义背景与组件的对齐方式。
同时设置了background，backgroundColor，backgroundImage时，叠加显示，background在最上层。
不支持嵌套使用该属性。 | | backgroundColor | [ResourceColor](ts-types.md#resourcecolor) | 设置组件的背景色。
从API version 9开始，该接口支持在ArkTS卡片中使用。 | | backgroundImage | src: [ResourceStr](ts-types.md#resourcestr),
repeat?: [ImageRepeat](ts-appendix-enums.md#imagerepeat) | src：图片地址，支持网络图片资源地址和本地图片资源地址和Base64，不支持svg类型的图片。
repeat：设置背景图片的重复样式，默认不重复。当设置的背景图片为透明底色图片，且同时设置了backgroundColor时，二者叠加显示，背景颜色在最底部。
从API version 9开始，该接口支持在ArkTS卡片中使用。 | | backgroundImageSize | {
width?: [Length](ts-types.md#length),
height?: [Length](ts-types.md#length)
} \| [ImageSize](ts-appendix-enums.md#imagesize) | 设置背景图像的高度和宽度。当输入为{width: Length, height: Length}对象时，如果只设置一个属性，则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。
width和height取值范围： [0, +∞)
默认值：ImageSize.Auto
从API version 9开始，该接口支持在ArkTS卡片中使用。
**说明：**
设置为小于0的值时，按值为0显示。当设置了height未设置width时，width根据图片原始宽高比进行调整。 |