1# ArkUI子系统ChangeLog
2
3## cl.arkui.1 默认焦点行为变更
4
5当开发者未配置通用属性:defaultFocus 时,默认焦点获取策略:
6
7API 11之前:给到当前页面上首个可获焦的非容器组件。
8
9API 11及之后:给到当前页面的根容器上。
10
11**变更影响**
12
13未配置defaultFocus属性的情况下,当页面首次打开时,原先默认第一个可获焦的非容器组件会立即获取焦点。变更后,该组件不会在此刻获取到焦点,此时焦点在当前页面的根容器上。
14
15例如:
161. 页面内首个可获焦的非容器组件为一个输入框组件,且无任何组件绑定defaultFocus属性。
17
18   API 11之前:在页面打开时该输入框组件获焦并拉起输入法。
19
20   API 11及之后:在页面打开时该输入框组件不处于获焦状态,无法自动拉起输入法。需要按一次TAB键才可以使其获焦。
21
222. 开发者在页面内首个可获焦的非容器组件上绑定了onKeyEvent事件,用以监听按键事件然后做对应的业务处理。
23
24   API 11之前:在页面打开时该组件默认获焦,无需其他任何操作,onKeyEvent回调可立即监听键盘的按键事件。
25
26   API 11及之后:在页面打开时该组件不处于获焦状态,此时它的onKeyEvent回调无法响应键盘按键事件,需要按一次TAB键使其获焦后,才可继续使用onKeyEvent功能。
27
28
29
30**适配指导**
31
32若希望应用保持变更前的效果,则需要给目标组件绑定defaultFocus(true)属性,使能其成为页面内的默认焦点,这样当页面首次打开时,焦点会自动给到首个绑定了defaultFocus(true)属性的组件上。
33
34
35## cl.arkui.2 输入框类组件软键盘交互行为变更
36
37输入框获焦后会拉起输入法,在输入法的软键盘上,有两个位置的点击可使软键盘收起,一个是软键盘右上角的倒三角收起按钮,另一个是软键盘右下角的EnterKey按钮。
38
39API 11之前:按钮点击时可使软键盘收起,但不会使对应拉起方的输入框组件失焦。
40
41API 11及之后:按钮点击时既可以使软键盘收起,也会使对应拉起方的输入框组件失焦。
42
43影响的输入框组件包括:TextInput、TextArea、Search、RichEditor。
44
45**变更影响**
46
47影响焦点的逻辑行为:
48
49API 11之前,点击按钮后输入框仍处于获焦状态,此时输入框组件上的onKeyEvent事件仍可正常响应、应用先后台再前台,会重新拉起输入法、按TAB键走焦可立即走到下一个组件。
50
51API 11及之后,点击按钮后输入框会立即失焦,此时输入框组件上的onKeyEvent事件无法响应、应用先后台再前台,不会重新拉起输入法、按TAB键会使该输入框组件重新获焦,而非走焦到下一个组件。
52
53**适配指导**
54
55默认行为变更,无需适配,但应注意变更后的行为是否对整体应用逻辑产生影响。
56
57## cl.arkui.3 Checkbox组件默认形状变更
58
59**访问级别**
60
61公开接口
62
63**变更原因**
64
65增强视觉、交互效果。
66
67**变更影响**
68
69该变更为兼容性变更。
70
71**API Level**
72
7311
74
75**变更发生版本**
76
77从OpenHarmony SDK 4.1.3.2 版本开始。
78
79**变更的接口/组件**
80
81checkbox组件。
82
83当开发者未配置Checkbox组件的shape属性,默认形状变更。
84
85**变更影响**
86
87默认形状策略:
88
89API version 11及之后:Checkbox组件的形状默认为圆形。
90
91  ![](figures/checkbox.png)
92
93API version 11之前:Checkbox组件的形状默认为圆角方形。
94
95  ![](figures/checkbox_old.png)
96
97**适配指导**
98
99若希望API version 11及之后Checkbox组件的形状为变更前的圆角方形,则需要Checkbox组件绑定shape(CheckBoxShape.ROUNDED_SQUARE)属性,这样Checkbox组件的形状就变成圆角方形。
100
101
102## cl.arkui.4 rawfile文件资源校验等级变更
103
104**访问级别**
105
106所有$rawfile()的使用校验。
107
108**变更影响**
109
110$rawfile()引用不存在的资源,报错等级由WARN变更成ERROR。
111
112**变更发生版本**
113
114从OpenHarmony SDK 4.1.3.2 开始。
115
116**示例:**
117
118```
119@Entry
120@Component
121struct Index {
122  build() {
123    Button(){
124      // ERROR: No such 'app_icon.ong' resource in current module.
125      Image($rawfile('app_icon.png'))
126    }
127  }
128}
129```
130
131**变更的接口/组件**
132
133不涉及。
134
135**适配指导**
136
137不涉及。