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  92 93API version 11之前:Checkbox组件的形状默认为圆角方形。 94 95  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不涉及。