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组件跳转位置会更精确,不涉及适配。