1# ArkUI 子系统变更说明 2 3## cl.arkui.1 菜单背板的默认视觉效果变更为模糊材质 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11增强视觉效果。 12 13**变更影响** 14 15该变更为兼容性变更。 16 17在**统一渲染模式**下，菜单背板的默认视觉效果变更为模糊材质。 18 19**API Level** 20 2111 22 23**变更发生版本** 24 25从OpenHarmony SDK 4.1.5.2 版本开始。 26 27**变更的接口/组件** 28 29涉及到左键菜单（bindMenu）、右键菜单（bindContextMenu）、下拉选项菜单（Select）、导航组件工具栏的更多悬浮菜单（Navigation）等菜单背板的默认视觉效果： 30 31- 变更前：菜单背景颜色显示为白色，不支持模糊材质。 32- 变更后：菜单背景颜色默认为透明和模糊材质，其中bindMenu与bindContextMenu可支持开发者配置是否模糊材质及背景色。 33 34**适配指导** 35 36bindMenu/bindContextMenu去除模糊材质示例代码： 37```ts 38@Entry 39@Component 40struct Index { 41 @State message: string = '自定义菜单'; 42 43 @Builder 44 MenuBuilder() { 45 Menu() { 46 MenuItem({ content: "item00" }) 47 MenuItem({ content: "item11" }) 48 } 49 } 50 51 @Builder 52 ContextMenuBuilder() { 53 Menu() { 54 MenuItem({ content: "item22" }) 55 MenuItem({ content: "item33" }) 56 } 57 } 58 59 build() { 60 Row() { 61 Column() { 62 Text(this.message) 63 .fontSize(50) 64 .fontWeight(FontWeight.Bold) 65 .fontColor('black') 66 .bindMenu(this.MenuBuilder(), { backgroundColor: Color.White, backgroundBlurStyle: BlurStyle.NONE }) 67 .bindContextMenu(this.ContextMenuBuilder(), ResponseType.LongPress, { 68 backgroundColor: Color.White, 69 backgroundBlurStyle: BlurStyle.NONE 70 }) 71 } 72 .width('100%') 73 } 74 .height('100%').backgroundColor(Color.Orange) 75 } 76} 77``` 78将 79```ts 80.bindMenu(this.MenuBuilder()) 81.bindContextMenu(this.ContextMenuBuilder(), ResponseType.LongPress) 82``` 83替换为 84```ts 85.bindMenu(this.MenuBuilder(), { backgroundColor: Color.White, backgroundBlurStyle: BlurStyle.NONE }) 86.bindContextMenu(this.ContextMenuBuilder(), ResponseType.LongPress, { backgroundColor: Color.White, backgroundBlurStyle: BlurStyle.NONE }) 87``` 88即手动设置背景色与背景模糊材质枚举值。 89 90 91 92## cl.arkui.2 bindSheet半模态面板视觉样式增加 93 94**访问级别** 95 96公开接口 97 98**变更原因** 99 100增强视觉效果。 101 102**变更影响** 103 104该变更为兼容性变更。 105 106a) 设备宽度小于600vp时，默认显示底部弹窗样式。 107 108b) 设备宽度在600-840vp间时，默认显示居中弹窗样式。 109 110c) 设备宽度大于840vp时，默认显示跟手弹窗样式，跟手弹窗显示在bindSheet绑定的节点下方。 111 112变更前：所有设备均为底部弹窗样式 113 114 115 116变更后：增加居中弹窗和跟手弹窗样式 117 118 119 120增加跟手弹窗样式。 121 122 123 124**API Level** 125 12611 127 128**变更发生版本** 129 130从OpenHarmony SDK 4.1.5.2 版本开始。 131 132**变更的接口/组件** 133 134bindSheet半模态面板。 135 136**适配指导** 137 138对于宽度大于840vp设备，如需要显示居中弹窗样式，可以设置SheetOptions中的preferType为SheetType.CENTER。 139 140 141 142## cl.arkui.3 bindSheet半模态面板底部弹窗样式修改 143 144**访问级别** 145 146公开接口 147 148**变更原因** 149 150增强视觉效果。 151 152**变更影响** 153 154该变更为兼容性变更。 155 156a) 底部弹窗SheetOptions中的SheetSize的Medium档位，设置后面板高度为屏幕高度*0.6。 157 158变更前： 159 160 161 162变更后： 163 164 165 166 167 168b) 底部弹窗SheetOptions中的SheetSize增加FIT_CONTENT档位，设置后面板高度根据内容自适应调整。 169 170变更前： 171 172 173 174变更后： 175 176 177 178c) 底部弹窗可通过SheetOptions中的detents设置1-3个自定义高度档位，面板可在不同档位间滑动切换，detents仅在底部弹窗并且设备为竖屏时生效。 179 180变更前：面板滑动无法切换档位。 181 182变更后： 183 184 185 186d) 底部弹窗在设备横屏时，仅有一个档位高度，距离屏幕顶部8vp。 187 188变更前：设备横屏时，底部弹窗规格与竖屏一致。 189 190变更后： 191 192 193 194e) 对内容区Builder设置高度为百分比时，百分比参考的依据是设置的height或detents的高度值，非屏幕高度。 195 196**API Level** 197 19811 199 200**变更发生版本** 201 202从OpenHarmony SDK 4.1.5.2 版本开始。 203 204**变更的接口/组件** 205 206bindSheet半模态面板。 207 208**适配指导** 209 210a) 设置SheetOptions中的detents时，默认高度为detents元组中的第一个元素。 211 212b) 当在SheetOptions中设置detents后，height属性设置无效。 213 214c) 当在height属性中设置自定义高度或FIT_CONTENT自适应的高度，大于最大高度或小于0，则显示最大高度。 215 216 217 218## cl.arkui.4 bindSheet半模态面板增加居中弹窗与跟手弹窗样式 219 220**访问级别** 221 222公开接口 223 224**变更原因** 225 226增强视觉效果。 227 228**变更影响** 229 230该变更为兼容性变更。 231 232a) 居中弹窗样式默认宽度480vp，默认高度560vp。 233 234b) 居中弹窗内容固定时可自定义半模态面板高度，自定义高度最小为320vp，最大为设备短边长度*0.9。 235 236c) 居中弹窗在横竖屏切换时，面板大小不会改变。 237 238d) 跟手弹窗样式默认宽度360vp，默认高度560vp。 239 240e) 跟手弹窗内容固定时可自定义半模态面板高度，自定义高度最小为320vp，最大为设备短边长度*0.9。 241 242**API Level** 243 24411 245 246**变更发生版本** 247 248从OpenHarmony SDK 4.1.5.2 版本开始。 249 250**变更的接口/组件** 251 252bindSheet半模态面板。 253 254**适配指导** 255 256当在height属性中设置自定义高度或FIT_CONTENT自适应的高度大于最大高度，则显示最大高度，小于最小高度，则显示最小高度，若自定义高度为负数，则显示默认高度。 257 258 259 260## cl.arkui.5 bindSheet半模态面板操作区修改 261 262**访问级别** 263 264公开接口 265 266**变更原因** 267 268增强视觉效果。 269 270**变更影响** 271 272该变更为兼容性变更。 273 274a) 增加标题区，通过SheetOptions中的title设置。设置单行标题或自定义标题时，标题区高为56vp，设置双行标题时，标题区高为72vp。 275 276变更前：面板无标题区。 277 278 279 280变更后：面板可设置标题区。 281 282 283 284b) 增加关闭图标，通过SheetOptions中的showClose设置，关闭图标默认为显示。 285 286变更前：面板没有关闭图标。 287 288变更后：面板默认显示关闭图标。 289 290c) 控制条的大小改变为48*4vp，控制条当面板高度为单档位时不显示，面板高度为多档位时默认显示。 291 292变更前：控制条大小为28*4vp，默认显示。 293 294变更后：控制条大小为48*4vp，控制条仅在底部弹窗多档位时默认显示。 295 296d) 拖拽控制条时，控制条在一定范围内无xy方向的小幅位移动效。 297 298变更前：拖拽控制条存在xy方向的小幅位移动效。 299 300变更后：控制条无拖拽xy方向的动效。 301 302**API Level** 303 30411 305 306**变更发生版本** 307 308从OpenHarmony SDK 4.1.5.2 版本开始。 309 310**变更的接口/组件** 311 312bindSheet半模态面板。 313 314**适配指导** 315 316无。 317 318 319 320## cl.arkui.6 bindSheet半模态面板内容区交互修改 321 322**访问级别** 323 324公开接口 325 326**变更原因** 327 328增强交互效果。 329 330**变更影响** 331 332该变更为兼容性变更。 333 334a) 底部弹窗内容处于顶部时上滑，如有更高的档位，则优先扩展档位，如无档位，则滚动内容；底部弹窗内容处于顶部时下滑，优先向下收缩面板档位，如无档位可收缩，则关闭面板。 335 336b) 底部弹窗内容处于底部时上滑，呈现内容区域回弹效果，不切换档位；底部弹窗内容处于底部时下滑，滚动内容直到到达顶部。 337 338c) 底部弹窗、居中弹窗和跟手弹窗内容处于中间位置时，上/下滑时，优先滚动内容，直至页面内容到达底部/顶部，无档位变化等其他交互内容。 339 340d) 居中弹窗如果内容处于顶部，下滑关闭面板，上滑滚动内容；如果内容处于底部，则上滑呈现内容区域回弹效果，下滑滚动内容。 341 342e) 跟手弹窗如果内容处于顶部，下滑不关闭面板，上滑滚动内容；如果内容处于底部，则上滑呈现内容区域回弹效果，下滑滚动内容。 343 344变更前：面板内容区上下滑无交互反馈。 345 346变更后： 347 348 349 350**API Level** 351 35211 353 354**变更发生版本** 355 356从OpenHarmony SDK 4.1.5.2 版本开始。 357 358**变更的接口/组件** 359 360bindSheet半模态面板。 361 362**适配指导** 363 364无。 365 366 367 368## cl.arkui.7 bindSheet半模态面板标题区交互修改 369 370**访问级别** 371 372公开接口 373 374**变更原因** 375 376增强交互效果。 377 378**变更影响** 379 380该变更为兼容性变更。 381 382a) 底部弹窗标题区上滑，短滑向上切换至相邻较大档位，长滑可跨档位直接切换至最大档位，若已到最大档位呈现面板回弹效果。 383 384b) 底部弹窗标题区下滑，短滑向下切换至相邻较小档位，长滑可跨档位直接关闭面板。 385 386c) 居中弹窗标题区上滑，呈现面板回弹效果；下滑时，短滑且速度未到阈值呈现面板回弹效果，长滑或速度到达阈值直接关闭面板。 387 388变更前：标题区交互仅会触发关闭事件。 389 390变更后： 391 392 393 394**API Level** 395 39611 397 398**变更发生版本** 399 400从OpenHarmony SDK 4.1.5.2 版本开始。 401 402**变更的接口/组件** 403 404bindSheet半模态面板。 405 406**适配指导** 407 408无。 409 410**变更示例** 411 412底部弹窗标题区交互示例。 413 414 415 416 417 418## cl.arkui.8 bindSheet半模态面板关闭交互修改 419 420**访问级别** 421 422公开接口 423 424**变更原因** 425 426增强交互效果。 427 428**变更影响** 429 430该变更为兼容性变更。 431 432a) 可通过点击蒙层关闭半模态面板，底部弹窗和居中弹窗样式默认有蒙层，跟手弹窗样式默认无蒙层。 433 434变更前：半模态面板默认无蒙层，点击蒙层无法关闭面板。 435 436变更后： 437 438 439 440b) 可通过点击关闭图标关闭半模态面板。 441 442c) 底部弹窗、居中弹窗可通过下滑手势关闭半模态面板。 443 444变更前：半模态面板可通过下滑手势关闭面板。 445 446变更后：底部弹窗、居中弹窗可通过下滑手势关闭半模态面板；跟手弹窗无法通过下滑手势关闭半模态面板。 447 448d) SheetOptions中增加shouldDismiss接口，当用户执行下拉关闭/back事件/点击蒙层关闭/关闭按钮关闭交互操作时，如果注册该回调函数，则不会立刻关闭。 449 450变更前：如果关闭事件被触发，半模态面板立刻关闭。 451 452变更后：注册shouldDismiss接口的回调函数，半模态面板不会立刻关闭。 453 454 455 456**API Level** 457 45811 459 460**变更发生版本** 461 462从OpenHarmony SDK 4.1.5.2 版本开始。 463 464**变更的接口/组件** 465 466bindSheet半模态面板。 467 468**适配指导** 469 470无。 471 472## cl.arkui.9 select组件修改 473 474**访问级别** 475 476公开接口 477 478**变更原因** 479 480增强视觉效果。 481 482**变更影响** 483 484该变更为兼容性变更。 485 486**API Level** 487 48811 489 490**变更发生版本** 491 492从OpenHarmony SDK 4.1.5.2 版本开始。 493 494**变更的接口/组件** 495 496select组件。 497 498- 变更前： 499 Select组件下拉按钮文本到左边界距离与箭头图标到右边界距离为12vp。 500 501 Select组件下拉按钮与下拉菜单之间对齐时横坐标略有偏移。 502 503 Select组件下拉按钮与下拉菜单之间距离4vp。 504 505  506 507- 变更后： 508 Select组件下拉按钮文本到左边界距离与箭头图标到右边界距离为16vp。 509 510 Select组件下拉按钮与下拉菜单之间横坐标无偏移。 511 512 Select组件下拉按钮与下拉菜单之间距离8vp。 513 514  515 516**适配指导** 517 518无。 519 520 521 522## cl.arkui.10 Refresh组件交互行为变更 523 524**访问级别** 525 526公开接口 527 528**变更原因** 529 530Refresh组件支持鼠标下拉动作进行交互，在某些场景下会与框选动作发生冲突，且该交互行为不符合UX规范，因此依照UX规范对相关交互行为做出变更。 531 532**变更影响** 533 534该变更为非兼容性变更，变更后Refresh组件不再支持鼠标下拉动作进行交互。 535 536**API Level** 537 5388 539 540**变更发生版本** 541 542从OpenHarmony SDK 4.1.5.2 版本开始。 543 544**变更的接口/组件** 545 546API 11之前，Refresh组件支持鼠标下拉动作进行交互。 547 548API 11及之后，Refresh组件不支持鼠标下拉动作进行交互。 549 550**适配指导** 551 552无。
