1# ArkUI子系统Changelog 2 3## cl.arkui.1 onTextSelectionChange触发回调不需要获焦变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11onTextSelectionChange回调触发与控件获焦解除绑定 12 13**变更影响** 14 15该变更为非兼容性变更。 16 17变更前:控件没有获焦时,不允许触发onTextSelectionChange。 18 19变更后:控件没有获焦时,允许触发onTextSelectionChange。 20 21**起始API Level** 22 2310 24 25**变更发生版本** 26 27从OpenHarmony SDK 5.0.0.27开始。 28 29**变更的接口/组件** 30 31Text、TextInput、TextArea、Search。 32 33**适配指导** 34 35如果onTextSelectionChange绑定了事件,需要适配未获焦时的触发回调的行为。 36 37## cl.arkui.2 富文本增加预上屏功能及开关接口,默认打开,支持关闭。 38 39**访问级别** 40 41公开接口 42 43**变更原因** 44 45富文本新增支持输入预上屏功能,默认打开,支持开关关闭。 46 47**变更影响** 48 49该变更为非兼容性变更。 50 51变更前:输入法应用输入时富文本组件无预上屏内容及预上屏下划线样式,在确认候选词后内容插入到组件中。 52 53变更后:输入法应用输入时富文本组件显示预上屏内容及下划线样式,未确认完毕候选词前,预上屏内容已经插入到组件中,在确认完毕候选词后,预上屏内容从组件中移除,再将确认完毕的候选词插入到组件中显示。应用若想保持之前输入时的状态,需要自行设置预上屏开关为false。 54输入相关回调返回值中增加预上屏字段:aboutToIMTInput#RichEditorInsertValue.previewText;onIMEInputComplete#RichEditorTextSpanResult.previewText。 55 56| 变更前 | 变更后 | 57|---------|---------| 58| | | 59 60**起始API Level** 61 6212 63 64**变更发生版本** 65 66从OpenHarmony SDK 5.0.0.27开始。 67 68**变更的接口/组件** 69 70RichEditor 71 72**适配指导** 73 74富文本预上屏功能默认打开,预上屏时会触发相关输入回调。 75例:预上屏输入 "n" -> "ni"时,aboutToIMeInput回调 : {RichEditorInsertValue.insertValue = "", RichEditorInsertValue.previewText = "i"} 76onIMEInputComplete回调 :{RichEditorTextSpanResult.value = "", RichEditorTextSpanResult.previewText = "i"} 77 78基于回调的使用方式不同,输入内容的状态可能会出现不符合开发者预期的情况,开发者可以通过设置预上屏开关,将预上屏功能关闭。 79RichEditor({ controller: this.controller }) 80 .enablePreviewText(false) 81 82## cl.arkui.3 按下鼠标按键(任意按键)移动鼠标情况下不再上报鼠标事件的行为变更。 83 84**访问级别** 85 86公开接口 87 88**变更原因** 89 90优化鼠标按压态下拖移的执行效率。 91 92**变更影响** 93 94该变更为非兼容性变更。 95 96变更前:按压鼠标按键拖移过程中,中途经过的控件会收到鼠标事件。 97 98变更后:按压鼠标按键拖移过程中,中途经过的控件不再会收到鼠标事件。 99 100| 变更前(按住鼠标进行拖移) | 变更后(按住鼠标进行拖移) | 101|---------|---------| 102| | | 103 104**起始API Level** 105 10612 107 108**变更发生版本** 109 110从OpenHarmony SDK 5.0.0.27开始。 111 112**变更的接口/组件** 113 114[onHover](../../../application-dev/reference/apis-arkui/arkui-ts/ts-universal-mouse-key.md#onhover) 115 116[onMouse](../../../application-dev/reference/apis-arkui/arkui-ts/ts-universal-mouse-key.md#onmouse) 117 118**适配指导** 119 120如果开发者需要在按住鼠标按键移动情况下,中间经过的控件也要有hover效果,则需要整改为通过点击开始时命中的控件接收鼠标事件,自行处理。如果当前鼠标移动为拖拽场景,则不要使用[onHover](../../../application-dev/reference/apis-arkui/arkui-ts/ts-universal-mouse-key.md#onhover)和[onMouse](../../../application-dev/reference/apis-arkui/arkui-ts/ts-universal-mouse-key.md#onmouse)而是通过[onDragMove](../../../application-dev/reference/apis-arkui/arkui-ts/ts-universal-events-drag-drop.md#ondragmove)去处理鼠标移动事件。 121 122## cl.arkui.4 TextInput、TextArea 设置TextAlign.Center且显示PlaceHolder文字时,光标位置的变更。 123 124**访问级别** 125 126公开接口 127 128**变更原因** 129 130UX规范变更 131 132**变更影响** 133 134该变更为不兼容性变更。 135 136变更前:TextAlign.Center,显示PlaceHolder文字时,光标在文字中间,输入文字后光标在末尾 137 138变更后:TextAlign.Center,显示PlaceHolder文字时,光标在文字前面,输入文字后光标在末尾 139 140| 变更前 | 变更后 | 141|---------|---------| 142| | | 143 144**起始API Level** 145 1469 147 148**变更发生版本** 149 150从OpenHarmony SDK 5.0.0.27开始。 151 152**适配指导** 153 154光标显示效果变化,无需适配。