1# ArkUI子系统变更说明 2 3## cl.arkui.1 手势事件出参中的控件坐标系数据规格明确 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11以往组件经过平移、旋转、缩放变换后,事件响应的控件坐标是错误的,不能对应到控件坐标系。 12 13**变更影响** 14 15此次变更,会返回开发者准确的控件坐标系下的数据。 16 17**变更发生版本** 18 19从OpenHarmony SDK 4.1.3.3开始。 20 21**变更的接口/组件** 22 23* GestureEvent中的offsetX、offsetY、pinchCenterX、pinchCenterY、speed。 24 25* FingerInfo中的localX、localY。 26 27* ClickEvent中的x、y。 28 29* TouchObject中的x、y。 30 31**适配指导** 32 33此次变更,会返回开发者准确的控件坐标下的数据,无需新增适配。 34 35## cl.ArkUI.2 TextInput组件selectBackgroundColor接口变更 36 37**访问级别** 38公开接口 39 40**变更原因** 41使用selectedBackgroundColor设置ResourceColor,未设置不透明度时,选中文本会遮罩所选文字。 42 43**变更影响** 44该变更为兼容性变更,在开发者设置selectedBackgroundColor的ResourceColor时,如果未指明不透明度,默认设置20%的不透明度。 45 46**变更发生版本** 47从OpenHarmony SDK 4.1.3.3开始。 48 49**变更的接口/组件** 50TextInput组件的selectedBackgroundColor接口。 51 52**适配指导** 53默认行为变更,不涉及适配。 54 55## cl.ArkUI.3 Tabs组件animationDuration属性默认行为变更 56 57**访问级别** 58 59公开接口 60 61**变更原因** 62 63Tabs组件animationDuration属性的默认行为未保持一致。 64不设置animationDuration属性值时,点击TabBar页签切换TabContent无动画;设置为小于0的异常值时,点击TabBar页签切换TabContent有动画,按默认值300ms显示。 65 66**变更影响** 67 68该变更为非兼容性变更。 69API version 10及以前,Tabs组件不设置animationDuration属性值时,点击TabBar页签切换TabContent无动画。 70API version 11及以后,Tabs组件不设置animationDuration属性值时,点击TabBar页签切换TabContent有动画,动画时长为默认值300ms。 71 72**变更发生版本** 73 74从OpenHarmony SDK 4.1.3.3 开始。 75 76**变更的接口/组件** 77 78Tabs组件的animationDuration属性。 79 80**适配指导** 81 82变更前,若希望点击TabBar页签切换TabContent无动画,可以不设置animationDuration属性值或设置animationDuration属性值为0。 83变更后,若希望点击TabBar页签切换TabContent无动画,API version 11及以后,需设置animationDuration属性值为0,API version 10及以前维持变更前规则,不会产生影响。 84 85## cl.ArkUI.4 TextInput组件padding接口变更 86 87**访问级别** 88 89公开接口 90 91**变更原因** 92 93使用padding设置{left:10vp},未设置上下右内边距,上下右内边距实际效果为0,不是TextInput组件padding默认值。 94 95**变更影响** 96 97该变更为非兼容性变更,在开发者设置padding{left:10vp}时,如果未指明上下右内边距,则上下内边距走默认值16vp,右内边距8vp。 98 99**变更发生版本** 100 101缺陷修复, 所有版本生效。 102 103**变更的接口/组件** 104 105TextInput组件的padding接口。 106 107**适配指导** 108 109此次变更,若开发者希望TextInput组件左内边距为10vp,上下右内边距为0vp,需要显示指定{left:10vp, right:0vp, top:0vp, bottom:0vp}, 未指明的各方向内边距均走TextInput组件padding默认值。 110 111## cl.ArkUI.5 Text组件换行高度规格明确 112 113**访问级别** 114 115其他 116 117**变更原因** 118 119Text组件换行高度应该和字号大小保持一致,非固定值14px。 120 121**变更影响** 122 123该变更为非兼容性变更。 124 125API Version 10及以前在开发者设置fontSize('20px')时,Text组件内容换行高度为14px, Text组件子组件Span换行高度也是固定值14px。 126 127API Version 11及以后在开发者设置fontSize('20px')时,Text组件内容换行高度则为20px, Text组件子组件Span换行高度还是固定值14px。 128 129**变更发生版本** 130 131从OpenHarmony SDK 4.1.3.3开始。 132 133**变更的接口/组件** 134 135Text组件。 136 137**适配指导** 138 139默认行为变更,不涉及适配。 140 141## cl.ArkUI.6 Scroller调用scrollTo方法控制Grid组件跳转Bug修复 142 143**访问级别** 144 145公开接口 146 147**变更原因** 148 149 Scroller调用scrollTo方法控制Grid组件跳转超过Grid当前页面主轴方向高度距离时,存在跳转位置会有rowsGap*行数的误差的Bug。现问题已修复。 150 151**变更影响** 152 153该变更为兼容性变更。此次变更,开发者使用Scroller调用scrollTo方法控制Grid组件跳转时,会跳转到更精确的位置。 154 155**API Level** 156 1577 158 159**变更发生版本** 160 161从OpenHarmony 4.1.3.3开始。 162 163**变更的接口/组件** 164 165变更前:Grid组件,调用Scroller的scrollTo接口,跳转超过一屏时,跳转位置会有rowsGap*行数的误差。 166 167变更后:Grid组件,调用Scroller的scrollTo接口,跳转超过一屏时,跳转位置会更精确。 168 169**适配指导** 170 171此次变更,Scroller调用scrollTo方法控制Grid组件跳转位置会更精确,不涉及适配。