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.previewText55
56| 变更前 | 变更后 |
57|---------|---------|
58| ![alt text](previewText_unenabled.PNG)| ![alt text](previewText_enabled.PNG)|
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| ![pre](premouseevent.gif)| ![current](curmouseevent.gif)|
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| ![alt text](textAlignCenter_before.gif)| ![alt text](textAlignCenter_after.gif)|
143
144**起始API Level**
145
1469
147
148**变更发生版本**
149
150从OpenHarmony SDK 5.0.0.27开始。
151
152**适配指导**
153
154光标显示效果变化,无需适配。