1# ArkUI 子系统变更说明
2
3
4## cl.arkui.1 keyboardShortcut快捷键功能增强
5
6**访问级别**
7
8公开接口
9
10**变更原因**
11
12应用快捷键功能增强。
13
14**变更影响**
15
16该变更为兼容性变更。
17
18API version 13及以后，不再禁止注册以下列表中的快捷键。
19
20- `Ctrl` + `C`
21- `Ctrl` + `A`
22- `Ctrl` + `V`
23- `Ctrl` + `X`
24- `Ctrl` + `Shift` + `Z`
25- `Ctrl` + `Z`
26- `Ctrl` + `Y`
27
28变更前：应用不可以使用keyboardShortcut注册上述列表中的快捷键。
29
30变更后：应用可以使用keyboardShortcut注册上述列表中的快捷键。
31
32**起始API Level**
33
3410
35
36**变更发生版本**
37
38从OpenHarmony SDK 5.0.0.41 版本开始。
39
40**变更的接口/组件**
41
42通用接口。
43
44**适配指导**
45
46不涉及适配，API使用参考[keyboardShortcut](../../../application-dev/reference/apis-arkui/arkui-ts/ts-universal-events-keyboardshortcut.md)。
47
48## cl.arkui.2 hideNonSecureWindows接口使用权限变更
49
50**访问级别**
51
52系统接口
53
54**变更原因**
55
56模态UIExtension默认隐藏不安全窗口且不允许取消隐藏，造成部分场景UX体验不佳。
57
58**变更影响**
59
60该变更为兼容性变更。
61
62变更前：模态UIExtension默认隐藏不安全窗口且不允许取消隐藏。
63
64变更后：模态UIExtension默认隐藏不安全窗口，申请ohos.permission.ALLOW_SHOW_NON_SECURE_WINDOWS权限后可取消隐藏。
65
66**起始API Level**
67
68API 12
69
70**变更发生版本**
71
72从OpenHarmony SDK 5.0.0.41开始。
73
74**变更的接口/组件**
75
76CreateModalUIExtension和hideNonSecureWindows接口。
77
78**适配指导**
79
80为避免不安全窗口先隐藏再显示导致闪烁，模态UIExtension在申请ohos.permission.ALLOW_SHOW_NON_SECURE_WINDOWS权限后，可以在``onSessionCreate``函数中调用``hideNonSecureWindows(false)``接口取消对不安全窗口的隐藏。此时应用需自行确保自身内容不会被遮挡，建议使用``createSubWindowWithOptions``接口创建模态置顶子窗，并将内容都加载在子窗中。
81
82## cl.arkui.3 MenuItem组件在非2in1设备上超长文本布局由缩略显示变更为换行显示
83
84**访问级别**
85
86公开接口
87
88**变更原因**
89
90对于使用超长文本的MenuItem组件场景，默认布局效果优化，UX体验更佳。
91
92**变更影响**
93
94该变更为不兼容变更。
95
96变更前：MenuItem组件含有超长文本时，文本缩略显示。
97
98变更后：API13开始，MenuItem组件含有超长文本时，在2in1设备上不换行，其余设备无限换行。
99
100| 变更前长文本缩略 | 变更后非2in1设备长文本换行 |
101|---------|---------|
102|  ![长文本缩略](figures/menu-item-long-text-before.png)       |  ![2in1设备长文本换行](figures/menu-item-long-text-after.png)       |
103
104**起始API Level**
105
106API 11
107
108**变更发生版本**
109
110从OpenHarmony SDK 5.0.0.41开始。
111
112**变更的接口/组件**
113
114MenuItem组件。
115
116**适配指导**
117
118MenuItem UX默认布局效果变更，应用无需适配。
119
120## cl.arkui.2 Image组件的borderRadius接口支持动态修改
121
122**访问级别**
123
124公开接口
125
126**变更原因**
127
128为了增强功能的灵活性，Image组件的borderRadius接口现在支持动态修改。
129
130**变更影响**
131
132该变更为不兼容变更。
133
134变更前：Image组件的borderRadius接口动态修改不生效。
135
136变更后：Image组件的borderRadius接口动态修改生效。
137
138**起始API Level**
139
1407
141
142**变更发生版本**
143
144从OpenHarmony SDK 5.0.0.41 版本开始。
145
146**变更的接口/组件**
147
148Image组件的borderRadius接口。
149
150**适配指导**
151
152如果代码中依赖borderRadius动态修改不生效的行为（如避免在运行时改变圆角效果），建议传入不变的值，例如：borderRadius('5px')。
153
154## cl.arkui.3 borderImage的outset属性按照实际的延伸距离来绘制边框向外扩展的效果
155
156**访问级别**
157
158公开接口
159
160**变更原因**
161
162borderImage中的边框外延距离（outset属性）在无需绘制的区域不会被绘制，这与预期行为不符。
163
164**变更影响**
165
166该变更为不兼容变更。
167
168变更前：borderImage中的边框外延距离（outset属性）在无需绘制的区域不会被绘制。
169
170变更后：borderImage中的边框外延距离（outset属性）按照实际延伸距离进行绘制。
171
172**起始API Level**
173
1749
175
176**变更发生版本**
177
178从OpenHarmony SDK 5.0.0.41 版本开始。
179
180**变更的接口/组件**
181
182通用接口。
183
184**适配指导**
185
186默认效果变更，无需适配，但应注意变更后的默认效果是否符合开发者预期，如不符合则应自定义修改效果控制变量以达到预期。