1# ArkUI子系统Changelog 2 3## cl.arkui.1 按钮默认值变更为新增圆角矩形类型 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11原有默认类型按钮是胶囊按钮,在适老化场景下字体过大,在多行等场景下胶囊按钮文字易超出其圆角范围。不符合简单易用及高端精致原则,因此新增圆角矩形类型按钮,默认值变为新增的圆角矩形类型。 12 13**变更影响** 14 15该变更为不兼容变更。 16 17变更前:ButtonOptions中type的默认值为ButtonType.Capsule。 18 19变更后:ButtonOptions中type的默认值为ButtonType.ROUNDED_RECTANGLE 20 21| 变更前 | 变更后 | 22|---------|---------| 23||| 24 25**起始API Level** 26 27API 9 28 29**变更发生版本** 30 31从OpenHarmony SDK 5.0.0.43开始。 32 33**变更的接口/组件** 34 35Button组件中ButtonOptions对象的type属性默认值。 36 37**适配指导** 38 39开发者在使用Button组件,创建默认类型的Button按钮时,Button按钮为ROUNDED_RECTANGLE类型。 40 41```ts 42 43@Entry 44@Component 45struct ButtonExample { 46 build() { 47 Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.SpaceBetween }) { 48 Text('Capsule button with rounded corners by default.').fontSize(9).fontColor(0xCCCCCC) 49 Flex({ alignItems: ItemAlign.Center, justifyContent: FlexAlign.SpaceBetween }) { 50 Button('Capsule') 51 .type(ButtonType.Capsule) 52 .backgroundColor(0x317aff) 53 .height(60) 54 .controlSize(ControlSize.NORMAL) 55 .width(180) 56 } 57 Text('Rounded rectangle button with rounded corners by default.').fontSize(9).fontColor(0xCCCCCC) 58 Flex({ alignItems: ItemAlign.Center, justifyContent: FlexAlign.SpaceBetween }) { 59 Button('Rounded rectangle') 60 .type(ButtonType.ROUNDED_RECTANGLE) 61 .backgroundColor(0x317aff) 62 .controlSize(ControlSize.NORMAL) 63 .height(60) 64 .width(180) 65 } 66 }.height(400).padding({ left: 35, right: 35, top: 35 }) 67 } 68} 69 70``` 71 72## cl.arkui.2 半模态顶部高度位置优化 73 74**访问级别** 75 76公开接口 77 78**变更原因** 79 80半模态顶部高度位置优化。 81 82**变更影响** 83 84该变更为不兼容变更。 85 86变更前: 87 881. 当使用Length设置的高度大于最大高度或者设置类型为SheetSize.LARGE、竖屏无状态栏时,最大高度为距离屏幕顶部8vp。 892. 当使用Length设置的高度大于最大高度或者设置类型为SheetSize.LARGE、竖屏有状态栏时,最大高度为距离信号栏8vp。 903. 当使用Length设置的高度大于最大高度或者设置类型为SheetSize.LARGE,横屏有无状态栏,最大高度都为距离屏幕顶部8vp。 91 92 93变更后: 94 951. 当使用Length设置的高度大于最大高度或者设置类型为SheetSize.LARGE,竖屏有无状态栏,最大高度都为距离信号栏8vp。 962. 当使用Length设置的高度大于最大高度或者设置类型为SheetSize.LARGE、横屏无状态栏时,最大高度为距离屏幕顶部8vp。 973. 当使用Length设置的高度大于最大高度或者设置类型为SheetSize.LARGE、横屏有状态栏时,最大高度为距离信号栏8vp。 98 99**起始API Level** 100 10114 102 103**变更发生版本** 104 105从OpenHarmony 5.0.0.40 版本开始。 106 107**变更的接口/组件** 108 109bindSheet组件。 110 111**适配指导** 112 113默认行为变更,无需适配。 114 115## cl.arkui.3 文本拖拽结束键盘行为变更 116 117**访问级别** 118 119公开接口 120 121**变更原因** 122 123优化系统易用性,提升用户体验 124 125**变更影响** 126 127该变更为兼容性变更。 128 129变更前:从文本框A拖拽到文本框B,文本框B获焦拉起键盘,触发onEditChange回调。 130 131变更后:从文本框A拖拽到文本框B,焦点转移到根节点。文本框B没有获焦,因此不触发onEditChange回调。 132 133| 变更前 | 变更后 | 134|---------|---------| 135|  |  | 136 137**起始API Level** 138 139API 8 140 141**变更发生版本** 142 143从OpenHarmony 5.0.0.40 版本开始。 144 145**变更的接口/组件** 146 147textInput/textArea/search组件的onEditChange接口 148 149**适配指导** 150 151onEditChange接口的规格没有发生变化,系统默认行为变更,不需要适配。 152